XuJiacheng
6490fc427f
- 更新微信登录、平台注册/登录、资料更新、token 刷新、认证落库等功能，统一使用 openid 作为全平台身份锚点。 - 新增平台用户注册和登录接口，支持手机号和密码认证。 - 实现系统级 token 刷新接口，支持通过微信 code 重新签发 token。 - 新增用户总数查询接口，返回 tbl_auth_users 表中的用户总数。 - 更新 OpenAPI 文档，反映新的接口和数据结构。 - 修改数据库结构，调整字段名称和索引。 - 新增页面示例，展示基本的 HTML 页面结构。
6.4 KiB
6.4 KiB
tbl_auth 系列表结构说明
数据来源：
script/pocketbase.newpb.js说明：以下为当前脚本中定义的
tbl_auth_系列 PocketBase 集合结构，不含 PocketBaseauth集合的系统内置字段，仅列出脚本中显式声明的自定义字段与索引。
1. tbl_auth_users
- 集合类型：
auth - 说明：认证用户主表，业务身份锚点为
openid
字段
| 字段名 | 类型 | 必填 | 备注 |
|---|---|---|---|
users_convers_id |
text |
否 | 会话/对话侧用户 ID |
openid |
text |
是 | 微信身份锚点，唯一索引 |
org_id |
number |
否 | 组织/部门 ID |
users_rank_level |
number |
否 | 等级 |
users_status |
number |
否 | 状态 |
users_auth_type |
number |
否 | 账户类型 |
users_id |
text |
否 | 自定义用户 ID |
users_name |
text |
否 | 用户姓名 |
users_idtype |
text |
否 | 证件类型 |
users_id_number |
text |
否 | 证件号 |
users_phone |
text |
否 | 手机号 |
users_level |
text |
否 | 用户等级 |
users_type |
text |
否 | 用户类型 |
users_status |
text |
否 | 用户状态 |
company_id |
text |
否 | 公司 ID |
users_parent_id |
text |
否 | 上级用户 ID |
users_promo_code |
text |
否 | 推广码 |
users_id_pic_a |
file |
否 | 证件照正面，maxSelect: 1，允许 jpeg/png/webp |
users_id_pic_b |
file |
否 | 证件照反面，maxSelect: 1，允许 jpeg/png/webp |
users_title_picture |
file |
否 | 资质照片，maxSelect: 1，允许 jpeg/png/webp |
users_picture |
text |
否 | 用户头像 |
usergroups_id |
text |
否 | 用户组 ID |
索引
| 索引名 | 类型 | 字段 |
|---|---|---|
idx_tbl_auth_users_users_convers_id |
UNIQUE INDEX | users_convers_id |
idx_tbl_auth_users_openid |
UNIQUE INDEX | openid |
idx_tbl_auth_users_org_id |
INDEX | org_id |
idx_tbl_auth_users_users_rank_level |
INDEX | users_rank_level |
idx_tbl_auth_users_users_status |
INDEX | users_status |
idx_tbl_auth_users_users_auth_type |
INDEX | users_auth_type |
idx_tbl_auth_users_users_phone |
INDEX | users_phone |
idx_tbl_auth_users_company_id |
INDEX | company_id |
idx_tbl_auth_users_usergroups_id |
INDEX | usergroups_id |
idx_tbl_auth_users_users_parent_id |
INDEX | users_parent_id |
2. tbl_auth_resources
- 集合类型：
base - 说明：受控资源定义表
字段
| 字段名 | 类型 | 必填 | 备注 |
|---|---|---|---|
res_id |
text |
是 | 资源 ID |
table_name |
text |
是 | 表名 |
column_name |
text |
否 | 字段名 |
res_type |
text |
是 | 资源类型 |
索引
| 索引名 | 类型 | 字段 |
|---|---|---|
idx_tbl_auth_resources_res_id |
UNIQUE INDEX | res_id |
idx_tbl_auth_resources_table_name |
INDEX | table_name |
idx_tbl_auth_resources_res_type |
INDEX | res_type |
idx_tbl_auth_resources_unique_res |
UNIQUE INDEX | table_name, column_name, res_type |
3. tbl_auth_roles
- 集合类型：
base - 说明：角色定义表
字段
| 字段名 | 类型 | 必填 | 备注 |
|---|---|---|---|
role_id |
text |
是 | 角色 ID |
role_name |
text |
是 | 角色名称 |
role_code |
text |
否 | 角色编码 |
role_status |
number |
否 | 角色状态 |
role_remark |
text |
否 | 备注 |
索引
| 索引名 | 类型 | 字段 |
|---|---|---|
idx_tbl_auth_roles_role_id |
UNIQUE INDEX | role_id |
idx_tbl_auth_roles_role_name |
UNIQUE INDEX | role_name |
idx_tbl_auth_roles_role_code |
UNIQUE INDEX | role_code |
4. tbl_auth_role_perms
- 集合类型：
base - 说明：角色权限映射表
字段
| 字段名 | 类型 | 必填 | 备注 |
|---|---|---|---|
role_perm_id |
text |
是 | 角色权限记录 ID |
role_id |
text |
是 | 角色 ID |
res_id |
text |
是 | 资源 ID |
access_level |
number |
是 | 权限级别 |
priority |
number |
否 | 优先级 |
索引
| 索引名 | 类型 | 字段 |
|---|---|---|
idx_tbl_auth_role_perms_role_perm_id |
UNIQUE INDEX | role_perm_id |
idx_tbl_auth_role_perms_role_id |
INDEX | role_id |
idx_tbl_auth_role_perms_res_id |
INDEX | res_id |
idx_tbl_auth_role_perms_unique_map |
UNIQUE INDEX | role_id, res_id |
5. tbl_auth_user_overrides
- 集合类型：
base - 说明：用户个性化权限覆盖表
字段
| 字段名 | 类型 | 必填 | 备注 |
|---|---|---|---|
override_id |
text |
是 | 覆盖记录 ID |
users_convers_id |
text |
是 | 用户会话标识 |
res_id |
text |
是 | 资源 ID |
access_level |
number |
是 | 权限级别 |
priority |
number |
否 | 优先级 |
索引
| 索引名 | 类型 | 字段 |
|---|---|---|
idx_tbl_auth_user_overrides_override_id |
UNIQUE INDEX | override_id |
idx_tbl_auth_user_overrides_users_convers_id |
INDEX | users_convers_id |
idx_tbl_auth_user_overrides_res_id |
INDEX | res_id |
idx_tbl_auth_user_overrides_unique_map |
UNIQUE INDEX | users_convers_id, res_id |
6. tbl_auth_row_scopes
- 集合类型：
base - 说明：行级权限范围表
字段
| 字段名 | 类型 | 必填 | 备注 |
|---|---|---|---|
scope_id |
text |
是 | 范围记录 ID |
target_type |
text |
是 | 目标类型 |
target_id |
text |
是 | 目标 ID |
table_name |
text |
是 | 作用表名 |
filter_sql |
editor |
是 | 行级过滤表达式 |
索引
| 索引名 | 类型 | 字段 |
|---|---|---|
idx_tbl_auth_row_scopes_scope_id |
UNIQUE INDEX | scope_id |
idx_tbl_auth_row_scopes_target_type |
INDEX | target_type |
idx_tbl_auth_row_scopes_target_id |
INDEX | target_id |
idx_tbl_auth_row_scopes_table_name |
INDEX | table_name |
备注
tbl_auth_users是auth集合，除上表字段外，还会受 PocketBase auth 系统字段与认证配置影响。- 当前文档仅以
script/pocketbase.newpb.js为准，不代表线上数据库已经 100% 同步成功。 - 若你需要，我可以继续帮你再生成一份“更像数据库设计说明书”的版本，增加字段含义、业务用途、关联关系三列。