03-数据库设计文档

Schema: xlyweberp_vibe_erp_test Migration 清单: sql/migrations/V*.sql（由 Flyway 顺序 apply） 生成方式: 由 A3 db-design-gen 基于 docs/01-需求清单/<module>/REQ-*.md REQ 卡片正向设计生成（schema SSoT）。

项目标准列约定

下文每张业务表的字段清单都自动包含以下 5 个标准列（匈牙利前缀 i int / s varchar / t datetime）。渲染时由 docs-03-table-template.md 模板内置原样输出。

列名	类型	可空	主键	说明
iIncrement	int	否	是	整数主键 ID（自增方式由实现决定：DB AUTO_INCREMENT 或应用 / 触发器分配）
sId	varchar(100)	是	—	业务 ID（对外暴露的字符串标识，如 UUID / 人类可读编号）
sBrandsId	varchar(100)	是	—	品牌 ID（多租户隔离）
sSubsidiaryId	varchar(100)	是	—	子公司 ID（组织层级隔离）
tCreateDate	datetime	否	—	记录创建时间

字典 / 辅助表如有豁免，在该表业务注记里注明豁免原因。

ER 关系概览

本期共 5 张业务表，分布在 USR / MOD 两个模块：

• tUser 是用户账户主表，可选关联 tStaff（员工）；与 tPermissionCategory 通过 tUserPermission 形成多对多权限授权关系。登录失败计数走 Redis，不入库。
• tStaff 是职员维度表，作为 tUser 的员工来源（员工名 / 部门下拉）。
• tPermissionCategory 是权限分类树（自引用 iParentId），由 tUserPermission 关联到具体用户。
• tUserPermission 是 tUser × tPermissionCategory 的关联表（多对多）。
• tModule 是 ERP 业务模块定义表（自引用 iParentId 形成模块树），与本期其他表无外键关系。

软删除统一使用 bDeleted / tDeletedDate / sDeletedBy 三件套；查询接口默认过滤 bDeleted = 0。

表清单

• tUser — 系统用户账户与登录凭据
• tStaff — 职员维度（员工名 / 部门 / 编号）
• tPermissionCategory — 权限分类树
• tUserPermission — 用户与权限分类的关联
• tModule — ERP 业务模块元数据树

---

tUser — 系统用户账户与登录凭据

字段

字段	类型	Nullable	默认	业务含义
iIncrement	int	否	—	整数主键 ID（标准列）
sId	varchar(100)	是	—	业务 ID（标准列）
sBrandsId	varchar(100)	是	—	品牌 ID（多租户隔离，标准列）
sSubsidiaryId	varchar(100)	是	—	子公司 ID（组织层级隔离，标准列）
tCreateDate	datetime	否	—	创建时间（标准列）
sUserNo	varchar(50)	否	—	用户号；系统内唯一
sUserName	varchar(50)	否	—	用户名（登录账号）；系统内唯一
iStaffId	int	是	NULL	关联职员 ID（可选，外键 → tStaff.iIncrement）
sUserType	varchar(20)	否	普通用户	用户类型；枚举：普通用户 / 超级管理员
sLanguage	varchar(10)	否	zh	语言偏好；枚举：zh / en / zh-TW
bCanModifyDocs	tinyint(1)	否	0	单据修改权限；0 否 / 1 是
sPasswordHash	varchar(255)	否	—	密码哈希值（BCrypt 等强哈希算法），新增默认初始密码 666666 的哈希
tLastLoginDate	datetime	是	NULL	最后登录时间
sCreatedBy	varchar(50)	是	—	制单人（创建用户的操作员用户号）
bDeleted	tinyint(1)	否	0	软删除标记；0 有效 / 1 已作废
tDeletedDate	datetime	是	NULL	软删除时间
sDeletedBy	varchar(50)	是	NULL	软删除操作人

索引

• uk_user_no (UNIQUE): (sUserNo)
• uk_user_name (UNIQUE): (sUserName)
• idx_staff_id (NORMAL): (iStaffId)
• idx_brand_subsidiary (NORMAL): (sBrandsId, sSubsidiaryId)
• idx_deleted_login (NORMAL): (bDeleted, tLastLoginDate)

外键

• fk_user_staff: iStaffId → tStaff.iIncrement (ON DELETE SET NULL, ON UPDATE CASCADE)

业务注记

• 用户名 / 用户号在系统内全局唯一（含已软删除记录是否计入唯一性，需在 service 层用部分唯一索引或代码校验决定，本设计取代码校验，唯一索引仅约束未删除部分由应用层保证）。
• 密码哈希存储；登录失败次数 / 临时锁定不入库，由 Redis 维护。
• REQ-USR-003 查询接口的「作废」字段直接映射 bDeleted；「制单日期」即 tCreateDate；「制单人」即 sCreatedBy。
• 未关联职员的用户允许 iStaffId = NULL（如系统管理员账号）。

---

tStaff — 职员维度（员工名 / 部门 / 编号）

字段

字段	类型	Nullable	默认	业务含义
iIncrement	int	否	—	整数主键 ID（标准列）
sId	varchar(100)	是	—	业务 ID（标准列）
sBrandsId	varchar(100)	是	—	品牌 ID（多租户隔离，标准列）
sSubsidiaryId	varchar(100)	是	—	子公司 ID（组织层级隔离，标准列）
tCreateDate	datetime	否	—	创建时间（标准列）
sStaffNo	varchar(50)	是	—	职员编号；系统内唯一
sStaffName	varchar(50)	否	—	职员姓名
sDepartment	varchar(100)	是	NULL	所属部门（本期暂用字符串，未来如需独立 tDepartment 字典表再另行重构）
sCreatedBy	varchar(50)	是	—	制单人
bDeleted	tinyint(1)	否	0	软删除标记
tDeletedDate	datetime	是	NULL	软删除时间
sDeletedBy	varchar(50)	是	NULL	软删除操作人

索引

• uk_staff_no (UNIQUE): (sStaffNo)
• idx_staff_name (NORMAL): (sStaffName)
• idx_department (NORMAL): (sDepartment)

外键

（无）

业务注记

• USR 模块通过 tUser.iStaffId 引用本表；REQ-USR-003 列表的「员工名 / 部门」均来自本表。
• 部门当前以字符串保存，便于本期快速落地；后续若需独立部门字典表（如审批流引用部门），改为 iDepartmentId 外键。

---

tPermissionCategory — 权限分类树

字段

字段	类型	Nullable	默认	业务含义
iIncrement	int	否	—	整数主键 ID（标准列）
sId	varchar(100)	是	—	业务 ID（标准列）
sBrandsId	varchar(100)	是	—	品牌 ID（多租户隔离，标准列）
sSubsidiaryId	varchar(100)	是	—	子公司 ID（组织层级隔离，标准列）
tCreateDate	datetime	否	—	创建时间（标准列）
sCategoryCode	varchar(50)	否	—	权限分类编码；系统内唯一
sCategoryName	varchar(100)	否	—	权限分类名称（界面展示）
iParentId	int	是	NULL	父分类 ID（自引用，根节点为 NULL）
iSortOrder	int	否	0	同级排序号
sCreatedBy	varchar(50)	是	—	制单人
bDeleted	tinyint(1)	否	0	软删除标记
tDeletedDate	datetime	是	NULL	软删除时间
sDeletedBy	varchar(50)	是	NULL	软删除操作人

索引

• uk_category_code (UNIQUE): (sCategoryCode)
• idx_parent (NORMAL): (iParentId)

外键

• fk_category_parent: iParentId → tPermissionCategory.iIncrement (ON DELETE RESTRICT, ON UPDATE CASCADE)

业务注记

• REQ-USR-001 / 002 表 2「权限组 - 权限分类」下拉来源即本表（bDeleted = 0 过滤）。
• 自引用形成权限分类树；删除前须确保无子分类、无 tUserPermission 引用。

---

tUserPermission — 用户与权限分类关联

字段

字段	类型	Nullable	默认	业务含义
iIncrement	int	否	—	整数主键 ID（标准列）
sId	varchar(100)	是	—	业务 ID（标准列）
sBrandsId	varchar(100)	是	—	品牌 ID（多租户隔离，标准列）
sSubsidiaryId	varchar(100)	是	—	子公司 ID（组织层级隔离，标准列）
tCreateDate	datetime	否	—	创建时间（标准列）
iUserId	int	否	—	关联用户 ID（外键 → tUser.iIncrement）
iCategoryId	int	否	—	关联权限分类 ID（外键 → tPermissionCategory.iIncrement）
sCreatedBy	varchar(50)	是	—	授权操作人

索引

• uk_user_category (UNIQUE): (iUserId, iCategoryId)
• idx_category (NORMAL): (iCategoryId)

外键

• fk_up_user: iUserId → tUser.iIncrement (ON DELETE CASCADE, ON UPDATE CASCADE)
• fk_up_category: iCategoryId → tPermissionCategory.iIncrement (ON DELETE RESTRICT, ON UPDATE CASCADE)

业务注记

• 关联表保留标准列以保持设计一致性，无独立软删除字段——授权撤销直接物理删除关联行（CASCADE 也会随用户删除而清理）。
• REQ-USR-001 / 002 提交时按表 2 选中行重建本表 iUserId 下的关联（先删后插或差异同步）。

---

tModule — ERP 业务模块元数据树

字段

字段	类型	Nullable	默认	业务含义
iIncrement	int	否	—	整数主键 ID（标准列）
sId	varchar(100)	是	—	业务 ID（标准列）
sBrandsId	varchar(100)	是	—	品牌 ID（多租户隔离，标准列）
sSubsidiaryId	varchar(100)	是	—	子公司 ID（组织层级隔离，标准列）
tCreateDate	datetime	否	—	创建时间（标准列）
sDisplayType	varchar(20)	否	手机端	显示类型；枚举：手机端 / 前端业务 / 系统配置 / 接口
sProcedureName	varchar(100)	否	—	存储过程（审核）名称；系统内唯一
sModuleType	varchar(50)	否	—	模块类型（本期按自由文本处理，VARCHAR(50)；如未来收敛到枚举再加 CHECK 约束）
sManageDeptEn	varchar(50)	否	—	管理部门英文标识
bShowPermission	tinyint(1)	否	0	权限是否显示；0 否 / 1 是
sModuleNameZh	varchar(100)	否	—	界面名称（中文，模糊查询用）
iParentId	int	是	NULL	父模块 ID（自引用，根节点为 NULL）
iSortOrder	int	否	0	同级排序号
sCreatedBy	varchar(50)	是	—	制单人
bDeleted	tinyint(1)	否	0	软删除标记
tDeletedDate	datetime	是	NULL	软删除时间
sDeletedBy	varchar(50)	是	NULL	软删除操作人

索引

• uk_procedure_name (UNIQUE): (sProcedureName)
• idx_module_name_zh (NORMAL): (sModuleNameZh)
• idx_parent (NORMAL): (iParentId)
• idx_display_type (NORMAL): (sDisplayType)

外键

• fk_module_parent: iParentId → tModule.iIncrement (ON DELETE RESTRICT, ON UPDATE CASCADE)

业务注记

• REQ-MOD-004 查询按 sModuleNameZh 模糊匹配（LIKE '%关键字%'，bDeleted = 0 过滤），结果按 iParentId 拼装树形。
• REQ-MOD-003 删除策略：仅软删除（写入 bDeleted / tDeletedDate / sDeletedBy）；service 层先校验「无未删除子模块」「未被外部业务引用」再执行。
• sProcedureName 假定系统内唯一，若实际允许同名请在审阅时移除该唯一索引。