数据库详情页
表前缀 ot_。本页为列表展示(无 Tab 切换),便于评审与交付对齐。
说明:下列字段与表结构为设计基线,实施时需结合现有 database_schema.md 中的业务字段做合并迁移(如 create_time 与 created_at 统一策略)。
一、全库通用字段(业务主表建议)
| 字段 | 类型 | 必填 | 说明 |
| tenant_id | bigint | 是 | 租户(平台/品牌主体),默认 1 |
| agent_id | bigint | 否 | 代理/加盟节点;直营可空 |
| station_id | bigint | 否 | 数据归属站点(站点级权限、仓储范围) |
| created_by | bigint | 否 | 创建人(后台用户或系统账号) |
| updated_by | bigint | 否 | 最后修改人 |
| created_at | datetime | 是 | 创建时间 |
| updated_at | datetime | 是 | 最后编辑时间(每次 UPDATE 刷新) |
| deleted_at | datetime | 否 | 伪删除;非空即已删,默认查询需过滤 |
| version | int | 否 | 乐观锁(高并发写表建议) |
索引建议:(tenant_id, deleted_at)、(tenant_id, station_id, deleted_at)、(tenant_id, created_at)。
二、多租户与代理节点
2.1 ot_tenant(租户)
| 字段 | 类型 | 说明 |
| id | bigint PK | |
| code | varchar(32) UK | 租户编码 |
| name | varchar(64) | 名称 |
| status | tinyint | 1 正常 0 停用 |
| config_json | json | 租户级配置 |
| created_at / updated_at / deleted_at | datetime | 审计与软删 |
2.2 ot_agent_node(代理/加盟节点)
| 字段 | 类型 | 说明 |
| id | bigint PK | |
| tenant_id | bigint FK | 所属租户 |
| parent_id | bigint | 上级代理(树形,可空) |
| code | varchar(32) | 租户内唯一编码 |
| name | varchar(64) | 节点名称 |
| region_codes | varchar(256) | 负责区域(可选) |
| status | tinyint | |
| created_at / updated_at / deleted_at | datetime | |
2.3 站点表补充(在 ot_station 上)
| 字段 | 类型 | 说明 |
| tenant_id | bigint FK | 站点归属租户 |
| agent_id | bigint FK | 可选,归属代理 |
| manager_admin_id | bigint | 站长/负责人(后台账号,可选) |
三、站点独立权限(RBAC + 数据范围)
平台级角色可跨站;站点级角色仅可操作绑定站点数据;代理账号可按 agent_id 收敛范围。
3.1 ot_admin_user(后台用户)
| 字段 | 类型 | 说明 |
| id | bigint PK | |
| tenant_id | bigint FK | 主租户 |
| username | varchar(64) | 建议 UK(tenant_id, username) |
| password_hash | varchar(128) | |
| real_name / phone | varchar | |
| default_station_id | bigint | 默认站点 |
| data_scope_type | tinyint | 1 全部 2 本代理 3 指定站点列表 4 仅默认站 |
| status | tinyint | |
| created_at / updated_at / deleted_at | datetime | |
3.2 角色与权限
ot_admin_role — 角色(含 tenant_id、scope:platform / station)
ot_admin_permission — 权限点(code 如 order:export)
ot_admin_role_permission — 角色-权限
ot_admin_user_role — 用户-角色
ot_admin_user_station — 用户可访问站点(data_scope_type=3 时生效)
四、审计与修改记录
4.1 ot_data_change_log(字段级变更,可选)
| 字段 | 类型 | 说明 |
| id | bigint PK | |
| tenant_id | bigint | |
| table_name | varchar(64) | 业务表 |
| record_id | bigint | 主键 |
| field_name | varchar(64) | 变更字段 |
| old_value / new_value | text | 脱敏后存储 |
| change_type | tinyint | insert / update / soft_delete |
| operator_id | bigint | 操作人 |
| operator_ip | varchar(45) | |
| remark | varchar(512) | |
| created_at | datetime | |
4.2 ot_operation_log(接口/操作粗粒度)
| 字段 | 类型 | 说明 |
| id | bigint PK | |
| tenant_id | bigint | |
| admin_user_id | bigint | |
| module / action | varchar | 模块与动作 |
| request_uri | varchar(256) | |
| request_body_digest | varchar(64) | 报文摘要 |
| result | tinyint | 成功/失败 |
| duration_ms | int | 耗时 |
| created_at | datetime | |
五、订单表 ot_order 须补充字段(在现有业务字段之上)
| 字段 | 说明 |
| tenant_id / agent_id / station_id | 隔离与调度 |
| created_by / updated_by | 代下单、后台改单 |
| created_at / updated_at / deleted_at / version | 时间与并发 |
完整业务字段列表见 database_schema.md 第 2 节。
六、各表对齐清单(摘要)
| 分类 | 表 | tenant | agent | station | 软删 | 编辑时间 |
| 订单 | ot_order 及子表 | ✓ | 可选 | ✓ | ✓ | ✓ |
| 骑手 | ot_courier 等 | ✓ | 可选 | 可选 | ✓ | ✓ |
| 用户 | ot_user、会员、地址 | ✓ | 可选 | - | ✓ | ✓ |
| 营销 | 优惠券、商城 | ✓ | 可选 | 可选 | ✓ | ✓ |
| 站点仓储 | 站点、入出库、库存 | ✓ | 可选 | ✓ | ✓ | ✓ |
| 轨迹 | 位置、轨迹流水 | ✓ | - | 可选 | 按需 | 按需 |
维护:项目团队 | Markdown 同源:database_schema_detail.md