主题
领域模型
分两段:A 平台域——已落地的 9 类核心实体、48 张表中的关键关系;B PM 域——规划中的 6 个实体,字段是草案,用来指导建表与代码生成,不代表已经实现。
下文 DO 路径统一省略前缀
pmforge-module-system/src/main/java/com/pmforge/module/system/。
A. 平台域(✅ 已实现)
A.1 核心实体
| 实体 | 表 | DO(相对前缀) | 关键字段 | 多租户 |
|---|---|---|---|---|
| 租户 | system_tenant | dal/dataobject/tenant/TenantDO | name、contactUserId、status、packageId、expireTime、accountCount | 全局 |
| 租户套餐 | system_tenant_package | dal/dataobject/tenant/TenantPackageDO | name、status、menuIds | 全局 |
| 用户 | system_users | dal/dataobject/user/AdminUserDO | username、password、nickname、deptId、postIds、email、mobile、status | 是 |
| 角色 | system_role | dal/dataobject/permission/RoleDO | name、code、type、dataScope、dataScopeDeptIds | 是 |
| 菜单 | system_menu | dal/dataobject/permission/MenuDO | name、permission、type、parentId、path、component、visible | 全局 |
| 部门 | system_dept | dal/dataobject/dept/DeptDO | name、parentId、leaderUserId、status | 是 |
| 岗位 | system_post | dal/dataobject/dept/PostDO | name、code、sort、status | 全局 |
| 字典类型 | system_dict_type | dal/dataobject/dict/DictTypeDO | name、type、status | 全局 |
| 字典数据 | system_dict_data | dal/dataobject/dict/DictDataDO | label、value、dictType、sort、colorType | 全局 |
| 站内信 | system_notify_message | dal/dataobject/notify/NotifyMessageDO | userId、userType、templateCode、templateContent、templateParams、readStatus | 全局 |
关系表三张:system_user_role(用户-角色)、system_role_menu(角色-菜单)、system_user_post(用户-岗位)。它们是纯关联表,没有独立业务语义。
A.2 关系图
text
system_tenant_package
▲ packageId
│
system_tenant (1) ──────► system_users (N) ──< system_user_role >── (N) system_role
│ deptId │
│ │
▼ ▼
system_dept (树) system_role_menu
│
system_users ──< system_user_post >── system_post
▼
system_menu (树)
permission 权限点
system_dict_type (1) ──< system_dict_data (N) system_users ──< system_notify_messageA.3 约束与实现要点
| 关系 | 实现方式 | 依据 |
|---|---|---|
| 租户隔离 | 继承 TenantBaseDO 的表自动拼 tenant_id,其余为全局表 | TenantDatabaseInterceptor#L68-L81:表信息为空则忽略、继承 TenantBaseDO 则不忽略 |
| 租户 → 套餐 | tenant.packageId → tenant_package.menuIds,开通时把菜单写入角色 | TenantServiceImpl#L136-L138 |
| 用户 → 部门 | users.deptId,部门是树 | AdminUserDO 字段、DeptDO#parentId |
| 角色 → 菜单 | role_menu 多对多;权限点写在 menu.permission | PermissionServiceImpl#L93-L106 |
| 字典 | dict_data.dictType 按字符串关联 dict_type.type | 两个 DO 的字段定义 |
| 站内信 → 模板 | notify_message.templateCode 关联模板 code,参数以 Map 持久化 | NotifyMessageDO 字段 |
| 数据权限 | role.dataScope + dataScopeDeptIds,查询时拼部门条件 | RoleDO、PermissionServiceImpl#L271 |
一个容易看错的点:system_menu 是全局表,租户能看哪些菜单不靠给菜单加 tenant_id,而是靠角色-菜单绑定 + 套餐裁剪。所以「改菜单」会影响所有租户的展示,「改套餐」才会改变租户可见范围。
B. PM 域(🚧 规划,字段为草案)
表名与 DO 命名为草案,落地时应遵循项目既有约定:DO 继承 TenantBaseDO、Mapper 继承 BaseMapperX、错误码向 ServiceErrorCodeRange 申请号段。
B.1 六个实体
Project 项目
| 字段 | 类型 | 说明 |
|---|---|---|
| id | bigint | 主键 |
| tenantId | bigint | 租户,来自 TenantBaseDO |
| code | varchar(32) | 项目编号,租户内唯一 |
| name | varchar(128) | 项目名称 |
| status | varchar(32) | 字典 pm_project_status(立项/进行/暂停/结项) |
| deptId | bigint | 归属部门,决定数据权限与可见范围 |
| ownerUserId | bigint | 项目经理,指向 system_users.id |
| planStart / planEnd | date | 计划起止 |
| description | varchar(1024) | 目标与范围 |
Sprint 迭代
| 字段 | 类型 | 说明 |
|---|---|---|
| id / projectId | bigint | 归属项目 |
| name | varchar(64) | 迭代名称,如 Sprint 12 |
| goal | varchar(512) | 迭代目标 |
| startDate / endDate | date | 周期 |
| status | varchar(32) | 规划中 / 进行中 / 已完成 |
Milestone 里程碑
| 字段 | 类型 | 说明 |
|---|---|---|
| id / projectId | bigint | 归属项目 |
| name | varchar(128) | 节点名称 |
| dueDate | date | 计划达成日 |
| actualDate | date | 实际达成日,可空 |
| ownerUserId | bigint | 责任人 |
| status | varchar(32) | 未达 / 达成 / 延期 |
Task 任务
| 字段 | 类型 | 说明 |
|---|---|---|
| id / projectId | bigint | 归属项目 |
| sprintId | bigint | 可空,挂在迭代下 |
| parentId | bigint | 支持层级(0 为顶层) |
| title / description | varchar | 标题、描述 |
| assigneeUserId | bigint | 指派给谁 |
| status | varchar(32) | 待办 / 进行中 / 已完成 / 已阻塞 |
| priority | varchar(16) | P0~P3,走字典 |
| planHours / dueDate | decimal / date | 计划工时、截止日 |
Timesheet 工时
| 字段 | 类型 | 说明 |
|---|---|---|
| id / projectId / taskId | bigint | 归属 |
| userId | bigint | 填报人 |
| workDate | date | 工作日期 |
| hours | decimal(6,2) | 工时,按天上限校验 |
| description | varchar(512) | 工作内容 |
| status | varchar(32) | 草稿 / 已提交 / 已通过 / 已驳回 |
| approverUserId | bigint | 审批人,可空 |
Risk 风险与问题
| 字段 | 类型 | 说明 |
|---|---|---|
| id / projectId | bigint | 归属项目 |
| type | varchar(16) | 风险(未发生)/ 问题(已发生) |
| title / description | varchar | 标题、描述 |
| probability / impact | varchar(16) | 概率、影响,走字典 |
| level | varchar(16) | 等级,可由概率×影响推导 |
| ownerUserId | bigint | 责任人 |
| status | varchar(32) | 已登记 / 跟踪中 / 已关闭 |
B.2 关系图
text
┌────────────┐
│ Project │
└─────┬──────┘
┌──────────────┼───────────────┬──────────────┐
▼ ▼ ▼ ▼
┌─────────┐ ┌───────────┐ ┌──────────┐ ┌──────────┐
│ Sprint │ │ Milestone │ │ Task │ │ Risk │
└────┬────┘ └───────────┘ └────┬─────┘ └──────────┘
│ │ ▲ parentId
└────────────► Task ◄─────────┘ └──(自关联)
│
▼
┌───────────┐
│ Timesheet │──► 审批(status 流转)
└───────────┘B.3 与平台域的挂接点
| 平台能力 | 现有落点 | PM 域怎么挂 | 状态 |
|---|---|---|---|
| 组织 | system_dept、DeptDO | 项目挂部门,成员可见范围复用部门树 | ✅ |
| 用户 | system_users、AdminUserDO | ownerUserId / assigneeUserId / userId 全部指向用户 ID | ✅ |
| 角色与权限 | system_role、system_menu.permission | 新增 pm:project:create、pm:task:assign 等权限点,挂到菜单的按钮上 | ✅ |
| 数据权限 | role.dataScope + starter-biz-data-permission | 项目查询按「本部门/本部门及下级」过滤,方法上加 @DataPermission | ✅ |
| 字典 | system_dict_data | 项目状态、任务优先级、风险等级走字典,不写死枚举 | ✅ |
| 文件 | infra_file、INF-FILE-01 | 交付物、验收单存 url 或 fileId 字段 | ✅ |
| 通知 | notify_message、邮件/短信模板 | 任务指派、工时待审、风险升级按模板 code 推送 | ✅ |
| 定时任务 | infra_job、INF-JOB-01 | 每日扫描逾期任务与未填工时 | ⏸ 本地默认禁用 |
| 代码生成 | infra_codegen_table、INF-CODEGEN-01 | 六张表先用生成器出骨架,再补状态机与审批 | ✅ |
落地约定:六张表先用 INF-CODEGEN-01 出骨架;DO 继承
TenantBaseDO,不要自加tenant_id;状态走字典、流转规则在 Service 校验;权限点与错误码段先申请编号(/reference/错误码段);BPM ⏸,工时审批 v1 用「状态 + 权限点」,不引入 Flowable。