Skip to content

领域模型 ​

分两段:A 平台域——已落地的 9 类核心实体、48 张表中的关键关系;B PM 域——规划中的 6 个实体,字段是草案,用来指导建表与代码生成,不代表已经实现。

下文 DO 路径统一省略前缀 pmforge-module-system/src/main/java/com/pmforge/module/system/。

A. 平台域(✅ 已实现) ​

A.1 核心实体 ​

实体表DO(相对前缀)关键字段多租户
租户system_tenantdal/dataobject/tenant/TenantDOname、contactUserId、status、packageId、expireTime、accountCount全局
租户套餐system_tenant_packagedal/dataobject/tenant/TenantPackageDOname、status、menuIds全局
用户system_usersdal/dataobject/user/AdminUserDOusername、password、nickname、deptId、postIds、email、mobile、status是
角色system_roledal/dataobject/permission/RoleDOname、code、type、dataScope、dataScopeDeptIds是
菜单system_menudal/dataobject/permission/MenuDOname、permission、type、parentId、path、component、visible全局
部门system_deptdal/dataobject/dept/DeptDOname、parentId、leaderUserId、status是
岗位system_postdal/dataobject/dept/PostDOname、code、sort、status全局
字典类型system_dict_typedal/dataobject/dict/DictTypeDOname、type、status全局
字典数据system_dict_datadal/dataobject/dict/DictDataDOlabel、value、dictType、sort、colorType全局
站内信system_notify_messagedal/dataobject/notify/NotifyMessageDOuserId、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_message

A.3 约束与实现要点 ​

关系实现方式依据
租户隔离继承 TenantBaseDO 的表自动拼 tenant_id,其余为全局表TenantDatabaseInterceptor#L68-L81:表信息为空则忽略、继承 TenantBaseDO 则不忽略
租户 → 套餐tenant.packageId → tenant_package.menuIds,开通时把菜单写入角色TenantServiceImpl#L136-L138
用户 → 部门users.deptId,部门是树AdminUserDO 字段、DeptDO#parentId
角色 → 菜单role_menu 多对多;权限点写在 menu.permissionPermissionServiceImpl#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 项目

字段类型说明
idbigint主键
tenantIdbigint租户,来自 TenantBaseDO
codevarchar(32)项目编号,租户内唯一
namevarchar(128)项目名称
statusvarchar(32)字典 pm_project_status(立项/进行/暂停/结项)
deptIdbigint归属部门,决定数据权限与可见范围
ownerUserIdbigint项目经理,指向 system_users.id
planStart / planEnddate计划起止
descriptionvarchar(1024)目标与范围

Sprint 迭代

字段类型说明
id / projectIdbigint归属项目
namevarchar(64)迭代名称,如 Sprint 12
goalvarchar(512)迭代目标
startDate / endDatedate周期
statusvarchar(32)规划中 / 进行中 / 已完成

Milestone 里程碑

字段类型说明
id / projectIdbigint归属项目
namevarchar(128)节点名称
dueDatedate计划达成日
actualDatedate实际达成日,可空
ownerUserIdbigint责任人
statusvarchar(32)未达 / 达成 / 延期

Task 任务

字段类型说明
id / projectIdbigint归属项目
sprintIdbigint可空,挂在迭代下
parentIdbigint支持层级(0 为顶层)
title / descriptionvarchar标题、描述
assigneeUserIdbigint指派给谁
statusvarchar(32)待办 / 进行中 / 已完成 / 已阻塞
priorityvarchar(16)P0~P3,走字典
planHours / dueDatedecimal / date计划工时、截止日

Timesheet 工时

字段类型说明
id / projectId / taskIdbigint归属
userIdbigint填报人
workDatedate工作日期
hoursdecimal(6,2)工时,按天上限校验
descriptionvarchar(512)工作内容
statusvarchar(32)草稿 / 已提交 / 已通过 / 已驳回
approverUserIdbigint审批人,可空

Risk 风险与问题

字段类型说明
id / projectIdbigint归属项目
typevarchar(16)风险(未发生)/ 问题(已发生)
title / descriptionvarchar标题、描述
probability / impactvarchar(16)概率、影响,走字典
levelvarchar(16)等级,可由概率×影响推导
ownerUserIdbigint责任人
statusvarchar(32)已登记 / 跟踪中 / 已关闭

B.2 关系图 ​

text
                 ┌────────────┐
                 │   Project  │
                 └─────┬──────┘
        ┌──────────────┼───────────────┬──────────────┐
        ▼              ▼               ▼              ▼
   ┌─────────┐   ┌───────────┐   ┌──────────┐   ┌──────────┐
   │ Sprint  │   │ Milestone │   │   Task   │   │   Risk   │
   └────┬────┘   └───────────┘   └────┬─────┘   └──────────┘
        │                             │  ▲ parentId
        └────────────► Task ◄─────────┘  └──(自关联)
                          │
                          ▼
                    ┌───────────┐
                    │ Timesheet │──► 审批(status 流转)
                    └───────────┘

B.3 与平台域的挂接点 ​

平台能力现有落点PM 域怎么挂状态
组织system_dept、DeptDO项目挂部门,成员可见范围复用部门树✅
用户system_users、AdminUserDOownerUserId / 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。