From 3a13c50a015b414029d7cc1229bd28ef185b9952 Mon Sep 17 00:00:00 2001
From: zhengwr
Date: Thu, 11 Jun 2026 15:41:57 +0800
Subject: [PATCH] =?UTF-8?q?P4=E5=89=8D=E7=BD=AE:=20=E9=97=AD=E7=8E=AF=20fl?=
=?UTF-8?q?owable-service=20projectRoleType=20=E5=80=99=E9=80=89=E4=BA=BA?=
=?UTF-8?q?=E8=A7=A3=E6=9E=90=20+=20=E9=95=BF=E5=B0=BE=E6=94=B6=E6=95=9B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
侦察老系统语义(以代码为准):projectRoleType 在 com.dsasp.server.wf
CandidateUsersHandler 单独分派(非 organize 的 AssignmentHandlerImpl),
调客户私有 ProjectRoleUser.getUserByProjectRole(projectId, "八大员位枚举");
framework 无该实现(项目定制 OSGi 扩展点)。解析链经客户库数据模型反推 +
真实流程任务实证锁定:content 位序(1-based)即 pm_project_user.role。
实现:
- OrgDirectoryJdbc.getUsersByProjectRole 去 WARN 降级,参数化直查
pm_project_user(pm_projectid + role IN(true 位序) + isactive=1),
保留 ProjectRoleResolver 钩子作客户私有覆盖位;
- 顺带闭环长尾: initiatorDepartManager(view_sys_user.masterdepart 子查询
→sys_depart.leader)、fixedDimension(view_sys_dimensiondepart 维度树
向上回溯)、sameToTask(historyService 取前序 userTask assignee);
- CandidateController 加 GET /project-role 对账端点。
验证(8089 起本地 eip4flow + 客户库只读):5 个真实 projectRoleType 任务
REST==手工 SQL(含数据漂移空例);initiatorDepartManager/fixedDimension
真实数据对账一致;P3 position/user 回归不破;新增 7 单测(原 26→33),
全反应堆 mvn test + ArchUnit 绿。
缺口:降级类型 5 类→1 类(仅 scriptUser 26 处),覆盖率 91%→99.46%。
scriptUser 需活的 ExecutionEntity + 反序列化变量,超独立服务边界,留方案。
Co-Authored-By: Claude Fable 5
---
docs/迁移手册.md | 20 +-
.../P4前置-projectRoleType闭环报告.md | 241 ++++++++++++++++++
.../user/assignee/CandidateUsersHandler.java | 72 +++++-
.../flowservice/api/CandidateController.java | 6 +
.../flowservice/org/OrgDirectoryJdbc.java | 185 +++++++++++++-
.../server/wf/CandidateUsersHandlerTest.java | 31 +++
.../flowservice/org/OrgDirectoryJdbcTest.java | 67 ++++-
7 files changed, 597 insertions(+), 25 deletions(-)
create mode 100644 flowable-service/P4前置-projectRoleType闭环报告.md
diff --git a/docs/迁移手册.md b/docs/迁移手册.md
index 61f803f..512da49 100644
--- a/docs/迁移手册.md
+++ b/docs/迁移手册.md
@@ -511,9 +511,27 @@ com.dsasp.* com.eip4.*
| **现象** | §6.3 原写「将 3 个 handler 移植到 `platform-flow-gateway`」;但架构第三节裁定交付为 4 进程,`flowable-service.jar` 是独立进程、引擎在独立服务,`platform-flow-gateway` 只做客户端。handler 须随引擎落在 **`flowable-service`** 模块,非 gateway |
| **根因** | 候选人表达式由 Flowable 引擎在 `cfg.setBeans` 注册的 bean 上求值,bean 必须与引擎同进程;gateway 是 REST 客户端、无引擎,注册无意义 |
| **对策** | handler 按原包名移植进 `flowable-service`(`com.dsasp.server.wf.*`),bean 名不变经 `cfg.setBeans` 注册。**关键裁剪**:原版 handler 经 `SpringBeanOsgiServices` 取 `AssignmentHandler`/`UserFindService`/`OrganizationService`,传递闭包是整个保真层元数据/CRUD 引擎(`POJOCRUDService`/`GeneralPOJO`);独立服务**不拖入该闭包**,改为 `OrgDirectory` 窄接口 + `OrgDirectoryJdbc` 直查业务组织库 SQL(逐条对齐 framework `AssignmentHandlerImpl`/`UserFindServiceImpl`/`OrganizationServiceImpl`)。OSGi 取 bean → `WfBeanRegistry`(§3.1/§5.17 替换类策略)。详见 `flowable-service/P3流程服务实测报告.md` 第二节 |
-| **覆盖面** | 实测配置类型分布 position 1949/user 1683/formSpecifiedDimension 601/depart 14/initiator 3 等占主导(~91%)已直查覆盖;scriptUser(JUEL 脚本)/initiatorDepartManager·fixedDimension(依赖 SYS_USER.MASTERDEPART 元数据虚拟列,客户库无物理列)/sameToTask(前序活动栈)/projectRoleType(项目定制扩展)依赖保真层或定制,WARN 降级,P3-4 聚合或保真层接入补齐 |
+| **覆盖面(P3 基线)** | 实测配置类型分布 position 1949/user 1683/formSpecifiedDimension 601/depart 14/initiator 3 等占主导(~91%)已直查覆盖;scriptUser(JUEL 脚本)/initiatorDepartManager·fixedDimension(依赖 SYS_USER.MASTERDEPART 元数据虚拟列,客户库无物理列)/sameToTask(前序活动栈)/projectRoleType(项目定制扩展)当时 WARN 降级 |
+| **覆盖面(P4 闭环后,2026-06-11 更新)** | 缺口表见下;**降级类型从 5 类收敛到 1 类,候选人覆盖率 91%→99.46%**,唯一剩余降级为 scriptUser(26 处,0.54%)。详见 `flowable-service/P4前置-projectRoleType闭环报告.md` |
| **影响范围** | P3 模块落点(flowable-service 而非 gateway);gateway 聚合实现是 P3-4 客户端任务 |
+#### 6.5.1 候选人配置类型缺口表(P4 前置闭环后,2026-06-11)
+
+| 类型 | 频次 | 占比 | 状态 | 解析链落点 |
+|------|-----:|-----:|------|-----------|
+| position | 1949 | 40.2% | ✅ P3 | `sys_positionuser` where positionid IN(...) |
+| user | 1683 | 34.7% | ✅ P3 | content 即 userid,直返 |
+| formSpecifiedDimension | 601 | 12.4% | ✅ P3 | 部门→岗位类别岗位→人员,部门内无则回退公司 |
+| **projectRoleType** | 528 | 10.9% | ✅ **P4 闭环** | `pm_project_user` where pm_projectid=? and role IN(八大员 true 位序) and isactive=1;位序 1-based↔role 编号;客户私有 `ProjectRoleUser` 注入时优先委托 |
+| **scriptUser** | **26** | **0.54%** | ⛔ **唯一剩余降级** | JUEL 脚本 `${var}`,需活的 ExecutionEntity + 反序列化变量(实测 serializable 15/null 14/string 7),超独立服务边界,WARN 降级;方案见 P4 报告 §5.1 |
+| **initiatorDepartManager** | 24 | 0.50% | ✅ **P4 闭环** | `getMainDepart`(MASTERDEPART 经 `view_sys_user.masterdepart` 子查询:positionuser.ismaster=1→position.parentdepartid)→ `sys_depart.leader` |
+| depart | 14 | 0.29% | ✅ P3 | 部门→岗位→人员 |
+| **fixedDimension** | 12 | 0.25% | ✅ **P4 闭环** | content=维度,岗位类别...;经 `view_sys_dimensiondepart`(parentdepartids 祖先链)本部门命中或向上回溯 |
+| **sameToTask** | 5 | 0.10% | ✅ **P4 闭环** | `historyService` 取流程实例下已结束 userTask 按结束时间倒序第一条 assignee(content 为指定活动 id),对齐 `ProcessCoreServiceImpl.getSpecialActivityProcessor` |
+| initiator | 3 | 0.06% | ✅ P3 | 发起人本人(流程变量 WFINITIATORUSERID) |
+
+> 总计 4845 处:覆盖 4819(99.46%),剩余降级 26(scriptUser,0.54%)。
+
### 6.6 Flowable 独立服务 Boot 自动装配两坑 [NEW 2026-06-11]
| 栏目 | 内容 |
diff --git a/flowable-service/P4前置-projectRoleType闭环报告.md b/flowable-service/P4前置-projectRoleType闭环报告.md
new file mode 100644
index 0000000..a88463e
--- /dev/null
+++ b/flowable-service/P4前置-projectRoleType闭环报告.md
@@ -0,0 +1,241 @@
+# P4 前置 —— projectRoleType 候选人解析闭环 实测报告
+
+> 日期:2026-06-11 | 模块:`flowable-service`(端口 8089)
+> 任务:闭环 P3 最大缺口 projectRoleType(528 处表达式,~11%),并顺带评估/闭环长尾降级类型
+> 验证场:本地 PG `localhost:5433` 库 `eip4flow` schema `eip3`(39 张 ACT_ 表,6.8.1.0 真实迁移数据,
+> 1,509 定义);业务组织库客户库副本 `192.168.20.68:5435` schema `eip3`(ceshi 只读,1,857 用户)
+> 前置:本报告承接 `P3流程服务实测报告.md`(OrgDirectoryJdbc 架构)与 `docs/迁移手册.md §6.5`(降级清单)
+
+---
+
+## 一、老系统语义侦察(以代码为准)
+
+### 1.1 projectRoleType 不在 organize 的 AssignmentHandlerImpl,而在 wf 的 CandidateUsersHandler
+
+`framework/com.dsasp.server.organize/service/AssignmentHandlerImpl.assignmentUser(...)`
+**不含** projectRoleType 分支(已逐行核对,只到 formSpecifiedDimension 为止)。projectRoleType
+是在 **`framework/com.dsasp.server.wf/user/assignee/CandidateUsersHandler.getCandidateUsers`**
+里单独分派的(与 scriptUser/sameToTask/beforeTask\* 并列,先于通用 `assignmentHandler.assignmentUser` 兜底):
+
+```java
+// CandidateUsersHandler.java(framework 原版,L127/L155-161)
+String projectId = ProcessEngines.getDefaultProcessEngine().getRuntimeService()
+ .getVariable(execution.getProcessInstanceId(), ProcessCoreService.PROJECTID);
+...
+else if (ProcessDefinitionService.PROJECTROLETYPE.equals(userProperty.getType())) {
+ ProjectRoleUser projectRoleUser =
+ (ProjectRoleUser) SpringBeanOsgiServices.getInstance().getBeanByName("projectRoleUser");
+ if (projectRoleUser != null) {
+ users = projectRoleUser.getUserByProjectRole(projectId, userProperty.getContent());
+ }
+}
+```
+
+同款分支另见 `com.dsasp.server.wf/user/listener/TaskCreateListener.java`(L245-250) 与
+`com.dsasp.server.quartz/util/JobWorkEngine.java`(L130-133)——三处一致。
+
+### 1.2 关键侦察结论:framework 无 ProjectRoleUser 实现,是客户私有化扩展点
+
+- `com.dsasp.server.common.user.service.ProjectRoleUser` 只有**接口**,全 eip3 源码树 `grep -rln "implements ProjectRoleUser"` **零命中**;
+- 也无任何 spring/OSGi xml 注册 `projectRoleUser` bean(`grep` 零命中);
+- 故 `getBeanByName("projectRoleUser")` 在基线 framework 返回 **null**(所以三处都有 `if(!=null)` 守卫)。
+- 接口 javadoc 自述:`roles "true,false,true,...",需要获取的八大员,按枚举顺序判断是否需要获取该角色人员`。
+
+**含义**:projectRoleType 的真正实现(含真实 SQL/表名)由**客户私有化插件**在部署期注入 OSGi 容器;
+本机及仓库内**不存在该实现 jar/class**(`find / | grep getUserByProjectRole` 仅命中本服务自身产物)。
+因此解析链的「真实 SQL」必须**从客户库数据模型反推 + 用真实流程任务实证**(见第二节),
+不能照抄一个不存在的源文件。
+
+### 1.3 解析链(输入变量 → SQL → 输出)
+
+| 环节 | 内容 |
+|------|------|
+| **输入 1** | 流程变量 `PROJECTID`(`ProcessCoreService.PROJECTID`,存于 `act_ru_variable`/`act_ru_execution`) |
+| **输入 2** | 配置项 `content`:八大员 true/false 位枚举串,如 `"true,false,false,false,false,false,false,false"` |
+| **位序语义** | content 第 i 位(1-based)为 `true` ⇒ 需要角色编号 i 的人员;位枚举长度随流程版本增长(实测 8/9/11 位) |
+| **SQL** | `SELECT distinct userid FROM pm_project_user WHERE pm_projectid = ? AND isactive = 1 AND role IN ()` |
+| **输出** | 该项目下这些角色的在用用户 id 列表(去 padding、去重) |
+
+> 对齐项:framework `ProjectRoleUser.getUserByProjectRole(projectId, roles)` 契约的两个入参
+> 即 `pm_projectid` 与位枚举;位序↔role 编号映射经第二节客户库实证锁定。
+
+---
+
+## 二、客户库数据模型验证(只读)
+
+连接 `192.168.20.68:5435` schema `eip3`(ceshi 只读)。
+
+### 2.1 表选型:pm_project_user 是 canonical 项目角色用户表
+
+候选表三张,实测对比后锁定 **`pm_project_user`**:
+
+| 表 | 行数 | 角色列 | role 取值分布 | 结论 |
+|------|-----:|--------|--------------|------|
+| **`pm_project_user`** | 1615 | `role`(int) | 1–8 各有 + 19/20/1000 扩展位 | ✅ **选用**,覆盖八大员全位序 + 变长扩展位 |
+| `view_projectuser` | 849 | `roleid`(int) | 仅 1/2/3/5 | ❌ 稀疏,多数项目无数据 |
+| `pm_projectuserrecord` | 151 | `roleid`(int) | — | ❌ 是变更/历史记录表,非当前态 |
+
+`pm_project_user` 列:`pm_projectid`、`userid`、`role`(int)、`isactive`(int,全为 1)。
+`pm_projectid`/`userid` 均 `bpchar(36)`:32 字符 hex id 补 4 空格至 36(与手册 §6.7/§5.32 padding 同源)。
+PG `char` 比较忽略尾随空格,故 `pm_projectid = '<32字符>'` 等值匹配成立;返回的 `userid` 需 `trim` 去 padding。
+
+### 2.2 三个(实为五个)真实含 projectRoleType 的流程任务,手工按解析链 SQL 算预期
+
+从 `act_ru_task ⋈ act_re_procdef`(定义所属 deployment 的 BPMN 含 projectRoleType)筛出 **34 个真实在办任务**,
+逐个从 BPMN(`act_ge_bytearray`)反转义出该 `task_def_key` 的 projectRoleType `content`,取实例 `PROJECTID`,
+按 §1.3 SQL 手工算预期候选人:
+
+| # | 任务 id | 任务名 | PROJECTID | content(位序→role) | 手工 SQL 预期候选人 |
+|---|--------|--------|-----------|---------------------|---------------------|
+| A | 192023 | 项目经理 | `80d698eb-…-44dc9dbd2dea` | `true,…`→role 1 | `672de215-…-afbf367bd9ef` |
+| B | 541357 | 项目经理 | `402881344fac0e280150b28dc4104d28` | role 1 | `402881343df56678013e011c8b99065d` |
+| C | 65647 | 项目经理 | `40288034449a42f60144aa675d750463` | role 1 | `402881343827d0a101382be781150013` |
+| D | 20361822 | 财务总监 | `ef15252e-…-350d85ce20c2` | role 1 | `d7dd95cb-…-c9e759a12fd5` |
+| E | 10909062 | 项目工程师交底 | `324a527c-…-83a2bfdbbd4f` | role 2 | **空**(该项目仅 role 1 有数据,BPMN 配 role 2 候选 → 数据漂移,忠实返回空) |
+
+> 位序↔role 映射实证:content `true,false,…` 全部对应 `role=1`(项目经理/项目负责人/财务总监);
+> `false,true,…` 对应 `role=2`。task 名「项目经理」与 role=1 语义一致,交叉印证位序即 1-based 角色编号。
+
+---
+
+## 三、实现
+
+### 3.1 projectRoleType 闭环(`OrgDirectoryJdbc.getUsersByProjectRole`)
+
+`flowable-service/src/main/java/com/eip4/flowservice/org/OrgDirectoryJdbc.java`:
+
+- 去掉原 P3 的 WARN 降级路径(`System.out.println("[WARN] projectRoleType …")` + 返回空);
+- 新增 `parseProjectRoles(content)`:位枚举 → 1-based role 编号列表(`"true,false,true"`→`[1,3]`);
+- 参数化直查:`SELECT distinct userid FROM pm_project_user WHERE pm_projectid=? AND isactive=1 AND role IN (?,…)`,
+ `userid` 去 padding(trim)+ `LinkedHashSet` 去重;
+- 保留 `ProjectRoleResolver` 钩子作**优先级最高的覆盖位**:客户私有化注入自有 `ProjectRoleUser` 时优先委托,
+ 否则走本直查(语义对齐 framework 契约)。
+
+### 3.2 长尾闭环(性价比高者一并实现)
+
+| 类型 | 频次 | 闭环方式 | 落点 |
+|------|-----:|---------|------|
+| **initiatorDepartManager** | 24 | `getMainDepart(initiatorId)` → `findDepartManager(mainDepart)`。MASTERDEPART 虚拟列经 **`view_sys_user.masterdepart` 等价子查询**(`sys_positionuser.ismaster=1` → `sys_position.parentdepartid`)落地;部门负责人取 **`sys_depart.leader`** 物理列(实证存在) | `OrgDirectoryJdbc.assignmentUser` 新增分支 + `getMainDepart`/`findDepartManager` |
+| **fixedDimension** | 12 | `findUsersByDimenDepartPositionTypes(curDepart, dimension, positionTypes, 0)`:经 **`view_sys_dimensiondepart`**(维度树,`parentdepartids` 祖先链)定位本部门,本部门有该岗位类别岗位则返回,否则按维度链**向上回溯**(direction=0,framework 全部调用点即 0;向下分支原版即 TODO 未实现,故不实现) | `OrgDirectoryJdbc.assignmentUser` 新增分支 + `findUsersByDimenDepartPositionTypes` |
+| **sameToTask** | 5 | `getSpecialActivityProcessor(piId, content)`:经 `historyService` 取流程实例下**已结束 userTask 按结束时间倒序第一条的 assignee**(content 为指定活动 id,空则取最近)。逐条对齐 framework `ProcessCoreServiceImpl.getSpecialActivityProcessor` | `CandidateUsersHandler` 新增 historyService 解析(不经 OrgDirectory,因需历史栈) |
+
+`CandidateUsersHandler` 同时把 `beforeTaskLeader`/`beforeTaskDepartManager`(实测 BPMN **0 处**,防御性接入)
+映射到 `initiatorLeader`/`initiatorDepartManager` 语义、以前序处理者作入参,与 framework 第 5 形参复用一致。
+
+### 3.3 验证口新增
+
+`CandidateController` 新增 `GET /api/flow/candidate/project-role?projectId=&content=`(对账用,调 `getUsersByProjectRole`)。
+
+### 3.4 改动文件清单
+
+| 文件 | 改动 |
+|------|------|
+| `…/org/OrgDirectoryJdbc.java` | projectRoleType 直查 + initiatorDepartManager/fixedDimension 分支 + getMainDepart/findDepartManager/findUsersByDimenDepartPositionTypes/parseProjectRoles |
+| `…/wf/user/assignee/CandidateUsersHandler.java` | sameToTask/beforeTask\* 经 historyService 闭环 + getSpecialActivityProcessor/resolveHistoryService |
+| `…/api/CandidateController.java` | `GET /project-role` 验证端点 |
+| `…/test/.../OrgDirectoryJdbcTest.java` | +6 测(projectRoleType 直查/位序解析/全 false/客户私有覆盖、initiatorDepartManager、fixedDimension),改 2 个旧降级断言 |
+| `…/test/.../CandidateUsersHandlerTest.java` | +2 测(sameToTask 有/无前序处理者) |
+
+---
+
+## 四、验证证据
+
+> 8089 起本服务(本地 eip4flow + 客户库组织只读),8084 未动。
+
+### 4.1 projectRoleType:REST `/project-role` == 手工 SQL 预期(5 例,含数据漂移空例)
+
+| # | 任务 | content | REST 返回 | 手工 SQL 预期 | 一致 |
+|---|------|---------|-----------|--------------|:---:|
+| A | 192023 项目经理 | role 1 | `["672de215-…e393…afbf367bd9ef"]` | 同 | ✅ |
+| B | 541357 项目经理 | role 1 | `["402881343df56678013e011c8b99065d"]` | 同 | ✅ |
+| C | 65647 项目经理 | role 1 | `["402881343827d0a101382be781150013"]` | 同 | ✅ |
+| D | 20361822 财务总监 | role 1 | `["d7dd95cb-…-c9e759a12fd5"]` | 同 | ✅ |
+| E | 10909062(role 2,漂移)| role 2 | `[]` | 空 | ✅ |
+
+另:多角色 content `true,…,true`(role 1+8,项目 `40288034474c75d9…073aa1` 同一人兼多角色)REST 返回 **去重后 1 个 userid**,验证 `LinkedHashSet` 去重生效。
+
+### 4.2 长尾闭环 REST 实证
+
+| 类型 | 入参 | REST 返回 | 手工 SQL 预期 | 一致 |
+|------|------|-----------|--------------|:---:|
+| initiatorDepartManager | initiatorId=`402880343fe2166f013fea6aaf4b0237` | `["402881343827d0a101382be6b8fb0012"]` | `view_sys_user.masterdepart`→`sys_depart.leader` 同 | ✅ |
+| initiatorDepartManager | initiatorId=`4028803441ba79140141deee59080f5a` | `["402881343826dc6f0138276705120015"]` | 同 | ✅ |
+| initiatorDepartManager | 不存在用户 | `[]` | 空 | ✅ |
+| fixedDimension | content=`administrative,73a88072-…-6197608a1726`,depart=`40288034474c75d90147b375c46a191c` | `["003aae9e-…","40288034474c75d9014786212e7509da"]` | 本部门 ptype 岗位人员同 | ✅ |
+
+> sameToTask:当前数据集无该 5 处 demo 活动(`sid-233550C4…`)的运行时历史(库内 0 条),
+> 无可对账的真实运行实例;其 historyService 查询语义经单测(桩历史栈)+ framework 逐字节对齐双重保证,
+> 与任务「能便宜闭环」尺度一致。
+
+### 4.3 回归:P3 已验证类型不破
+
+| 类型 | 入参(取自 P3 报告 3.1) | REST 返回 | 一致 |
+|------|------|-----------|:---:|
+| position | `fb2ea316-43c2-4d21-946e-3bb9a3052ce8` | `["6d84e817-…-873a9577e393"]`(== P3 3.1) | ✅ |
+| position(3 人岗位)| `402881343827d0a1013830922bee005c` | 3 个 userid(== P3:顾鼎/顾建方/奚岳云) | ✅ |
+| user | `u-aaa,u-bbb` | `["u-aaa","u-bbb"]`(直返) | ✅ |
+
+### 4.4 单测 + 全模块 + ArchUnit
+
+| 项 | 命令 | 结果 |
+|----|------|------|
+| flowable-service 单测 | `mvn test`(本模块)| **33 passed**(原 26 + **新增 7**,0 fail):OrgDirectoryJdbcTest 12→17、CandidateUsersHandlerTest 5→7、FlowControllerTest 9 不变 |
+| 全反应堆 + ArchUnit | `mvn test`(整库)| **BUILD SUCCESS**,`ArchitectureRulesTest` 绿(保真层 CandidateUsersHandler 仍 **零 `import com.eip4`**,自查 grep=0),各模块全绿 |
+| 启动 | `java -jar`(8089)| 1.94s 启动,v6+v5 双引擎,零错;验证毕已 `kill` 8089 |
+
+---
+
+## 五、长尾处置结论
+
+| 类型 | 频次 | P3 状态 | P4 处置 | 性价比说明 |
+|------|-----:|:------:|---------|-----------|
+| **projectRoleType** | 528 | 降级 WARN | ✅ **直查闭环**(pm_project_user)| 主目标,5 例真实任务对账一致 |
+| **initiatorDepartManager** | 24 | 降级(虚拟列)| ✅ **直查闭环** | 便宜:MASTERDEPART 经 `view_sys_user` 视图落地,leader 物理列存在;2 例真实用户对账一致 |
+| **fixedDimension** | 12 | 降级(虚拟列/维度树)| ✅ **直查闭环** | 中等:`view_sys_dimensiondepart` 视图提供祖先链,复用 findUsersByPositions;1 例真实对账一致 |
+| **sameToTask** | 5 | 降级(活动栈)| ✅ **historyService 闭环** | 便宜:Flowable `HistoricActivityInstanceQuery` 原生支持,逐条对齐 framework;当前数据集无运行时实例,单测+parity 保证 |
+| **scriptUser** | 26 | 降级(JUEL)| ⛔ **保持降级(写方案)** | 见下:工作量大且风险高,不便宜 |
+
+### 5.1 scriptUser 不闭环的理由与实现方案(任务要求「工作量大就只写方案」)
+
+**为何不便宜**:
+- framework 原版用 `Context.getProcessEngineConfiguration().getScriptingEngines().evaluate(content, "juel", (ExecutionEntity) execution)`,
+ **必须有活的 `ExecutionEntity`**(v6)/v5 execution 才能求值;本 handler 形参 `execution` 是 `Object`
+ (v5/v6 双类型,仅安全取 processInstanceId),拿不到可直接喂给脚本引擎的实体;
+- content 实测为 `${users}`/`${WRITERS}`/`${RECEIVERS}`/`${APPLYUSERS}` 等读流程变量的 JUEL;
+ 这些变量在 `act_ru_variable` 实测类型分布:**serializable 15 / null 14 / string 7**——
+ **serializable 是 Java 序列化的 ArrayList**,反序列化依赖原 framework 类在 classpath,独立服务无;
+- 即接一个表达式引擎,serializable 变量这条主路仍取不回 List,收益打折,风险(误解析/类加载)高。仅 26 处(0.54%)。
+
+**实现方案(待保真层接入或 P3-4 聚合时落地)**:
+1. 让 `CandidateUsersHandler.getCandidateUsers` 在 v6 路径下拿到 `DelegateExecution`/`ExecutionEntity`
+ (由 Flowable 在表达式求值时注入,而非反射 id);
+2. scriptUser 分支调 `processEngineConfiguration.getExpressionManager().createExpression(content).getValue(execution)`
+ (Flowable 6.8.1 内置 JUEL,无需 Nashorn),结果按 `List`/`String` 收敛为 userid 集(对齐原版收口逻辑);
+3. serializable 变量:约束业务侧把用户集存为 `string`(逗号分隔)或 Flowable 原生 `json`,
+ 避免依赖 framework 私有类反序列化;存量 serializable 由数据迁移期规整(属 P3-4/保真层议题)。
+4. 工作量评估:表达式引擎接线 0.5d + execution 上下文贯通(与 v5 兼容层交互)0.5d + serializable 规整策略(跨团队)——
+ 非「顺手」量级,故本次留方案。
+
+---
+
+## 六、剩余降级类型最终清单(手册 §6.5 缺口表据此更新)
+
+| 类型 | 频次 | 占比 | 状态 |
+|------|-----:|-----:|------|
+| position / user / formSpecifiedDimension / depart / initiator | 4250 | 87.7% | ✅ P3 已覆盖 |
+| projectRoleType | 528 | 10.9% | ✅ **P4 闭环** |
+| initiatorDepartManager | 24 | 0.5% | ✅ **P4 闭环** |
+| fixedDimension | 12 | 0.25% | ✅ **P4 闭环** |
+| sameToTask | 5 | 0.10% | ✅ **P4 闭环** |
+| **scriptUser** | **26** | **0.54%** | ⛔ **唯一剩余降级**(WARN,方案见 §5.1)|
+
+- **总占比**:覆盖 4819 / 4845 = **99.46%**;剩余降级仅 scriptUser **0.54%**。
+- 较 P3(覆盖 ~91%、5 类降级):**降级类型从 5 类收敛到 1 类,覆盖率 91%→99.46%**。
+
+---
+
+## 七、收尾
+
+- 8089 验证完成后已 `kill`,端口释放(8084 全程未动)。
+- 业务组织库全程**只读**(biz 数据源 `read-only`),无任何写操作;flow 库无数据变更。
+- git 仅 add 本任务自有文件(见提交记录)。
diff --git a/flowable-service/src/main/java/com/dsasp/server/wf/user/assignee/CandidateUsersHandler.java b/flowable-service/src/main/java/com/dsasp/server/wf/user/assignee/CandidateUsersHandler.java
index 68ba994..9084726 100644
--- a/flowable-service/src/main/java/com/dsasp/server/wf/user/assignee/CandidateUsersHandler.java
+++ b/flowable-service/src/main/java/com/dsasp/server/wf/user/assignee/CandidateUsersHandler.java
@@ -5,8 +5,12 @@ import java.util.List;
import org.codehaus.jackson.JsonNode;
import org.flowable.common.engine.impl.identity.Authentication;
+import org.flowable.engine.HistoryService;
+import org.flowable.engine.ProcessEngine;
import org.flowable.engine.ProcessEngines;
import org.flowable.engine.RuntimeService;
+import org.flowable.engine.history.HistoricActivityInstance;
+import org.flowable.engine.history.HistoricActivityInstanceQuery;
import com.dsasp.server.wf.bean.BasePropertiesConverter;
import com.dsasp.server.wf.bean.UserProperty;
@@ -59,15 +63,24 @@ public class CandidateUsersHandler {
if(userProperties != null){
for(UserProperty userProperty : userProperties){
List users = null;
- if(WfTypes.SAMETOTASK.equals(userProperty.getType())
- || WfTypes.BEFORETASKLEADER.equals(userProperty.getType())
- || WfTypes.BEFORETASKDEPARTMANAGER.equals(userProperty.getType())){
- // 原版经 processCoreService.getSpecialActivityProcessor(前一活动处理者)解析;
- // 该解析依赖历史活动栈遍历(framework ProcessCoreServiceImpl),
- // 独立服务暂不接入(WARN 降级),报告登记。占比小(sameToTask 5 处)。
- System.out.println("[WARN] candidateUsersHandler: 类型 " + userProperty.getType()
- + " 依赖前序活动处理者解析,独立服务暂未接入,跳过该项");
+ if(WfTypes.SAMETOTASK.equals(userProperty.getType())){
+ // 原版:processCoreService.getSpecialActivityProcessor(piId, content) 取前序 userTask 处理者。
+ // P4 闭环:经 historyService 历史活动栈直查(content 为指定活动 id,空则取最近一个)。
+ String user = getSpecialActivityProcessor(processInstanceId, userProperty.getContent());
users = new ArrayList();
+ if(user != null){
+ users.add(user);
+ }
+ }else if(WfTypes.BEFORETASKLEADER.equals(userProperty.getType())
+ || WfTypes.BEFORETASKDEPARTMANAGER.equals(userProperty.getType())){
+ // 原版:先取前一活动处理者(getSpecialActivityProcessor(piId, null)),再经
+ // assignmentUser(type, content, null, null, beforeUser) 求其直接领导/部门负责人。
+ // P4 闭环:前序处理者经 historyService 取;领导/部门负责人经 OrgDirectory 直查
+ // (beforeUser 作 initiatorId 入参,对齐原版第 5 形参的语义复用)。
+ String beforeUser = getSpecialActivityProcessor(processInstanceId, null);
+ String t = WfTypes.BEFORETASKLEADER.equals(userProperty.getType())
+ ? WfTypes.INITIATORLEADER : WfTypes.INITIATORDEPARTMANAGER;
+ users = directory.assignmentUser(t, userProperty.getContent(), beforeUser, null);
}else if(WfTypes.SCRIPTUSER.equals(userProperty.getType())){
// 原版经 ScriptingEngines.evaluate(content,"juel",execution) 求值;
// 独立服务不内置服务流脚本引擎(精简边界),WARN 降级,报告登记。
@@ -135,6 +148,49 @@ public class CandidateUsersHandler {
}
}
+ /** 取默认引擎的 HistoryService;无默认引擎(如单测)时返回 null。 */
+ protected HistoryService resolveHistoryService() {
+ try {
+ ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
+ return engine != null ? engine.getHistoryService() : null;
+ } catch (Exception e) {
+ return null;
+ }
+ }
+
+ /**
+ * 取前序活动处理者(sameToTask/beforeTask* 用)。
+ *
+ * 逐条对齐 framework {@code ProcessCoreServiceImpl.getSpecialActivityProcessor}:
+ * 取流程实例下已结束 userTask 活动、按结束时间倒序的第一条的 assignee;
+ * 指定 activityId(content)时只在该活动内取。framework 的 UserSession 兜底
+ * (取当前登录人)在独立服务无会话上下文,省略(返回 null,候选项为空)。
+ */
+ protected String getSpecialActivityProcessor(String processInstanceId, String activityId) {
+ HistoryService historyService = resolveHistoryService();
+ if (historyService == null || processInstanceId == null) {
+ return null;
+ }
+ try {
+ HistoricActivityInstanceQuery query = historyService.createHistoricActivityInstanceQuery()
+ .activityType("userTask")
+ .processInstanceId(processInstanceId)
+ .finished()
+ .orderByHistoricActivityInstanceEndTime().desc();
+ if (!isEmpty(activityId)) {
+ query.activityId(activityId);
+ }
+ List list = query.list();
+ if (list != null && !list.isEmpty()) {
+ return list.get(0).getAssignee();
+ }
+ } catch (Exception e) {
+ // 历史服务异常不阻断候选人解析(与原版 null 兜底同口径)
+ return null;
+ }
+ return null;
+ }
+
private Object getVariable(RuntimeService runtimeService, String processInstanceId, String name) {
if (runtimeService == null || processInstanceId == null) {
return null;
diff --git a/flowable-service/src/main/java/com/eip4/flowservice/api/CandidateController.java b/flowable-service/src/main/java/com/eip4/flowservice/api/CandidateController.java
index c6c6a6b..82aae5a 100644
--- a/flowable-service/src/main/java/com/eip4/flowservice/api/CandidateController.java
+++ b/flowable-service/src/main/java/com/eip4/flowservice/api/CandidateController.java
@@ -68,6 +68,12 @@ public class CandidateController {
return org != null ? ResponseEntity.ok(org) : ResponseEntity.notFound().build();
}
+ @GetMapping("/project-role")
+ @Operation(summary = "projectRoleType 解析", description = "projectId+八大员位枚举 content → 用户 id 列表(直查 pm_project_user),P4 对账用")
+ public List projectRole(String projectId, String content) {
+ return orgDirectory.getUsersByProjectRole(projectId, content);
+ }
+
@GetMapping("/task-context")
@Operation(summary = "任务上下文", description = "给定 taskId,回显其流程实例的发起人/部门/项目变量,辅助候选人对账")
public Map taskContext(String taskId) {
diff --git a/flowable-service/src/main/java/com/eip4/flowservice/org/OrgDirectoryJdbc.java b/flowable-service/src/main/java/com/eip4/flowservice/org/OrgDirectoryJdbc.java
index dbf4867..ea49b81 100644
--- a/flowable-service/src/main/java/com/eip4/flowservice/org/OrgDirectoryJdbc.java
+++ b/flowable-service/src/main/java/com/eip4/flowservice/org/OrgDirectoryJdbc.java
@@ -28,12 +28,22 @@ import com.dsasp.server.wf.support.WfTypes;
*
* 实测分布(本地客户库副本):position 1949 / user 1683 / formSpecifiedDimension 601
* / projectRoleType 528 / scriptUser 26 / initiatorDepartManager 24 / depart 14
- * / fixedDimension 12 / sameToTask 5 / initiator 3。占主导类型全部覆盖。
+ * / fixedDimension 12 / sameToTask 5 / initiator 3。
*
- * 未覆盖类型(报告登记):initiatorDepartManager/initiatorLeader/initiatorSubordinate/
- * initiatorDepart/fixedDimension 依赖 SYS_USER.MASTERDEPART/MASTERPOSITION 等
- * 元数据虚拟列(客户库 sys_user 无该物理列,引擎经元数据映射),纯直查 SQL 无法复现,
- * 需保真层元数据层;本实现对这些类型返回空并由调用侧 WARN。
+ * P4 闭环新增(原 P3 降级,现直查闭环):
+ *
+ * - {@code projectRoleType}(528):content 是「八大员」true/false 位枚举,
+ * true 的位序(1-based)即 {@code PM_PROJECT_USER.ROLE},按 PROJECTID 直查项目角色用户表;
+ * - {@code initiatorDepartManager}(24):MASTERDEPART 虚拟列经
+ * {@code view_sys_user.masterdepart} 子查询(sys_positionuser.ismaster=1 → sys_position.parentdepartid)落地,
+ * 再取 {@code sys_depart.leader} 得部门负责人;
+ * - {@code fixedDimension}(12):经 {@code view_sys_dimensiondepart}(维度树,PARENTDEPARTIDS 链)
+ * 本部门命中岗位类别岗位则返回,否则按维度链向上回溯(direction=0)。
+ *
+ *
+ * 仍降级类型(报告登记):{@code scriptUser}(26,JUEL 脚本求值需活的 ExecutionEntity
+ * + 反序列化变量,超独立服务精简边界,handler 侧 WARN)、{@code sameToTask}(5,前序活动栈,
+ * 已在 handler 侧经 historyService 闭环,不经本类)。
*/
public class OrgDirectoryJdbc implements OrgDirectory {
@@ -80,20 +90,75 @@ public class OrgDirectoryJdbc implements OrgDirectory {
} else if (WfTypes.FORMSPECIFIEDDIMENSION.equals(type)) {
// framework: findUsersByDepartPositionTypes(curDepart, contents)
return findUsersByDepartPositionTypes(initiatorDepart, contents);
+ } else if (WfTypes.INITIATORDEPARTMANAGER.equals(type)) {
+ // framework AssignmentHandlerImpl:getMainDepart(author) → findDepartManager(mainDepart)
+ // MASTERDEPART 经 view_sys_user.masterdepart 子查询落地(P4 闭环)
+ String mainDepart = getMainDepart(initiatorId);
+ if (mainDepart == null) {
+ return rtn;
+ }
+ return findDepartManager(mainDepart);
+ } else if (WfTypes.FIXEDDIMENSION.equals(type)) {
+ // framework AssignmentHandlerImpl:content=维度,岗位类别1,岗位类别2...
+ // → findUsersByDimenDepartPositionTypes(curDepart, dimension, positionTypes, 0)
+ if (contents.size() < 2) {
+ return rtn;
+ }
+ String dimension = contents.get(0);
+ List positionTypes = new ArrayList(contents.subList(1, contents.size()));
+ return findUsersByDimenDepartPositionTypes(initiatorDepart, dimension, positionTypes);
}
- // initiatorDepartManager/beforeTask*/fixedDimension:依赖 MASTERDEPART 等元数据虚拟列
- // 或前序活动栈,纯直查无法复现,返回空(报告登记)。
+ // beforeTask*/sameToTask:依赖前序活动处理者栈(historyService),已在 handler 侧闭环,不经本类。
return rtn;
}
@Override
public List getUsersByProjectRole(String projectId, String roleContent) {
+ // 客户私有化注入了自有 ProjectRoleUser 实现时,优先委托(完全对齐其语义);
+ // 否则走 P4 闭环的 pm_project_user 直查(逐条对齐 framework projectRoleUser 契约)。
if (projectRoleResolver != null) {
return projectRoleResolver.getUserByProjectRole(projectId, roleContent);
}
- System.out.println("[WARN] projectRoleType 候选人:framework 无通用 ProjectRoleUser 实现(项目定制扩展),"
- + "未注入 ProjectRoleResolver,返回空。projectId=" + projectId);
- return new ArrayList();
+ List roles = parseProjectRoles(roleContent);
+ if (projectId == null || projectId.trim().isEmpty() || roles.isEmpty()) {
+ return new ArrayList();
+ }
+ // framework ProjectRoleUser.getUserByProjectRole(projectId, "true,false,...") 契约:
+ // content 是「八大员」按枚举顺序的 true/false 串,true 的位序(1-based)即角色编号 role,
+ // 取该项目下这些角色的在用用户(PM_PROJECT_USER.ROLE,isactive=1)。
+ String sql = "SELECT distinct userid FROM pm_project_user WHERE pm_projectid = ? AND isactive = 1 "
+ + "AND role IN (" + placeholders(roles.size()) + ")";
+ Object[] args = new Object[roles.size() + 1];
+ args[0] = projectId;
+ for (int i = 0; i < roles.size(); i++) {
+ args[i + 1] = roles.get(i);
+ }
+ List rows = bizJdbc.query(sql, (rs, n) -> rs.getString("userid"), args);
+ Set userIds = new LinkedHashSet();
+ for (String u : rows) {
+ if (u != null && !u.trim().isEmpty()) {
+ userIds.add(u.trim());
+ }
+ }
+ return new ArrayList(userIds);
+ }
+
+ /**
+ * 解析「八大员」true/false 位枚举 content 为角色编号(1-based)列表。
+ * 例:{@code "true,false,true"} → {@code [1, 3]};空/全 false → 空。
+ */
+ static List parseProjectRoles(String roleContent) {
+ List roles = new ArrayList();
+ if (roleContent == null || roleContent.trim().isEmpty()) {
+ return roles;
+ }
+ String[] flags = roleContent.split(",");
+ for (int i = 0; i < flags.length; i++) {
+ if ("true".equalsIgnoreCase(flags[i].trim())) {
+ roles.add(i + 1);
+ }
+ }
+ return roles;
}
@Override
@@ -217,6 +282,106 @@ public class OrgDirectoryJdbc implements OrgDirectory {
return new ArrayList();
}
+ /**
+ * OrganizationServiceImpl.getMainDepart:取用户主部门。
+ *
+ * framework 经元数据虚拟列 {@code SYS_USER.MASTERDEPART} 取得;客户库 sys_user 无该物理列,
+ * 由数据库视图 {@code view_sys_user.masterdepart} 落地(等价 SQL:主岗位 ismaster=1 的
+ * sys_position.parentdepartid)。此处直查该计算逻辑,避免依赖保真层元数据引擎。
+ */
+ String getMainDepart(String userId) {
+ if (userId == null || userId.trim().isEmpty()) {
+ return null;
+ }
+ List rows = bizJdbc.query(
+ "SELECT s2.parentdepartid FROM sys_positionuser s1 "
+ + "LEFT JOIN sys_position s2 ON s1.positionid = s2.sys_position_id "
+ + "WHERE s1.ismaster = 1 AND s1.userid = ?",
+ (rs, n) -> rs.getString(1), userId);
+ for (String d : rows) {
+ if (d != null && !d.trim().isEmpty()) {
+ return d.trim();
+ }
+ }
+ return null;
+ }
+
+ /**
+ * UserFindServiceImpl.findDepartManager:部门负责人 = {@code SYS_DEPART.LEADER}。
+ * framework 经 {@code loadPOJO(departId, SYS_DEPART).get_Value("LEADER")} 取,此处直查列。
+ */
+ List findDepartManager(String departId) {
+ List userIds = new ArrayList();
+ if (departId == null || departId.trim().isEmpty()) {
+ return userIds;
+ }
+ List rows = bizJdbc.query(
+ "SELECT leader FROM sys_depart WHERE sys_depart_id = ?",
+ (rs, n) -> rs.getString("leader"), departId);
+ for (String u : rows) {
+ if (u != null && !u.trim().isEmpty()) {
+ userIds.add(u.trim());
+ }
+ }
+ return userIds;
+ }
+
+ /**
+ * UserFindServiceImpl.findUsersByDimenDepartPositionTypes(curDepart, dimension, positionTypes, 0):
+ * 维度内按部门找岗位类别岗位人员,本部门无则按维度树向上回溯。
+ *
+ * framework 经 {@code VIEW_SYS_DIMENSIONDEPART}(维度部门树,PARENTDEPARTIDS 为祖先链 CSV)
+ * 落地;此处直查该视图。direction 固定 0(向上找,framework 全部调用点即 0,向下分支原版未实现)。
+ */
+ List findUsersByDimenDepartPositionTypes(String curDepartId, String dimension, List positionTypes) {
+ if (curDepartId == null || curDepartId.trim().isEmpty()
+ || dimension == null || dimension.trim().isEmpty()
+ || positionTypes == null || positionTypes.isEmpty()) {
+ return new ArrayList();
+ }
+ // 1、定位当前维度下的当前部门,取其祖先链 PARENTDEPARTIDS
+ List parentChains = bizJdbc.query(
+ "SELECT parentdepartids FROM view_sys_dimensiondepart WHERE departid = ? AND dimensionid = ?",
+ (rs, n) -> rs.getString("parentdepartids"), curDepartId, dimension);
+ if (parentChains.size() != 1) {
+ // framework:list.size()==1 才继续(维度内该部门唯一),否则返回空
+ return new ArrayList();
+ }
+ // 2、本部门下有该岗位类别岗位则直接返回
+ String posSql = "SELECT sys_position_id FROM sys_position WHERE parentdepartid = ? AND positiontype IN (" + placeholders(positionTypes.size()) + ")";
+ List positionIds = bizJdbc.query(posSql, (rs, n) -> rs.getString("sys_position_id"),
+ prependArg(curDepartId, positionTypes));
+ if (!positionIds.isEmpty()) {
+ return findUsersByPositions(positionIds);
+ }
+ // 3、向上回溯祖先部门链(从近到远),命中岗位类别岗位即返回
+ String chain = parentChains.get(0);
+ if (chain != null && !chain.trim().isEmpty()) {
+ List parents = Arrays.asList(chain.split(","));
+ for (int i = parents.size() - 1; i >= 0; i--) {
+ String parent = parents.get(i);
+ if (parent == null || parent.trim().isEmpty()) {
+ continue;
+ }
+ List parentPositionIds = bizJdbc.query(posSql, (rs, n) -> rs.getString("sys_position_id"),
+ prependArg(parent.trim(), positionTypes));
+ if (!parentPositionIds.isEmpty()) {
+ return findUsersByPositions(parentPositionIds);
+ }
+ }
+ }
+ return new ArrayList();
+ }
+
+ private static Object[] prependArg(String first, List rest) {
+ Object[] args = new Object[rest.size() + 1];
+ args[0] = first;
+ for (int i = 0; i < rest.size(); i++) {
+ args[i + 1] = rest.get(i);
+ }
+ return args;
+ }
+
private static String placeholders(int n) {
StringBuilder sb = new StringBuilder();
for (int i = 0; i < n; i++) {
diff --git a/flowable-service/src/test/java/com/dsasp/server/wf/CandidateUsersHandlerTest.java b/flowable-service/src/test/java/com/dsasp/server/wf/CandidateUsersHandlerTest.java
index 2532440..529acdd 100644
--- a/flowable-service/src/test/java/com/dsasp/server/wf/CandidateUsersHandlerTest.java
+++ b/flowable-service/src/test/java/com/dsasp/server/wf/CandidateUsersHandlerTest.java
@@ -92,6 +92,37 @@ class CandidateUsersHandlerTest {
assertThat(dir.dispatched).contains("projectRoleType:true,false");
}
+ @Test
+ void sameToTask经前序活动处理者解析() {
+ // sameToTask:content 为指定活动 id,经 getSpecialActivityProcessor(历史活动栈)取处理者。
+ // 单测以子类桩注入前序处理者,验证其进候选人列表(独立服务无引擎时该方法本应取历史)。
+ String expr = "【\"items\":["
+ + "【\"type\":\"sameToTask\",\"content\":\"sid-PRIOR-ACTIVITY\",\"isCandidate\":true,\"isSendMail\":false,\"isSendPhone\":false】"
+ + "]】";
+ CandidateUsersHandler handler = new CandidateUsersHandler() {
+ @Override
+ protected String getSpecialActivityProcessor(String processInstanceId, String activityId) {
+ // 模拟历史活动栈返回前序 userTask 的 assignee
+ return "sid-PRIOR-ACTIVITY".equals(activityId) ? "prev-user-7" : null;
+ }
+ };
+ List users = handler.getCandidateUsers((Object) null, expr);
+ assertThat(users).containsExactly("prev-user-7");
+ // sameToTask 不经 OrgDirectory.assignmentUser 分派
+ assertThat(dir.dispatched).noneMatch(s -> s.startsWith("sameToTask"));
+ }
+
+ @Test
+ void sameToTask无前序处理者时返回空不抛异常() {
+ String expr = "【\"items\":["
+ + "【\"type\":\"sameToTask\",\"content\":\"sid-X\",\"isCandidate\":true,\"isSendMail\":false,\"isSendPhone\":false】"
+ + "]】";
+ // 默认 handler:无引擎 → getSpecialActivityProcessor 返回 null → 候选人空
+ CandidateUsersHandler handler = new CandidateUsersHandler();
+ List users = handler.getCandidateUsers((Object) null, expr);
+ assertThat(users).isEmpty();
+ }
+
@Test
void scriptUser分支降级返回空不抛异常() {
String expr = "【\"items\":["
diff --git a/flowable-service/src/test/java/com/eip4/flowservice/org/OrgDirectoryJdbcTest.java b/flowable-service/src/test/java/com/eip4/flowservice/org/OrgDirectoryJdbcTest.java
index db05dc1..67e145b 100644
--- a/flowable-service/src/test/java/com/eip4/flowservice/org/OrgDirectoryJdbcTest.java
+++ b/flowable-service/src/test/java/com/eip4/flowservice/org/OrgDirectoryJdbcTest.java
@@ -111,21 +111,76 @@ class OrgDirectoryJdbcTest {
}
@Test
- void 元数据虚拟列依赖类型返回空_initiatorDepartManager() {
- // initiatorDepartManager 依赖 MASTERDEPART 元数据虚拟列,纯直查不可复现,返回空(报告登记)
+ void initiatorDepartManager经主部门查部门负责人() {
+ // P4 闭环:getMainDepart(经 view_sys_user.masterdepart 子查询)→ findDepartManager(sys_depart.leader)
+ stubQuerySequence(
+ List.of("dep-main"), // getMainDepart:主岗位 parentdepartid
+ List.of("leader-9 ")); // findDepartManager:sys_depart.leader(带 padding)
+ OrgDirectoryJdbc d = directory();
+ assertThat(d.assignmentUser("initiatorDepartManager", null, "u1", "dep1"))
+ .containsExactly("leader-9"); // 去 padding
+ }
+
+ @Test
+ void initiatorDepartManager无主部门返回空() {
+ stubQuery(List.of()); // getMainDepart 返回空
OrgDirectoryJdbc d = directory();
assertThat(d.assignmentUser("initiatorDepartManager", null, "u1", "dep1")).isEmpty();
- assertThat(d.assignmentUser("fixedDimension", "dim1,typeA", "u1", "dep1")).isEmpty();
}
@Test
- void projectRoleType无解析器时返回空() {
+ void fixedDimension本部门命中岗位类别岗位则返回不回溯() {
+ // 维度内本部门唯一(parentdepartids 链命中 1 条)→ 本部门岗位命中 → 取人员
+ stubQuerySequence(
+ List.of("a,b,c"), // view_sys_dimensiondepart.parentdepartids(1 条)
+ List.of("posDim"), // 本部门岗位类别岗位
+ List.of("dim-user")); // findUsersByPositions
OrgDirectoryJdbc d = directory();
- assertThat(d.getUsersByProjectRole("proj1", "true,false")).isEmpty();
+ assertThat(d.assignmentUser("fixedDimension", "administrative,typeA", "u1", "dep1"))
+ .containsExactly("dim-user");
}
@Test
- void projectRoleType有解析器时委托() {
+ void fixedDimension内容不足两段返回空() {
+ OrgDirectoryJdbc d = directory();
+ assertThat(d.assignmentUser("fixedDimension", "onlyDimension", "u1", "dep1")).isEmpty();
+ }
+
+ @Test
+ void projectRoleType解析八大员位枚举查pm_project_user() {
+ // content "true,false,true" → 角色 1,3 → 查 pm_project_user
+ stubQuery(List.of("pu-1 ", "pu-2 ", "pu-1 "));
+ OrgDirectoryJdbc d = directory();
+ List users = d.getUsersByProjectRole("proj1", "true,false,true");
+ // 去 padding + 去重
+ assertThat(users).containsExactly("pu-1", "pu-2");
+ }
+
+ @Test
+ void projectRoleType全false或空content返回空不查库() {
+ OrgDirectoryJdbc d = directory();
+ assertThat(d.getUsersByProjectRole("proj1", "false,false,false")).isEmpty();
+ assertThat(d.getUsersByProjectRole("proj1", "")).isEmpty();
+ assertThat(d.getUsersByProjectRole(null, "true")).isEmpty();
+ }
+
+ @Test
+ void projectRoleType位枚举解析为1based角色编号() {
+ // 单元验证位序解析:true 的位置(1-based)即角色编号
+ assertThat(OrgDirectoryJdbc.parseProjectRoles("true,false,false,false,false,false,false,false"))
+ .containsExactly(1);
+ assertThat(OrgDirectoryJdbc.parseProjectRoles("false,true,false")).containsExactly(2);
+ assertThat(OrgDirectoryJdbc.parseProjectRoles("true,false,true")).containsExactly(1, 3);
+ // 变长(新版流程加了角色位)
+ assertThat(OrgDirectoryJdbc.parseProjectRoles("false,false,false,false,false,false,false,false,false,false,true"))
+ .containsExactly(11);
+ assertThat(OrgDirectoryJdbc.parseProjectRoles("")).isEmpty();
+ assertThat(OrgDirectoryJdbc.parseProjectRoles(null)).isEmpty();
+ }
+
+ @Test
+ void projectRoleType有客户私有解析器时优先委托() {
+ // 客户私有化注入自有 ProjectRoleUser 时,优先委托,不走 pm_project_user 直查
OrgDirectoryJdbc d = new OrgDirectoryJdbc(bizJdbc,
(projectId, roleContent) -> List.of("pr-user-1"));
assertThat(d.getUsersByProjectRole("proj1", "true")).containsExactly("pr-user-1");