luoweijian
/
crm-backend-matt
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
3 Commits
1 Branch
0 Tags
405 MiB
Tree: 13e15c142a
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '13e15c142a'
${ noResults }
crm-backend-matt/.qoder/repowiki/zh/content/数据模型/数据模型.md

651 lines
25 KiB
Raw Normal View History

first-commit
1 month ago
# 数据模型
<cite>
**本文引用的文件**
- [AuthUser.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthUser.java)
- [SysRole.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysRole.java)
- [SysMenu.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysMenu.java)
- [SysDept.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysDept.java)
- [SysUserRole.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysUserRole.java)
- [SysRoleMenu.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysRoleMenu.java)
- [SysUserDept.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysUserDept.java)
- [AuthIdentity.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthIdentity.java)
- [FileInfo.java](file://crm-file/src/main/java/com/crm/file/domain/entity/FileInfo.java)
- [BaseEntity.java](file://crm-base/src/main/java/com/crm/base/domain/entity/BaseEntity.java)
- [OwnedEntity.java](file://crm-base/src/main/java/com/crm/base/domain/entity/OwnedEntity.java)
- [SnowflakeIdWorker.java](file://crm-base/src/main/java/com/crm/base/config/SnowflakeIdWorker.java)
- [CustomIdGenerator.java](file://crm-base/src/main/java/com/crm/base/config/CustomIdGenerator.java)
- [DataScopeEnum.java](file://crm-auth/src/main/java/com/crm/auth/domain/enums/DataScopeEnum.java)
- [IdentityTypeEnum.java](file://crm-auth/src/main/java/com/crm/auth/domain/enums/IdentityTypeEnum.java)
- [MenuTypeEnum.java](file://crm-auth/src/main/java/com/crm/auth/domain/enums/MenuTypeEnum.java)
- [StatusEnum.java](file://crm-base/src/main/java/com/crm/base/domain/enums/StatusEnum.java)
- [HasValueEnum.java](file://crm-base/src/main/java/com/crm/base/domain/enums/HasValueEnum.java)
- [MetaObjectFillHandler.java](file://crm-base/src/main/java/com/crm/base/config/MetaObjectFillHandler.java)
- [MybatisPlusConfig.java](file://crm-base/src/main/java/com/crm/base/config/MybatisPlusConfig.java)
- [CrmSqlInjector.java](file://crm-base/src/main/java/com/crm/base/config/CrmSqlInjector.java)
- [InsertBatchOnDuplicateKeyUpdate.java](file://crm-base/src/main/java/com/crm/base/config/InsertBatchOnDuplicateKeyUpdate.java)
- [application.yml](file://crm-app/src/main/resources/application.yml)
- [application.yml](file://crm-auth/src/main/resources/application.yml)
</cite>
## 目录
1. [简介](#简介)
2. [项目结构](#项目结构)
3. [核心组件](#核心组件)
4. [架构总览](#架构总览)
5. [详细组件分析](#详细组件分析)
6. [依赖关系分析](#依赖关系分析)
7. [性能考虑](#性能考虑)
8. [故障排查指南](#故障排查指南)
9. [结论](#结论)
10. [附录](#附录)
## 简介
本文件为 CRM 后端的数据模型文档，面向数据库管理员与后端开发者。内容覆盖用户、角色、菜单、部门、身份认证、文件等核心实体的字段定义、数据类型、约束与业务含义；提供实体关系图（ER）与类图；说明主键策略、外键关联、索引设计、数据完整性约束；给出数据字典、枚举值定义、默认值设置；并补充数据迁移策略、版本兼容性与备份恢复方案。
## 项目结构
本项目采用多模块架构：
- crm-base：基础能力（通用实体、配置、工具、异常、分页、结果封装等）
- crm-auth：认证授权与系统管理（用户、角色、菜单、部门、权限、数据范围等）
- crm-file：文件服务（上传、分片、预览、清理任务等）
- crm-app：应用启动入口与全局配置
```mermaid
graph TB
subgraph "基础层"
base["crm-base<br/>通用实体/配置/工具"]
end
subgraph "认证授权"
auth["crm-auth<br/>用户/角色/菜单/部门/权限"]
end
subgraph "文件服务"
file["crm-file<br/>文件元数据/分片/预览"]
end
subgraph "应用"
app["crm-app<br/>启动与配置"]
end
app --> auth
app --> file
auth --> base
file --> base
```
**图表来源**
- [application.yml](file://crm-app/src/main/resources/application.yml)
- [application.yml](file://crm-auth/src/main/resources/application.yml)
**章节来源**
- [application.yml](file://crm-app/src/main/resources/application.yml)
- [application.yml](file://crm-auth/src/main/resources/application.yml)
## 核心组件
- 通用基类
- BaseEntity：统一审计字段（如创建时间、更新时间等），配合自动填充处理器实现默认值与审计信息注入
- OwnedEntity：扩展数据所有权字段（如创建人、所属组织等），用于数据可见性控制
- 主键生成器
- SnowflakeIdWorker：雪花算法分布式ID生成
- CustomIdGenerator：MyBatis-Plus 自定义ID生成器，将雪花ID注入到实体主键
- 自动填充与SQL注入
- MetaObjectFillHandler：MyBatis-Plus 自动填充处理器，统一处理审计字段与默认值
- CrmSqlInjector：MyBatis-Plus SQL 注入器，启用逻辑删除、乐观锁等增强功能
- InsertBatchOnDuplicateKeyUpdate：批量插入去重更新支持
**章节来源**
- [BaseEntity.java](file://crm-base/src/main/java/com/crm/base/domain/entity/BaseEntity.java)
- [OwnedEntity.java](file://crm-base/src/main/java/com/crm/base/domain/entity/OwnedEntity.java)
- [SnowflakeIdWorker.java](file://crm-base/src/main/java/com/crm/base/config/SnowflakeIdWorker.java)
- [CustomIdGenerator.java](file://crm-base/src/main/java/com/crm/base/config/CustomIdGenerator.java)
- [MetaObjectFillHandler.java](file://crm-base/src/main/java/com/crm/base/config/MetaObjectFillHandler.java)
- [MybatisPlusConfig.java](file://crm-base/src/main/java/com/crm/base/config/MybatisPlusConfig.java)
- [CrmSqlInjector.java](file://crm-base/src/main/java/com/crm/base/config/CrmSqlInjector.java)
- [InsertBatchOnDuplicateKeyUpdate.java](file://crm-base/src/main/java/com/crm/base/config/InsertBatchOnDuplicateKeyUpdate.java)
## 架构总览
下图展示核心实体之间的关系与职责边界，包括用户、角色、菜单、部门、身份与文件的关联。
```mermaid
erDiagram
AUTH_USER {
bigint id PK
string username UK
string nickname
string email
string phone
int status
bigint create_by
bigint update_by
datetime create_time
datetime update_time
}
SYS_ROLE {
bigint id PK
string role_code UK
string role_name
int sort
int status
bigint create_by
bigint update_by
datetime create_time
datetime update_time
}
SYS_MENU {
bigint id PK
string menu_code UK
string menu_name
int type
string path
string component
int sort
int status
bigint parent_id
bigint create_by
bigint update_by
datetime create_time
datetime update_time
}
SYS_DEPT {
bigint id PK
string dept_code UK
string dept_name
int sort
int status
bigint parent_id
bigint create_by
bigint update_by
datetime create_time
datetime update_time
}
AUTH_IDENTITY {
bigint id PK
string identity_type
string identity_value
bigint user_id FK
string provider
string open_id
string union_id
int status
bigint create_by
bigint update_by
datetime create_time
datetime update_time
}
FILE_INFO {
bigint id PK
string bucket
string object_key
string file_name
long file_size
string mime_type
string md5
int status
bigint create_by
bigint update_by
datetime create_time
datetime update_time
}
SYS_USER_ROLE {
bigint id PK
bigint user_id FK
bigint role_id FK
unique uk_user_role
}
SYS_ROLE_MENU {
bigint id PK
bigint role_id FK
bigint menu_id FK
unique uk_role_menu
}
SYS_USER_DEPT {
bigint id PK
bigint user_id FK
bigint dept_id FK
unique uk_user_dept
}
AUTH_USER ||--o{ AUTH_IDENTITY : "拥有"
AUTH_USER ||--o{ SYS_USER_ROLE : "属于"
SYS_ROLE ||--o{ SYS_USER_ROLE : "分配给"
SYS_ROLE ||--o{ SYS_ROLE_MENU : "包含"
SYS_MENU ||--o{ SYS_ROLE_MENU : "被包含"
AUTH_USER ||--o{ SYS_USER_DEPT : "归属"
SYS_DEPT ||--o{ SYS_USER_DEPT : "包含"
```
**图表来源**
- [AuthUser.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthUser.java)
- [SysRole.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysRole.java)
- [SysMenu.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysMenu.java)
- [SysDept.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysDept.java)
- [AuthIdentity.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthIdentity.java)
- [FileInfo.java](file://crm-file/src/main/java/com/crm/file/domain/entity/FileInfo.java)
- [SysUserRole.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysUserRole.java)
- [SysRoleMenu.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysRoleMenu.java)
- [SysUserDept.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysUserDept.java)
## 详细组件分析
### 用户实体（AuthUser）
- 字段与类型
- 主键：id（bigint，雪花ID）
- 用户名：username（varchar，唯一）
- 昵称：nickname（varchar）
- 邮箱：email（varchar，可选唯一）
- 手机：phone（varchar，可选唯一）
- 状态：status（int，参考 StatusEnum）
- 审计字段：create_by、update_by、create_time、update_time（继承自 BaseEntity）
- 约束与索引
- 主键：id
- 唯一索引：username
- 可选唯一索引：email、phone（按业务需要开启）
- 业务含义
- 系统登录与鉴权的核心主体，支持第三方身份绑定（通过 AuthIdentity）
- 默认值与填充
- 审计字段由 MetaObjectFillHandler 自动填充
- 主键由 CustomIdGenerator + SnowflakeIdWorker 生成
**章节来源**
- [AuthUser.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthUser.java)
- [BaseEntity.java](file://crm-base/src/main/java/com/crm/base/domain/entity/BaseEntity.java)
- [MetaObjectFillHandler.java](file://crm-base/src/main/java/com/crm/base/config/MetaObjectFillHandler.java)
- [CustomIdGenerator.java](file://crm-base/src/main/java/com/crm/base/config/CustomIdGenerator.java)
- [SnowflakeIdWorker.java](file://crm-base/src/main/java/com/crm/base/config/SnowflakeIdWorker.java)
### 角色实体（SysRole）
- 字段与类型
- 主键：id（bigint，雪花ID）
- 角色编码：role_code（varchar，唯一）
- 角色名称：role_name（varchar）
- 排序：sort（int）
- 状态：status（int，参考 StatusEnum）
- 审计字段：create_by、update_by、create_time、update_time
- 约束与索引
- 主键：id
- 唯一索引：role_code
- 业务含义
- 权限集合的载体，与菜单进行多对多关联
**章节来源**
- [SysRole.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysRole.java)
### 菜单实体（SysMenu）
- 字段与类型
- 主键：id（bigint，雪花ID）
- 菜单编码：menu_code（varchar，唯一）
- 菜单名称：menu_name（varchar）
- 类型：type（int，参考 MenuTypeEnum）
- 路径：path（varchar）
- 组件：component（varchar）
- 排序：sort（int）
- 状态：status（int，参考 StatusEnum）
- 父级：parent_id（bigint，自引用树形结构）
- 审计字段：create_by、update_by、create_time、update_time
- 约束与索引
- 主键：id
- 唯一索引：menu_code
- 建议索引：parent_id（树形查询优化）
- 业务含义
- 前端路由与按钮权限的控制点，支持多级菜单
**章节来源**
- [SysMenu.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysMenu.java)
- [MenuTypeEnum.java](file://crm-auth/src/main/java/com/crm/auth/domain/enums/MenuTypeEnum.java)
### 部门实体（SysDept）
- 字段与类型
- 主键：id（bigint，雪花ID）
- 部门编码：dept_code（varchar，唯一）
- 部门名称：dept_name（varchar）
- 排序：sort（int）
- 状态：status（int，参考 StatusEnum）
- 父级：parent_id（bigint，自引用树形结构）
- 审计字段：create_by、update_by、create_time、update_time
- 约束与索引
- 主键：id
- 唯一索引：dept_code
- 建议索引：parent_id（树形查询优化）
- 业务含义
- 组织架构维度，用于数据范围与资源归属
**章节来源**
- [SysDept.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysDept.java)
### 用户-角色-菜单-部门关联表
- SysUserRole（用户-角色）
- 主键：id（bigint）
- 外键：user_id（AUTH_USER.id）、role_id（SYS_ROLE.id）
- 唯一约束：(user_id, role_id)
- SysRoleMenu（角色-菜单）
- 主键：id（bigint）
- 外键：role_id（SYS_ROLE.id）、menu_id（SYS_MENU.id）
- 唯一约束：(role_id, menu_id)
- SysUserDept（用户-部门）
- 主键：id（bigint）
- 外键：user_id（AUTH_USER.id）、dept_id（SYS_DEPT.id）
- 唯一约束：(user_id, dept_id)
**章节来源**
- [SysUserRole.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysUserRole.java)
- [SysRoleMenu.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysRoleMenu.java)
- [SysUserDept.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysUserDept.java)
### 身份认证（AuthIdentity）
- 字段与类型
- 主键：id（bigint）
- 身份类型：identity_type（int，参考 IdentityTypeEnum）
- 身份值：identity_value（varchar，唯一或组合唯一）
- 用户：user_id（AUTH_USER.id）
- 提供方：provider（varchar，如钉钉、企业微信等）
- 开放ID：open_id、union_id（varchar）
- 状态：status（int，参考 StatusEnum）
- 审计字段：create_by、update_by、create_time、update_time
- 约束与索引
- 主键：id
- 唯一索引：identity_value（或按 provider+open_id 组合唯一）
- 建议索引：user_id、provider
- 业务含义
- 统一第三方登录与账号绑定，支持多身份聚合到同一用户
**章节来源**
- [AuthIdentity.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthIdentity.java)
- [IdentityTypeEnum.java](file://crm-auth/src/main/java/com/crm/auth/domain/enums/IdentityTypeEnum.java)
### 文件元数据（FileInfo）
- 字段与类型
- 主键：id（bigint）
- 存储桶：bucket（varchar）
- 对象键：object_key（varchar，唯一）
- 文件名：file_name（varchar）
- 大小：file_size（bigint）
- MIME类型：mime_type（varchar）
- 哈希：md5（varchar）
- 状态：status（int，参考 StatusEnum）
- 审计字段：create_by、update_by、create_time、update_time
- 约束与索引
- 主键：id
- 唯一索引：object_key
- 建议索引：md5（去重校验）、status（过滤查询）
- 业务含义
- 记录文件在对象存储中的元数据，支撑上传、下载、预览与生命周期管理
**章节来源**
- [FileInfo.java](file://crm-file/src/main/java/com/crm/file/domain/entity/FileInfo.java)
### 类图（实体与基类关系）
```mermaid
classDiagram
class BaseEntity {
+long createBy
+long updateBy
+datetime createTime
+datetime updateTime
}
class OwnedEntity {
+long ownerDeptId
+long ownerUserId
}
class AuthUser {
+long id
+string username
+string nickname
+string email
+string phone
+int status
}
class SysRole {
+long id
+string roleCode
+string roleName
+int sort
+int status
}
class SysMenu {
+long id
+string menuCode
+string menuName
+int type
+string path
+string component
+int sort
+int status
+long parentId
}
class SysDept {
+long id
+string deptCode
+string deptName
+int sort
+int status
+long parentId
}
class AuthIdentity {
+long id
+string identityType
+string identityValue
+long userId
+string provider
+string openId
+string unionId
+int status
}
class FileInfo {
+long id
+string bucket
+string objectKey
+string fileName
+long fileSize
+string mimeType
+string md5
+int status
}
class SysUserRole {
+long id
+long userId
+long roleId
}
class SysRoleMenu {
+long id
+long roleId
+long menuId
}
class SysUserDept {
+long id
+long userId
+long deptId
}
BaseEntity <|-- OwnedEntity
OwnedEntity <|-- AuthUser
OwnedEntity <|-- SysRole
OwnedEntity <|-- SysMenu
OwnedEntity <|-- SysDept
OwnedEntity <|-- AuthIdentity
OwnedEntity <|-- FileInfo
```
**图表来源**
- [BaseEntity.java](file://crm-base/src/main/java/com/crm/base/domain/entity/BaseEntity.java)
- [OwnedEntity.java](file://crm-base/src/main/java/com/crm/base/domain/entity/OwnedEntity.java)
- [AuthUser.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthUser.java)
- [SysRole.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysRole.java)
- [SysMenu.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysMenu.java)
- [SysDept.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysDept.java)
- [AuthIdentity.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthIdentity.java)
- [FileInfo.java](file://crm-file/src/main/java/com/crm/file/domain/entity/FileInfo.java)
- [SysUserRole.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysUserRole.java)
- [SysRoleMenu.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysRoleMenu.java)
- [SysUserDept.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysUserDept.java)
## 依赖关系分析
- 主键策略
- 所有实体主键使用雪花ID，避免集中式ID冲突，提升写入性能
- CustomIdGenerator 集成 MyBatis-Plus，自动注入雪花ID
- 外键与关联
- 通过中间表实现多对多（用户-角色、角色-菜单、用户-部门）
- 自引用树形结构（菜单、部门）通过 parent_id 维护层级
- 索引设计
- 唯一索引保证业务唯一性（用户名、角色编码、菜单编码、部门编码、对象键）
- 建议为高频查询字段建立普通索引（如 status、parent_id、user_id、md5）
- 数据完整性
- 逻辑删除由 CrmSqlInjector 启用，避免物理删除导致关联断裂
- 审计字段由 MetaObjectFillHandler 统一填充，确保一致性
```mermaid
graph LR
AuthUser -- "1:N" --> AuthIdentity
AuthUser -- "N:M" --> SysRole
SysRole -- "N:M" --> SysMenu
AuthUser -- "N:M" --> SysDept
SysMenu -- "自引用" --> SysMenu
SysDept -- "自引用" --> SysDept
FileInfo -- "独立" --> "*"
```
**图表来源**
- [AuthUser.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthUser.java)
- [SysRole.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysRole.java)
- [SysMenu.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysMenu.java)
- [SysDept.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysDept.java)
- [AuthIdentity.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthIdentity.java)
- [FileInfo.java](file://crm-file/src/main/java/com/crm/file/domain/entity/FileInfo.java)
**章节来源**
- [CustomIdGenerator.java](file://crm-base/src/main/java/com/crm/base/config/CustomIdGenerator.java)
- [SnowflakeIdWorker.java](file://crm-base/src/main/java/com/crm/base/config/SnowflakeIdWorker.java)
- [CrmSqlInjector.java](file://crm-base/src/main/java/com/crm/base/config/CrmSqlInjector.java)
- [MetaObjectFillHandler.java](file://crm-base/src/main/java/com/crm/base/config/MetaObjectFillHandler.java)
## 性能考虑
- 主键选择雪花ID，减少热点与锁竞争，适合高并发写入
- 树形结构（菜单、部门）建议缓存根节点与常用分支，降低递归查询开销
- 大文件元数据（FileInfo）建议按状态分区或归档，保持热数据表轻量
- 批量操作使用 InsertBatchOnDuplicateKeyUpdate 减少往返次数
- 合理索引：唯一索引优先，普通索引按需添加，避免过度索引影响写入
[本节为通用指导，不直接分析具体文件]
## 故障排查指南
- ID重复或生成失败
- 检查 SnowflakeIdWorker 时钟回拨与节点ID配置
- 确认 CustomIdGenerator 已正确注册到 MyBatis-Plus
- 审计字段未填充
- 检查 MetaObjectFillHandler 是否生效，字段命名是否符合约定
- 确认 BaseEntity/OwenedEntity 的字段映射正确
- 逻辑删除失效
- 检查 CrmSqlInjector 是否启用，@TableLogic 注解是否正确
- 唯一约束冲突
- 核对业务唯一字段（username、role_code、menu_code、dept_code、object_key）的输入校验
**章节来源**
- [SnowflakeIdWorker.java](file://crm-base/src/main/java/com/crm/base/config/SnowflakeIdWorker.java)
- [CustomIdGenerator.java](file://crm-base/src/main/java/com/crm/base/config/CustomIdGenerator.java)
- [MetaObjectFillHandler.java](file://crm-base/src/main/java/com/crm/base/config/MetaObjectFillHandler.java)
- [CrmSqlInjector.java](file://crm-base/src/main/java/com/crm/base/config/CrmSqlInjector.java)
## 结论
本数据模型以雪花ID为主键，结合 MyBatis-Plus 的自动填充与SQL增强，实现了统一的审计、逻辑删除与批量操作能力。用户、角色、菜单、部门、身份与文件等核心实体通过明确的关联表与索引设计，满足权限控制、组织架构与文件管理的业务需求。建议在后续演进中持续完善索引与缓存策略，保障性能与可维护性。
[本节为总结性内容，不直接分析具体文件]
## 附录
### 数据字典（核心实体）
- 用户（AuthUser）
- id：主键，雪花ID
- username：用户名，唯一
- nickname：昵称
- email：邮箱，可选唯一
- phone：手机，可选唯一
- status：状态（参考 StatusEnum）
- 审计字段：create_by、update_by、create_time、update_time
- 角色（SysRole）
- id：主键，雪花ID
- role_code：角色编码，唯一
- role_name：角色名称
- sort：排序
- status：状态（参考 StatusEnum）
- 审计字段：同上
- 菜单（SysMenu）
- id：主键，雪花ID
- menu_code：菜单编码，唯一
- menu_name：菜单名称
- type：类型（参考 MenuTypeEnum）
- path：路由路径
- component：前端组件
- sort：排序
- status：状态（参考 StatusEnum）
- parent_id：父级ID
- 审计字段：同上
- 部门（SysDept）
- id：主键，雪花ID
- dept_code：部门编码，唯一
- dept_name：部门名称
- sort：排序
- status：状态（参考 StatusEnum）
- parent_id：父级ID
- 审计字段：同上
- 身份（AuthIdentity）
- id：主键，雪花ID
- identity_type：身份类型（参考 IdentityTypeEnum）
- identity_value：身份值，唯一或组合唯一
- user_id：用户ID
- provider：提供方
- open_id、union_id：第三方标识
- status：状态（参考 StatusEnum）
- 审计字段：同上
- 文件（FileInfo）
- id：主键，雪花ID
- bucket：存储桶
- object_key：对象键，唯一
- file_name：文件名
- file_size：文件大小
- mime_type：MIME类型
- md5：文件哈希
- status：状态（参考 StatusEnum）
- 审计字段：同上
**章节来源**
- [AuthUser.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthUser.java)
- [SysRole.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysRole.java)
- [SysMenu.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysMenu.java)
- [SysDept.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/SysDept.java)
- [AuthIdentity.java](file://crm-auth/src/main/java/com/crm/auth/domain/entity/AuthIdentity.java)
- [FileInfo.java](file://crm-file/src/main/java/com/crm/file/domain/entity/FileInfo.java)
### 枚举值定义
- StatusEnum：通用状态（如启用/禁用）
- HasValueEnum：通用布尔值（是/否）
- MenuTypeEnum：菜单类型（如目录、菜单、按钮）
- IdentityTypeEnum：身份类型（如手机号、邮箱、第三方账号）
**章节来源**
- [StatusEnum.java](file://crm-base/src/main/java/com/crm/base/domain/enums/StatusEnum.java)
- [HasValueEnum.java](file://crm-base/src/main/java/com/crm/base/domain/enums/HasValueEnum.java)
- [MenuTypeEnum.java](file://crm-auth/src/main/java/com/crm/auth/domain/enums/MenuTypeEnum.java)
- [IdentityTypeEnum.java](file://crm-auth/src/main/java/com/crm/auth/domain/enums/IdentityTypeEnum.java)
### 默认值与填充策略
- 主键：雪花ID（CustomIdGenerator + SnowflakeIdWorker）
- 审计字段：create_by、update_by、create_time、update_time（MetaObjectFillHandler）
- 逻辑删除：enabled（CrmSqlInjector）
- 批量插入去重：InsertBatchOnDuplicateKeyUpdate
**章节来源**
- [CustomIdGenerator.java](file://crm-base/src/main/java/com/crm/base/config/CustomIdGenerator.java)
- [SnowflakeIdWorker.java](file://crm-base/src/main/java/com/crm/base/config/SnowflakeIdWorker.java)
- [MetaObjectFillHandler.java](file://crm-base/src/main/java/com/crm/base/config/MetaObjectFillHandler.java)
- [CrmSqlInjector.java](file://crm-base/src/main/java/com/crm/base/config/CrmSqlInjector.java)
- [InsertBatchOnDuplicateKeyUpdate.java](file://crm-base/src/main/java/com/crm/base/config/InsertBatchOnDuplicateKeyUpdate.java)
### 数据迁移策略与版本兼容性
- 使用数据库迁移工具（如 Flyway/Liquibase）管理DDL变更，确保环境一致性
- 新增字段时提供默认值与向后兼容的查询逻辑
- 修改唯一约束前评估历史数据，必要时先清洗再变更
- 灰度发布：先在测试环境验证，再逐步上线生产
[本节为通用指导，不直接分析具体文件]
### 备份恢复方案
- 定期全量备份（每日）与增量备份（每小时）
- 关键表（用户、角色、菜单、部门、文件元数据）提高备份频率
- 恢复演练：定期执行恢复演练，验证备份有效性
- 灾难恢复：制定RTO/RPO目标，明确恢复流程与责任人
[本节为通用指导，不直接分析具体文件]