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 关系概览

本库围绕「用户管理（USR）」单模块设计，核心实体为用户表 usr_user，辅以 4 张支撑/关联表：

• usr_user（用户）—— 核心表。承载登录账号、密码、用户类型、语言、单据修改权限、作废标志、最后登录时间等。
• usr_employee（职员）—— 支撑表。提供员工名 / 员工编号 / 部门；usr_user.iEmployeeId 可选外键关联（N:1，一个职员至多对应一个登录用户）。
• usr_company（公司 / 版本）—— 支撑表。登录页「版本」下拉的数据来源；当前仅供登录时选择，不与 usr_user 建强外键。
• usr_permission（权限）—— 支撑表。定义可分配的权限项，按「权限分类」组织。
• usr_user_permission（用户权限）—— 关联表。usr_user 与 usr_permission 的多对多授权关系（对应新增 / 修改用户界面的「权限组」勾选）。

关系：

usr_user  N:1  usr_employee          （ON DELETE SET NULL）
usr_user  N:M  usr_permission         经 usr_user_permission（两侧 ON DELETE CASCADE）
usr_company                           独立支撑表（登录时选择，无外键）

表清单

• usr_user — 用户表：登录账号与用户属性核心表
• usr_employee — 职员表：员工名 / 部门等支撑信息
• usr_company — 公司表：登录「版本」下拉数据来源
• usr_permission — 权限表：可分配权限项定义
• usr_user_permission — 用户权限关联表：用户↔权限多对多授权

---

usr_user — 用户表：登录账号与用户属性核心表

字段

字段	类型	Nullable	默认	业务含义
iIncrement	int	否	—	整数主键 ID（标准列）
sId	varchar(100)	是	—	业务 ID（标准列）
sBrandsId	varchar(100)	是	1111111111	品牌 ID，多租户隔离（标准列）
sSubsidiaryId	varchar(100)	是	1111111111	子公司 ID，组织层级隔离（标准列）
tCreateDate	datetime	否	当前时间	创建时间（标准列，对应「制单日期」）
sUserName	varchar(50)	否	—	用户名，登录账号，系统内全局唯一（3-20 位字母数字下划线）
sUserNo	varchar(50)	是	—	用户号，关联职员后可自动带出员工编号 / 姓名
sPassword	varchar(100)	否	—	登录密码，BCrypt 哈希存储（初始密码 666666）
iEmployeeId	int	是	—	关联职员 ID（可选），外键 → usr_employee.iIncrement
sUserType	varchar(20)	否	普通用户	用户类型：普通用户 / 超级管理员
sLanguage	varchar(20)	否	中文	界面语言：中文 / 英文 / 繁体 【人工填写：需用户审阅】默认值与取值范围待确认
iCanModifyBill	tinyint(1)	否	0	单据修改权限：0 否 / 1 是
iIsVoid	tinyint(1)	否	0	作废 / 禁用标志：0 正常 / 1 已作废（禁用后不可登录）
tLastLoginDate	datetime	是	—	最后登录时间，登录成功时更新
sCreator	varchar(50)	是	—	制单人（创建该用户的操作员）

索引

• uk_usr_user_username (UNIQUE): sUserName
• idx_usr_user_employee (INDEX): iEmployeeId
• idx_usr_user_type (INDEX): sUserType
• idx_usr_user_tenant (INDEX): sBrandsId, sSubsidiaryId

外键

• fk_usr_user_employee: iEmployeeId → usr_employee.iIncrement (SET NULL)

业务注记

用户表为本模块核心实体，承载登录认证（用户名 + 密码）与用户类型 / 语言 / 单据修改权限等属性。sUserName 全局唯一；sPassword 以 BCrypt 哈希存储，初始为 666666；iIsVoid=1 表示禁用，禁止登录。可选关联职员（iEmployeeId，职员删除时置空）以带出员工名 / 部门。登录令牌 JWT 为无状态，不落库。查询接口（REQ-USR-003）按用户名 / 类型 / 作废 / 登录日期 / 制单人等条件检索，密码字段不返回。

---

usr_employee — 职员表：员工名 / 部门等支撑信息

字段

字段	类型	Nullable	默认	业务含义
iIncrement	int	否	—	整数主键 ID（标准列）
sId	varchar(100)	是	—	业务 ID（标准列）
sBrandsId	varchar(100)	是	1111111111	品牌 ID，多租户隔离（标准列）
sSubsidiaryId	varchar(100)	是	1111111111	子公司 ID，组织层级隔离（标准列）
tCreateDate	datetime	否	当前时间	创建时间（标准列）
sEmployeeName	varchar(50)	否	—	职员 / 员工姓名（用户「员工名」下拉来源）
sEmployeeNo	varchar(50)	是	—	员工编号
sDepartment	varchar(100)	是	—	所属部门（用户查询输出「部门」来源）

索引

• idx_usr_employee_name (INDEX): sEmployeeName
• idx_usr_employee_tenant (INDEX): sBrandsId, sSubsidiaryId

外键

（无）

业务注记

职员表为用户的关联支撑表，提供员工名、员工编号、部门信息。用户新增 / 修改时通过「员工名」下拉选择职员，用户查询 / 展示时按 usr_user.iEmployeeId 关联取员工名与部门。可作为字典型支撑数据维护。

---

usr_company — 公司表：登录「版本」下拉数据来源

字段

字段	类型	Nullable	默认	业务含义
iIncrement	int	否	—	整数主键 ID（标准列）
sId	varchar(100)	是	—	业务 ID（标准列）
sBrandsId	varchar(100)	是	1111111111	品牌 ID，多租户隔离（标准列）
sSubsidiaryId	varchar(100)	是	1111111111	子公司 ID，组织层级隔离（标准列）
tCreateDate	datetime	否	当前时间	创建时间（标准列）
sCompanyName	varchar(100)	否	—	公司名称（登录页「版本」下拉的显示来源）
sVersion	varchar(50)	是	—	版本 / 账套标识 【人工填写：需用户审阅】"版本"语义（账套 / 数据版本）待确认

索引

• uk_usr_company_name (UNIQUE): sCompanyName

外键

（无）

业务注记

公司表为登录页「版本」下拉的数据来源（REQ-USR-004），每行代表一个可登录的公司 / 账套。当前仅用于登录时选择，不与用户表建立强外键关系。

---

usr_permission — 权限表：可分配权限项定义

字段

字段	类型	Nullable	默认	业务含义
iIncrement	int	否	—	整数主键 ID（标准列）
sId	varchar(100)	是	—	业务 ID（标准列）
sBrandsId	varchar(100)	是	1111111111	品牌 ID，多租户隔离（标准列）
sSubsidiaryId	varchar(100)	是	1111111111	子公司 ID，组织层级隔离（标准列）
tCreateDate	datetime	否	当前时间	创建时间（标准列）
sPermissionName	varchar(100)	否	—	权限名称
sPermissionCode	varchar(100)	否	—	权限编码（程序判定用，系统内唯一）
sPermissionCategory	varchar(100)	是	—	权限分类（新增 / 修改用户界面「权限组」的"权限分类"）

索引

• uk_usr_permission_code (UNIQUE): sPermissionCode
• idx_usr_permission_category (INDEX): sPermissionCategory

外键

（无）

业务注记

权限表定义可分配的权限项，按「权限分类」组织（对应新增 / 修改用户界面的「权限组」网格）。sPermissionCode 全局唯一供程序判定。【人工填写：需用户审阅】权限粒度（按分类 / 按具体功能点）待确认。

---

usr_user_permission — 用户权限关联表：用户↔权限多对多授权

字段

字段	类型	Nullable	默认	业务含义
iIncrement	int	否	—	整数主键 ID（标准列）
sId	varchar(100)	是	—	业务 ID（标准列；关联表对外不暴露，可留空）
sBrandsId	varchar(100)	是	1111111111	品牌 ID，多租户隔离（标准列）
sSubsidiaryId	varchar(100)	是	1111111111	子公司 ID，组织层级隔离（标准列）
tCreateDate	datetime	否	当前时间	创建时间（标准列）
iUserId	int	否	—	用户 ID，外键 → usr_user.iIncrement
iPermissionId	int	否	—	权限 ID，外键 → usr_permission.iIncrement

索引

• uk_usr_user_permission (UNIQUE): iUserId, iPermissionId
• idx_usr_user_permission_perm (INDEX): iPermissionId

外键

• fk_usr_up_user: iUserId → usr_user.iIncrement (CASCADE)
• fk_usr_up_permission: iPermissionId → usr_permission.iIncrement (CASCADE)

业务注记

用户↔权限多对多关联表，记录每个用户被授予的权限（对应「权限组」勾选）。(iUserId, iPermissionId) 唯一防重复授权；删除用户或权限时级联清除对应授权记录。该表为纯关联表，sId 业务 ID 不对外暴露（标准列仍保留以保持结构一致）。