9.0 KiB
SaaS：租户、用户、权限、日志
约定见 00-conventions.md。本文件在 Phase 1 锁定，Phase 4 写迁移。
认证令牌用 Laravel Sanctum 自带的 personal_access_tokens，不另建 wms_ 表。
wms_tenant 租户
用途：租户注册表。行本身就是租户，不套 TenantContext 的自动过滤。
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
| id | BIGINT UNSIGNED | N | AUTO_INCREMENT | 内部主键 |
| tenant_code | VARCHAR(32) | N | 租户编码 | |
| name | VARCHAR(128) | N | 租户名称 | |
| status | VARCHAR(32) | N | active | 状态 |
| timezone | VARCHAR(64) | N | UTC | IANA 时区 |
| created_at | TIMESTAMP | Y | ||
| updated_at | TIMESTAMP | Y |
索引：
| 名称 | 类型 | 字段 | 支撑的查询 |
|---|---|---|---|
| uk_tenant_code | UNIQUE | (tenant_code) | 按租户编码查找 |
状态：active 可用，suspended 停用（拒绝新的业务写入）。
关联：被所有带 tenant_code 的表引用。
并发 / 审计：无乐观锁。不停用后物理删除。状态变更写 wms_status_log，biz_type = tenant。
wms_user 用户
用途：租户内登录用户。
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
| id | BIGINT UNSIGNED | N | AUTO_INCREMENT | 内部主键 |
| tenant_code | VARCHAR(32) | N | 租户编码 | |
| user_code | VARCHAR(64) | N | 用户编码 | |
| name | VARCHAR(128) | N | 显示名 | |
| VARCHAR(255) | N | 登录邮箱 | ||
| password | VARCHAR(255) | N | 密码哈希，禁止写入日志 | |
| status | VARCHAR(32) | N | active | 状态 |
| last_login_at | TIMESTAMP | Y | 最近登录 | |
| created_at | TIMESTAMP | Y | ||
| updated_at | TIMESTAMP | Y | ||
| deleted_at | TIMESTAMP | Y | 软删除 |
索引：
| 名称 | 类型 | 字段 | 支撑的查询 |
|---|---|---|---|
| uk_tenant_user_code | UNIQUE | (tenant_code, user_code) | 按用户编码查找 |
| uk_tenant_email | UNIQUE | (tenant_code, email) | 登录 |
状态：active、disabled。
关联：wms_user_role.user_code。操作人字段一律存 user_code。
并发 / 审计：无乐观锁。软删除规则见约定。权限变更写 wms_operation_log。
wms_role 角色
用途：租户内角色。
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
| id | BIGINT UNSIGNED | N | AUTO_INCREMENT | 内部主键 |
| tenant_code | VARCHAR(32) | N | 租户编码 | |
| role_code | VARCHAR(64) | N | 角色编码 | |
| name | VARCHAR(128) | N | 角色名称 | |
| created_at | TIMESTAMP | Y | ||
| updated_at | TIMESTAMP | Y | ||
| deleted_at | TIMESTAMP | Y | 软删除 |
索引：
| 名称 | 类型 | 字段 | 支撑的查询 |
|---|---|---|---|
| uk_tenant_role_code | UNIQUE | (tenant_code, role_code) | 按角色编码查找 |
关联：wms_user_role、wms_role_permission。
并发 / 审计：被用户引用时不能软删。
wms_permission 权限目录
用途：系统预置权限，全租户共用。不按租户复制，因此没有 tenant_code。
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
| id | BIGINT UNSIGNED | N | AUTO_INCREMENT | 内部主键 |
| permission_code | VARCHAR(64) | N | 权限编码，如 inbound.receive |
|
| name | VARCHAR(128) | N | 名称 | |
| module | VARCHAR(64) | N | 模块，如 inbound |
|
| created_at | TIMESTAMP | Y | ||
| updated_at | TIMESTAMP | Y |
索引：
| 名称 | 类型 | 字段 | 支撑的查询 |
|---|---|---|---|
| uk_permission_code | UNIQUE | (permission_code) | 按权限编码查找 |
关联：wms_role_permission.permission_code。数据由迁移或 Seeder 写入，不开放租户自行新增。
wms_role_permission 角色权限
用途：租户角色与权限目录的对应。
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
| id | BIGINT UNSIGNED | N | AUTO_INCREMENT | 内部主键 |
| tenant_code | VARCHAR(32) | N | 租户编码 | |
| role_code | VARCHAR(64) | N | 角色编码 | |
| permission_code | VARCHAR(64) | N | 权限编码 | |
| created_at | TIMESTAMP | Y | ||
| updated_at | TIMESTAMP | Y |
索引：
| 名称 | 类型 | 字段 | 支撑的查询 |
|---|---|---|---|
| uk_tenant_role_permission | UNIQUE | (tenant_code, role_code, permission_code) | 防止重复授权 |
| idx_tenant_permission | INDEX | (tenant_code, permission_code) | 反查拥有某权限的角色 |
并发 / 审计：变更写 wms_operation_log。无软删除，收回权限即删行。
wms_user_role 用户角色
用途：用户与角色的对应。
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
| id | BIGINT UNSIGNED | N | AUTO_INCREMENT | 内部主键 |
| tenant_code | VARCHAR(32) | N | 租户编码 | |
| user_code | VARCHAR(64) | N | 用户编码 | |
| role_code | VARCHAR(64) | N | 角色编码 | |
| created_at | TIMESTAMP | Y | ||
| updated_at | TIMESTAMP | Y |
索引：
| 名称 | 类型 | 字段 | 支撑的查询 |
|---|---|---|---|
| uk_tenant_user_role | UNIQUE | (tenant_code, user_code, role_code) | 防止重复绑定 |
| idx_tenant_role | INDEX | (tenant_code, role_code) | 查角色下的用户 |
并发 / 审计：同角色权限。无软删除。
wms_tenant_setting 租户设置
用途：租户级配置。值用字符串，由应用解析。
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
| id | BIGINT UNSIGNED | N | AUTO_INCREMENT | 内部主键 |
| tenant_code | VARCHAR(32) | N | 租户编码 | |
| setting_key | VARCHAR(64) | N | 配置键 | |
| setting_value | TEXT | Y | 配置值 | |
| created_at | TIMESTAMP | Y | ||
| updated_at | TIMESTAMP | Y |
索引：
| 名称 | 类型 | 字段 | 支撑的查询 |
|---|---|---|---|
| uk_tenant_setting_key | UNIQUE | (tenant_code, setting_key) | 读取一项配置 |
并发 / 审计：覆盖写 updated_at。变更写 wms_operation_log。不存第三方密钥明文以外的内容；密钥加密存储留到平台对接 Phase。
wms_number_sequence 取号
用途：租户内单号序号。见 00-conventions.md。
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
| id | BIGINT UNSIGNED | N | AUTO_INCREMENT | 内部主键 |
| tenant_code | VARCHAR(32) | N | 租户编码 | |
| biz_type | VARCHAR(32) | N | 单据类型，如 inbound |
|
| period | CHAR(8) | N | yyyyMMdd |
|
| current_value | INT UNSIGNED | N | 0 | 当日已分配到的序号 |
| created_at | TIMESTAMP | Y | ||
| updated_at | TIMESTAMP | Y |
索引：
| 名称 | 类型 | 字段 | 支撑的查询 |
|---|---|---|---|
| uk_tenant_biz_period | UNIQUE | (tenant_code, biz_type, period) | 取号时锁这一行 |
并发 / 审计：SELECT ... FOR UPDATE 后递增。独立短事务。不软删除。
wms_status_log 状态变更日志
用途：状态机审计。只追加。登录日志与 API 日志留在后续 95-audit.md。
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
| id | BIGINT UNSIGNED | N | AUTO_INCREMENT | 内部主键 |
| tenant_code | VARCHAR(32) | N | 租户编码 | |
| biz_type | VARCHAR(32) | N | order、inbound、outbound、wave、adjust、stocktake、tenant |
|
| biz_no | VARCHAR(64) | N | 业务单号 | |
| from_status | VARCHAR(32) | Y | 变更前，新建时可空 | |
| to_status | VARCHAR(32) | N | 变更后 | |
| operator_user_code | VARCHAR(64) | Y | 操作人，系统任务为空 | |
| request_id | VARCHAR(64) | Y | 请求标识 | |
| remark | VARCHAR(500) | Y | ||
| created_at | TIMESTAMP | Y | ||
| updated_at | TIMESTAMP | Y | 行创建后不更新 |
索引：
| 名称 | 类型 | 字段 | 支撑的查询 |
|---|---|---|---|
| idx_tenant_biz_created | INDEX | (tenant_code, biz_type, biz_no, created_at) | 查一张单据的状态历史 |
并发 / 审计：禁止更新和删除。与状态变更同一事务写入。
wms_operation_log 操作日志
用途：主数据、权限、设置等关键变更。只追加。
| 字段 | 类型 | 可空 | 默认 | 说明 |
|---|---|---|---|---|
| id | BIGINT UNSIGNED | N | AUTO_INCREMENT | 内部主键 |
| tenant_code | VARCHAR(32) | N | 租户编码 | |
| operator_user_code | VARCHAR(64) | Y | 操作人 | |
| action | VARCHAR(64) | N | 如 user.update、role.grant |
|
| biz_type | VARCHAR(32) | N | 对象类型 | |
| biz_no | VARCHAR(64) | N | 对象编码 | |
| biz_ip | VARCHAR(64) | Y | 来源 IP | |
| request_id | VARCHAR(64) | Y | 请求标识 | |
| before_data | JSON | Y | 变更前 | |
| after_data | JSON | Y | 变更后 | |
| created_at | TIMESTAMP | Y | ||
| updated_at | TIMESTAMP | Y | 行创建后不更新 |
索引：
| 名称 | 类型 | 字段 | 支撑的查询 |
|---|---|---|---|
| idx_tenant_biz_created | INDEX | (tenant_code, biz_type, biz_no, created_at) | 查某对象的操作历史 |
| idx_tenant_created | INDEX | (tenant_code, created_at) | 按时间查日志 |
并发 / 审计：禁止更新和删除。before_data / after_data 不得包含密码、Token。