Compare commits

...

77 Commits

Author SHA1 Message Date
d97e69d124 Merge feat/process-modeler T4.3收尾: 安全Critical修复+文档回写(B3完工)
Some checks failed
ci / build-test-parity (push) Has been cancelled
parity-nightly / nightly-parity (push) Has been cancelled
- 安全对抗评审Critical#1修复:nginx关闭/flowable/公网直通(无鉴权引擎不对外)
- 文档回写:总览B3行🔴→🟢+一句话进度+README+计划完成横幅
- 双对抗评审处置:发布链I-1语料dry-run证伪(803formKey全命中)/A10加固backlog

B3 在线流程Modeler v1 全17任务完成。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 16:33:54 +08:00
74b30adb6e docs(B3): 收尾——总览B3行🔴→🟢+一句话进度+README+计划完成横幅+双对抗评审处置
B3 在线流程Modeler v1 全17任务完成合main。评审处置:安全Critical#1(nginx)已修+A10加固backlog;
发布链I-1(formKey门误拒)语料dry-run证伪(803全命中miss=0)/I-2空content已知限制v2/M-1~3低优先。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 16:33:03 +08:00
36aa94db7d fix(deploy): nginx 关闭 /flowable/ 公网直通(安全评审 Critical#1)+A10加固backlog
flowable-service:8089 无鉴权,裸 proxy_pass 对外会绕过网关超管门匿名部署/覆盖生产BPMN。
前端只经 /api/workflow/ 网关访问流程能力,/flowable/ 改 return 404。
High#2/Medium#3-4 等 A10 生产加固项记入计划 backlog(超管信任模型内可接受)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 16:26:12 +08:00
49d056be09 Merge feat/process-modeler 阶段4: 计划文档回写(e2e发现/已知限制)
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 16:16:14 +08:00
a5e2540c8f docs(plan): 阶段4 e2e 发现——会签空content语义缺口/e2e非幂等/403降级(已知限制)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 16:14:03 +08:00
93f3823a06 Merge feat/process-modeler 阶段3: 发布门(deploy+校验+审计+同人确认)
Some checks failed
ci / build-test-parity (push) Has been cancelled
- deploy-from-model(incoming/outgoing剥除+id还原中文key+ProcessValidator校验门+
  disableSchemaValidation+metaInfo不可读fail-fast防坏key)+impact影响摘要
- 网关语义校验门 ModelSemanticValidator(办理人JSON items非空+type白名单对齐WfTypes16种防误拒/
  formKey存在性/完成条件三预设∪自定义不阻断)+FlowDeployAuditService+Flyway V4 sys_flow_deploy_audit
- 下游ProcessValidator结构化errors透传前端(不再吞成通用FLOW_REMOTE_ERROR)
- live 验收:改总包合同交底→存草稿→发布 v9,中文key保住+审计行(op=ADMIN)+起实例生成真userTask+
  旧6实例不受影响+非admin 403;全reactor mvn clean install绿+ArchUnit 6/6
- live 揪修CRITICAL:activiti.json缺tagAlias致Modeler输出PascalCase元素名(Flowable大小写敏感断部署)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 15:30:32 +08:00
4af6776164 docs(plan): 回写阶段3 live CRITICAL——activiti.json致bpmn-js Modeler输出PascalCase元素名(部署断)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 15:02:37 +08:00
732655e776 fix(gateway): 语义门收口——type白名单对齐WfTypes(防误拒存量)+透传下游结构化errors+TOCTOU文档
评审 T3.2 收口(2 Important + 2 Minor):
- I-1(功能回归):ModelSemanticValidator.TYPE_WHITELIST 10 种→16 种,对齐 flowable-service WfTypes
  配置类型 + OrgDirectoryJdbc 运行期分派(权威源,非 BasePropertiesConverter,注释已改)。
  psql 窄查询实证:缺失 6 种里 initiatorDepartManager(24 文档)/fixedDimension(12 文档)在真实
  candidateUsers 有非零命中,旧白名单会 422 误拒这些存量流程(载入→编辑无关节点→发布)。
  网关不依赖 flowable-service 故复刻常量并注同步提醒。
- I-2(UX):FlowRemoteException 加 responseBody;FlowableClient.execute 携带下游原始体;
  FlowGatewayExceptionHandler.onRemote 解析并把下游 errors 数组并入网关响应顶层——发布下游 422
  的引擎结构校验 errors[{activityId,problem,defaultDescription}] 现能到前端,与网关语义 422 顶层
  errors 契约统一(前端 T3.3 同一渲染)。非发布路径纯文本体照旧不加 errors 键(无回归)。
- I-3(TOCTOU):deploy 端点加「已接受风险」javadoc(超管低频+窄窗+非安全洞,v1 不做 content-hash 409)。
- 补测 M-1(flowable: 前缀 candidateUsers 按本地名匹配同校验)+ M-2(新增 4 种 type 放行,锁 I-1)+
  I-2 客户端携带体/handler 并入顶层 errors 两用例。

测试:语义 19(+2)、审计 3、客户端 24(+1)、控制器 30(+1)。全 reactor mvn clean install 退出码 0,
零 <<< FAILURE,ArchitectureRulesTest 6/6。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 14:52:03 +08:00
5eed5f0b26 feat(gateway): 发布语义校验门(ModelSemanticValidator)+部署审计(V4/FlowDeployAuditService)
网关发布门收口(T3.2):
- ModelSemanticValidator(@Service):钉 JDK 解析器解析 bpmn XML,校验办理人/会签内嵌
  JSON(全角【】→半角)items 非空+type 白名单、formKey 存在于 view_wftemplate(读库降级放行)、
  会签 completionCondition 预设∪自定义非空(自定义不阻断,保留 T2.4 自定义态);返 List<String> 错误清单。
- Flyway V4 建 sys_flow_deploy_audit(平台表);FlowDeployAuditService(@Service)收口 INSERT,
  写失败不反噬已成功的部署。SQL 全收口 @Service,@RestController 不直用 JdbcTemplate(ArchUnit 棘轮)。
- ProcessModelerController 加 POST /models/{id}/deploy(超管门→语义校验 fail 则 422 零转发→
  转发 deploy→审计 INSERT operator=userId)+ GET /models/{id}/impact(超管门转发)。
- FlowableClient 加 deployModel(id)/modelImpact(id)(uri 变量转发)。

测试:语义校验 17(各错误类型+通过+items 空 error+自定义完成条件不阻断+读库降级+XXE)、
审计 3、客户端转发 +3、控制器 deploy/impact +7。全 reactor mvn clean install 绿,
ArchitectureRulesTest 6/6(@RestController 未新增直用 JdbcTemplate)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 14:12:21 +08:00
529f73f8f5 fix(flow): 发布门坏key地雷收口——metaInfo不可读fail-fast(防部署净化key)+危险分支补测
评审 I1(高后果):readIdMap 把三种情况塌成「空 idMap→跳过还原」——(a)真新建 (b)JSON 解析失败
(c)解析成功但缺 eip4IdMap 键。对 from-procdef 存量草稿(editorSource 的 <process id> 是净化 nXXX),
(b)/(c) 会跳过还原 → 静默部署 key=nXXX 而非中文原 key(HTTP 200,违 D7,且与 restore 非双射 fail-fast 自相矛盾)。

修:readIdMap→resolveIdMap,据 from-procdef 写的 sourceProcDefId/originalKey 标记分流——
metaInfo 非空且(解析失败 或 带标记但缺/非-Map eip4IdMap)→ IllegalStateException fail-fast,
deploy catch→422「草稿 id 映射不可用,无法还原原 key」,不部署。eip4IdMap 存在(含空 {})即可用
(空=全 ASCII 存量流程无需还原);真·新建(metaInfo {}/null、无标记)仍空 map 正常放行。impact 只读
最终回退 model.key(from-procdef 的 model.key 即中文原 key),不 500。

补测(评审 I2):非双射 idMap→IllegalArgumentException→422;存量草稿缺 eip4IdMap→422;metaInfo 坏 JSON→422;
存量空 eip4IdMap 全 ASCII 不误拒正常部署;deploy 路径字节级 DOCTYPE 守卫→422。Minor:M1 注释钉边界
(EIP4 语义校验在网关 ModelSemanticValidator/T3.2,此处仅引擎结构校验);M3 impact 注释说明为何不需独立 DOCTYPE 守卫。

ProcessModelControllerTest 30/30(19 既有零改动 + 11 T3.1:6 首轮 + 5 本轮);全 reactor clean install 绿
(ArchitectureRulesTest 6/6)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:48:36 +08:00
6f180522f3 feat(flow): 草稿发布(incoming/outgoing剥除+id还原中文key+ProcessValidator校验门+disableSchemaValidation)+影响摘要
POST /models/{id}/deploy:剥除 bpmn-js 补的 incoming/outgoing 文本引用元素
(Flowable 从 sequenceFlow 自行推导,不剥则 restore 只还原属性位→落库脏 XML,T1.3 I-2)
→ BpmnIdSanitizer.restore 依 eip4IdMap 还原中文原 key(存量 D7 硬需求,新建流程无 idMap 跳过)
→ ProcessValidator 语义校验门(仅 ERROR 级阻断,返 422 {errors:[{activityId,problem,defaultDescription}]}
不部署;WARNING 放行)→ createDeployment().disableSchemaValidation()(只跳 XSD:bpmn-js 默认命名空间
与严格 XSD 已知不兼容,语义已在上一步)部署 → {status,deploymentId,processKey,newVersion}。

GET /models/{id}/impact:还原后解析 processKey → {processKey,currentVersion(最新已部署版本),
runningInstances(运行中实例数)},供同人确认弹窗展示。

控制器加 @Autowired(RepositoryService,RuntimeService) 构造(保留单参构造零改动既有 CRUD 单测)+
全参构造注入 mock ProcessValidator。发布/影响端点 8 单测(还原中文key+剥除无残留净化id+disableSchemaValidation
验证/ERROR 422 不部署/WARNING 放行/404/impact 计数),既有 17 单测零改动;全 reactor clean install 绿
(ArchitectureRulesTest 6/6)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:32:31 +08:00
84be9c658a Merge feat/process-modeler: 修 ArchUnit 棘轮(wftemplates SQL 收口 WfTemplatePickerService)+计划红线
Some checks failed
ci / build-test-parity (push) Has been cancelled
修复 7524e5f 阶段2 merge 引入的 platform-app ArchitectureRulesTest 失败:
ProcessModelerController 直注 JdbcTemplate 违反棘轮,SQL 收口新建 WfTemplatePickerService;
全 reactor mvn clean install 独立验证真绿(ArchitectureRulesTest 6/6)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:17:18 +08:00
647f06836f fix(gateway): wftemplates SQL 收口 WfTemplatePickerService(修 ArchUnit 控制器JdbcTemplate棘轮)
T2.2 给 ProcessModelerController(@RestController)直注 JdbcTemplate 触发 platform-app
ArchitectureRulesTest 棘轮「控制器不得新增直用 JdbcTemplate」(该测试在 platform-app 扫全模块,
模块级 mvn -pl 跑不到故 T2.2 时未暴露,main 全 reactor 失败)。按规则本意收口(不加白名单):

- 新建 platform-flow-gateway aggregate/WfTemplatePickerService(@Service):wftemplates 的 JdbcTemplate
  查询(view_wftemplate_id + entityid→sys_entity.name LEFT JOIN + trim CHAR 补白 + isactive=1 +
  读库异常降级)整体搬入,暴露 listTemplates() 返 {templates} / 降级 {templates:[],degraded:true}。
  Service 用 JdbcTemplate 不违规,规则只禁 @RestController。
- ProcessModelerController 去掉 JdbcTemplate 字段/构造参 + SQL/RowMapper 常量,改注入 WfTemplatePickerService,
  wftemplates 端点只保留超管门 + 透传。

测试:新建 WfTemplatePickerServiceTest(2:trim补白+回退id+正常不带degraded / 读库异常降级带degraded);
ProcessModelerControllerTest 的 wftemplates 三例(直查 JdbcTemplate)收敛为两例(超管透传 service 结果 /
非超管 403 不调 service),jdbcTemplate mock 换 WfTemplatePickerService mock。

验证(全 reactor,ArchitectureRulesTest 真跑):JAVA_HOME=...openjdk@21 mvn clean install -q → 退出码 0;
ArchitectureRulesTest 6/6 绿(JdbcTemplate 棘轮通过)、WfTemplatePickerServiceTest 2、ProcessModelerControllerTest 22、
FlowableClientTest 20,全 reactor 零失败报告。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:13:32 +08:00
26532a64c3 docs(plan): 红线补——合main前全reactor真绿(ArchUnit在platform-app)+控制器SQL收口Service
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:04:58 +08:00
7524e5f7bf Merge feat/process-modeler 阶段2: EIP4 控件+草稿闭环
Some checks failed
ci / build-test-parity (push) Has been cancelled
- 流程草稿 ProcessModelController(act_re_model,Model API 首启;metaInfo 存 eip4IdMap 供发布还原;
  category=eip4 隔离 143 存量;草稿保存 validateSchema=false+字节级DOCTYPE守卫;DELETE 端点)
- 网关 models 五端点+DELETE 转发(requireSuperAdmin 统一门)+wftemplates picker(entityid→sys_entity.name)
- EIP4 侧板五控件(办理人 codec meta 透传/会签保真读回 isSequential/elementVariable/自定义完成条件/
  formKey 过滤/扩展属性/监听器);表达式 codec 与 BasePropertiesConverter 逐字对齐+引号映射防截断JUEL
- 存草稿闭环(三路径保 eip4IdMap+首存回填 modelId 防刷新重复+草稿列表/删除)
- live 验收:总包合同交底 中文key 打开→会签保真→saveXML(bpmn-js默认命名空间,后端XSD修复接受)→
  act_re_model 含完整 eip4IdMap→重开侧板忠实回显;全 reactor mvn clean install 绿
- live 揪修3真bug:options source=model语义/属性面板ref未绑/bpmn-js输出被严格XSD拒
- 评审含金量:codec全库4794表达式往返/反编译Flowable抓XXE参数/28会签流对账保真

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 13:02:45 +08:00
789cb90af3 fix(flow): 草稿保存关严格XSD校验(bpmn-js默认命名空间输出)+字节级DOCTYPE守卫保XXE
阶段2 live 验收阻断 bug:UI 保存草稿恒 422。根因=T2.1 评审 I-1 我把 enableSafeBpmnXml 从
false 改 true 时,convertToBpmnModel(source, validateSchema=true, ...) 的 validateSchema=true
开启严格 XSD 校验;bpmn-js saveXML 用默认命名空间(无前缀 definitions/process)重序列化,Flowable
严格 Xerces XSD 校验拒之(cvc-complex-type.2.4.a: element {MODEL}process ... expected)——bpmn-js
面向 BPMN 模型非字节级 XSD 合规,这是已知固有不兼容;原始 source(带前缀)故能过。

架构:草稿是可视化工具编辑的半成品,不该做完整 XSD 校验(完整校验属部署门 T3.1 ProcessValidator,
在解析后模型上跑,非 XSD)。修法:
1. parseGuard 的 convertToBpmnModel(..., true, true) → (..., false, true)(validateSchema=false)。
   仍解析(非良构 XML 抛→422),不做严格 XSD。
2. XXE 不只靠此:解析前加字节级 DOCTYPE 拒绝守卫(移植 platform-report ReportXmlGuard
   hasDoctypeInBytes/hasDoctype 模式,含 BOM/UTF-16 编码识别,就地复刻不引 platform-* 依赖),
   与 enableSafeBpmnXml=true 双保险防外部实体注入。

测试(TDD 先红后绿):ProcessModelControllerTest 16→19——①bpmn-js 默认命名空间输出(BPMNDiagram
先于 process,触发同族 cvc-complex-type.2.4.a)改前 422 改后 200 落库(回归锚点,改前实测必红);
②含 <!DOCTYPE 声明的 XML → 422(XXE 守卫);③非良构 XML(标签不匹配)→ 关 XSD 后仍 422。
flowable-service 全模块 92 测试绿,BUILD SUCCESS,既有 16 测试零改动。

附带排查(T3.1 deploy 路径同问题,不在本 task 范围):Flowable 6.8.1 BpmnParse 构造器
validateSchema 默认 iconst_1=true,BpmnDeployer 把它传给 convertToBpmnModel → createDeployment()
.addString(bpmnJsXml).deploy() 会被同一 cvc-complex-type.2.4.a 咬。escape hatch:DeploymentBuilder
有 disableSchemaValidation()(仅跳 XSD)。T3.1 应:parse(validateSchema=false)→跑 ProcessValidator
(语义校验,计划已设计)→ createDeployment().disableSchemaValidation().addString().deploy()。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 12:52:51 +08:00
a9d21ec46c docs(plan): 回写阶段2 live 实证——bpmn-js默认命名空间输出被严格XSD拒(草稿已修+警示T3.1部署路径)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 12:42:56 +08:00
f0d704d1b9 feat(flow+gateway): 草稿删除端点 DELETE /models/{id}(超管门)
补前端 T2.5 已按占位契约做好测试的草稿删除两层端点:

flowable-service ProcessModelController:DELETE /api/flow/models/{id}——先 getModel 判 null→404
{status:1,msg};存在则 deleteModel(id)(连带 editorSource/metaInfo 一并删)→{status:0}。

网关:FlowableClient +deleteModel(id)(id 走 uri 变量严格编码,DELETE 无既有封装→照 put 补私有
delete() 助手,无请求体,幂等重试安全);ProcessModelerController +DELETE /api/workflow/models/{id}
过 requireSuperAdmin 门后透传,{status:0} 原样回(对齐前端 deleteDraft 只判成功),下游 404 经既有
FlowGatewayExceptionHandler 透传。

测试(严格 TDD,均先红后绿):
- flowable ProcessModelControllerTest 14→16(删存在的 verify deleteModel 调 1 次/删不存在 404 verify 零删)
- gateway FlowableClientTest 18→20(DELETE 按 id 透传/下游 404 透传 FlowRemote 不重试)
- gateway ProcessModelerControllerTest 21→23(超管 200 透传+非超管 403 门拦下游恰调 1 次/404 胶水经 handler 出 FLOW_REMOTE_ERROR)
两模块 mvn -pl flowable-service,platform-flow-gateway -am test 全绿,BUILD SUCCESS,既有测试零改动。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 12:21:05 +08:00
653866c852 fix(gateway): T2.2 评审小项——幂等注释/降级标记/PUT胶水测试
M-1(javadoc):FlowableClient put()/post() 点破幂等性差别——PUT 覆盖写幂等,execute 连接级重试安全;
POST 非幂等,重试存在重复创建窗口,接受理由=草稿廉价可覆盖(非不可逆副作用)+本地同机链路瞬时故障概率极低,
语义级 4xx/5xx 绝不重试故无此窗口。
M-2(一行):wftemplates 读库异常降级分支返回 {templates:[],degraded:true},正常路径不带 degraded 键;
测试两分支各断言(正常 doesNotContainKey degraded / 降级 containsEntry degraded=true)。
M-3(胶水):照 glueMvc 补 PUT /api/workflow/models/{id} MockMvc 路由层测试(PUT 谓词匹配+@PathVariable
绑定 id=m1+200 透传)。

测试:ProcessModelerControllerTest 20→21(+PUT 胶水),FlowableClientTest 18(M-1 纯注释不加测试)。
platform-flow-gateway 全模块绿,BUILD SUCCESS,既有测试零改动。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 12:01:18 +08:00
e19bac805e docs(plan): 回写 T2.2 评审——草稿删除端点挂 T2.5/T4.1
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:57:45 +08:00
a25e7ce4b7 docs(plan): 回写 T2.2 实证——wftemplate 无名称列,formKey 下拉须过滤输入
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:49:45 +08:00
b489f3d834 feat(gateway): models 五端点转发(requireSuperAdmin 统一门)+wftemplates picker 数据源
阶段 2 网关侧(对齐 flowable-service T2.1 ProcessModelController 契约):

FlowableClient +5 方法:listModels/getModel/createModel/updateModel/modelFromProcDef,
全 uri 模板变量严格编码(禁字符串拼接);RestClient 无 PUT 封装 → 照 post 补私有 put()
(uriTemplate+uriVars 严格编码);连接级重试 + 4xx/5xx 透传语义复用既有 execute。

ProcessModelerController:抽 requireSuperAdmin(principal) 私有方法(超管返 null,非超管/无身份
返 403 {status:1,msg:"仅系统管理员可用"}),既有两个 source 端点改用它(行为零变,既有 10 测试零改动);
新增五端点 GET /models、GET /models/{id}、POST /models、PUT /models/{id}、POST /models/from-procdef
全部先过门再转发 FlowableClient,返回体原样透传。

GET /api/workflow/wftemplates(同门):formKey 选择器数据源。
**information_schema 实证**:view_wftemplate 无独立名称列(仅 view_wftemplate_id CHAR + xml +
isactive + 审计列),<form> 根标签也无 title/name 属性(0/1016);唯一人类可读名来自 XML 的
entityid → sys_entity.name(378/1016 带 entityid,339 解析出中文名如「通知管理」)。故
name = entityid 解析出的实体名(LEFT JOIN + substring 正则抽 entityid),空则回退 id;
view_wftemplate_id 是 CHAR 补白 → RowMapper trim;isactive=1 过滤;读库异常降级空列表不 500。

测试:FlowableClientTest 12→18(+list/get/create/update/from-procdef body 透传+4xx 透传);
ProcessModelerControllerTest 10→20(五端点各 admin 200 透传+非超管 403 门拦下游 恰调 1 次证明门生效、
无身份 403、422 胶水经 FlowGatewayExceptionHandler 出 FLOW_REMOTE_ERROR、wftemplates 超管 trim 补白+
无名回退 id、非超管 403 零读库、读库异常降级空列表)。platform-flow-gateway 全模块 98 测试绿、
上游 493 测试绿,BUILD SUCCESS,既有测试零改动。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:48:30 +08:00
4abe9f8ce6 docs(plan): 回写 T2.4 评审——T3.2 语义校验加 items 非空与自定义完成条件口径
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:48:29 +08:00
b89447556f fix(flow): 草稿控制器评审收口——safeBpmnXml+category过滤存量+metaInfo保持回归测试等
评审跟进 7 项(评审者反编译 Flowable 6.8.1 实证):
- I-1(安全):parseGuard convertToBpmnModel 第三参 enableSafeBpmnXml false→true,
  启用 flowable 加固解析器(禁外部 DTD/参数实体/DOCTYPE)关 XXE/SSRF 面;javadoc 写明两布尔参语义。
- I-2(列表污染):库里 143 条存量 act_re_model(老 shape+悬空 editorSource)会进草稿列表打不开。
  create/from-procdef 建 model 时 setCategory("eip4");list() 改 modelCategory("eip4") 只查本分类。
- I-3(回归契约):加「PUT 只带 name 不带 metaInfo→verify never setMetaInfo」用例,钉住 eip4IdMap
  不被普通保存抹掉(T3.1 发布逆向还原原 key 的命根)。
- M-1:class javadoc 补「裸 8089 无鉴权,写端点必须经网关超管门访问(T2.2),生产 8089 不对外」。
- M-2:parseGuard 422 msg 改通用文案「BPMN 解析失败」,原始 e.getMessage 只进 log.warn(防内部细节回显)。
- M-3:POST create 对空白 name/key 返 422(key 是 T3.1 部署资源名/还原依赖),在解析守卫前拦;加测试。
- M-4:补 from-procdef「BPMN 读取为空(getProcessModel null)→found:false 不落库」分支测试。

测试:ProcessModelControllerTest 11→14 例(新增 空白 name/key 422 不落库、只带 name 不改 metaInfo、
BPMN 读空 found:false;既有列表用例补 modelCategory 断言、建草稿/from-procdef 补 setCategory 断言)。
flowable-service 全模块 87 测试绿(新增 3,既有其他模块测试零改动)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:32:26 +08:00
93b5433f1e docs(plan): 回写 T2.3 实证——表达式 meta 5 字段透传为 T2.4 正确性硬要求
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:18:53 +08:00
57812f0edc feat(flow): 流程草稿 ProcessModelController(act_re_model,Model API 首次启用)
在线 Modeler 草稿仓:flowable 原生 Model API 存草稿于 act_re_model(全仓首次启用
Model API,表已有 143 行存量,databaseSchemaUpdate=false 不涉 DDL)。5 端点(@RequestMapping
"/api/flow"):GET /models 列表(orderByLastUpdateTime desc,时间转 ISO)、GET /models/{id}
取草稿(getModel+getModelEditorSource,不存在/源空→found:false)、POST /models 建草稿
(XML 过 BpmnXMLConverter 解析守卫,坏 XML→422 不落库)、PUT /models/{id} 更新
(不存在→404;name/metaInfo 仅当请求提供才更新,避免抹掉 eip4IdMap)、
POST /models/from-procdef 从流程定义建草稿(BpmnIdSanitizer 净化中文 id,
metaInfo={eip4IdMap,sourceProcDefId,originalKey} 供发布逆向还原)。

解析守卫就地 catch 转 422,不逸出到 FlowExceptionHandler(那里 FlowableException→400
语义不符)。from-procdef 复用本控制器自带 readProcessModel 小方法,零改动 ProcessDiagramController。

测试:ProcessModelControllerTest 11 例(列表 ISO 降序/取草稿含 metaInfo/model 不存在或
源空 found:false/建草稿合法 XML 落库/坏 XML 422 且 verify 零 saveModel/PUT 404/PUT 合法
更新 status:0/PUT 坏 XML 422/from-procdef 净化 XML 与 idMap 落 metaInfo(捕获 setMetaInfo
断言 JSON 含 eip4IdMap+中文 originalKey、捕获 editorSource 断言净化无中文 id)/procDef
不存在 found:false 不落库)。flowable-service 全模块 84 测试绿(新增 11,既有 73 零改动)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:15:54 +08:00
546a8228b0 Merge feat/process-modeler 阶段1: Modeler 只读载入存量(可逆净化+source端点+网关超管门)
Some checks failed
ci / build-test-parity (push) Has been cancelled
- BpmnIdSanitizer 可逆化(碰撞消解+前缀安全+双射契约测试,BpmnIdSanitizerTest 10)
- by-id/by-key 取净化源XML端点(共享 sourceResponse,ProcessDiagramControllerTest 9)
- 网关转发+超管门(isSystemAdmin public化+9契约测试,中文procDefId uri变量编码硬验收,
  FlowGatewayExceptionHandler 全仓首测,ProcessModelerControllerTest 10)
- live 验收:中文key「总包合同交底」全链打开,画布/palette/标准面板(Multi-instance组)全渲染,
  无身份403;全 reactor mvn clean install 绿
- live 揪修2真bug:options source=model 语义缺口(by-key修法)/属性面板 ref 未绑
- 计划文件随评审实证持续回写(7次 docs 提交)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:08:05 +08:00
ddaf536419 test(gateway+auth): T1.6 评审收口(I-1 胶水测试/M-2 空 userId/M-1 时效性注释)
- I-1(合 main 前必须):ProcessModelerControllerTest 补 4 个 MockMvc 胶水测试
  (standaloneSetup + setControllerAdvice(FlowGatewayExceptionHandler) + 自定义超管参数解析器)——
  by-id/by-key 各:①引擎不可达经既有 handler 出 503 通用信封(FlowGatewayExceptionHandler 全仓首测)
  ②正常路径 200 透传 ③MVC 层把 percent 编码中文 path variable(含冒号 procDefId)正确解码回原串交控制器。
- M-2:EngineContextBinderAdminTest 补「userId 空串/空白/null 且 account 非 admin → false」用例。
- M-1:EngineContextBinder.isSystemAdmin javadoc 补时效性说明(userId/account 取自 JWT claim 签发快照,
  非实时查库;token 有效期内 admin 改名/停用/降权不即时生效,由 TTL/吊销兜底)。

测试(mvn -pl platform-flow-gateway,platform-auth -am test 全绿,既有零修改):
ProcessModelerControllerTest 6→10 / EngineContextBinderAdminTest 8→9 / FlowableClientTest 12 不变。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:03:59 +08:00
9cfef7e931 feat(flow+gateway): by-key 取最新版源 XML(修 process-select options=model 语义缺口)
live 验收发现:/api/process-select/options 在本库 143 项全部 source='model',
option.id=act_re_model id(非 procDefId)→ by-id source 端点永远 found:false;
option.key 才是真流程 key。补 by-key 姊妹端点,打开器改用 key 载入。

- flowable-service ProcessDiagramController:
  + GET /api/flow/process-definitions/by-key/{key}/source
    (processDefinitionKey(key).latestVersion().singleResult(),null→found:false)。
  by-id 与 by-key 逻辑抽共享私有 sourceResponse(procDefId, def),不复制粘贴;
  by-id 行为不变(仍以入参 procDefId 读部署 BPMN,既有 7 测试零修改)。
- 网关:FlowableClient.procDefSourceByKey(key)(uri 变量严格编码,禁拼接)
  + ProcessModelerController GET /api/workflow/process-definitions/by-key/{key}/source
    (同超管门,非超管 403)。by-id/by-key 段数不同无路由歧义。

测试(mvn -pl flowable-service,platform-flow-gateway,platform-auth -am test 全绿,既有零修改):
- ProcessDiagramControllerTest 7→9(+2:by-key 命中取最新版 v2 净化XML+idMap / key 不存在 found:false)
- FlowableClientTest 11→12(+1:纯中文 key「总包合同交底」uri 变量严格编码,断言 %E6%80%BB 且无裸中文)
- ProcessModelerControllerTest 4→6(+2:by-key 超管 200 透传 / 非超管 403 不触发下游)
- 三模块 Reactor 均 SUCCESS。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:59:04 +08:00
88ab0b8f0e docs(plan): 回写 T1.6 评审 M-3——T2.2 抽 requireSuperAdmin 统一过门 + 红线补「生产 8089 不对外」
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:55:38 +08:00
fdb97def4d docs(plan): 回写阶段1 live 发现——options source=model 语义缺口与 by-key 修法
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:54:10 +08:00
6d16206a08 feat(gateway): Modeler source 转发+超管门(中文 procDefId 编码硬验收)
阶段1 T1.6 代码部分:流程 Modeler 存量源 XML 经网关超管门载入。

- FlowableClient.procDefSource(procDefId):转发 GET /api/flow/process-definitions/{id}/source,
  procDefId 作为 uri 变量由 RestClient 严格编码(中文 percent、冒号→%3A),绝不字符串拼 URL(M-2)。
  走既有 execute() 重试/降级封装(连接级重试→503,4xx/5xx 透传)。
- ProcessModelerController GET /api/workflow/process-definitions/{procDefId}/source:
  超管门(EngineContextBinder.isSystemAdmin,非超管 403 {status:1,msg:"仅系统管理员可用"}),
  过门后透传下游返回体。flowable-service 裸 8089 无安全栈,超管门唯一落点在网关。
- EngineContextBinder.isSystemAdmin 由 private 提升为 public static + null 安全,供网关复用;
  判定口径不变(ADMIN 大小写不敏感去补白 / account 大小写敏感=admin / 含 admin 字样不误判)。

测试(mvn -pl platform-flow-gateway,platform-auth -am test 全绿,既有测试零修改):
- FlowableClientTest +2:中文 procDefId「总包合同交底:3:abc123」uri 变量严格编码(断言 %3A 且无裸中文)
  / 下游 4xx 透传 FlowRemoteException 不重试。共 11。
- ProcessModelerControllerTest 4:超管 200 透传 / 非超管 403 不触发下游 / 无身份 403 / 引擎不可达上抛。
- EngineContextBinderAdminTest 8:ADMIN 大小写·补白 / account=admin / Admin 变体不提权 / 含 admin 普通用户 / null。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:47:00 +08:00
14a825d0a0 docs(plan): 回写 T1.5 评审——T2.4 顺带补红线回归测试+canvas分支错误提示
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:43:12 +08:00
3ca082408c docs(plan): 回写 T1.4 评审 M-2——T1.6 中文 procDefId 编码为硬验收点(禁拼URL,测试+live 均须中文用例)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:34:25 +08:00
e5781ddd02 test(flow): source 端点补 ref 重写断言(评审 M-1)
中文 fixture 测试追加断言:sequenceFlow 的 sourceRef 引用须随 process id
一致重写,净化后 XML 不含 sourceRef="总包合同交底",让 ref 重写不白放。
ProcessDiagramControllerTest 7/7 绿(JDK21)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:34:22 +08:00
3927146f08 feat(flow): 按 procDefId 取净化源 XML 端点(含 idMap,D7 载入侧)
新增 GET /api/flow/process-definitions/{procDefId}/source:
createProcessDefinitionQuery 取 key/version + readProcessModel 取 BPMN
+ BpmnIdSanitizer.sanitize 净化中文 id → {found,bpmnXml,idMap,procDefKey,version}。
定义不存在 / XML 为空或读取异常 → {found:false}(HTTP 200,WARN log,防御性同 diagram 端点)。
idMap 透出原→净化映射,供发布时逆向还原原 key(D7)。

TDD:ProcessDiagramControllerTest +3 用例(净化XML+idMap+key版本 / 定义不存在
found:false / 读取异常 found:false),既有 4 用例零修改仍绿。
类 7/7、模块全量 71/71 绿(JDK21)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:27:46 +08:00
e361d3a9ad fix(flow): BpmnIdSanitizer 评审收口——safe占位契约测试+空白原样+inverse fail-fast
- I-1:补「生成净化 id 不与文档既有合法字面 id 冲突」契约测试。fixture 含合法字面
  id nb7af8 + 中文 id 审批(其 hashCode&0x7fffffff 的 hex 恰为 b7af8)→ 断言 审批 让位
  映射为 nb7af8-2、既有 nb7af8 不动、restore 逐字节还原。
- M-1:rewrite 未改值的属性原样回写(append group(0)),不再重构 → 不归一 id = "x" 这类
  等号周围空白,保逐字节契约。补测:带等号空白的合法属性 + 非空 map,round-trip 后原文不变。
- M-2:restore 反转 idMap 时检测净化 id 重复(非双射,损坏 metaInfo)抛 IllegalArgumentException,
  不再静默覆盖还原错。补 fail-fast 测试。

测试:BpmnIdSanitizerTest 7→10 例;ProcessDiagramControllerTest 4 例仍零修改;
flowable-service 全模块 mvn -pl flowable-service -am test = 68 测试 0 失败 0 错误。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:24:14 +08:00
33fccb6541 docs(plan): 回写 T1.3 评审 I-2——T3.1 部署前须处理 incoming/outgoing 文本引用(剥除或纳入 restore)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:22:57 +08:00
3cf58fe72c refactor(flow): id 净化抽 BpmnIdSanitizer,补可逆 restore+碰撞消解(D7 地基)
ProcessDiagramController.sanitizeBpmnIds 的中文 id→安全 ASCII 净化逻辑抽成
BpmnIdSanitizer(sanitize 返 Result{xml,idMap} / restore 逆向还原),为 D7「发布存量
流程 key 不变」打地基。

- 双射保证:同文档两个不同中文 id hash 碰撞时基名追加 -2/-3 序号,生成 id 亦不与既有
  合法 id 冲突;非碰撞场景净化输出与旧实现逐字节一致(查看器零回归)。
- restore 前缀安全:复用 ID_ATTR 正则逐属性值精确匹配,不裸 String.replace 子串替换
  (n1 不误伤 n1x);映射外 ASCII id(设计器新增节点)原样保留。
- ProcessDiagramController.sanitizeBpmnIds 改为委托,原包级签名/行为不变。

测试:新增 BpmnIdSanitizerTest 7 例(中文全引用面 restore 逐字节还原/撞哈希 中Aa~中BB
双射/restore n1~n1x 前缀安全/合法 NCName 不改写/混合只映射中文/空 XML 防御);
既有 ProcessDiagramControllerTest 4 例零修改仍绿;flowable-service 全模块 65 测试通过。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:10:47 +08:00
7a97b712b4 docs(plan): 回写 T1.2 实证——T1.3 净化 hash 有碰撞风险,可逆 restore 须双射消解
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:03:06 +08:00
90a6f97040 docs(plan): T1.1 评审 M-3 回写——T1.5 严禁引 Camunda provider(双包冲突变体)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 09:45:06 +08:00
f7d96489d0 docs(plan): 回写 T1.1 实证——双包冲突/嵌套全角【】/formKey裸UUID/moddle拒中文id
T1.1(eip4-web 8fdfe68)三发现防漂移回写:T1.5 只载 activiti 描述符(双载丢 userTask)+resolveJsonModule 提示;
T2.3 表达式 fixture 改嵌套全角形态(items 内层对象也是【】,content 尾部补白不可 trim);
§0 补 formKey=裸UUID + moddle 拒中文id 实证

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 09:38:19 +08:00
be9767cbe3 Merge docs/process-modeler-plan: B3 流程Modeler 实施计划
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 09:13:02 +08:00
6f5b1f7117 docs(plan): 在线流程Modeler(B3)实施计划——4阶段TDD任务
基于 06-26 design(D1-D9)+三路事实勘探(语料/后端/前端)合成:
- §0 事实基线:1512真实BPMN扩展面实测(11属性/5元素/中文key会签流)+后端(deploy无审计/sanitize单向/Model API零使用/网关超管判定现成)+前端(bpmn-js17已装/属性面板缺/admin门与测试范本)
- §0.5 计划级决策P1-P6:moddle自建vendored+语料双门/影响摘要节点级diff/3模板/草稿admin共见/EIP4控件走React侧板非preact/全量保真扫描做工具不进CI
- 阶段1 moddle保真+只读载入/阶段2 三控件+草稿/阶段3 发布门(校验+超管+同人确认+审计V4+id还原)/阶段4 新建+live e2e
- 验收清单8项+红线提醒(databaseSchemaUpdate=false/保真层不改/JDK解析器/部署门只落网关)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 09:13:02 +08:00
adae344323 docs: 核实修正——EIP-3.0 业务源码已在本地,P1③ 仅剩 S1 拍板一重阻塞
Some checks failed
ci / build-test-parity (push) Has been cancelled
用户指出 eip3 源码在当前目录:核实 ../EIP-3.0/(3.1G,pm/hr/oa/dm+framework)确已存在,
总览三处「源码未克隆/在远仓」表述过时修正;并核实当前 eip4 库(5433)=1512 真实 BPMN bytearray+1503 部署+143 act_re_model

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:58:18 +08:00
8091aaf7fa Merge docs/scrub-private-host-0702: 文档清除私有托管地址
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:29:30 +08:00
dd3b048899 docs: 清除私有托管地址,改中性表述(取码地址向负责人索取)
- 新人上手 §1:托管地址/clone 命令改 <GIT_HOST>:<OWNER> 占位,SSH 端口细节改「向负责人索取」
- 路线图/用户管理Delta/总览 三处历史记录行、.gitea/ci.yml 注释:host 名改「私有 Gitea/私有远程」
- 全仓 grep 验证零残留

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:29:30 +08:00
f01b7abda0 Merge docs/hosting-note-0702: 托管现状标注(私人库非团队库)
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:23:54 +08:00
0f153d658e docs: 标注托管现状——git.latent.chat 为私人 Gitea 非团队库
- 新人上手 §1 加警示:团队接手前需迁移团队代码托管或开通协作者账号,CI runner 应部署团队侧
- CONTRIBUTING CI 段补托管注记:workflow 为 Gitea Actions(GHA 兼容)语法,迁 GitHub 近乎原样复用,迁 GitLab/Jenkins 需转换

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:23:54 +08:00
cc5cb83500 Merge docs/team-onboarding-0702: 新人上手 + CONTRIBUTING
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:15:57 +08:00
2f97124ba1 docs: 新人上手一页纸 + CONTRIBUTING 协作约定(团队接手准备)
- docs/新人上手.md:第一天路径(前置软件/取码/构建/eip4dev/起服务/前端/必读序/高频坑/红线)
- CONTRIBUTING.md:分支命名/--no-ff 合并/提交格式/质量门(TDD+全 reactor 绿+作者评审分离+转换器重转重导)/CI 现状/文档归档纪律(两仓通用)
- docs/README.md §2 登记两份新文档

配套(仓外):工作区根 README 刷新至 07-02(原停 06-11);eip4-web README 联调指引修正另仓提交;两仓本地已合并分支清理(platform 40/web 7,含 ai-agent worktree)+远端 8 个已合并分支删除

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:15:57 +08:00
c6bfcebcad Merge docs/doc-alignment-0702: 文档-代码对抗核查对齐 + 归档整理 + 架构图入库
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:01:45 +08:00
1b02036153 docs+javadoc: 文档-代码对抗核查对齐 + 归档候选物理归档
5 路并行核对总览 §9/§10/§11 + A/B 矩阵声明 vs 两仓代码(48 条 46 条完全一致,无虚报),修正不一致处:
- A10 行 🔴→🟡:W1 Flyway(V1-V3)+W2-W4 容器化/nginx/compose 骨架 06-25 已合 main,文档此前低报;§10.2 Flyway/compose 两条标 ✅
- §9 P0② 表格「同族扩长」与对抗审查①矛盾(代码一律拒 TYPE 变更)改齐
- §10.2 render-plan 行号迁 AiDraftGateValidator.java:246(SRP 拆分后位置)
- §11 报表单测 73→79;§2「五步编排壳」改四步向导
- CandidateUsersHandler 类级 javadoc:scriptUser 已于 06-26 接入(resolveScriptUsers),删「WARN 降级未接入」陈旧表述(纯注释零行为变更)

归档整理(总览 §8 归档候选落地):
- 10 份已完成/被取代文档 git mv 入 docs/归档/(06-14×3/06-15/06-16/06-20 plans、CRUD-QA、C3/C5、总览-06-17)
- 引用同步改路径:README 索引、M0剩余项登记、通用模板收口计划、架构方向-design、新闻管理plan
- README 刷新至 07-02:补 06-22→06-26 增量一节、审批/报表行状态、§2 补登 06-25/06-26 四份 design/计划、§4 过时「未 push」表述修正

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:01:23 +08:00
b4baca5d94 docs: 架构图快照(2026-06-26)入库 + 生成式OS驾驶舱迁出指针存根
- 架构设计.md 头部挂当前架构图 assets/eip4-architecture-2026-06-26.png(此前改动遗留未提交)
- plans/2026-06-24-生成式OS数据驾驶舱-design.md 为指针存根,权威文档在独立仓 genos-cockpit

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:01:23 +08:00
1dd65b0142 Merge: 报表公司名改取系统配置 sys_application_config
Some checks failed
ci / build-test-parity (push) Has been cancelled
parity-nightly / nightly-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 13:01:10 +08:00
e63b3a3373 fix(report): 公司名改取系统配置 sys_application_config,不用静态 Spring 值
用户指正:报表抬头公司名应取系统配置的值。新增 ReportTemplateRepository.loadCompanyName() 读 sys_application_config[com.dsasp.server.organize.COMPANY](客户系统参数里维护的公司名,如「苏州第五建筑集团有限公司」);ReportController 优先用它,缺失才回退 eip4.report.company。部署无需额外配置,直接复用客户已维护的系统参数。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 13:01:10 +08:00
d87d0e2185 Merge: 办公用品采购报表修复(打印空白/审批意见/公司名占位) + dev 合库
Some checks failed
ci / build-test-parity (push) Has been cancelled
- 套打打印按选中行主键直接渲染(修195页单据打印空白)
- approve 默认记「同意」审批意见(供报表审批段显示)
- 注入配置公司名覆盖模板占位「XXXXXX公司」
- dev 数据源合并为单库 eip4(业务+流程同库,对齐生产单库拓扑;env 可覆盖)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:36:29 +08:00
3e642a8aae chore(dev): 本地 dev 数据源指向合并库 eip4(业务+流程同库)
把 eip4dev(业务)/eip4flow(流程)合并为单库 eip4,对齐生产单库拓扑,跨库报表(审批意见 act_hi_comment 等)可单连接直接 join。原分库保留作回滚。均经 SPRING_DATASOURCE_URL/FLOWABLE_JDBC_URL/BIZ_JDBC_URL 可覆盖。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:32:42 +08:00
3afc55817e fix(report): 注入配置公司名覆盖模板占位「XXXXXX公司」
报表抬头绑自定义参数 COMPANY(经 jatools =COMPANY 表达式,非 ${}宏),默认值是占位「XXXXXX公司」,EIP4 从不注入 → 显占位。新增 ReportParamGuard.applyConfiguredCompany():模板声明 COMPANY 时注入 eip4.report.company 配置值。部署设客户公司名即全报表生效。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:32:42 +08:00
0d952acc00 fix(approval): approve 默认记「同意」审批意见,供报表审批段显示
approve 原只在审批人手填意见时才写 act_hi_comment,且无默认前缀。报表审批段按 message LIKE '同意%' 匹配,故不填意见的审批在报表不显示。新增 agreeComment():空→"同意",有意见→"同意:意见",已带「同意」→原样,保证恒以「同意」开头。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:32:42 +08:00
5a5aedcbb7 fix(report): 套打打印按选中行主键直接渲染,修单据打印空白
navigation+reportnosearch 打印按钮原嵌报表查看器,报表唯一的主键选择字段被 F3-1 剔除,选中行主键到不了 /api/report/render → SQL 用设计期默认 ID(库内不存在) → 空白。改为读目标报表 <search> 真实参数名,弹窗直接 iframe 渲染并注入选中行同名列(${selectedItems[0].P})。覆盖 195 个打印页(参数 PK/ID/PROJECTID 各异)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 12:32:41 +08:00
d3ec7581fd Merge origin/main (报表进度文档更新) into Modeler 设计文档
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-26 09:42:45 +08:00
0cf6536a59 Merge docs/process-modeler-design: 在线流程 Modeler 设计文档 2026-06-26 09:42:06 +08:00
e0e92a88b4 docs: 在线流程 Modeler 设计(brainstorming 拍定 D1-D9)
在已有 bpmn-js 流程图查看器 + 现成 /api/flow/deploy 之上扩成可编辑 BPMN 流程设计器:
老流程可编辑改、新流程可创建、全 BPMN/flowable 流程属性 + EIP4 办理人/会签/formKey 定制叠加。
决策:改存量+新建 / 草稿+同人确认部署(超管+校验+审计) / 草稿存 act_re_model /
标准全属性面板+EIP4控件 / 完整 activiti moddle 保真零丢失 / id 可逆净化保流程key /
flowable 原生版本隔离 / v1 不含 DMN/CMMN/表单设计器。4 阶段交付。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 09:42:06 +08:00
ccb179d84a docs: 进度总览更新报表保真层 JOR 重宿主 + 安全/OOM 收口(§11 + A3 升 🟢)
Some checks failed
ci / build-test-parity (push) Has been cancelled
A3 报表系统由 🟠 升 🟢:套打 JOR 重宿主已完成 + 保真层安全/OOM 收口已完成;
新增 §11 记三批合入(e6c73a4/dccca17/d697885)的 SQLi门/IDOR/XXE/并发·字节·超时·
结果集封顶/CVE替换/只读数据源,含关键验证与仍开口项;§0 一句话进度补一行。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:54:01 +08:00
0ee919b89e Merge feat/approval-diagram-cjk-fix: BPMN 流程图净化中文 id(bpmn-js 渲染修复)+ 进度总览对齐
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-26 08:45:34 +08:00
9be0a39c0f docs: 进度总览 A2 流程审批优化 → 🟢(审批闭环批+xerces修复),B3/路线图对齐
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:45:25 +08:00
1be949cc04 fix(approval): BPMN 流程图净化中文 id,修 bpmn-js「no diagram to display」
UI 走查实证:迁移的 BPMN 常用中文做 process/diagram id(如「招投标工程评审流程」),
bpmn-js/moddle 的 NCName 校验拒非 ASCII id → 整图不渲染(illegal ID)。
ProcessDiagramController.sanitizeBpmnIds 把非法(非 ASCII NCName)id 及其所有引用
(id/bpmnElement/sourceRef/targetRef/...)一致重写为安全 ASCII id(稳定哈希),
只动 id/引用类属性、不碰 name(保中文节点名),并同步重映射当前/历史节点 id。
单测 ProcessDiagramControllerTest 4 绿;浏览器 live:25 形状渲染+当前节点绿高亮+中文标签正常。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:45:25 +08:00
c95eaee0a5 Merge feat/approval-closure: 审批闭环 P0(协办/转阅)+BPMN流程图+scriptUser会签+会签进度+xerces击穿修复(WfTemplate/Excel解析钉JDK)
Some checks failed
ci / build-test-parity (push) Has been cancelled
2026-06-26 08:29:29 +08:00
d697885df6 Merge: 报表 CVE 依赖替换(reload4j/cc3.2.2)+只读数据源(残留1/CVE),73单测+依赖树+live全绿
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:27:47 +08:00
98ce37c11b 报表保真层:CVE 依赖替换 + 报表只读数据源(残留1凭据/CVE 收口)
CVE(引擎 jar 不可改,但依赖可替换;已核实引擎 API 面):
- commons-collections 3.0 → 3.2.2:关 InvokerTransformer 反序列化 gadget(CVE-2015-7501)。
  引擎源码不直接引用,3.2.x 向后兼容,3.2.2 本地仓已有。
- log4j 1.2.8 → reload4j 1.2.25:drop-in,关 SocketServer/JMSAppender 等 RCE CVE。
  引擎仅用 org.apache.log4j.Logger / PropertyConfigurator,reload4j 同包同 API。
- 依赖树实证:仅 reload4j-1.2.25 + commons-collections-3.2.2 在 classpath,旧 log4j-eip3/
  commons-collections-eip3 已不再被解析(无传递回流)。

残留1(凭据外泄)收口(实测当前模板 0 处泄露,纵深防御):
- JatoolsConfig 报表连接改读 eip4.report.db.url/username/password,未配置回落 spring.datasource.*
  (向后兼容,默认零行为变化)。供配置独立的只读最小权账号 → 收口 SQLi/凭据外泄爆炸半径。
- docs/security/report-readonly-db-account.sql:只读账号 GRANT 脚本(default_transaction_read_only
  + statement_timeout + 仅 SELECT)。
- docs/security/credential-leak-scan.sql:巡检 type=200 模板把 property("DB...") 用在 <Connection>
  之外的可疑项(本库扫描 0 命中)。

验证:73单测全绿;依赖树+runtime classpath 实证替换生效;live(新 jar 8097)HTML/PDF 渲染=200、
无 ClassNotFound/log4j 错误;报表数据源 override(eip4.report.db.username)与 fallback 两条腿均实证。
注:bsh(jatools fork 不可换)/itext(只生成不解析 PDF,XXE 不可达)/xerces 2.6.2(XXE 已被前置
DOCTYPE 拒绝兜住)三项记录在案,不替换。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:27:47 +08:00
e8af5b0a74 fix(dataimport): Excel XML 解析钉到 JDK 解析器,绕开 report 带入的上古 xerces
与 WfTemplateService 同病:运行时 platform-app fat jar 含 platform-report 的
xerces-eip3.jar(2004),DataImportExcelParser.parseSpreadsheetXml 的
DocumentBuilderFactory.newInstance() 会选中它 → setFeature AbstractMethodError
击穿数据导入 Excel 解析。同法显式钉 JDK 内置 DocumentBuilderFactoryImpl。

DataImportExcelParserTest + 导入控制器测试 4 绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:25:29 +08:00
aae418653e fix(approval): WfTemplate XML 解析钉到 JDK 解析器,绕开 report 带入的上古 xerces
platform-report(jatools)依赖 com.dsasp.thirdparty:xerces:eip3(2004),被打进 platform-app
fat jar 后,classpath 发现机制让 DocumentBuilderFactory.newInstance() 选中它;该古董不实现
JAXP 1.4 的 setFeature → AbstractMethodError,击穿 gateway 全部 WfTemplate XML 解析
(approval-meta 对任何带 formKey 的审批任务 500,影响 approve/reject 按钮解析+会签进度)。

修法:WfTemplateService.parseXml 显式指定 JDK 内置实现
com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl(总在,实现 setFeature),
不删/不动 report 的 xerces。极端兜底回退默认发现。

live:修复后 gateway approval-meta 正常返回 buttonsSource=wftemplate;会签进度 0/3→1/3 实时更新。
(另记:platform-metadata DataImportExcelParser 同样 newInstance(),数据导入路径同病,另案。)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:21:41 +08:00
5c4894d40a feat(approval): 会签进度("已会签 N/M") — approval-context 多实例计数
- ApprovalContextDto(flowable + gateway)加 cosign/cosignTotal/cosignCompleted
- FlowController.approvalContext: fillCosign 沿执行树向上找带 nrOfInstances 的
  多实例根执行,读 nrOfInstances/nrOfCompletedInstances 回填
- gateway ApprovalController.approvalMeta 透传 cosign 字段
- 单测 FlowControllerTest 会签进度回填(22 绿);live(8089)实证 cosign:true 0/2

注:gateway 端 cosign 展示当前被 platform-report 引入的上古 xerces-eip3.jar(2004)
击穿 WfTemplate XML 解析所阻(AbstractMethodError on DocumentBuilderFactory.setFeature,
影响全部 approve/reject 按钮解析,非本改动引入,需在 report 模块侧隔离/排除该 xerces)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:19:09 +08:00
4f9e4abfc2 feat(approval): 审批闭环 P0/流程图/会签 — 协办转阅+BPMN图+scriptUser会签
承接 WfTemplate 数据驱动审批主链路(approve/reject/reback/agent 已 live),补齐缺口:

P0 协办(assist)/转阅(circulated):
- flowable-service 新增 POST /tasks/{id}/assist、/circulate(对齐老 ProcessCoreServiceImpl
  createSubTask/createNewTask:每人建独立任务,父任务记意见,不阻断主流程)
- gateway FlowableClient.assist/circulate + ApprovalController 把 assist/circulated 从 400 改真实分派
- 前端 ApprovalDrawer 多选人弹窗 MultiUserForm
- 对抗审查修复:独立任务沿 parentTaskId 回溯父任务取 businessKey/formKey(否则协办/转阅人
  看不到业务单据,且 processInstanceId(null) 崩 500);assist 父任务 404 守卫;MAX_FANOUT=50;
  @Transactional;转阅改 setFormKey 而非 description

P1 BPMN 流程图查看:
- flowable-service 新 ProcessDiagramController GET /process/{pi}/diagram
  (bpmnXml + 当前/历史活动节点,运行/历史双路取 procDefId,只读)
- gateway FlowableClient.diagram + TodoController 转发
- 前端 bpmn-js 渲染(中文走浏览器字体,当前节点绿/已走过灰),ApprovalDrawer 按需展开

P3 会签(BPMN 多实例):移植 CandidateUsersHandler 的 scriptUser(JUEL)候选人解析分支
(原"精简边界"WARN 降级,致招投标/总包合同/施工技术交底等用 ${APPLYUSERS} 的会签节点被跳过):
单变量直读流程变量 + 复杂表达式回退 flowable 表达式管理器 + 结果归一为去重 userId 列表

测试:flowable-service 56 + gateway 全模块 全绿;前端 tsc 干净 + vitest 83/83 + build。
live e2e(真 eip4flow):协办/转阅各 count:1 且子任务回溯出 businessKey/进目标用户待办;
流程图真 DI 实例渲染;会签起 3 并行任务/全票聚合推进。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:09:12 +08:00
dccca17314 Merge: 报表保真层残留2(maxResultBuffer结果集封顶)+残留4(逗号IN列表),73单测+JDBC探针+live全绿
Some checks failed
ci / build-test-parity (push) Has been cancelled
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:08:29 +08:00
b15acfa2f3 报表保真层:收口残留2(结果集OOM)+残留4(多值IN列表),续 feat/report-fidelity-security-hardening
- 残留2(结果集全量物化OOM):JatoolsConfig 给报表DB URL追加 pgjdbc maxResultBuffer(默认60p=最大堆60%,
  可配)。引擎用TYPE_SCROLL_INSENSITIVE整集物化,无此上限时海量结果集可在产出前OOM;设此值则驱动层超限
  抛PSQLException而非OOM。JDBC实证:同款scroll-insensitive查询over view_template(1516行/14.5MB),
  cap=null读全表;cap=100/10k/1m分别在对应字节数抛"Result set exceeded maxResultBuffer limit"。
- 残留4(多值IN列表被误拒):isSafeValue允许逗号——真实模板有 in (${WELFARECATEGORYID})/in (${SCHEMEITEM})
  多值列表。逗号安全:UNION/子查询/注释/堆叠仍需空格/括号/引号/分号(均被拒),逗号单独无法构成注入。
  live:?WELFARECATEGORYID=1,2,3 渲染200(不再400)。

验证:73单测全绿(TDD,+4);live(8095默认60p正常render=200;8096 cap注入URL实证;逗号IN列表=200);
maxResultBuffer机制经独立JDBC探针在同一scroll-insensitive代码路径上证实超限即抛。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-26 08:08:20 +08:00
75 changed files with 6648 additions and 104 deletions

View File

@@ -1,6 +1,6 @@
# eip4-platform CI(Gitea Actions)。 # eip4-platform CI(Gitea Actions)。
# #
# P0 修复(2026-06-24 架构评审):原 .github/workflows/ci.yml 在 Gitea(git.latent.chat)上是孤儿 # P0 修复(2026-06-24 架构评审):原 .github/workflows/ci.yml 在私有 Gitea 上是孤儿
# (GitHub Actions 不会跑),且 java-version 写死 17(项目 JDK21)。本文件迁到 Gitea 规范位置 # (GitHub Actions 不会跑),且 java-version 写死 17(项目 JDK21)。本文件迁到 Gitea 规范位置
# .gitea/workflows/,JDK 升 21。 # .gitea/workflows/,JDK 升 21。
# #

39
CONTRIBUTING.md Normal file
View File

@@ -0,0 +1,39 @@
# 贡献约定(eip4-platform / eip4-web 通用)
> 新人先读 `docs/新人上手.md`(环境)与 `docs/架构设计.md`(红线)。本文只讲协作流程。
## 分支与合并
- **main 不直接提交功能代码**;从 main 拉分支,前缀语义:`feat/`、`fix/`、`docs/`、`chore/`、`deploy/` + 短横线主题(如 `feat/approval-closure`)。
- 完成后 **`--no-ff` 合回 main 并 push**(保留合并节点,按批次可回溯),或走 Gitea Web UI 发 PR。合并后**删除本地/远端特性分支**。
- 一个分支一个主题;跨仓联动改动(platform+web)用同名分支便于对照。
## 提交信息
- 格式:`type(scope): 中文摘要`(如 `fix(report): 套打打印按选中行主键直接渲染`)。
- 正文写清:做了什么 / 为什么 / **验证证据**(单测数、live e2e 结论)。没验证的事不写「已完成」。
## 质量门(合并前自查清单)
1. **TDD**:新功能/修 bug 先写测试看它红,再实现变绿;禁止事后补「恒绿」测试。
2. **后端**:改动模块 `mvn -pl <模块> -am test` 绿;合并前全 reactor `mvn clean install` 绿(含 ArchUnit 边界规则)。
3. **前端**:`tsc -b` 干净 + `npx vitest run` 绿 + `npm run build` 成功。
4. **作者/评审分离**:合并前过一遍独立 code review(他人或 agent 对抗评审);涉及鉴权/SQL/脚本执行/DDL 的改动**必须加安全评审**。
5. **转换器改动**:重转重导后在运行库 live 验证(浏览器真渲染,不止单测),再合并。
6. **保真层改动**:默认禁止重写;确需改(如安全修)须登记 `docs/迁移手册.md` 并跑对拍回归。
## CI
- `.gitea/workflows/ci.yml`(构建+测试)与 `parity-nightly.yml`(夜间对拍)已就位,**待注册 runner 后生效**。
- runner 生效前,合并到 main 前请手跑 `bash scripts/ci.sh` 等价把关。
- **托管注记**:当前远端为私人 Gitea(见 `docs/新人上手.md` §1 警示)。workflow 是 Gitea Actions(GHA 兼容)语法——若迁 GitHub 可近乎原样复用(挪到 `.github/workflows/`),迁 GitLab/Jenkins 需转换;团队化后 runner 应部署在团队基础设施。
## 文档纪律
- 进度只回写 `docs/项目进度与路线-总览-*.md`(唯一权威);README 索引随之更新。
- 一次性 plan/报告完成后 `git mv` 入 `docs/归档/`,并同步改所有引用路径(grep 验证零断链)。
- 文档声明「已完成」必须附 git 证据(commit/merge 哈希)。
## 红线速查(详见 docs/架构设计.md 与 docs/新人上手.md §6)
JDK 21(严禁 26)|保真层不重写不改包名|DDL 走守卫单点|Flowable 不自动改表|AI 恒人审、对外严禁承诺全自动开发|amis 锁 6.13.0 本地 SDK。

View File

@@ -1,5 +1,6 @@
# EIP4 单源托管(A10 W3)。挂载为 nginx:alpine 的 /etc/nginx/conf.d/default.conf。 # EIP4 单源托管(A10 W3)。挂载为 nginx:alpine 的 /etc/nginx/conf.d/default.conf。
# 一个源:静态 SPA(eip4-web/dist)+ 反代 /api→platform-app、/flowable→flowable-service。 # 一个源:静态 SPA(eip4-web/dist)+ 反代 /api→platform-app(唯一后端入口)。
# flowable-service:8089 无鉴权,绝不经 nginx 对外(见下 /flowable/ 说明)。
# 消除 dev 的 vite proxy 依赖;切流灰度(W6)可在此用 upstream 权重双跑(eip3↔eip4)。 # 消除 dev 的 vite proxy 依赖;切流灰度(W6)可在此用 upstream 权重双跑(eip3↔eip4)。
server { server {
listen 80; listen 80;
@@ -22,12 +23,14 @@ server {
proxy_read_timeout 130s; # 略大于 statement_timeout(120s),避免反代先于 DB 超时切断 proxy_read_timeout 130s; # 略大于 statement_timeout(120s),避免反代先于 DB 超时切断
} }
# 工作流引擎(按需直达;多数流程经 platform-app 网关,故默认收窄) # 🔴 工作流引擎(flowable-service:8089)绝不对外暴露。
# flowable-service 进程无 Spring Security,鉴权唯一落点=platform-app 网关的超管门
# (ProcessModelerController.requireSuperAdmin);裸直达 8089 会绕过所有鉴权,
# 匿名即可部署/覆盖生产 BPMN、办结/终止任意任务(安全评审 Critical#1)。
# 前端只经 /api/workflow/*(网关)访问流程能力,不需要 /flowable/ 直达。
# 若确需内网调试直达,改为 `internal;` 仅供内部子请求,严禁对公网 proxy_pass。
location /flowable/ { location /flowable/ {
proxy_pass http://flowable-service:8089/; return 404;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
} }
# 静态资源:带 hash 的构建产物可长缓存 # 静态资源:带 hash 的构建产物可长缓存

View File

@@ -159,9 +159,9 @@ ls -la /opt/eip3/reports/ 2>/dev/null || echo "路径待确认"
|---|------|------|---------|---------|---------|--------| |---|------|------|---------|---------|---------|--------|
| C1 | **逐行对拍框架**:旧系统 SQL 录制切面 + 新引擎结果集逐行 diff | 后端架构(老员工)| ≥20 个代表性实体逐行一致率 100% | 🟢 **完成(客户库口径,2026-06-11)**:框架四件套落地 platform-parity;本地自举 21 实体/1,108 行 100% 后,客户库真实数据 **24/24 实体通过(23 全量 442,529 行 + PM_PAYMENTAPPLY 抽样 2,000 行),零未解释差异**;首轮 6/24 经四类归因迭代修 harness 达成(计算列/复合键/null 省略/布尔域/COLUMNSQL,均元数据感知、可见不判负);单测 23/23 | `eip4-platform/platform-parity/C1实测报告.md`(含客户库口径节+归因台账);`parity-reports/` | 「新 vs 旧系统」录制重放对拍待旧系统环境(切面交付物已就绪);PM_PAYMENTAPPLY 全量(约 78 分钟)列夜间批跑待办 | | C1 | **逐行对拍框架**:旧系统 SQL 录制切面 + 新引擎结果集逐行 diff | 后端架构(老员工)| ≥20 个代表性实体逐行一致率 100% | 🟢 **完成(客户库口径,2026-06-11)**:框架四件套落地 platform-parity;本地自举 21 实体/1,108 行 100% 后,客户库真实数据 **24/24 实体通过(23 全量 442,529 行 + PM_PAYMENTAPPLY 抽样 2,000 行),零未解释差异**;首轮 6/24 经四类归因迭代修 harness 达成(计算列/复合键/null 省略/布尔域/COLUMNSQL,均元数据感知、可见不判负);单测 23/23 | `eip4-platform/platform-parity/C1实测报告.md`(含客户库口径节+归因台账);`parity-reports/` | 「新 vs 旧系统」录制重放对拍待旧系统环境(切面交付物已就绪);PM_PAYMENTAPPLY 全量(约 78 分钟)列夜间批跑待办 |
| C2 | 数据权限最小真实现替换桩,纳入对拍样本 | 后端 | ≥3 个行级过滤实体对拍通过 | 🟢 **完成**:framework 原版 DataPrivilegeServiceImpl/DataFilterHelper 原样移植(Jackson 1.x 共存),删桩;3 受控实体×3 用户 **9/9 正例 150 行 100% 一致 + 3/3 负例 PrivilegeException 拒绝**,全量回归 21/21;单测 9/9(独立复跑确认);ROLES 多值=LIST+中间表机制已查明并入手册 §5.8 | `eip4-platform/platform-auth/C2实测报告.md`;`platform-parity/parity-reports/privilege-parity-*.{json,md}` | P2 在 platform-auth 做组织/权限整体真实现(本实现即原版语义底座) | | C2 | 数据权限最小真实现替换桩,纳入对拍样本 | 后端 | ≥3 个行级过滤实体对拍通过 | 🟢 **完成**:framework 原版 DataPrivilegeServiceImpl/DataFilterHelper 原样移植(Jackson 1.x 共存),删桩;3 受控实体×3 用户 **9/9 正例 150 行 100% 一致 + 3/3 负例 PrivilegeException 拒绝**,全量回归 21/21;单测 9/9(独立复跑确认);ROLES 多值=LIST+中间表机制已查明并入手册 §5.8 | `eip4-platform/platform-auth/C2实测报告.md`;`platform-parity/parity-reports/privilege-parity-*.{json,md}` | P2 在 platform-auth 做组织/权限整体真实现(本实现即原版语义底座) |
| C3 | Top 10 高频实体基础压测 + 慢查询采样 | 后端 + 架构 | 输出 P95 延迟基线文档 | 🟢 **完成(双口径,2026-06-11)**:本地自举基线 + 客户库真实数据基线(9 实体含 34k 行大表与复杂视图,0 错误)。**关键发现:首页延迟与表行数强相关(22ms→1.18s→4.6s)**,定位 DDL 索引/参数化/流式三个改造点的优先验证实体;为风险 R2 提供真实锚点 | `eip4-platform/docs/C3压测基线.md`(双口径+归因);JSON 在 `eip4-platform/tools/loadtest/` | 真实 Top10 待生产访问日志;正式 SLA 锚点待隔离准生产环境复测 | | C3 | Top 10 高频实体基础压测 + 慢查询采样 | 后端 + 架构 | 输出 P95 延迟基线文档 | 🟢 **完成(双口径,2026-06-11)**:本地自举基线 + 客户库真实数据基线(9 实体含 34k 行大表与复杂视图,0 错误)。**关键发现:首页延迟与表行数强相关(22ms→1.18s→4.6s)**,定位 DDL 索引/参数化/流式三个改造点的优先验证实体;为风险 R2 提供真实锚点 | `eip4-platform/docs/归档/C3压测基线.md`(双口径+归因);JSON 在 `eip4-platform/tools/loadtest/` | 真实 Top10 待生产访问日志;正式 SLA 锚点待隔离准生产环境复测 |
| C4 | S3 脚本正则改写器原型在真实脚本上实测自动化率 | 后端 | 自动化率 ≥80% 锁定 P4 预算;<80% 按保守口径重估 | 🟢 **完成(真实库口径,2026-06-11)**:全量 1,427 条实测,S3=612,自动化率 **81.2%(497/612)≥80% 预算线锁定**;31 条规则、单测 105/105、0 误改、硬 S3 85 条判定未放松(独立复跑确认)。教训:合成语料首测仅 7.1%,经 5 轮真实语料模式挖掘迭代达标——「文档模式 ≠ 真实写法」已记入报告附录 A | `eip4-platform/tools/s3_rewriter/C4实测报告.md`;`eval-real-20260611-final.json` | 剩余 115 条(PARTIAL 30+HARD 85)人工处理预算 0.5–1 人月(盘点口径内,上界 2.8 人月) | | C4 | S3 脚本正则改写器原型在真实脚本上实测自动化率 | 后端 | 自动化率 ≥80% 锁定 P4 预算;<80% 按保守口径重估 | 🟢 **完成(真实库口径,2026-06-11)**:全量 1,427 条实测,S3=612,自动化率 **81.2%(497/612)≥80% 预算线锁定**;31 条规则、单测 105/105、0 误改、硬 S3 85 条判定未放松(独立复跑确认)。教训:合成语料首测仅 7.1%,经 5 轮真实语料模式挖掘迭代达标——「文档模式 ≠ 真实写法」已记入报告附录 A | `eip4-platform/tools/s3_rewriter/C4实测报告.md`;`eval-real-20260611-final.json` | 剩余 115 条(PARTIAL 30+HARD 85)人工处理预算 0.5–1 人月(盘点口径内,上界 2.8 人月) |
| C5 | amis 6.13.0 fork 可行性预演(独立构建通过)| 前端 | 构建产物可替换 CDN 版本运行 | 🟢 **完成**:Node 22 全量构建成功(按拓扑序逐包构建),sdk.js 2.0MB 含 amisRequire,本地冒烟通过;**止损 S2 不触发** | `eip4-platform/docs/C5构建预演报告.md`;产物 `static/sdk-local/` + `amis-local.html` | — | | C5 | amis 6.13.0 fork 可行性预演(独立构建通过)| 前端 | 构建产物可替换 CDN 版本运行 | 🟢 **完成**:Node 22 全量构建成功(按拓扑序逐包构建),sdk.js 2.0MB 含 amisRequire,本地冒烟通过;**止损 S2 不触发** | `eip4-platform/docs/归档/C5构建预演报告.md`;产物 `static/sdk-local/` + `amis-local.html` | — |
| — | **老员工知识转移**:PoC 坑位记录整编为《迁移手册》v1 | 老员工 + 架构 | 手册过评审,backup 人选确定 | 🟡 **进行中** | `eip4-platform/docs/迁移手册.md`(本批交付)| backup 人选待确定(项目负责人决策)| | — | **老员工知识转移**:PoC 坑位记录整编为《迁移手册》v1 | 老员工 + 架构 | 手册过评审,backup 人选确定 | 🟡 **进行中** | `eip4-platform/docs/迁移手册.md`(本批交付)| backup 人选待确定(项目负责人决策)|
| — | **153 定制视图处置清单**(重写/降级/留旧三分)| 项目负责人 | 决策会开放项,2 周限期 | 🟡 **进行中** | `153定制视图处置清单v1.md`(本批交付,初判底稿)| 需客户库 SQL 拉取完整列表 + 老员工终判 | | — | **153 定制视图处置清单**(重写/降级/留旧三分)| 项目负责人 | 决策会开放项,2 周限期 | 🟡 **进行中** | `153定制视图处置清单v1.md`(本批交付,初判底稿)| 需客户库 SQL 拉取完整列表 + 老员工终判 |
| — | **JOR 报表布局客户环境清点** | 交付团队 | 报表 C 类预算锁定 | 🔴 **未开始**(需客户环境访问)| — | 客户环境网络访问权限;执行方案见本文档第一节 | | — | **JOR 报表布局客户环境清点** | 交付团队 | 报表 C 类预算锁定 | 🔴 **未开始**(需客户环境访问)| — | 客户环境网络访问权限;执行方案见本文档第一节 |

View File

@@ -1,6 +1,6 @@
# EIP4 迁移项目 — 文档索引与状态总览 # EIP4 迁移项目 — 文档索引与状态总览
> 维护日期:2026-06-21 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。 > 维护日期:2026-07-02 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。
> >
> **进度权威看这份**:`项目进度与路线-总览-2026-06-21.md`(A/B 矩阵 + 06-17→06-21 增量交付 + 下一步 + 待拍板决策)。本 README 只做「文档地图 + 模块完成度」,进度细节以总览为准。 > **进度权威看这份**:`项目进度与路线-总览-2026-06-21.md`(A/B 矩阵 + 06-17→06-21 增量交付 + 下一步 + 待拍板决策)。本 README 只做「文档地图 + 模块完成度」,进度细节以总览为准。
> >
@@ -8,12 +8,14 @@
--- ---
## 0. 一句话现状(2026-06-21) ## 0. 一句话现状(2026-07-02)
**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制① / 元数据+写真相门禁);**A 兼容线**纵向「按模块做到 parity 验收」目前只有「用户管理」1 个完成,framework 其余约 38 视图待写、**业务 106 视图是最大未动块**;**B 新能力线本期破局**——「人走五环建新功能」低代码平台 v1 全链交付合 main、设计器选型(amis-editor)拍板 + DesignerPage 全闭环、AI 确定性五环生产线合 main。仍在 dev,生产上线(A10)未起步。 **横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制① / 元数据+写真相门禁);**A 兼容线**纵向「按模块做到 parity 验收」目前只有「用户管理」1 个完成,framework 其余约 38 视图待写、**业务 106 视图是最大未动块**;**B 新能力线本期破局**——「人走五环建新功能」低代码平台 v1 全链交付合 main、设计器选型(amis-editor)拍板 + DesignerPage 全闭环、AI 确定性五环生产线合 main。仍在 dev;**A10 MVP 骨架(Flyway + 容器化/nginx/compose)已合 main(06-25),切流未执行**。
> **06-17→06-21 增量**(详见总览 §2):人走五环后端全链 + 前端编排壳/建模器、DesignerPage 闭环(解除 P1 头号阻塞)、主子表四件套、AI 五环生产线合 main + 写路径对齐、附件双态、framework P2 移植一批。两仓 origin/main 已 push(platform `75f942b` / web `d1fd6ed`)。 > **06-17→06-21 增量**(详见总览 §2):人走五环后端全链 + 前端编排壳/建模器、DesignerPage 闭环(解除 P1 头号阻塞)、主子表四件套、AI 五环生产线合 main + 写路径对齐、附件双态、framework P2 移植一批。两仓 origin/main 已 push(platform `75f942b` / web `d1fd6ed`)。
> **06-22→06-26 增量**(详见总览 §10/§11 与 A2/A3 行):安全基线 P0 全收口(RCE/fail-open/asUser 越权/CI 孤儿 + 2 孪生 + Groovy 沙箱,platform `eba9ce1` / web `2a37251`);报表 A3 JOR 重宿主 + 安全/OOM 收口 🟢(总览 §11);审批闭环补齐(协办/转阅/BPMN 流程图/会签/会签进度,`c95eaee`);A10 W1-W4 骨架(Flyway `f7675c9` + deploy `97a0eb1`);稳定性三件套 + actuator + ArchUnit 6 条 + AiAgentService SRP 拆分;G1-G3 外部 agent 接入(`eip4 init`/platform-mcp/7 skills);在线流程 Modeler design 拍定 D1-D9(`d3ec758`)。06-26 后至 07-02 无代码增量(本次为文档对齐与归档)。
--- ---
## 1. 模块完成度(诚实口径) ## 1. 模块完成度(诚实口径)
@@ -31,13 +33,13 @@
| 元数据/平台工具 | 数据导入配置 / 定时任务「设置提醒人」 | 🟡 | `DataImportConfigController` / `ScheduleJobNotifyController` 已落(c9e4d35);调度运行时未起步 | | 元数据/平台工具 | 数据导入配置 / 定时任务「设置提醒人」 | 🟡 | `DataImportConfigController` / `ScheduleJobNotifyController` 已落(c9e4d35);调度运行时未起步 |
| 元数据/平台工具 | 脚本编辑器 / 工作日历 | 🟡 | framework P2 批次已移植(57c3412…d218c2b) | | 元数据/平台工具 | 脚本编辑器 / 工作日历 | 🟡 | framework P2 批次已移植(57c3412…d218c2b) |
| 元数据/平台工具 | 功能模板下载 / 实体分类-枚举组 | ✅ | 已核对验收 | | 元数据/平台工具 | 功能模板下载 / 实体分类-枚举组 | ✅ | 已核对验收 |
| 流程/审批 | 待办/已办/我发起的任务 | 🟡 | 列表/查看/处理抽屉/审批历史抽屉已浏览器验收;缺最终同意/拒绝点击验、列表入口按钮接线 | | 流程/审批 | 待办/已办/我发起的任务 | 🟡→✅ | 列表/查看/处理抽屉/审批历史抽屉已验收;列表入口接线已 live(228 页 openApprovalDrawer);协办/转阅/会签/会签进度/approve 默认「同意」意见 06-26 补齐。剩客户 BPMN 真实流转(外部前置①) |
| 流程/审批 | 查看审批/流程监控/流程定义/BPMN 图 | ❌🟠 | 监控部分移植;流程定义 = Flowable Modeler 另案(B3);客户 BPMN 部署 = 前置① | | 流程/审批 | 查看审批/流程监控/流程定义/BPMN 图 | 🟡 | 监控(撤回/结束/高级)已 live;BPMN 流程图**查看**已做(ProcessDiagramController + bpmn-js,中文 id 净化);流程定义**编辑**=Modeler 另案(B3,design 已拍定 D1-D9);客户 BPMN 部署=前置① |
| 消息/邮件 | 收到/已发送消息、短消息 | 🟠→🟡 | 短消息发送 + 消息详情已移植(16393c1 等);已读联动未接 | | 消息/邮件 | 收到/已发送消息、短消息 | 🟠→🟡 | 短消息发送 + 消息详情已移植(16393c1 等);已读联动未接 |
| 消息/邮件 | 电子邮件全家桶(webmail) | ❌ | 独立子系统,另案立项(A5) | | 消息/邮件 | 电子邮件全家桶(webmail) | ❌ | 独立子系统,另案立项(A5) |
| picker 控件 | 用户选择框×4 / 流程选择框 | 🟡 | 已切回标准 amis `picker`(单/多选靠 `multiple`),数据源 `/api/picker/<dialogid>/list`;流程选择框接 `transfer-picker`。已烟测,待真实业务保存/权限验收 | | picker 控件 | 用户选择框×4 / 流程选择框 | 🟡 | 已切回标准 amis `picker`(单/多选靠 `multiple`),数据源 `/api/picker/<dialogid>/list`;流程选择框接 `transfer-picker`。已烟测,待真实业务保存/权限验收 |
| 日志/历史 | 系统日志/登录历史 | 🟡 | 删除按钮组 + real-first 列表 + 时间段过滤已通;剩登录操作列表此库缺视图 | | 日志/历史 | 系统日志/登录历史 | 🟡 | 删除按钮组 + real-first 列表 + 时间段过滤已通;剩登录操作列表此库缺视图 |
| 其它 bespoke | 个人设置/工作日历/报表 | 🟠❌ | 工作日历已移植;个人设置/报表(A3)未起步 | | 其它 bespoke | 个人设置/工作日历/报表 | 🟠→🟢 | 工作日历已移植;**报表 A3 已完成**(JOR 重宿主 + 安全/OOM 收口,总览 §11);个人设置未起步 |
> framework 定制视图共 46 个,逐视图清单见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog),当前执行队列见 **`framework定制视图-TODO-2026-06-17.md`**(活清单·三态)。 > framework 定制视图共 46 个,逐视图清单见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog),当前执行队列见 **`framework定制视图-TODO-2026-06-17.md`**(活清单·三态)。
@@ -66,11 +68,18 @@
| 文档 | 用途 | | 文档 | 用途 |
|---|---| |---|---|
| **`项目进度与路线-总览-2026-06-21.md`** | **全项目进度权威**:A/B 矩阵 + 增量交付 + 下一步 + 待拍板决策 | | **`项目进度与路线-总览-2026-06-21.md`** | **全项目进度权威**:A/B 矩阵 + 增量交付 + 下一步 + 待拍板决策 |
| `新人上手.md` | 新成员第一天路径(环境→起服务→验证→必读序→高频坑→红线) |
| `../CONTRIBUTING.md` | 分支/合并/提交/质量门/文档纪律约定(两仓通用) |
| `架构设计.md` | 双层制架构 / 工程结构 / 选型 / 红线(架构基线) | | `架构设计.md` | 双层制架构 / 工程结构 / 选型 / 红线(架构基线) |
| `迁移手册.md` | 双层制纪律 + 踩坑四栏制(知识转移手册) | | `迁移手册.md` | 双层制纪律 + 踩坑四栏制(知识转移手册) |
| `plans/2026-06-19-EIP4开发平台-架构方向-design.md` | 开发平台方向级 design(锁定 D1-D7) | | `plans/2026-06-19-EIP4开发平台-架构方向-design.md` | 开发平台方向级 design(锁定 D1-D7) |
| `plans/2026-06-20-人走五环建新功能-NocoBase式-design.md` | 主特性「人走五环」设计定型 | | `plans/2026-06-20-人走五环建新功能-NocoBase式-design.md` | 主特性「人走五环」设计定型 |
| `plans/2026-06-19-EIP4开发平台-落地执行路线图.md` | 活路线图(M0-M8,状态随里程碑回写) | | `plans/2026-06-19-EIP4开发平台-落地执行路线图.md` | 活路线图(M0-M8,状态随里程碑回写) |
| `plans/2026-06-25-A10-生产上线工程化-design.md` | A10 生产化 design(D1-D6 待拍板;W1-W4 骨架已合 main) |
| `plans/2026-06-25-报表迁移-JOR引擎重宿主-design.md` | 报表 A3 设计(Phase1-3 已完成 + 安全收口,总览 §11) |
| `plans/2026-06-25-审批闭环-实施计划.md` | 审批闭环 P0-P3(已实施合 main `c95eaee`,剩外部前置) |
| `plans/2026-06-26-在线流程Modeler-design.md` | B3 流程 Modeler 设计(D1-D9 拍定) |
| `plans/2026-07-02-在线流程Modeler-实施计划.md` | B3 实施计划(4 阶段 17 任务 **全完成合 main 2026-07-02**;含语料/代码勘探基线 + 计划级决策 + 每阶段 live 验收发现 + 双对抗评审处置) |
| `AI_AGENT_AUTO_DEVELOPMENT.md` + `AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md` / `AI_AGENT_REPAIR_CONTRACT.md` / `AI_AGENT_Nocobase_ADOPTION_PLAN.md` + `skills/` | AI Agent 对外口径红线 + 编译/修复/采纳契约 + Skills 目录 | | `AI_AGENT_AUTO_DEVELOPMENT.md` + `AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md` / `AI_AGENT_REPAIR_CONTRACT.md` / `AI_AGENT_Nocobase_ADOPTION_PLAN.md` + `skills/` | AI Agent 对外口径红线 + 编译/修复/采纳契约 + Skills 目录 |
| `framework定制视图-TODO-2026-06-17.md` | A 兼容线**活清单**(Done/In-Progress/待验三态),每次修完回写 | | `framework定制视图-TODO-2026-06-17.md` | A 兼容线**活清单**(Done/In-Progress/待验三态),每次修完回写 |
| `framework定制视图-engineclass移植backlog-2026-06-17.md` | 46 framework 视图迁移**主 backlog**(verdict/移植项/优先级) | | `framework定制视图-engineclass移植backlog-2026-06-17.md` | 46 framework 视图迁移**主 backlog**(verdict/移植项/优先级) |
@@ -91,15 +100,15 @@
| 文档 | 状态 | 备注 | | 文档 | 状态 | 备注 |
|---|---|---| |---|---|---|
| `项目进度与路线-总览-2026-06-21` | 现行·权威 | 进度唯一入口 | | `项目进度与路线-总览-2026-06-21` | 现行·权威 | 进度唯一入口 |
| `项目进度与路线-总览-2026-06-17` | 已被取代 | 被 06-21 总览取代(顶部已加横幅) | | `归档/项目进度与路线-总览-2026-06-17` | 已归档(07-02) | 被 06-21 总览取代 |
| `README.md`(本文) | 现行·权威 | 文档地图 + 模块完成度 | | `README.md`(本文) | 现行·权威 | 文档地图 + 模块完成度 |
| `架构设计`、`迁移手册` | 现行·权威 | 架构基线 | | `架构设计`、`迁移手册` | 现行·权威 | 架构基线 |
| `plans/2026-06-19-EIP4开发平台-架构方向-design` | 现行·权威 | 方向 D1-D7 | | `plans/2026-06-19-EIP4开发平台-架构方向-design` | 现行·权威 | 方向 D1-D7 |
| `plans/2026-06-20-人走五环建新功能-NocoBase式-design` | 现行·权威 | 主特性设计 | | `plans/2026-06-20-人走五环建新功能-NocoBase式-design` | 现行·权威 | 主特性设计 |
| `plans/2026-06-19-EIP4开发平台-落地执行路线图` | 现行·活路线图 | 里程碑状态已回写本期进展 | | `plans/2026-06-19-EIP4开发平台-落地执行路线图` | 现行·活路线图 | 里程碑状态已回写本期进展 |
| `plans/2026-06-20-人走五环建新功能-实施计划` | 现行(执行已收尾) | 24 TDD 任务全完成 + 合 main(顶部已加横幅) | | `归档/2026-06-20-人走五环建新功能-实施计划` | 已归档(07-02) | 24 TDD 任务全完成 + 合 main |
| `AI_AGENT_AUTO_DEVELOPMENT` / `PAGE_BLUEPRINT_CONTRACT` / `REPAIR_CONTRACT` / `Nocobase_ADOPTION_PLAN` / `Nocobase_SOURCE_REVIEW` | 现行·权威 | AI 契约族;前 4 份正文个别过时点已加横幅 | | `AI_AGENT_AUTO_DEVELOPMENT` / `PAGE_BLUEPRINT_CONTRACT` / `REPAIR_CONTRACT` / `Nocobase_ADOPTION_PLAN` / `Nocobase_SOURCE_REVIEW` | 现行·权威 | AI 契约族;前 4 份正文个别过时点已加横幅 |
| `skills/`(eip4-ai-feature-development / env-manage / release-manage) | 现行·权威 | AI Agent Skills 目录 | | `skills/`(7 份:ai-feature-development / data-modeling / page-recipe / acl-manage / amis-pitfalls / env-manage / release-manage) | 现行·权威 | AI Agent Skills 目录(`eip4 init` 渲染分发,G1/G3) |
| `framework定制视图-TODO-2026-06-17` | 现行·活清单 | 执行队列 | | `framework定制视图-TODO-2026-06-17` | 现行·活清单 | 执行队列 |
| `framework定制视图-engineclass移植backlog-2026-06-17` | 现行·权威 | framework 主 backlog(开头有 agent 思考噪声待清) | | `framework定制视图-engineclass移植backlog-2026-06-17` | 现行·权威 | framework 主 backlog(开头有 agent 思考噪声待清) |
| `用户管理-Delta移植-…-2026-06-17` | 现行·权威 | 方法论 + 交接 | | `用户管理-Delta移植-…-2026-06-17` | 现行·权威 | 方法论 + 交接 |
@@ -107,13 +116,8 @@
| `通用模板全类型可用性-…-2026-06-16` | 现行 | 通用模板线(§七运行库现状需复核) | | `通用模板全类型可用性-…-2026-06-16` | 现行 | 通用模板线(§七运行库现状需复核) |
| `客户沟通清单v1` | 现行 | 商务线(部分卡点随本期交付已消解) | | `客户沟通清单v1` | 现行 | 商务线(部分卡点随本期交付已消解) |
| `决策与盘点/`(架构决策报告/会纪要/客户库盘点/源码预核查/报表迁移方案/EIP4前端实施计划) | 现行·权威 + 历史盘点混放 | 决策报告/会纪要 = 现行权威红线来源;06-10 一次性盘点报告(源码预核查/客户库盘点/报表迁移方案)= 历史 | | `决策与盘点/`(架构决策报告/会纪要/客户库盘点/源码预核查/报表迁移方案/EIP4前端实施计划) | 现行·权威 + 历史盘点混放 | 决策报告/会纪要 = 现行权威红线来源;06-10 一次性盘点报告(源码预核查/客户库盘点/报表迁移方案)= 历史 |
| `plans/2026-06-14-onEvent脚本挂回修复-plan` | 已完成·归档候选 | onEvent seq 映射已修上线 | | `plans/2026-06-24-生成式OS数据驾驶舱-design` | 指针存根 | 方案已迁独立仓 `genos-cockpit`(权威在彼仓 docs/design/) |
| `plans/2026-06-14-提交审批桥接-design` | 已完成·归档候选 | processCoreService 桥已端到端实证 | | `归档/`(06-14 onEvent修复/提交审批桥接/新闻管理、06-15 菜单维护、06-16 WfTemplate方案、CRUD-QA-06-14、C3压测基线、C5构建预演) | 已归档(07-02) | 一次性 plan/报告,均已落地;引用处已同步改路径 |
| `plans/2026-06-14-新闻管理垂直切片-plan` | 已完成·归档候选 | 新闻收藏已修上线 |
| `plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan` | 已完成·归档候选 | 菜单树/树选已修 live 验收 |
| `plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案` | 已完成·归档候选 | Phase0-4 全做完(仍可作机制参考) |
| `CRUD-QA-发现与剩余-2026-06-14` | 已完成·归档候选 | 单次 dogfooding,多数缺口已处理(被通用模板收口引用,移动前先改引用) |
| `C3压测基线` / `C5构建预演报告` | 已完成·归档候选 | M0 一次性本地基线/构建预演(被 M0交付/M0剩余项登记 引用) |
| `归档/`(framework parity/交付报告/数据驱动重审/转换页审计/EIP4-架构与缺口现状-06-13/转换器覆盖度审计-06-13/F2-12/F2-17 三件套/未完成工作清单) | 已归档 | 历史快照,**勿据以判进度** | | `归档/`(framework parity/交付报告/数据驱动重审/转换页审计/EIP4-架构与缺口现状-06-13/转换器覆盖度审计-06-13/F2-12/F2-17 三件套/未完成工作清单) | 已归档 | 历史快照,**勿据以判进度** |
| `M0交付/`(153 处置清单 v1 / 153 终判证据包 / M0 剩余项登记) | 历史 | M0 阶段交付,已被 engineclass backlog + 终判取代 | | `M0交付/`(153 处置清单 v1 / 153 终判证据包 / M0 剩余项登记) | 历史 | M0 阶段交付,已被 engineclass backlog + 终判取代 |
| `P1/`(F1/F2-x/F3/F4/P1-P4 简报 共 ~22 份) | 历史 | 阶段交付简报(部分已被后续重做取代,如审批 UI/选择窗),保留备查 | | `P1/`(F1/F2-x/F3/F4/P1-P4 简报 共 ~22 份) | 历史 | 阶段交付简报(部分已被后续重做取代,如审批 UI/选择窗),保留备查 |
@@ -125,11 +129,12 @@
## 4. 下一步指引 ## 4. 下一步指引
> 完整优先级排序见 `项目进度与路线-总览-2026-06-21.md` §5;**P0②/P1④/P1⑥/P1⑤ 已实施 + 对抗审查 + 全验证(见总览 §9;提交于分支 `feat/p0p1-impl`,未 push)**。 > 完整优先级排序见 `项目进度与路线-总览-2026-06-21.md` §5;P0②/P1④/P1⑥/P1⑤ 已实施 + 对抗审查 + 全验证,**已合 main 并 push**(总览 §9);安全基线 P0(§10.1)、报表 A3(§11)、审批闭环(A2)、A10 骨架均已收口/落地。
- **P0**:① 文档对齐 ✅;② AI 门禁余项 —— 引擎 ALTER 安全通道 ✅ / 安全门 enforced ✅ / overlay 审计端点 ✅;存量 overlay 白名单 strict 化推进 待续。 - **P0**:① 文档对齐 ✅;② AI 门禁余项 —— 引擎 ALTER 安全通道 ✅ / 安全门 enforced ✅ / overlay 审计端点 ✅;存量 overlay 白名单 strict 化推进 待续。
- **P1**:③ framework 业务 106 视图 —— **双重阻塞:卡 S1 止损评审 + EIP-3.0 源码本地未克隆,无法分析迁移**;④ 人走五环 v2 改表加列 ✅(recipe 扩面 M7 待续);⑤ 流程审批列表入口 e2e ✅(真实流转依赖客户 BPMN、BPMN 图另案);⑥ 运行时 DELETE ✅ + publish 菜单授权 ✅(部署包下沉统一待续,已查两生成器现逻辑等价无 bug)。 - **P1**:③ framework 业务 106 视图 —— **双重阻塞:卡 S1 止损评审 + EIP-3.0 源码本地未克隆,无法分析迁移**;④ 人走五环 v2 改表加列 ✅(recipe 扩面 M7 待续);⑤ 流程审批列表入口 e2e ✅(真实流转依赖客户 BPMN、BPMN 图另案);⑥ 运行时 DELETE ✅ + publish 菜单授权 ✅(部署包下沉统一待续,已查两生成器现逻辑等价无 bug)。
- **P2**:报表 A3 立项 / 附件 A4 补完 / 生产上线 A10 / 生产级 UI B4 补完。 - **P2**:~~报表 A3 立项~~(✅ 已完成,总览 §11)/ 附件 A4 补完 / 生产上线 A10 落地执行(骨架已建,剩切流/性能/灰度 + Gitea act_runner 注册)/ 生产级 UI B4 补完。
- **进行中方向**:B3 流程 Modeler(design 已拍定,待 plan→实现);报表作者化 WEB 设计器 + Agent 设计报表(目标已立,待 brainstorm→design)。
- **待拍板**(总览 §6):153 终判三选一、②面 AI/内置 LLM 立项、type100/101 死页停转或留、onEvent 面板自动化率边界、对外口径统一、webmail 是否纳入本期。 - **待拍板**(总览 §6):153 终判三选一、②面 AI/内置 LLM 立项、type100/101 死页停转或留、onEvent 面板自动化率边界、对外口径统一、webmail 是否纳入本期。
- 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 `scripts/run-dev.sh`。 - 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 `scripts/run-dev.sh`。

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

View File

@@ -1,7 +1,7 @@
# EIP4 开发平台 · 架构方向(与最初设计对齐版) # EIP4 开发平台 · 架构方向(与最初设计对齐版)
> 日期:2026-06-19 | 性质:方向级 design(brainstorm 收敛 + 最初设计考古 + 引擎代码核实 + 对抗审查产出) > 日期:2026-06-19 | 性质:方向级 design(brainstorm 收敛 + 最初设计考古 + 引擎代码核实 + 对抗审查产出)
> 配套权威:`项目进度与路线-总览-2026-06-17.md`(A 兼容 / B 新功能全景)、`架构设计.md`(双层制/选型/红线)、`决策与盘点/EIP4前端与收尾实施计划.md`(F4 低代码工具链原始定义) > 配套权威:`项目进度与路线-总览-2026-06-21.md`(A 兼容 / B 新能力全景,取代 06-17 版)、`架构设计.md`(双层制/选型/红线)、`决策与盘点/EIP4前端与收尾实施计划.md`(F4 低代码工具链原始定义)
> 方法:9-agent workflow(7 路考古/代码核实 → 综合 → 对抗审查),逐行核实引擎实况。 > 方法:9-agent workflow(7 路考古/代码核实 → 综合 → 对抗审查),逐行核实引擎实况。
--- ---

View File

@@ -72,7 +72,7 @@
## 5. Housekeeping ## 5. Housekeeping
- 本文 + design doc(补 D6/D7)commit 进 main。 - 本文 + design doc(补 D6/D7)commit 进 main。
- main 现领先 origin/main 20 提交(AI 合并 + 3 收口),**push = 用户决策**(两仓需先 add remote / git.latent.chat,见 memory `eip3-git-remotes-latentchat`)。 - main 现领先 origin/main 20 提交(AI 合并 + 3 收口),**push = 用户决策**(两仓需先 add remote 到私有托管,见 memory `eip3-git-remotes-latentchat`)。
- worktree `eip4-platform-ai-agent` 已与 main 同 commit,可清理。 - worktree `eip4-platform-ai-agent` 已与 main 同 commit,可清理。
--- ---

View File

@@ -0,0 +1,9 @@
# 生成式 OS 数据驾驶舱(GenOS Cockpit)— 已迁出本仓
> 2026-06-24:本方案定为**独立产品**(不属于 Java 后端仓),已迁至独立仓 `genos-cockpit`。
- 项目:**GenOS Cockpit / 生成式 OS 数据驾驶舱**(独立可单独部署的伴随模块,EIP4 为首个集成)
- 权威文档位置:`/Users/zhengwr/workspace/genos-cockpit/docs/design/2026-06-24-生成式OS数据驾驶舱-design.md`
- 原型简报:`/Users/zhengwr/workspace/genos-cockpit/docs/design/genos-cockpit-claude-design-brief.md`
一句话:用自然语言表达意图 → daemon 驱动用户本机 CLI agent(平台不内置 LLM)→ 经 **EIP4 platform-mcp** 取数(自动继承 RBAC)→ OpenUI Lang 流式自组装成驾驶舱。与 EIP4 **只通过 MCP/REST 松耦合**,不替换 amis、不进确定性五环主路径。最大前置门 = S1 拍板是否引入运行态 LLM。

View File

@@ -0,0 +1,209 @@
# 审批闭环 — 完整实施计划(2026-06-25)
> 目标:把 EIP4 审批从「单人串行主链路已 live」推进到「动作类型齐全 + 流程可视化 + 流程监控 + 端到端真实流转」的生产可用闭环。
>
> 现状权威依据:`ApprovalController.java`(gateway)/ `FlowController.java`、`CandidateController.java`(flowable-service)/ `FlowableClient.java`(gateway client)/ `ApprovalDrawer.tsx`、`TodoPage.tsx`(web)实读核实;进度矩阵见 `docs/项目进度与路线-总览-2026-06-21.md` §A2/B3/B4。
---
## 0. 现状基线(核实于 2026-06-25)
### ✅ 已实现并 live(WfTemplate 数据驱动审批主链路)
- 动作:`approve`(complete + 回写 SYS_DATASTATUS 3/2)、`reject`(终止 + 回写 4)、`reback`(退回发起 + 回写 5)、`agent`(委托)。
- 界面:`ApprovalDrawer`(只读业务表单 + 流程轨迹时间线 + 动态按钮 + 审批意见);业务表单走统一 sys_page_schema editform 解析;load 脚本保真层执行(4s 超时守护);action servicename 服务器侧按 buttonId 重解析后执行。
- 入口:228 个 sys_page_schema 含 `openApprovalDrawer` 按钮接线(mock e2e 1/1)。
- 提交审批桥:`ProcessCoreServiceBridge`(startWorkflow)已实证起真实 flowable 实例。
### 🟡 引擎/Client 层已具备、仅缺 gateway 动作接线 + UI 按钮(关键发现:比想象中近)
> 这些**不需要动引擎**,引擎与 `FlowableClient` 方法都已存在并测过:
- `FlowableClient.withdraw(pi, comment)` ← flowable-service `POST /api/flow/process/{pi}/withdraw`(发起人撤回)
- `FlowableClient.terminateProcessInstance(pi, comment)` ← `POST /process/{pi}/terminate`(强制结束)
- flowable-service `POST /process/{pi}/suspend` / `/activate`(挂起/激活,client 侧尚无封装方法)
- `FlowableClient.started(...)` ← `GET /process/started`(我发起的流程列表)
- `FlowableClient.deleteHistoricProcessInstance(pi)` ← `POST /process/{pi}/delete-history`
- `trace` / `traceByBusiness`(轨迹)已用于 ApprovalDrawer。
### ❌ 完全缺失
1. 动作类型:**协办/加签 `assist`**、**转阅/抄送 `circulated`** —— `ApprovalController.java:227` 直接 `badRequest`。**会签**(多实例并行 + 结果聚合)无任何处理。
2. **BPMN 流程图查看** —— 现仅文本轨迹,无图形化高亮当前节点。
3. **流程定义 Modeler(B3)** —— 完全未起步。
4. **「我发起的流程」页 / 流程监控页** —— web 无对应 page(仅 `TodoPage`);撤回/结束按钮无 UI。
5. **审批待办组件 B4** —— UI/UE 组件骨架未补完。
### 🔒 外部阻塞(非代码能力问题)
- 客户真实 BPMN 部署:新提交走通用流 `EIP4_DEFAULT_APPROVAL`,无 `form_key` → 降级默认按钮。全数据驱动 + 候选人计算需客户部署真实 BPMN(`form_key` 指 WfTemplate)。dev act 流程库不可达。
- `reject`/`reback`/action-servicename 写流:仅 wired + 单测,未对真实迁移数据跑 mutation(数据安全自限)。
---
## 1. 范围分层与优先级
| 层 | 内容 | 外部依赖 | 工作量 | 价值 |
|----|------|---------|--------|------|
| **P0**(立即可做) | 协办/加签 `assist`、转阅/抄送 `circulated` 动作落地 | 无 | 中 | 高(补齐审批语义完整性) |
| **P1**(接线打磨) | 流程监控按钮(撤回/结束/挂起)接线 + 「我发起的流程」页 | 无 | 小-中 | 高(引擎已就绪,最后一公里) |
| **P1**(可视化) | BPMN 流程图查看(bpmn-js 高亮当前节点) | 无(用已部署 bpmn) | 中 | 高(审批可视化刚需) |
| **P2**(验证闭环) | 真实流转 / 候选人计算 / 写流对真实记录的端到端验收 | **客户 BPMN** | 中 | 高(但卡外部) |
| **P3**(大工程) | 会签(多实例聚合)+ 流程定义 Modeler(B3) | 部分卡 S1 | 大 | 中(按客户诉求排期) |
> 建议交付顺序:**P0 → P1 监控接线 → P1 BPMN 图 → P2(客户 BPMN 到位后)→ P3**。P0/P1 共约 4 个可独立交付的增量,互不阻塞,均不依赖外部。
---
## 2. 分阶段任务
### 阶段 A — 协办/加签 `assist`(P0)
**语义对账(先做,不可跳过)**:核对老系统 `TaskProcessServiceImpl` 中 assist 的真实行为。预期两种之一:
- (a) **加签**:当前任务保留,给目标人新增一个并行/串行待办(`addCandidateUser` 或动态加 task),目标人办完回到原审批人;
- (b) **协办**:把当前任务的 candidate 增加目标人,任一人可办。
> WfTemplate 数据里 assist 仅 2 例 —— **务必先 SQL 取这 2 例的 xml + servicename,确认是 (a) 还是 (b)**,不要凭猜实现。
**改动**:
- flowable-service `FlowController`:新增 `POST /api/flow/tasks/{taskId}/assist`(入参 targetUserId、comment)。用 `TaskService.addCandidateUser` 或 `runtimeService` 动态加签,按语义对账结果实现。CHAR(36) 补白对齐既有 `TrimmingCandidateUsersHandler` 口径。
- `FlowableClient`:加 `assist(taskId, targetUserId, comment)`。
- `ApprovalController.action`:`case "assist"` → 新 `assist(taskId, req)` 方法(替换当前 400)。
- 单测:FlowController assist 1 + ApprovalController dispatch 1。
**验收**:真实/构造任务加签后,目标人 todo 出现该任务;办理后流程状态正确。
**风险**:加签的「办完回到谁」依赖 BPMN 结构;若客户 BPMN 不可达,先用 dev 构造流程验证机制,标注真实流待客户库。
---
### 阶段 B — 转阅/抄送 `circulated`(P0)
**语义对账**:circulated 仅 2 例。老系统转阅通常是**只读知会**(不阻塞流程):给目标人发一条「抄送待阅」记录,目标人可见单据但无审批动作。核实是否落 `act_ru_identitylink`(type=participant)或独立抄送表。
**改动**:
- flowable-service `FlowController`:`POST /api/flow/tasks/{taskId}/circulate`(targetUserIds[]、comment)。实现 = 加 participant identityLink + 写抄送记录(若老系统有抄送表,迁移对齐;否则用 identityLink + 历史评论)。
- `FlowableClient`:`circulate(taskId, targetUserIds, comment)`。
- `ApprovalController.action`:`case "circulated"` → `circulate(...)`。
- 「抄送给我的」列表:复用 `TodoController` 加 `GET /api/tasks/circulated?user=`(查 participant identityLink)。**前端可暂缓**,先保证动作不报 400。
- 单测:circulate 1 + dispatch 1。
**验收**:转阅后目标人能在「抄送给我」看到只读单据;原审批流不受影响继续。
**风险**:抄送列表入口是新页面,P0 只交付动作 + 后端列表端点,前端页面归 B4。
---
### 阶段 C — 流程监控按钮接线(P1)✅ 实施时核实:已完成(无需重做)
> **2026-06-25 实施勘探更正**:本阶段在 06-21 矩阵里被标为「缺监控按钮」,实测**后端 + amis 页全部已存在**(进度文档 framework P2 那批 `57c3412…d218c2b` 已交付,当时计划按旧矩阵误判):
> - `GET /api/workflow/process/started-amis`(我的发起)+ `monitor-amis`(流程监控)列表端点 —— 各被 1 个 `sys_page_schema` 页引用。
> - 我的发起页(`0db4af06…`)含**撤回**按钮 → `POST /api/workflow/process/{pi}/withdraw`(回写 SYS_DATASTATUS=5)。
> - 流程监控页(`9f3b5a8b…`)含**强制结束**按钮 → `/terminate`(回写=6 作废)+ **高级处理脚本** `/advanced-script`(带 RCE 守卫,仅非生产 profile)+ `/delete-history`。
> - 语义正确:发起人撤回自己的、管理员监控结束别人的。
>
> **结论**:阶段 C 无需实现。残留仅 suspend/activate(挂起/激活)未在 gateway 暴露——价值低,暂不做;监控页缺「流程图/轨迹」按钮归入阶段 D。
>
> ~~原计划(引擎 + client 已全有,只缺 gateway 动作端点 + UI)~~ —— 实际 gateway 端点也已就绪。
**改动**:
- `FlowableClient`:补 `suspend(pi)` / `activate(pi)`(其余 withdraw/terminate/started 已有)。
- gateway 新 `ProcessMonitorController`(或并入 ApprovalController):
- `POST /api/process/{pi}/withdraw`(发起人撤回,回写 SYS_DATASTATUS)
- `POST /api/process/{pi}/terminate`(强制结束,超管/管理员权限校验,回写状态)
- `POST /api/process/{pi}/suspend` / `/activate`
- 权限:撤回限发起人本人;结束/挂起限管理员角色(复用 JWT 角色)。
- web 新 `StartedProcessPage.tsx`(「我发起的流程」):列表走 `started`,行内「撤回」按钮 + 流程轨迹抽屉(复用 ApprovalDrawer 只读模式 + historyMeta 端点,已存在)。
- 单测:ProcessMonitorController 4(每动作 1)+ 权限拒绝 1;前端 vitest 列表渲染 1。
**验收**:发起人撤回未审任务 → 状态回写 + todo 消失;管理员强制结束运行流程 → 实例 ended。
**风险**:撤回/结束对真实客户数据是破坏性操作,**只对 dev 构造流程跑实际 mutation**,真实库标注待客户授权。
---
### 阶段 D — BPMN 流程图查看(P1)
**方案**:bpmn-js 前端渲染 + 后端给 XML & 当前活动节点(业界标准,比服务端出图灵活,可高亮 + 缩放)。
**改动**:
- flowable-service:`GET /api/flow/process/{pi}/bpmn-xml` → 用 `RepositoryService.getProcessModel(procDefId)` 返 BPMN XML 字符串;`GET /api/flow/process/{pi}/active-activities` → `runtimeService.getActiveActivityIds(pi)`(高亮用,已有 RuntimeService)。历史流程取 `HistoricActivityInstance` 标记走过的节点。
- `FlowableClient`:`bpmnXml(pi)` / `activeActivities(pi)`。
- gateway:`GET /api/process/{pi}/diagram`(聚合 xml + active + history 节点)。
- web:引入 `bpmn-js`(NavigatedViewer),新 `ProcessDiagram.tsx`,在 ApprovalDrawer 加「流程图」Tab;高亮当前节点(绿)、走过节点(灰)。
- 单测:diagram 端点 2;前端组件渲染 smoke 1。
**验收**:打开任一运行中流程,流程图正确渲染并高亮当前停留节点。
**风险**:迁移的是 activiti5 流程定义,bpmn-js 需 BPMN 2.0 XML;若部分老流程是 activiti5 私有格式,需确认 `getProcessModel` 返的是标准 BPMN 2.0(flowable 部署后通常是)。先用一条已部署流程验证格式兼容性。
---
### 阶段 E — 端到端真实流转验收(P2,卡客户 BPMN)
**前置①(外部)**:客户提供并部署真实 BPMN(form_key 指 WfTemplate)。到位后:
- 真实流转:提交 → 候选人计算(`CandidateController` + `OrgDirectory` 已就绪)→ 多级审批 → approve/reject/reback 实际推进。
- 写流:对**测试租户/沙箱记录**(非生产迁移数据)跑 reject/reback/action-servicename 实际 mutation,验证回写与服务流副作用。
- 候选人对账:用 `CandidateController` 对真实组织库批量核对解析结果(P3 报告口径)。
**验收**:一条客户真实审批流从提交到归档全程在 EIP4 走通,状态/候选人/表单全部正确。
**阻塞**:无客户 BPMN 则只能 dev 构造流程验机制,标注「机制已验,真实流待客户库」。
---
### 阶段 F — 会签 + 流程定义 Modeler(P3,大工程,按客户诉求排期)
- **会签**:BPMN 多实例(multi-instance)任务,多人并行/串行审批,按比例/全票聚合结果。需引擎多实例支持 + 聚合变量 + UI 显示「3/5 已审批」。**先确认客户是否真有会签节点**(WfTemplate action type 分布里无独立会签 type,可能藏在 BPMN 结构,需核实)。
- **流程定义 Modeler(B3)**:bpmn-js + bpmn-js-properties-panel 在线编辑 BPMN,存 flowable 部署。**卡 S1 拍板**(是否自研 vs 用 flowable-modeler 嵌入)。工作量最大,建议独立 design。
---
## 3. 红线与约束(贯穿全程)
1. **不碰 view_template.xml / 153 bespoke**;审批是框架级通用能力。
2. **破坏性引擎动作(撤回/结束/加签/写流)只对 dev 构造数据跑实际 mutation**,真实迁移数据需用户显式授权。
3. **servicename 服务器侧按 buttonId 重解析,不信前端直传**(沿用 `ApprovalController.runActionServiceIfAny` 既有口径,防注入)。
4. **CHAR(36) 补白 / 候选人补白对齐既有 handler**(`TrimmingCandidateUsersHandler`、`EngineContextBinder` 归一化),避免身份不匹配。
5. **不自我批准**:实现后走 `code-reviewer` + 真库/dev e2e 验证,作者与评审分离。
6. e2e 端口坑:五环 jar = 8094(`playwright.fivering.config.ts`),标准 dev = 8093;psql 查业务表设 `PGOPTIONS='-c search_path=eip3'`。
---
## 4. 外部依赖与待拍板
- **【外部】客户真实 BPMN 部署** → 阻塞阶段 E 全部、阶段 A/B 的真实流验证。
- **【S1 拍板】流程定义 Modeler 自研 vs 嵌入 flowable-modeler**(阶段 F)。
- **【待核实】会签是否为客户真实诉求**(数据里无独立 type,先核实再排期)。
---
## 5. 执行进度(2026-06-25/26 本会话,按 P0→P3 顺序)
### 波1 ✅ 已实现 + 对抗审查收口 + 单测绿 + **live 验证通过**:阶段 A(assist 协办)+ 阶段 B(circulated 转阅)
- 语义对账(红线)已做:SQL 取 view_wftemplate 那 2+2 例(全空 servicename)+ 读老 `ProcessCoreServiceImpl.createSubTask/createNewTask` 坐实语义(协办=建独立子任务、转阅=建只读知会任务)。
- 后端 flowable-service `POST /tasks/{id}/assist`+`/circulate`;gateway `FlowableClient.assist/circulate` + `ApprovalController` 分派把 400 改真实;前端 `ApprovalDrawer` 多选人弹窗 `MultiUserForm`。
- **对抗代码审查(code-reviewer)揪出 1 HIGH + 3 MEDIUM,已修**:
- 【HIGH 已修+live证】协办/转阅是独立任务(无 processInstanceId/formKey),审批渲染原取不到 businessKey/formKey → 协办人/转阅人看不到业务单据。修法=`approvalContext` 对独立任务**沿 parentTaskId 回溯父任务**取 businessKey+formKey(兼防 `processInstanceId(null)` 崩 500);circulate/assist 子任务 `setFormKey(父formKey)`。
- 【MEDIUM 已修】assist 补父任务 404 守卫(与 circulate 对称);派发 `MAX_FANOUT=50` 上限;assist/circulate 加 `@Transactional` 整批原子。
- 【LOW】转阅改 `setFormKey` 而非 description(FormKeyResolver 直接命中);javadoc 与实现对齐。
- 单测:flowable-service FlowControllerTest 21 + ProcessDiagramControllerTest 3 全绿;gateway ApprovalControllerActionTest 5 全绿;前端 tsc 干净 + vitest 83/83。
- **live e2e(8089+8093 新 jar,真引擎)**:① POST assist/circulated 各返 `count:1`(不再 400);② 子任务 approval-context **回溯出父流程 businessKey=probe-bk-1 + processInstanceId**(HIGH 修复实证);③ 子任务**进目标用户待办**(assignee 匹配无补白问题,reviewer Open Question 实证排除);④ 测试产物已清理。
### 波2 ✅ 核实即完成:阶段 C(流程监控)
后端 + amis 页早已存在(见上文阶段 C 更正),无需重做。
### 波3 ✅ 已实现 + 单测绿 + **live 验证通过**:阶段 D(BPMN 流程图)
- 后端 flowable-service 新 `ProcessDiagramController` `GET /process/{pi}/diagram`(返 bpmnXml + activeActivityIds + finishedActivityIds,只读,运行/历史双路取 procDefId);gateway `FlowableClient.diagram` + `TodoController GET /api/workflow/process/{pi}/diagram` 转发。
- 前端新 `src/api/diagram.ts` + `src/components/ProcessDiagram.tsx`(bpmn-js NavigatedViewer,中文节点走浏览器字体,当前节点绿/已走过灰高亮);`ApprovalDrawer` 加「查看流程图」按需展开段。bpmn-js 依赖已装,build ✓(5104 模块)。
- 单测 ProcessDiagramControllerTest 3 绿。**live e2e**:真实带 DI 的迁移实例(PI=511732)返 `bpmnXml=7586 chars / 含 BPMNDiagram 布局 / 当前节点 sid-… / 已走过 4 节点` → bpmn-js 可渲染。
### 阶段 E(P2)⏸ 外部阻塞
真实流转/候选人/写流端到端 —— 需客户 BPMN(dev `EIP4_DEFAULT_APPROVAL` 通用流无 form_key)。注:`eip4flow` 库有 1512 流程定义/9441 实例可读,故**只读类**(流程图/轨迹)已能 live;写类真实流转仍待客户 BPMN。
### 阶段 F(P3)— 会签 ✅ 已实现+live;Modeler ⏸ 待 S1
**会签更正(2026-06-26,用户确认是客户真实诉求)**:先前「阻塞/待核实」判断**错误**——会签不是 WfTemplate 的按钮 type,而是 **BPMN 多实例(multiInstance)节点结构**,故按钮 type 分布看不出。核实结果:
- 迁移库 28/1512 流程定义含 `multiInstanceLoopCharacteristics`;其中 **4 个真实业务流程**:安全技术交底(集合 type=`user`)、总包合同交底/招投标工程评审流程/施工技术交底(集合 type=`scriptUser`)。
- **引擎机制本就全在**:flowable 原生多实例(并行任务+`completionCondition` 聚合) + `multiInstanceUsersHandler` bean 已移植并在 `FlowableEngineConfig` 注册 + 每个会签人走现有 `approve`。故 `user` 类型会签早已能跑。**会签从不是外部阻塞**。
- **真正缺口**:`CandidateUsersHandler` 的 **`scriptUser`(JUEL 脚本)候选人解析分支当初故意没移植**("精简边界" WARN 降级,26 处)。3/4 真实会签流程用 scriptUser(`${APPLYUSERS}`) → 办理人解析返空 → 会签节点被跳过(日志实锤 WARN)。
- **已修复**:`CandidateUsersHandler` 实现 scriptUser 分支 = 单变量 `${VAR}` 直读流程变量、复杂表达式回退 flowable 表达式管理器对 execution 求值、结果按 List/数组/逗号分号串/单值归一为去重 userId 列表。单测 8(`CandidateUsersScriptUserTest`);flowable-service 全量 56 绿无回归。
- **live e2e**:起「招投标工程评审流程」(APPLYUSERS=3人) → 会签节点**生成 3 条并行任务**(修复前 0 条被跳过);完成 **1/3 不推进**(剩 2)、完成 **3/3 聚合推进**到下一节点(完成条件 `nrOfCompletedInstances/nrOfInstances==1` 全票);测试实例已清理。
**剩 Modeler ⏸**:流程定义 BPMN 在线 Modeler(B3,自研 vs 嵌入 flowable-modeler)仍卡 S1 拍板。
**会签残留(跟踪项,非阻断)**:① 会签进度显示("已会签 N/M 人")未做,可从多实例执行的 `nrOfInstances/nrOfCompletedInstances` 取,属 UX 增强;② scriptUser 复杂表达式回退依赖命令上下文,已 try/catch 安全降级;③ 真实 APPLYUSERS 由业务表单/前序步骤设置,本次用 start 变量模拟。
### 残留(非阻断,跟踪项)
- 协办/转阅目标用户用文本输入(与现有「转办」DelegateForm 同款),无真实用户存在性校验 → 错填 userId 会建不可见任务。**与现有转办行为一致**,建议后续统一接用户 picker(同时惠及转办)。
- 协办/转阅按钮在 WfTemplate 均无 servicename(已核实),故 `runActionServiceIfAny` 对其为 no-op,安全。
**改动文件**(全部在 flowable-service + platform-flow-gateway + eip4-web,未触及其他模块;platform-report/legacy-core 的失败测试是它处 WIP/JDK 环境问题,与本次无关):
- 后端:`FlowController.java`、`Requests.java`、`ProcessDiagramController.java`(新)、`FlowableClient.java`、`ApprovalController.java`、`GatewayRequests.java`、`TodoController.java` + 3 测试
- 前端:`approval.ts`、`ApprovalDrawer.tsx`、`diagram.ts`(新)、`ProcessDiagram.tsx`(新)、`package.json`(bpmn-js)

View File

@@ -0,0 +1,134 @@
# 在线流程定义 Modeler — 设计(2026-06-26)
> 在 EIP4 已有 bpmn-js 流程图查看器之上,扩成**可编辑的 BPMN 流程设计器**:老审批流程能在线编辑修改、新审批流程能在线创建,flowable 流程相关特性全支持,叠加 EIP4 专有语义(办理人/会签/表单绑定)。
>
> 经 brainstorming 逐项拍定(本文末「决策记录」)。承接审批闭环:[[2026-06-25-审批闭环-实施计划]]、流程图查看(main `0ee919b`)。
---
## 0. 目标与成功标准(用户拍定)
1. **老流程能正常编辑修改**(改造 eip4flow 里 1512 个真实迁移流程)。
2. **新功能流程能正常创建**(从空白/模板新建并部署)。
3. **功能不缺失**:全 BPMN/flowable 元素可编可配(各类任务/网关/事件/子流程/边界事件/定时器/信号/错误/补偿…)。
4. **支持 flowable 流程特性**:监听器/超时/异步/网关条件/多实例/事件定义等 flowable 扩展属性可编辑。
**v1 边界(不含)**:DMN(决策表)、CMMN(案例管理)、flowable 自带表单设计器(EIP4 表单走 WfTemplate/amis,不需要)。这三者是 flowable 里平级但独立的编辑器,若客户需要 DMN(复杂规则表)属未来另立评估。
---
## 1. 现状基线(已具备,~70% 基础设施)
| 件 | 状态 |
|----|------|
| 部署端点 `POST /api/flow/deploy`(bpmnXml → `createDeployment().addString().deploy()`) | ✅ 已有 |
| 读流程 BPMN `GET /api/flow/process/{pi}/diagram`(含中文 id 净化) | ✅ 已有 |
| `bpmn-js/lib/Modeler`(可编辑版) | ✅ 已在 eip4-web 依赖 |
| 引擎模型表 `act_re_model`(草稿存储) | ✅ 已有 143 行 |
| `bpmn-js-properties-panel` + `@bpmn-io/properties-panel` | ❌ 需 npm 加 |
| activiti/flowable moddle 描述符 | ❌ 需加(保真地基) |
| 无 `ACT_DE_*`(flowable-modeler 设计态表) | — 不依赖;不嵌 flowable-modeler(Angular 栈,off-stack;其底层本就是 bpmn-js) |
---
## 2. 架构与组件
**前端**(eip4-web,新 `ProcessModelerPage` + 路由 `/process-modeler/:modelId?`):
- 用 `bpmn-js/lib/Modeler`(替查看用的 `NavigatedViewer`)+ 完整元素 palette + `bpmn-js-properties-panel`。
- 布局:左画布 / 右属性面板 / 顶栏(保存草稿·发布上线·校验·返回)。
**后端**(flowable-service,新 `ProcessModelController`,复用既有 `RepositoryService`):
- `GET /api/flow/models` 列草稿
- `GET /api/flow/models/{id}` 取草稿 XML(`getModelEditorSource`)
- `POST /api/flow/models` 建草稿(`newModel`+`saveModel`+`addModelEditorSource`)
- `PUT /api/flow/models/{id}` 存草稿
- `POST /api/flow/models/{id}/deploy` 发布(草稿 XML → 复用既有 /deploy 逻辑)
- `GET /api/flow/process/{procDefId}/source` 载入存量流程为新草稿(复用 /diagram 的中文 id 净化)
- gateway(platform-flow-gateway)转发对应 `/api/workflow/models/**`,套 JWT 权限。
**存储**:草稿 = `act_re_model`(flowable 原生);发布 = `act_re_deployment`/`act_re_procdef`(引擎原生版本机制)。
**版本与运行实例**:发布 = 引擎出**新版本**;**运行中实例留在旧版本不受影响**(flowable 原生版本隔离)。v1 **不做实例迁移**(YAGNI;迁移属高级特性,另案)。
---
## 3. 数据流
1. **新建**:空白/模板 → 编辑 → 存草稿(act_re_model)。
2. **改存量**:打开 procDef → `/source` 灌成草稿 → 编辑 → 存草稿。
3. **发布**:草稿 XML → 同人确认弹窗(影响摘要)→ 校验门 → `/deploy` → 新版本。
---
## 4. 属性面板:标准全套 + EIP4 定制叠加
**标准面板**(bpmn-js-properties-panel):出全部 flowable 流程属性——节点名/文档、网关条件、多实例、监听器、超时、异步、事件定义等 → 满足「功能不缺失 / flowable 特性」。
**EIP4 定制控件**(叠加的自定义分组):
1. **办理人**:读节点 `activiti:candidateUsers="${candidateUsersHandler.getCandidateUsers(execution,'<JSON>')}"` → 解析内嵌 JSON → 友好编辑(角色/部门/前序处理人/scriptUser 多项,对齐已移植的 `UserProperty` 结构)→ 回写表达式。**前后端同源复用 CandidateUsersHandler 配置格式**。
2. **会签**:开关 → `multiInstanceLoopCharacteristics`(并行/顺序)+ collection=`${multiInstanceUsersHandler.getUsers(execution,'<JSON>')}` + 完成规则(全票 `nrOfCompletedInstances/nrOfInstances==1` / 过半 / 指定数)。人员来源复用办理人控件。
3. **formKey**:选择器列 `view_wftemplate` → 设 `formKey=view_wftemplate_id`,绑 EIP4 业务表单。
**原生 assignee/candidateUsers 字段不压**(用户拍定):保留显示供调试/高级,加灰字提示「EIP4 引擎以下方办理人控件为准」缓解误填。
---
## 5. moddle 扩展(保真地基)
迁移 BPMN 用 `xmlns:activiti="http://activiti.org/bpmn"` 存扩展。bpmn-js 默认不认 → 重新导出**会丢扩展**(致命)。**提供完整 activiti moddle 描述符**(JSON,声明整个 activiti 命名空间的元素/属性,非最小集),让编辑器读写原样保留 → 既保真零丢失,又使「flowable 扩展全属性可编辑」。activiti 命名空间予以保留(不归一为 flowable,避免引擎侧读取依赖断裂)。
**铁律测试**:载入真实流程 BPMN → 不改 → 导出 → XML 语义 diff **零丢失**(覆盖 activiti 扩展 / 会签 / 办理人表达式)。
---
## 6. 🔴 关键保真细节:id 可逆净化(保流程 key)
`/diagram` 把中文 process id(如「招投标工程评审流程」)净化为 `nXXX` 是给 bpmn-js 渲染用的。若拿净化版去部署,**流程 key 会变成 nXXX,断了与存量实例/引用的连续性**。
**对策**:载入改存量时**记下 id 映射**(原中文 ↔ 安全 ASCII),编辑器用净化版;**发布时逆向还原原始中文 key**(新加节点的 ASCII id 保留)。这样存量流程 key 不变、版本连续。映射随草稿一并存。
---
## 7. 红线 / 权限 / 审计(套「草稿 + 同人确认部署」)
- **部署门限超管**:`POST /models/{id}/deploy` JWT role 校验(控制器层拦),非超管 403。
- **同人确认**:前端发布弹窗显**影响摘要**(流程 key、当前版本号、运行中实例数、改了哪些节点的办理人/会签)→ 确认才部署。
- **校验门**:部署前服务端跑 flowable 部署校验 + EIP4 校验(办理人表达式可解析 / formKey 命中 view_wftemplate / 会签完成条件合法)→ 不过不部署。
- **审计**:每次部署记一条(谁 / 何时 / model→deploymentId / 新版本号)。
- 不分离作者/审批(v1 取舍;作者-审批分离属 v2 增强)。
**错误处理**:草稿损坏/解析失败 → 422 不部署;校验失败 → 返回具体节点错误;权限不足 → 403。
---
## 8. 测试策略
1. **moddle 保真**:载真实流程 → 不改 → 导出 → XML 语义 diff 零丢失(activiti 扩展/会签/办理人表达式)。
2. **控件双向**:办理人 JSON ↔ 表达式、会签完成条件生成、formKey picker。
3. **id 可逆净化**:净化→还原回原 key、新节点 ASCII id 保留、映射稳定。
4. **后端**:model CRUD + deploy(校验门/权限门/审计)单测。
5. **live e2e**:载存量会签流 → 改办理人 → 存草稿 → 发布 → 起实例验新办理人生效;Playwright 走查编辑器渲染(含中文节点名、palette、属性面板)。
---
## 9. 分阶段交付
- **阶段 1**:完整 activiti moddle 保真 + 只读载入存量(编辑器能开真实流程、palette/标准属性可见、不丢扩展)+ 保真零丢失测试。
- **阶段 2**:三 EIP4 定制控件(办理人/会签/formKey)+ 存草稿(act_re_model)+ 控件双向测试。
- **阶段 3**:发布门(校验+超管权限+同人确认+审计)+ id 可逆净化 + 后端 deploy 门测试。
- **阶段 4**:新建流程(空白/模板)+ live e2e(载存量改办理人→发布→起实例验生效)+ Playwright 走查。
每阶段独立可验、可合 main。
---
## 决策记录(brainstorming 2026-06-26)
| # | 决策 | 取定 |
|---|------|------|
| D1 | v1 范围 | **改存量 + 新建**(两者都要) |
| D2 | 部署门 | **草稿 + 同人确认部署**(限超管 + 校验 + 审计;不分离作者/审批) |
| D3 | 草稿存储 | **复用 flowable `act_re_model`**(model→deployment 一条龙) |
| D4 | 属性面板 | **标准全套 + EIP4 定制控件(办理人/会签/formKey)**;原生字段不压(加提示) |
| D5 | 编辑器能力 | **全功能 bpmn-js Modeler + flowable 流程全属性**(功能不缺失、新特性支持) |
| D6 | moddle | **完整 activiti 描述符**(保真零丢失 + 全属性可编辑),保留 activiti 命名空间 |
| D7 | id 处理 | **可逆净化**,发布还原原始中文流程 key |
| D8 | 版本/运行实例 | flowable 原生版本隔离,发新版本,运行中实例留旧版,v1 不做实例迁移 |
| D9 | v1 边界 | **BPMN 流程编辑器**,不含 DMN/CMMN/flowable 表单设计器 |
## 待 plan 阶段细化
- moddle 描述符来源:社区 flowable/activiti moddle vs 自建最小完整描述符(需核 activiti 命名空间实际用到的元素/属性全集)。
- 影响摘要里「改了哪些节点」的 diff 算法(节点级语义 diff)。
- 模板库(新建流程的起步模板:单人审批/多级审批/会签)放哪、几个。
- 草稿权限模型(谁能看/改别人的草稿)。

View File

@@ -0,0 +1,392 @@
# 在线流程 Modeler(B3)实施计划
> **✅ B3 全 17 任务完成并合 main(2026-07-02)**:platform origin/main 阶段1-4 全合、web origin/main 全合;每任务 TDD+对抗评审+修复轮,每阶段出口 live 验收(挡下 3 个单测/评审都没抓到的真 bug:options语义/面板ref/**bpmn-js PascalCase断部署**),末尾双对抗评审(安全+发布链)判定可宣告完成、唯一 Critical(nginx骨架洞)已修。**Modeler 端到端可用**:打开中文key存量流程→改办理人/会签保真读回→存草稿eip4IdMap保全→同人确认发布→部署新版本中文key保住+审计+起实例真userTask+旧实例不动+非admin403。
>
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
>
> 设计权威:`2026-06-26-在线流程Modeler-design.md`(D1-D9 已拍定)。本计划把 design 落成 TDD 任务,
> 每阶段独立可验、可 `--no-ff` 合 main。执行分支:platform `feat/process-modeler` / web `feat/process-modeler`。
**Goal:** 在既有 bpmn-js 流程图查看器之上交付可编辑 BPMN 流程设计器——1512 个存量真实流程可在线改(key 不变),新流程可从空白/模板建并部署,activiti 扩展零丢失。
**Architecture:** 前端 eip4-web 新 `/process-modeler` 页(bpmn-js `lib/Modeler` + 标准属性面板 + EIP4 React 侧栏控件);后端 flowable-service 新 `ProcessModelController`(flowable 原生 Model API 存草稿 act_re_model,id 净化映射存 metaInfo,发布时逆向还原);platform-flow-gateway 转发 `/api/workflow/models/**` 并承担超管门/EIP4 语义校验/部署审计。
**Tech Stack:** bpmn-js 17.11(已装)+ `bpmn-js-properties-panel`/`@bpmn-io/properties-panel`(新增)+ 自建 vendored activiti moddle 描述符;Flowable 6.8.1 RepositoryService Model API;React 18 + 自研 ui/Dialog;vitest + Mockito/MockMvc + Playwright。
---
## §0 事实基线(2026-07-02 勘探,全部核实过)
**语料(本地 eip4 库,5433,search_path=eip3)**:1512 真实 BPMN(act_ge_bytearray)/1503 部署/143 act_re_model。
扩展面实测:**11 个扩展属性**(activiti:formKey 1476docs / candidateUsers 1465 / exclusive 1311 / assignee 27 / collection 28 / elementVariable 24 / candidateGroups 3 / autoStoreVariables 4 / initiator 3 / dueDate 1 + flowable:assignee 3docs)、**5 个扩展元素**(taskListener 159docs / formProperty 6 / value / field / string);命名空间 activiti=1509docs、flowable=3docs。BPMN 特性:userTask 1505 / conditionExpression 297 / exclusiveGateway 276 / parallelGateway 52 / **multiInstance 28(8 个 distinct key,如「总包合同交底」——key 就是中文,D7 id 可逆净化是硬需求;且 moddle-xml 拒绝中文 id=进 moddle 前必须已净化,T1.1 实证)**。activiti:formKey 值=裸 UUID(view_wftemplate_id 本身,无前缀) / boundary·timer·subProcess·error 个位数 / signal·callActivity·serviceTask 零。
**后端**(file:line 均已核实):
- 部署端点已有:`FlowController.deploy` @ flowable-service `api/FlowController.java:81-105`,body=`{name?,bpmnXml}`,`createDeployment().name().addString().deploy()`,**无鉴权无审计**;网关 FlowableClient **未封装 deploy**。
- `ProcessDiagramController.java`:`sanitizeBpmnIds` @ :120 **单向丢映射**(:125 建 map :130 `"n"+hex(hash)`,方法返回即弃);`readProcessModel(procDefId)` @ :172 是 private(`repositoryService.getProcessModel`);**无 public 按 procDefId 取 XML 端点**。ID 重写正则 `ID_ATTR` @ :113-114 覆盖 `id|bpmnElement|sourceRef|targetRef|attachedToRef|processRef|default`。
- Flowable 6.8.1 裸引擎(flowable-service/pom.xml:26,非 starter;flowable5-compatibility 已引)。`RepositoryService` bean @ `config/FlowableEngineConfig.java:73-76`;`databaseSchemaUpdate=false`(:55,红线)。**Model API(newModel/saveModel/addModelEditorSource/getModelEditorSource/createModelQuery)全仓零使用**——本计划首次启用,act_re_model 表已存在(143 行),无需 DDL。
- 网关模式:`FlowableClient`(client/FlowableClient.java,RestClient,baseUrl 默认 :8089,`execute()` @ :299 连接类失败重试→503、4xx/5xx 透传不重试);控制器方法参数注入 `AuthPrincipal`;**超管判定现成**:`EngineContextBinder.isSystemAdmin(AuthPrincipal)` @ platform-auth `security/EngineContextBinder.java:68-76`(userId trim equalsIgnoreCase "ADMIN" 或 account=="admin")。
- flowable-service **无 Spring Security 无 @Profile**,裸 8089 靠网关保护 → 超管门必须落在网关层。
- 审计现状:部署/审批动作无审计表(只有 taskService.addComment + logger);唯一显式审计模型先例=platform-ai `AiAuditEntry`。Flyway 机制已有(platform-app `db/migration/V1-V3`),本计划加 V4。
- 办理人 JSON(`BasePropertiesConverter.java`):`{"items":[{type,content,isCandidate,isSendMail,isSendPhone(,isSendMessage)}]}`;**BPMN 里花括号写全角 `【】`**,handler 运行时 replace 回 `{}`;前缀常量 `CANDIDATESERVICE="${candidateUsersHandler.getCandidateUsers(execution,'"` @ :34、`MULTIINSTANCESERVICE="${multiInstanceUsersHandler.getUsers(execution,'"` @ :35。type 取值:user/depart/position/formSpecifiedDimension/initiator/sameToTask/beforeTaskLeader/beforeTaskDepartManager/scriptUser/projectRoleType。引擎注册 bean 名(FlowableEngineConfig:62-68):`candidateUsersHandler`(TrimmingCandidateUsersHandler)/`multiInstanceUsersHandler`。
- 起实例(e2e 用):`POST /api/flow/process/start` @ FlowController:246(processDefinitionKey→startProcessInstanceByKey)。
- WfTemplate 全量列表端点**不存在**(WfTemplateService 只按单 id 查)→ 需新建 picker 数据源。
- 测试范本:`ProcessDiagramControllerTest`(@Mock RepositoryService + MockMvc standalone + getProcessModel stub 返 ByteArrayInputStream)、`FlowableClientTest`(MockRestServiceServer)、`CandidateUsersHandlerTest`。
**前端**:
- bpmn-js 17.11.1 已装、`lib/Modeler` 可直接 import、CSS 裸路径可行(ProcessDiagram.tsx:4-6 已验证);**需新增 `bpmn-js-properties-panel` + `@bpmn-io/properties-panel`**;Modeler 需补 `bpmn-js/dist/assets/bpmn-font/css/bpmn.css`(palette 图标)。
- 现有 `/modeler` = 实体建模器(占用)→ 新页用 **`/process-modeler`**。
- admin 门=页面组件内 `isAdminProfile(getProfile())` 自查降级(ModelerPage.tsx:21-22 范式);路由注册 App.tsx:41-52;入口挂 DesignCenterPage.tsx:76-91 按钮区 + Topbar.tsx:71-80 admin 图标。
- 弹窗/确认:自研 `ui/Dialog`(Dialog/Drawer)+ `toast()`;选人表单范本 ApprovalDrawer.tsx `MultiUserForm`(:199-261)。
- api 惯例:`src/api/http.ts` axios 单例;流程域走裸 JSON 派(diagram.ts 防御性默认);网关前缀 `/api/workflow/`。
- 测试:vitest(token 用 importOriginal 只 mock getProfile);Playwright 新配一个 config(照 `playwright.fivering.config.ts`:后端 8094、vite 5174、`apiJson`/`adminToken` 辅助复用 five-ring.spec.ts 写法)。
- 生命周期范本 ProcessDiagram.tsx:29-67(alive flag + destroy try/catch);编辑器页布局范本 editor/DesignerPage.tsx。
## §0.5 计划级决策(design「待 plan 细化」四项 + 实现取舍,执行前已定)
| # | 决策 | 取定与理由 |
|---|------|-----------|
| P1 | moddle 描述符来源 | **自建 vendored** `eip4-web/src/modeler/moddle/activiti.json`(完整 activiti 命名空间描述符,以社区 activiti-bpmn-moddle 内容为种子手工审校收录,不引 npm 依赖——供应链可控 + 可扩展 flowable 别名)。**验收=双门**:①语料覆盖测试(§0 的 11 属性+5 元素全部声明)②moddle 层 round-trip 零丢失测试 |
| P2 | 影响摘要 diff | 前端 DOMParser 节点级 diff:按 userTask id 对齐,比较 candidateUsers/assignee/formKey/multiInstance 四类属性变化,列「节点名:改了什么」。不做通用图 diff(YAGNI) |
| P3 | 新建模板库 | 3 个:单人审批/两级审批/会签,静态 BPMN 字符串放 `src/modeler/templates/`。**以真实流程为骨架改造**(从「总包合同交底」等抽形),保证与引擎兼容 |
| P4 | 草稿权限 | v1 整页 admin 门(页面+网关双层),草稿全体 admin 共见,无 per-user 属主(YAGNI,v2 再说) |
| P5 | EIP4 定制控件宿主 | **不写 preact 属性面板分组**,改为**同右栏叠放的 React 侧板**(selection.changed 驱动),放标准面板上方。理由:preact entries 与 React+RTL 测试栈割裂、集成风险高;React 侧板同样满足 D4「标准全套+定制叠加」,且原生字段照旧显示+灰字提示。含通用「activiti 扩展属性」键值编辑器兜底长尾属性(D5 全属性可编辑)+ taskListener 简单编辑(event+class/delegateExpression) |
| P6 | 语料保真扫描 | 全量 1512 流 round-trip 扫描做成**工具脚本**(连库跑,如 parity 模式),不进 CI 硬门;单测用**合成 fixture**(复刻 §0 全扩展面+中文 id+全角【】),不把客户 BPMN 提交进仓 |
---
## 阶段 1:moddle 保真 + 只读载入存量(可独立合 main)
### Task 1.1 前端依赖 + moddle 描述符 + 保真单测 ✅(8fdfe68,2026-07-02)
> 完成实证:panel 5.60.0/3.47.0;12/12+全量 101/101 绿;**三发现已回写本计划**(双包冲突→T1.5 只载 activiti / 嵌套全角【】→T2.3 / formKey=裸 UUID)。遗留:bpmn-moddle 无类型声明(TS7016 编辑器诊断,tsc -b 不受影响)→ T1.5 顺带补 `.d.ts`。
**Files:**
- Modify: `eip4-web/package.json`(+`bpmn-js-properties-panel@^5.23.0` +`@bpmn-io/properties-panel@^3.23.0`;装完看 npm 实际解析版本,只需兼容 bpmn-js 17)
- Create: `eip4-web/src/modeler/moddle/activiti.json`(完整 activiti 描述符:name=Activiti, uri=`http://activiti.org/bpmn`, prefix=activiti;types 覆盖 §0 全部 11 属性(挂 bpmn:UserTask/Process/SequenceFlow 等宿主的 extension attributes)+ taskListener/formProperty/field/string/value 元素;另加 flowable 别名描述符 `flowable.json`(uri=`http://flowable.org/bpmn`,覆盖 flowable:assignee 等 3docs 用到的属性))
- Create: `eip4-web/src/modeler/moddle/fidelity.test.ts`
- Create: `eip4-web/src/modeler/moddle/fixtures/synthetic-full-surface.bpmn.ts`(合成 fixture:中文 process id/name + userTask 带 candidateUsers 全角【】JSON + formKey + exclusive + 多实例(collection/elementVariable/completionCondition) + taskListener(class+field/string/value) + formProperty + boundaryEvent/timer + conditionExpression + BPMNDiagram DI)
**Step 1** 写失败测试(fidelity.test.ts,moddle 层 round-trip):
```ts
import BpmnModdle from 'bpmn-moddle';
import activiti from './activiti.json';
import flowable from './flowable.json';
import { SYNTHETIC_BPMN } from './fixtures/synthetic-full-surface.bpmn';
const CORPUS_ATTRS = ['formKey','candidateUsers','exclusive','assignee','collection',
'elementVariable','candidateGroups','autoStoreVariables','initiator','dueDate'];
const CORPUS_ELEMENTS = ['taskListener','formProperty','value','field','string'];
it('语料覆盖:全部实测 activiti 属性/元素在描述符中有声明', () => {
const declared = JSON.stringify(activiti);
[...CORPUS_ATTRS, ...CORPUS_ELEMENTS].forEach(n =>
expect(declared, `activiti:${n} 未声明`).toContain(`"${n}"`));
});
it('round-trip 零丢失:import→export 后全部 activiti 扩展原样保留', async () => {
const moddle = new BpmnModdle({ activiti, flowable });
const { rootElement } = await moddle.fromXML(SYNTHETIC_BPMN);
const { xml } = await moddle.toXML(rootElement, { format: false });
// 关键断言:每个扩展属性值逐字保留(含全角【】JSON、中文 id)
for (const frag of ['activiti:formKey="view_wftemplate_'
, "candidateUsersHandler.getCandidateUsers(execution,'【"
, 'activiti:taskListener', 'activiti:elementVariable="assignee"'
, 'multiInstanceUsersHandler.getUsers']) {
expect(xml).toContain(frag);
}
});
```
**Step 2** `cd eip4-web && npm install bpmn-js-properties-panel@^5.23.0 @bpmn-io/properties-panel@^3.23.0 && npx vitest run src/modeler` → 期望 FAIL(描述符/fixture 不存在)。
**Step 3** 写 activiti.json/flowable.json 描述符 + 合成 fixture(fixture 的多实例/办理人形态先 `psql` 抽「总包合同交底」BPMN 对照,形态照抄)。
**Step 4** `npx vitest run src/modeler` → PASS;`npx tsc -b` 干净。
**Step 5** commit:`feat(modeler): activiti/flowable moddle 描述符 + 语料覆盖/round-trip 保真测试`
### Task 1.2 全量语料保真扫描脚本(工具,不进 CI)
**Files:** Create: `eip4-web/tools/modeler-fidelity-sweep.mjs`
node 脚本:`pg` 不引依赖——用 `psql` 子进程拉 `translate(encode(bytes_,'base64'),E'\n','')`(同勘探法),逐条 bpmn-moddle round-trip,对比「activiti:*/flowable:* 属性与元素多重集」前后一致(归一化后 diff),输出 `匹配 N/1512 + 差异清单`。跑:`node tools/modeler-fidelity-sweep.mjs`(连 5433/eip4)。
**验收:1512/1512 零丢失**(有差异=描述符缺口,回补 Task 1.1 描述符后重跑)。结果记进 commit message。
commit:`feat(modeler): 全量 1512 真实流程 moddle round-trip 保真扫描工具(实测零丢失)`
### Task 1.3 后端:id 净化抽成可逆 `BpmnIdSanitizer`
> ⚠️ **T1.2 实证预警——hash 碰撞**:现行 `"n"+hex(hashCode&0x7fffffff)` **有碰撞可能**(1445/1512 文档 process id 为中文;同文档内两个原 id 撞哈希→引用错乱)。查看器容忍,但**可逆 restore 要求双射**:`sanitize` 必须检测碰撞并消解(碰撞时追加 `-2`/`-3` 序号),并补「同文档撞哈希仍双射可逆」单测(构造碰撞对或可注入 hash 的测试缝)。
**Files:**
- Create: `flowable-service/src/main/java/com/eip4/flowservice/api/BpmnIdSanitizer.java`
- Modify: `flowable-service/src/main/java/com/eip4/flowservice/api/ProcessDiagramController.java`(sanitizeBpmnIds 委托新类,行为不变)
- Create: `flowable-service/src/test/java/com/eip4/flowservice/api/BpmnIdSanitizerTest.java`
**Step 1** 失败测试(核心断言:可逆):
```java
@Test void 净化后还原_逐字节等于原文() {
String xml = 读fixture(中文id流程含processRef/sourceRef引用);
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
assertThat(r.xml()).doesNotContain("总包合同交底");
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
@Test void 还原只回写映射内id_新增ASCII节点id保留() { ... }
@Test void 合法NCName_id不改写_映射为空() { ... }
```
**Step 2** `mvn -pl flowable-service -am test -Dtest=BpmnIdSanitizerTest` → FAIL。
**Step 3** 实现:搬 ProcessDiagramController :113-150 的 `ID_ATTR` 正则与净化逻辑进 `sanitize`(返回 `record Result(String xml, Map<String,String> idMap)`,idMap=原→净化);`restore(xml, idMap)` 用同一 `ID_ATTR` 正则反向替换(净化→原,仅命中 map 值者)。ProcessDiagramController 原 static 方法改为委托(保持包级可见签名,原单测不动)。
**Step 4** `mvn -pl flowable-service -am test`(含既有 ProcessDiagramControllerTest 回归)→ 全绿。
**Step 5** commit:`refactor(flow): id 净化抽 BpmnIdSanitizer,补可逆 restore(D7 地基)`
### Task 1.4 后端:按 procDefId 取源 XML 端点
**Files:**
- Modify: `flowable-service/.../api/ProcessDiagramController.java`(新增端点,readProcessModel 已在此类)
- Modify: `flowable-service/src/test/java/com/eip4/flowservice/api/ProcessDiagramControllerTest.java`
**Step 1** 失败测试:`GET /api/flow/process-definitions/{procDefId}/source` → `{found:true, bpmnXml:<净化后>, idMap:{原:净}, procDefKey, version}`;procDefId 不存在 → `{found:false}`(200,防御性——网关照 diagram 惯例)。
**Step 3** 实现:`repositoryService.getProcessModel` + `createProcessDefinitionQuery().processDefinitionId(id).singleResult()`(取 key/version)+ `BpmnIdSanitizer.sanitize`,返回 xml 与 idMap。
**Step 4** `mvn -pl flowable-service -am test` 绿。**Step 5** commit:`feat(flow): 按 procDefId 取净化源 XML 端点(含 idMap)`
### Task 1.5 前端:ProcessModelerPage 骨架 + 只读载入存量
**Files:**
- Create: `eip4-web/src/pages/ProcessModelerPage.tsx`、`src/api/processModeler.ts`、`src/pages/ProcessModelerPage.test.tsx`
- Modify: `src/App.tsx`(+route `/process-modeler`)、`src/pages/DesignCenterPage.tsx`(+入口按钮 `dc-process-modeler`「流程设计」)、`src/shell/Topbar.tsx`(admin 图标可选,跟设计中心并排)
**Step 1** 失败测试(照 ModelerPage.test.tsx 范式:importOriginal 保留 isAdminProfile、mock getProfile + api):admin 可见容器 `data-testid="process-modeler-canvas"` 与属性面板容器;非 admin 显示「仅管理员可用」;`?procDefId=` 时调 `fetchProcDefSource` 并 importXML(mock api 返合成 fixture)。
**Step 3** 实现:照 ProcessDiagram.tsx 生命周期(alive flag/destroy)挂 `bpmn-js/lib/Modeler`:
```ts
import Modeler from 'bpmn-js/lib/Modeler';
import { BpmnPropertiesPanelModule, BpmnPropertiesProviderModule } from 'bpmn-js-properties-panel';
import 'bpmn-js/dist/assets/diagram-js.css';
import 'bpmn-js/dist/assets/bpmn-js.css';
import 'bpmn-js/dist/assets/bpmn-font/css/bpmn.css';
import '@bpmn-io/properties-panel/dist/assets/properties-panel.css';
import activitiModdle from '../modeler/moddle/activiti.json';
// (app 代码首次 import json:本 task 顺带在 tsconfig.app.json 开 "resolveJsonModule": true)
const modeler = new Modeler({
container: canvasRef.current,
propertiesPanel: { parent: panelRef.current },
additionalModules: [BpmnPropertiesPanelModule, BpmnPropertiesProviderModule],
// ⚠️ 只载 activiti!T1.1 实证:activiti+flowable 双包同载会因 bpmn:UserTask 同名 extends
// 属性冲突(not allowed without redefines)静默丢弃 userTask。语料 1509/3 两命名空间不混用;
// 单载 activiti 时 flowable 文档经 moddle lax $attrs 零丢失往返。flowable.json 只做隔离单测。
// ⚠️ 同理:只 import 标准 BpmnPropertiesProviderModule,严禁引 Camunda provider——
// 它会把 camunda 描述符注进 moddle,即双包冲突的变体(T1.1 评审 M-3)。
moddleExtensions: { activiti: activitiModdle },
});
```
布局参照 DesignerPage:顶栏(名称/保存草稿·发布·返回,本阶段按钮 disabled 占位)+ 左画布 + 右栏(上=EIP4 侧板占位,下=标准面板)。存量入口:设计中心按钮 → 新页内「打开存量流程」下拉(数据源复用 `GET /api/process-select/options`)。
**Step 4** `npx vitest run` + `npx tsc -b` + `npm run build` 全绿。
**Step 5** commit:`feat(modeler): /process-modeler 页骨架(Modeler+标准属性面板+存量只读载入)`
### Task 1.6 网关:source 转发 + 阶段 1 live 验收
> 🔴 **阶段1 live 验收实证(2026-07-02)——options 语义缺口已修**:`/api/process-select/options` 在合并库返回的 143 选项**全部 source='model',option.id=act_re_model 的 id 非 procDefId**(计划原假设错),打开器按 procDefId 载入恒 found:false。修法=新增 **by-key 取最新版**端点(`GET /api/flow/process-definitions/by-key/{key}/source` + 网关同门转发),前端打开器按 option.source 双参分派(model→?procKey=key / processDefinition→?procDefId=id)。
>
> ⚠️ **T1.4 评审 M-2——中文 procDefId 编码**:真实 procDefId 形如 `总包合同交底:3:<uuid>`(中文+冒号进 path segment)。网关 FlowableClient 转发**必须用 UriComponentsBuilder/uriVariables 正确编码**(禁字符串拼 URL),且测试必须含一个**中文 procDefId 用例**(MockRestServiceServer 断言转发 URL 编码正确);live 验收也必须用中文 key 流程点穿 HTTP 全链。
**Files:**
- Modify: `platform-flow-gateway/.../client/FlowableClient.java`(+`procDefSource(procDefId)`)
- Create: `platform-flow-gateway/.../web/ProcessModelerController.java`(`GET /api/workflow/process-definitions/{id}/source`,**超管门**:`AuthPrincipal` 校验 `EngineContextBinder.isSystemAdmin`,非超管 403——若该方法非 public static,本 task 顺带提升可见性并补一个判定单测)
- Create: `platform-flow-gateway/src/test/.../ProcessModelerControllerTest.java`(admin 200 转发 / 非 admin 403 / flowable 不可达 503——照 FlowableClientTest 的 MockRestServiceServer 模式)
**live 验收(阶段 1 出口)**:`mvn -pl platform-app,flowable-service -am package -DskipTests` → `run-dev.sh both` → 浏览器 admin 登录 → 设计中心「流程设计」→ 打开「总包合同交底」→ palette/标准属性面板可见、中文节点名正常渲染、点 userTask 属性面板出 BPMN 标准属性。截图留档。
commit + `--no-ff` 合 main:`feat(modeler): 阶段1 存量流程只读载入(moddle保真+可逆净化+页面骨架)`
---
## 阶段 2:EIP4 三控件 + 草稿(act_re_model)
### Task 2.1 后端:ProcessModelController(草稿 CRUD + from-procdef)
**Files:**
- Create: `flowable-service/.../api/ProcessModelController.java`(`@RequestMapping("/api/flow")`)
- Create: `flowable-service/src/test/.../ProcessModelControllerTest.java`(@Mock RepositoryService + Model + ModelQuery,MockMvc standalone,照 ProcessDiagramControllerTest)
端点(全裸 JSON,防御性风格同 diagram):
- `GET /models` → `createModelQuery().orderByLastUpdateTime().desc().list()` → `[{id,name,key,lastUpdateTime}]`
- `GET /models/{id}` → model + `new String(getModelEditorSource(id), UTF_8)` → `{found,id,name,key,bpmnXml,metaInfo}`
- `POST /models` body `{name,key,bpmnXml,metaInfo?}` → `newModel()`+`saveModel`+`addModelEditorSource`(XML 先过 BpmnXMLConverter 解析守卫,坏 XML→422)
- `PUT /models/{id}` → 更新 name/editorSource/metaInfo(不存在→404)
- `POST /models/from-procdef` body `{procDefId}` → 读源 XML → `BpmnIdSanitizer.sanitize` → 建 model,**metaInfo=`{"eip4IdMap":{...},"sourceProcDefId":"...","originalKey":"总包合同交底"}`**(jackson 序列化)→ `{modelId}`
TDD 循环同前;测试含:from-procdef 的 metaInfo 落 idMap、坏 XML 422、404。
commit:`feat(flow): 流程草稿 ProcessModelController(act_re_model,Model API 首次启用)`
### Task 2.2 网关:models 全套转发 + wftemplate picker 数据源
> 📌 **T1.6 评审 M-3**:本 task 给 ProcessModelerController 加第二个及以后端点时,先抽 `requireSuperAdmin()` 私有方法(返回 403 ResponseEntity 或 null),所有端点统一过门防漏。
**Files:**
- Modify: `FlowableClient.java`(+models list/get/create/update/fromProcDef 五方法)
- Modify: `ProcessModelerController.java`(+`/api/workflow/models/**` 五端点,全部过超管门)
- Modify: `platform-flow-gateway/.../web/`(新 `GET /api/workflow/wftemplates`:JdbcTemplate `SELECT view_wftemplate_id, ... FROM view_wftemplate`——**实现前先 psql `\d view_wftemplate` 核实名称列**(name 或 xml 内 title,照 WfTemplateService.parse 的取名逻辑),返 `[{id,name}]`)
- Tests:转发/403/wftemplates 列表(mock JdbcTemplate)
commit:`feat(gateway): 流程草稿转发(超管门)+wftemplate picker 数据源`
### Task 2.3 前端:办理人表达式编解码器(纯函数,TDD 核心件)
**Files:** Create: `eip4-web/src/modeler/candidateExpression.ts` + `candidateExpression.test.ts`
**Step 1** 失败测试(真实形态往返):
```ts
// T1.1 psql 实证真实形态:外层对象与 items 内每个对象的花括号**全部**是全角【】,
// 方括号[]半角,XML 属性内引号转义为 &quot;,content 可带 CHAR 尾部补白空格(不可 trim)。
const REAL = `\${candidateUsersHandler.getCandidateUsers(execution,'【"items":[【"type":"user","content":"u1,u2","isCandidate":true,"isSendMail":false,"isSendPhone":false】]】')}`;
it('解析真实表达式(全角【】)', () => {
const r = parseCandidateExpression(REAL);
expect(r!.items[0]).toMatchObject({ type: 'user', content: 'u1,u2', isCandidate: true });
});
it('构建=引擎口径(全角【】+前缀后缀逐字)', () => {
expect(buildCandidateExpression(r.items)).toBe(REAL);
});
it('scriptUser/depart/beforeTaskLeader 各 type 往返不丢字段', ...);
it('multiInstance 前缀变体 multiInstanceUsersHandler.getUsers 同套解析', ...);
it('非法/空表达式返回 null 不抛', ...);
```
> ⚠️ 全角【】的准确包裹形态(`【"items":...】` 还是 `{"items":...}` 外层才转)**以「总包合同交底」真实 BPMN 逐字为准**——写实现前先 psql 抽原文对照,测试 fixture 逐字复制真实片段。
**Step 3** 实现 `parse/build`(前后缀常量逐字对齐 BasePropertiesConverter :34-35;build 输出全角,parse 兼容全角/半角)。
commit:`feat(modeler): 办理人/会签表达式编解码器(与 BasePropertiesConverter 逐字对齐)`
### Task 2.4 前端:EIP4 侧板(办理人/会签/formKey/扩展属性/监听器)
> 🔴 **T2.3 实证——meta 透传是正确性硬要求**:真实表达式外层对象除 items 外还有 5 个业务 meta 字段(messageTemplate/taskSuccessService/isSkipInitiator/isNoUserSkip/isSkipBeforeTask;taskSuccessService 是真实任务后置服务钩子如 PM_CONTRACTUALREGISTER_UPDATEPROJECTSTATUS)。codec 的 parse 已返 `{items,variant,meta}`、build 收 meta 可选参——**侧板写回办理人/会签时必须把 parse 出的 meta 原样传回 build**,否则发布会打掉已部署流程的业务字段。测试必须含「改 items 后 meta 逐字保留」用例。
>
> 📌 **随本 task 顺带收 T1.5 评审遗留**:红线回归测试——ProcessModelerPage 测试断言 `ModelerCtor.mock.calls[0][0].moddleExtensions` 键恰为 `['activiti']` 且 `additionalModules` 长度为 2(防「顺手」加 provider 静默回归)。(canvas ref null 分支已随 dffd1f3 修复,勿重复。)
**Files:**
- Create: `src/modeler/Eip4Panel.tsx`(+`Eip4Panel.test.tsx`)、`src/modeler/useSelectedElement.ts`(订阅 `selection.changed`)
- Modify: `ProcessModelerPage.tsx`(右栏上方挂 Eip4Panel)
控件(全部经 bpmn-js `modeling.updateProperties(element, {...})` 写回,undo/redo 天然生效):
1. **办理人**(userTask 选中时):解析 `activiti:candidateUsers` → items 表格编辑(type 下拉=§0 的 10 种 + content 文本 + isCandidate/三个通知开关)→ build 回写。原生字段照旧显示于标准面板,控件顶部灰字:「EIP4 引擎以本控件为准,下方原生字段仅供高级调试」。
2. **会签**:开关=读写 `loopCharacteristics`(`moddle.create('bpmn:MultiInstanceLoopCharacteristics', {isSequential, collection: MI表达式, elementVariable:'assignee'})` + completionCondition 三预设:全票 `${nrOfCompletedInstances/nrOfInstances==1}`/过半 `>0.5`/指定数 `>=N`;**结构逐字对照真实会签流**);人员来源复用办理人 items 编辑器。
3. **formKey**:下拉(数据源 `GET /api/workflow/wftemplates`)写 `activiti:formKey`。
4. **扩展属性**(兜底 D5):列出 `element.businessObject.$attrs` 里 activiti:/flowable: 长尾键值可增删改。
5. **任务监听器**:读写 `extensionElements` 里 `activiti:taskListener`(event 下拉 create/assignment/complete/all + class/delegateExpression 文本;v1 不做 fields 编辑,原样保留)。
测试:RTL 渲染 + 假 element/modeling(vi.fn 断言 updateProperties 载荷);办理人/会签/formKey 三控件各 set/clear 用例。
commit:`feat(modeler): EIP4 侧板三控件+扩展属性/监听器编辑`
### Task 2.5 前端:存草稿 + 草稿列表打开
> 📌 **T2.2 评审遗留——草稿删除端点**:五端点无 DELETE,POST 重试窗口产生的重复草稿无 API 可清、草稿列表 UX 也需要删除。**本 task 或 T4.1 补**:flowable-service `DELETE /api/flow/models/{id}`(deleteModel)+ 网关同门转发 + 前端草稿列表删除按钮(confirm)。
>
> 📌 **T2.2 实证——wftemplates 名称现实**:view_wftemplate **无名称列**(计划原假设错),网关已按 entityid→sys_entity.name 解析——1016 活动模板仅 339 有中文名,其余下拉显 uuid。**formKey 下拉须加过滤输入框**(1016 项不可裸滚动),无名项显示「<uuid 前 8 位>…(未命名)」。此项归本 task 或 T2.4 收口轮顺带。
**Files:** Modify `processModeler.ts`(saveDraft/createDraft/listModels/getModel/fromProcDef)、`ProcessModelerPage.tsx`(顶栏「保存草稿」`saveXML({format:true})`→PUT;打开器加「草稿」tab);tests。
**阶段 2 live 验收**:打开「总包合同交底」→ from-procdef 建草稿 → 改办理人(加一个 user)→ 保存 → psql 查 `act_re_model` 新行 + `act_ge_bytearray` 编辑源含改动 + metaInfo 含 eip4IdMap → 重开草稿回显正确。
commit + 合 main:`feat(modeler): 阶段2 EIP4 控件+草稿闭环`
---
## 阶段 3:发布门(校验 + 超管 + 同人确认 + 审计 + id 还原)
### Task 3.1 后端:deploy-from-model(id 还原 + 引擎校验门)
> 🔴 **阶段2 live 实证——bpmn-js 输出被严格 XSD 校验拒(已修,且警示 T3.1)**:flowable `convertToBpmnModel(src, validateSchema=true, ...)` 的严格 Xerces XSD 校验**拒绝 bpmn-js saveXML 的默认命名空间输出**(`cvc-complex-type.2.4.a: Invalid content ... {MODEL}Process`),原始带前缀 source 能过。草稿保存已改 validateSchema=false(草稿是半成品,XSD 不适用)+ 字节级 DOCTYPE 守卫保 XXE。**本 task deploy 必须验证同问题**:`createDeployment().addString().deploy()` 也解析 bpmn-js 输出,若 Flowable 部署校验拒默认命名空间/activiti 扩展,需在部署前把 bpmn-js XML 规范化(或确认 deploy 路径不走严格 XSD)——阶段 3 live 必须用「编辑器改过并 saveXML 的真实流程」部署,不能只用原始 source。
> ⚠️ **T1.3 评审 I-2 预警——文本引用**:bpmn-js `saveXML` 会给流节点补 `<bpmn:incoming>/<bpmn:outgoing>` **元素文本**引用(存量 1512 文档 0 命中,但编辑器导出会有),`BpmnIdSanitizer.restore` 只还原**属性位** → 直接部署会落库「属性=中文原 id、文本引用=净化 id」的脏 XML(Flowable 不解析 incoming/outgoing 故功能无害,但再次 from-procdef 重编辑时碰撞序号换位可能指错节点)。**本 task 必须**:restore 前剥除 incoming/outgoing 元素(Flowable 自行从 sequenceFlow 推导)或把文本引用位纳入 restore,二选一并加测试(含「编辑器导出态 XML → 部署 XML 无净化 id 残留」断言)。
**Files:** Modify `ProcessModelController.java` + test。
`POST /models/{id}/deploy`:
1. 读 editorSource + metaInfo.eip4IdMap → `BpmnIdSanitizer.restore`(**存量 key 还原为中文原 key**;无 idMap=新建流程,跳过)。
2. **引擎校验门**:`BpmnXMLConverter.convertToBpmnModel` + `new ProcessValidatorFactory().createDefaultProcessValidator().validate(model)` → 有 error 返回 422 `{errors:[{activityId,problem}]}` 不部署。
3. `createDeployment().name(model.getName()).addString(key+".bpmn20.xml", restoredXml).deploy()` → 查新 procdef → `{deploymentId, processKey, newVersion}`。
4. `GET /models/{id}/impact`:还原后解析 key → `{processKey, currentVersion(latest procdef), runningInstances(runtimeService.createProcessInstanceQuery().processDefinitionKey(key).count())}`。
测试:还原后部署 XML 含原中文 key(捕获 addString 参数断言)、校验失败 422 不调 deploy、impact 计数。
commit:`feat(flow): 草稿发布(id还原+ProcessValidator校验门)+影响摘要端点`
### Task 3.2 网关:EIP4 语义校验 + 部署审计(Flyway V4)
> 📌 **T2.4 评审补充**:语义校验白名单须加两条——①办理人/会签表达式的 `items` **非空**(`items:[]` 的 MI collection 运行期会炸,仅 JSON 可解析+type 白名单不够);②completionCondition 允许「三预设 或 保留的自定义 body」(T2.4 已实现自定义保留态,校验别把存量自定义条件拒了,白名单改为预设正则 ∪ 非空任意表达式加告警)。
**Files:**
- Create: `platform-flow-gateway/.../aggregate/ModelSemanticValidator.java` + test:解析 XML(**照 WfTemplateService.newJdkDbf :116-135 钉 JDK 解析器**,防 xerces 击穿)→ ①每个 `activiti:candidateUsers`/multiInstance collection 的内嵌 JSON 可解析且 items[].type ∈ 白名单 ②`activiti:formKey` 存在于 view_wftemplate(JdbcTemplate exists)③completionCondition 匹配预设白名单正则。返回 `List<String> errors`。
- Create: `platform-app/src/main/resources/db/migration/V4__flow_deploy_audit.sql`(照 V3 风格):`sys_flow_deploy_audit(id bigserial pk, model_id, deployment_id, process_key, new_version int, operator varchar(64), deployed_at timestamp default now())`
- Modify: `ProcessModelerController.java`:deploy 端点=超管门 → ModelSemanticValidator(fail→422 带明细)→ FlowableClient.deployModel → 成功后 JdbcTemplate INSERT 审计行(operator=principal.userId())。
- Tests:语义校验三类各 fail 用例 / 非 admin 403 / 审计行落库断言(mock JdbcTemplate 捕获参数)。
commit:`feat(gateway): 发布语义校验门+sys_flow_deploy_audit 审计(V4)`
> 🔴🔴 **阶段3 live 揪出 CRITICAL——activiti.json 描述符致 bpmn-js Modeler 输出 PascalCase 元素名(部署链断)**:bpmn-js Modeler.saveXML 对 activiti.json `extends` 的 bpmn 类型(Process/UserTask/StartEvent)序列化成大写 `<Process>/<UserTask>/<StartEvent>`(未扩展的 sequenceFlow/endEvent 仍小写)。Flowable 大小写敏感→`<Process>` 不识别→ProcessValidator 报 flowable-process-definition-not-executable,**部署完全断**。「isExecutable 丢失」是此 bug 症状非独立问题。**T1.1/T1.2 moddle round-trip 测试抓不到**(直接 fromXML→toXML 读写同形),只有真 Modeler saveXML+真部署暴露(live 铁证)。修=重构 activiti.json 扩展类型定义让 Modeler 序列化保持小写 BPMN 元素名(moddle extends 惯用法),验收硬门=saveXML 输出小写 userTask/process + 真部署 200 + 起实例生成 userTask。已挂 T3.3 修复轮 + 需前端保真测试升级到「过 bpmn-js Modeler.saveXML 非仅 bpmn-moddle」。
### Task 3.3 前端:同人确认弹窗(影响摘要)+ 发布流
**Files:** Create `src/modeler/PublishConfirm.tsx`(+test)、`src/modeler/diffSummary.ts`(+test,P2 节点级 diff);Modify `ProcessModelerPage.tsx`。
发布点击 → 并发取 impact + 本地 diffSummary(打开时的源 XML vs 当前 saveXML)→ `ui/Dialog`:流程 key/当前版本→新版本/运行中实例数(灰字:留在旧版本不受影响)/「办理人或会签变更节点」清单 → 确认 → deploy → `toast('已发布 vN','ok')`;422 校验失败按节点渲染错误清单。
commit:`feat(modeler): 同人确认发布(影响摘要+节点级diff+校验错误展示)`
**阶段 3 live 验收**:改「总包合同交底」办理人 → 发布 → psql 验 act_re_procdef 新版本 **key_ 仍=总包合同交底**、sys_flow_deploy_audit 有行、旧版本运行实例不受影响;非 admin 用户 curl deploy=403。合 main。
---
## 阶段 4:新建流程 + live e2e + 收尾
### Task 4.1 模板库 + 新建流
**Files:** Create `src/modeler/templates/{blank,single-approval,two-level,cosign}.bpmn.ts` + `NewProcessDialog.tsx`(名称/key/模板选择;key 允许中文——引擎既有事实)+ tests。模板以真实流程结构为骨架(psql 抽形改造),三模板全部先过 Task 1.1 round-trip 测试 + 后端 ProcessValidator 校验。
commit:`feat(modeler): 空白/单人/两级/会签模板新建流程`
### Task 4.2 Playwright live e2e(8094 惯例)
**Files:** Create `eip4-web/playwright.process-modeler.config.ts`(照 fivering:VITE_BACKEND_TARGET=8094、vite 5174、testMatch process-modeler)+ `e2e/process-modeler.spec.ts`。
场景(复用 five-ring 的 apiJson/adminToken/登录块):
1. **改存量全链**:登录 admin → 流程设计 → 打开「总包合同交底」→ 改办理人 content 加用户 → 保存草稿 → 发布(确认弹窗断言含 key/版本/实例数)→ `apiJson POST /api/flow/process/start {processDefinitionKey:'总包合同交底'}` → 取新实例任务 approval-context 断言新办理人生效。
2. **新建全链**:会签模板新建 → formKey 选一个 → 发布 → start → 任务出现。
3. **走查**:中文节点名渲染 / palette 元素齐 / 标准面板 + EIP4 侧板同屏 / 非 admin 页面降级。
跑法(spec 头注释):`java -jar platform-app/target/*.jar --server.port=8094` + flowable 8089 → `npx playwright test -c playwright.process-modeler.config.ts`。
commit:`test(modeler): 流程Modeler live e2e(改存量/新建/走查 3 场景)`
### Task 4.3 收尾:文档回写 + 对抗评审
- 总览 B3 行 🔴→🟢(证据哈希)、A2 行「仅剩」措辞更新、README/设计中心导航登记;本计划顶部加完成横幅。
- **对抗评审**(house 惯例,不可跳):code-reviewer + security-reviewer 双 agent 过 diff(重点:网关超管门绕过面 / restore 正则替换的边界(id 是另一 id 前缀)/ deploy XML 注入面 / 审计字段),揪修后全量 `mvn clean install` + `npm test` + e2e 重跑。
- 合 main + push。
---
## B3 最终发布链对抗评审处置(2026-07-02)
判定「可宣告完成,无 Critical 无阻断」。id 保真闭环三来源自洽+发布错误契约双形状透传扎实。跟进项处置:
- **I-1 formKey 门误拒改存量——语料 dry-run 证伪(无需修)**:全库 803 个 distinct activiti:formKey **全部命中 view_wftemplate(miss=0)**,formKey 门不会误拒任何存量流程。评审担心的静默回归在真实库不成立。
- **I-2 空 content 语义缺口**:已作已知限制记录(见下),v2 精化(content 可能是变量表达式,硬要求非空会误拒,需按 type 分白名单)。
- **M-1**(下游 422 顶层文案 handler 用 message、前端读 msg,per-node 错误仍渲染)/ M-2(by-id 写删侧无 category 守卫,超管门+UI 已兜)/ M-3(writeCosign 重建只保 4 属性,真实会签仅用 handler-collection 模式暴露低)= 低优先清理 backlog。
## B3 最终安全对抗评审(2026-07-02 阶段4)——1 Critical 已修 + A10 生产加固 backlog
- **✅ Critical#1 已修**:`deploy/nginx.conf` 的 `/flowable/` 裸 proxy 到无鉴权 8089 对公网暴露→绕过网关超管门匿名部署/覆盖生产 BPMN。改 `return 404`(前端只走 `/api/workflow/` 网关,不需要直达)。**注:此洞在 A10 部署骨架里、生产未切流,非 B3 运行时可达**;网关侧超管门本身实现严密无绕过面(评审确认)。
- **A10 生产加固 backlog(非 B3 dev 阻塞,超管信任模型内可接受,随 A10 生产化做)**:High#2 部署 BPMN 可含 serviceTask/JUEL 表达式/监听器=引擎内表达式求值面(超管信任内可接受;修 #1 后降为加固项,v2 可加可执行元素白名单);Medium#3 网关→flowable-service 无凭据纯靠网络隔离(加 X-Internal-Auth 共享密钥纵深);Medium#4 审计只覆盖网关 deploy 路径+写失败静默(下沉审计到 flowable-service 实际部署点或加失败告警)。Low#5(无细粒度流程授权=v1有意)/#6(伪造metaInfo不提权=超管本可写任意key)/#7(impact 缺 DOCTYPE 兜底=enableSafeBpmnXml 已挡)/#8(disableSchemaValidation 只跳 XSD 不开 DTD) 均已缓解/可接受。
## 已知限制 / v2 精化点(2026-07-02 阶段4 e2e 发现)
- **会签办理人 content 为空的语义缺口**:ModelSemanticValidator 校验 `items 非空`(数组长度)但不校验 candidate item 的 `content 非空`。会签模板出厂 items=[{type:user,content:""}] 过语义门,但运行期 multiInstanceUsersHandler 解析空 content → MI 跳过 → 流程无任务直接结束。**不硬修**(content 常是 `${APPLYUSERS}` 变量表达式,硬要求非空会误拒合法流程);v2 可考虑「content 空且非变量表达式 → WARNING」。用户新建会签流程须填办理人,否则部署出空转流程。
- **live e2e 非幂等**:发布无运行时下架端点,每跑场景A「总包合同交底」版本 +1(live 验收固有,非 CI 硬门)。
- **非超管 403 e2e 降级**:dev 库无非超管账号,场景C④用无 token(principal==null 走同一 requireSuperAdmin 分支)+admin 对照证门有效;真非超管 token 断言待 dev 库补账号。
## 验收清单(全项打勾才算 B3 完成)
- [ ] 1512 流 moddle round-trip 扫描零丢失(Task 1.2 工具实测)
- [ ] 打开存量中文 key 流程→编辑→发布,act_re_procdef 新版本 key 不变(D7)
- [ ] 办理人/会签/formKey 三控件双向往返与 BasePropertiesConverter 逐字兼容(D4)
- [ ] 发布门:非超管 403 / ProcessValidator+语义校验 422 / 审计行落库(D2)
- [ ] 运行中实例留旧版本(D8,e2e 断言)
- [ ] 新建(空白+3 模板)可部署可起实例(D1)
- [ ] Playwright 3 场景 + 全量单测 + `mvn clean install` + `tsc -b`/`npm run build` 全绿
- [ ] 对抗评审收口,文档回写
## 红线提醒(执行中不可越)
**每阶段合 main 前必须全 reactor `mvn clean install` 真绿**(模块级 `mvn -pl` 跑不到 platform-app 的 ArchitectureRulesTest,阶段2 wftemplates 给 @RestController 注 JdbcTemplate 触棘轮就是模块级漏过、全 reactor 才 catch;且判绿看 `BUILD SUCCESS` 字样,勿信 `| tail` 后的 `$?`=tail 退出码);控制器新增 SQL 一律收口 Service(ArchUnit 棘轮禁 @RestController 直用 JdbcTemplate);**生产 8089 不对外**(T1.6 评审:门在网关的前提=flowable-service 网络隔离,阶段 3 部署门验收清单显式检查,deploy/nginx/compose 不得暴露 8089);flowable `databaseSchemaUpdate=false` 不动(act_re_model 已存在无需 DDL;审计表走 Flyway V4 是平台表非引擎表);保真层 `com.dsasp.*` 不改(BasePropertiesConverter 只读对齐,不重构);XML 解析一律钉 JDK 解析器(xerces 击穿前科);JDK 21;部署门只落网关(flowable-service 裸 8089 无安全栈);每 task TDD、每阶段对抗自查后才合 main。

View File

@@ -50,7 +50,7 @@
## WS-B:onEvent 脚本挂回(按钮联动 / 表单只读联动) ## WS-B:onEvent 脚本挂回(按钮联动 / 表单只读联动)
> P0(rewritten-root 路径)已修并提交 `7b76dce`。本 WS 修 P0+(seq 映射/覆盖/事件类型/组件)。**完整 TDD 细化见原稿** `docs/plans/2026-06-14-onEvent脚本挂回修复-plan.md`(Phase 0 Spike→Phase 4 验收),此处仅列要点,实施以原稿为准。 > P0(rewritten-root 路径)已修并提交 `7b76dce`。本 WS 修 P0+(seq 映射/覆盖/事件类型/组件)。**完整 TDD 细化见原稿** `docs/归档/2026-06-14-onEvent脚本挂回修复-plan.md`(Phase 0 Spike→Phase 4 验收),此处仅列要点,实施以原稿为准。
**根因:** `TemplateToAmisConverter.attachScriptOnEvent`:1644 只挂 `full_auto_index.json` 的 FULL_AUTO 脚本(漏 NO_S3 的「按钮状态控制」onselectedscript),且每段同挂 inited+change 不分事件/组件;工具栏按钮无 `id` 致 enableButton 指令定位不到。影响 930 onselected/422 onload/259 enableButton 模板。 **根因:** `TemplateToAmisConverter.attachScriptOnEvent`:1644 只挂 `full_auto_index.json` 的 FULL_AUTO 脚本(漏 NO_S3 的「按钮状态控制」onselectedscript),且每段同挂 inited+change 不分事件/组件;工具栏按钮无 `id` 致 enableButton 指令定位不到。影响 930 onselected/422 onload/259 enableButton 模板。

86
docs/新人上手.md Normal file
View File

@@ -0,0 +1,86 @@
# 新人上手 — 第一天路径
> 目标:半天内从零到「本地起全栈 + 登录看到真实页面 + 全量测试绿」。
> 遇到与本文不符的情况,以 `README.md`(仓根)+ `docs/架构设计.md` 为准并回改本文。
## 0. 前置软件
| 软件 | 版本 | 说明 |
|---|---|---|
| JDK | **21(硬性,严禁 26)** | `brew install openjdk@21`。保真层 Groovy 4.0.27 不认 JDK 26 字节码,服务流会批量 500(`scripts/run-dev.sh` 有守卫,详见仓根 README) |
| Node | 22+ | 前端 Vite + amis 本地 SDK |
| PostgreSQL | 15 | 本地 `localhost:5433`(惯例 `PGDATA=~/eip4-pgdata`,非 brew 默认);psql 查业务表先 `set search_path=eip3` |
| Maven | 3.9+ | 模块化构建注意:`mvn -pl <模块>` **必须加 `-am`** |
## 1. 取码
> ⚠️ **托管现状**:三仓目前在项目负责人的**私人 Git 托管**,**非团队基础设施**。
> 团队接手前需二选一:迁移到团队代码托管(届时本节地址与 CONTRIBUTING 的 CI 段随之更新),
> 或由仓主开通协作者账号。CI runner 也应部署在团队侧而非个人机器。
取码地址与账号**向项目负责人索取**(当前为私有 Gitea,SSH 走非标准端口,需在 `~/.ssh/config` 为该 Host 配 `Port`)。
clone 三个仓到同一父目录(前后端脚本按兄弟目录相互引用):
```bash
git clone <GIT_HOST>:<OWNER>/eip4-platform.git
git clone <GIT_HOST>:<OWNER>/eip4-web.git
git clone <GIT_HOST>:<OWNER>/amis-fork.git # 渲染 SDK 源,日常开发只读,可后取
```
## 2. 后端:构建 + 开发库 + 起服务
```bash
cd eip4-platform
mvn clean install # 全 reactor 构建+单测(首次较久);绿=环境 OK 第一证
bash tools/local-devdb/build_devdb.sh --drop-target
# 构建日常开发库 eip4dev(约 6 分钟,需内网可达客户库副本 192.168.20.68:5435)
mvn -pl platform-app,flowable-service -am package -DskipTests # 出可运行 jar
bash scripts/run-dev.sh both # platform :8093(dev profile) + flowable-service :8089
curl -s localhost:8093/v3/api-docs | head -c 80 # 健康判定用这个端点(返回 JSON 即活)
```
- 日志:`/tmp/eip4-platform.log`、`/tmp/eip4-flowable.log`。
- 不在内网/没有客户库副本:用 `deploy/` 的 compose 演示栈(见 `deploy/README.md`),或 local profile + `eip4m0` 极简自举集(CI/对拍口径,账号 alice/123456)。
- 三套 profile 的含义与端口:见仓根 `README.md`「三套 profile」表。
## 3. 前端:起 dev server
```bash
cd ../eip4-web
npm install
npm run dev # :5173,/api 反代 dev 后端 :8093(.env 已配)
```
浏览器 `http://localhost:5173/login`,**dev 库账号 `admin` / `111111`**。
登录后随便开几个菜单(如 新闻管理/用户管理),列表能出数据即全链路通。
```bash
npx vitest run && npm run build # 前端测试 + 生产构建绿=环境 OK 第二证
```
## 4. 必读文档(按序,约 1-2 小时)
1. 仓根 `README.md` — 模块地图、双层制纪律、三套 profile、JDK 红线
2. `docs/架构设计.md` — 双层制(保真层供奉/现代层生长)全部架构决策
3. `docs/迁移手册.md` — 引擎坑位台账(§5 引擎行为契约最常用)
4. `docs/README.md` — 全文档索引与状态分级(**历史/归档文档勿据以判断进度**)
5. `docs/项目进度与路线-总览-2026-06-21.md` — 进度权威(A/B 矩阵 + 待拍板)
6. 仓根 `CONTRIBUTING.md` — 分支/合并/提交/质量门约定
## 5. 高频坑(前人真踩过的)
- **fat jar 不重打**:改代码后 `mvn -pl platform-app -am package` 若行为没变,加 `clean` —— 增量打包可能没把改动打进 fat jar。
- **`mvn -pl` 忘 `-am`**:兄弟模块改动没被一起构建,报旧类错误。
- **前端页面卡死/转圈**:先杀孤儿 vite 进程(端口会漂 5173→5176…),再 `rm -rf node_modules/.vite` 清 pre-bundle 缓存重起。
- **psql 查不到表**:业务 schema 是 `eip3`,先 `set search_path=eip3`。
- **登录接口取 token**:`POST /api/auth/login` 的 token 在响应**顶层** `token` 字段;引擎主键 CHAR 补白,比对/传参前 `trim`。
- **改转换器不生效**:转换器产物落 `sys_page_schema`,改完须**重转重导**(BatchConvertCli + SchemaImportCli)运行库才变。
- **CRLF + tab 的老文件**:别用 sed 改,用 python 脚本改(保字节格式)。
## 6. 红线(越线=返工)
- 保真层 `com.dsasp.*` **只移植不重写**、不改包名(ArchUnit 强制现代层→保真层单向依赖)。
- 引擎 DDL 只走守卫单点(`AlterTableSqlGuard`/`CreateTableSqlGuard`/`DropTableSqlGuard`),禁裸 JDBC DDL。
- Flowable `databaseSchemaUpdate=false`,严禁引擎自动改表。
- AI 产物终点恒人审(`READY_FOR_HUMAN_REVIEW`),平台不内置生成 LLM;**对外严禁承诺「AI 全自动开发」**。
- amis 锁 6.13.0 本地 SDK,不依赖 CDN、不升版本。

View File

@@ -4,6 +4,10 @@
> 本文档固化了立项后关于工程结构、选型、中间件、保真层安全/性能的全部架构决策。 > 本文档固化了立项后关于工程结构、选型、中间件、保真层安全/性能的全部架构决策。
> **新会话/新成员开工 eip4-platform 前必读本文。** > **新会话/新成员开工 eip4-platform 前必读本文。**
## 当前架构图(2026-06-26)
![EIP4 最新架构](assets/eip4-architecture-2026-06-26.png)
--- ---
## 一、总原则:双层制——保真层供奉,现代层生长 ## 一、总原则:双层制——保真层供奉,现代层生长

View File

@@ -123,7 +123,7 @@ classpath:`mvn -pl platform-converter dependency:build-classpath -Dmdep.output
**live 验证(浏览器 dogfood,决定性证据)**:navigate `/page/71de2065...` 独立渲染表单 → 选组织「名城分公司」→ 网络实证 `GET /api/picker/SYS_DEPART/list?...&PARENTORGID=402881...0006` 自动重拉、部门下拉只显「名城分公司>经理室」→ 选该部门 → `GET .../SYS_POSITION/list?...&PARENTDEPARTID=402881...0063`、岗位下拉只显「经理室>科员/经理」。API 层亦验证(部门 48→28、岗位 75→6,匹配 DB)。「添加」按钮弹窗正常打开渲染该表单(无 bug;先前点击没弹是页面未就绪的时序问题,刷新后正常)。 **live 验证(浏览器 dogfood,决定性证据)**:navigate `/page/71de2065...` 独立渲染表单 → 选组织「名城分公司」→ 网络实证 `GET /api/picker/SYS_DEPART/list?...&PARENTORGID=402881...0006` 自动重拉、部门下拉只显「名城分公司>经理室」→ 选该部门 → `GET .../SYS_POSITION/list?...&PARENTDEPARTID=402881...0063`、岗位下拉只显「经理室>科员/经理」。API 层亦验证(部门 48→28、岗位 75→6,匹配 DB)。「添加」按钮弹窗正常打开渲染该表单(无 bug;先前点击没弹是页面未就绪的时序问题,刷新后正常)。
**部署**:转换器=schema 改动,重转 + 只导这 4 页(避免 24 噪声页 churn)即时生效;PickerController=后端改动,**已 `mvn -pl platform-app -am clean package` 重建 + 重启 8093**(新 jar 验含 `applyColumnFilters`)。备份 `/tmp/platform-app-NEW-filterscript.jar`、回滚 `/tmp/platform-app-BACKUP-running.jar`。converter 149 测试绿 + PickerControllerTest 26 绿。**改动未提交**(TemplateToAmisConverter/PickerController + 2 测试,叠加在上一轮 7 文件之上;eip4-platform 现有远程 git.latent.chat)。 **部署**:转换器=schema 改动,重转 + 只导这 4 页(避免 24 噪声页 churn)即时生效;PickerController=后端改动,**已 `mvn -pl platform-app -am clean package` 重建 + 重启 8093**(新 jar 验含 `applyColumnFilters`)。备份 `/tmp/platform-app-NEW-filterscript.jar`、回滚 `/tmp/platform-app-BACKUP-running.jar`。converter 149 测试绿 + PickerControllerTest 26 绿。**改动未提交**(TemplateToAmisConverter/PickerController + 2 测试,叠加在上一轮 7 文件之上;eip4-platform 现有私有远程)。
**剩余(P2/P3)**:P2 AUTOGENERATECODE 账号自动生成(USERORGID change 调取号端点 → bind ACCOUNT,需补后端取号端点)+ MASTERDEPART 改变设 MASTERPOSITION 必填(可 `requiredOn`);P3 非模式脚本走 `/api/script/execute-template-by-name` 运行时兜底。 **剩余(P2/P3)**:P2 AUTOGENERATECODE 账号自动生成(USERORGID change 调取号端点 → bind ACCOUNT,需补后端取号端点)+ MASTERDEPART 改变设 MASTERPOSITION 必填(可 `requiredOn`);P3 非模式脚本走 `/api/script/execute-template-by-name` 运行时兜底。

View File

@@ -2,7 +2,7 @@
日期:2026-06-16 日期:2026-06-16
触发:用户要求「停下来通盘考虑,保证**所有类型**的旧模板(不光 tree)**没有自定义模板**的功能都能正常使用——新架构(转换器+设计器);自定义的走 bespoke」。 触发:用户要求「停下来通盘考虑,保证**所有类型**的旧模板(不光 tree)**没有自定义模板**的功能都能正常使用——新架构(转换器+设计器);自定义的走 bespoke」。
方法:精读 `转换器覆盖度审计-2026-06-13` / `EIP4-架构与缺口现状-2026-06-13` / `CRUD-QA-发现与剩余-2026-06-14` / `M0交付/153定制视图处置清单v1` + 全库 `view_template` 实测分布,合成一张通盘视图。 方法:精读 `转换器覆盖度审计-2026-06-13` / `EIP4-架构与缺口现状-2026-06-13` / `归档/CRUD-QA-发现与剩余-2026-06-14` / `M0交付/153定制视图处置清单v1` + 全库 `view_template` 实测分布,合成一张通盘视图。
> **状态校准(2026-06-16 晚)**:本计划 §三 的 **P0 三项(日历 type5 / 树 type3 接端点 / 组合 type6)转换器源码已全部实现并提交**(eip4-platform main `598f4f9`,连同审批 `33fda45` / 引用列显名 `cd133aa` / chore `bf56595`;提交前 `mvn test` 绿)。**但下文 §二 矩阵里 type3/5/6 的"未接/占位/语义错"描述的是 _运行库(883 页)现状_——在「全量重转重导 + 重启」之前仍成立**。即:源码已修 ✅,运行库待部署 ⏳。详见末尾「§七 收口落地与校准」。 > **状态校准(2026-06-16 晚)**:本计划 §三 的 **P0 三项(日历 type5 / 树 type3 接端点 / 组合 type6)转换器源码已全部实现并提交**(eip4-platform main `598f4f9`,连同审批 `33fda45` / 引用列显名 `cd133aa` / chore `bf56595`;提交前 `mvn test` 绿)。**但下文 §二 矩阵里 type3/5/6 的"未接/占位/语义错"描述的是 _运行库(883 页)现状_——在「全量重转重导 + 重启」之前仍成立**。即:源码已修 ✅,运行库待部署 ⏳。详见末尾「§七 收口落地与校准」。

View File

@@ -1,7 +1,7 @@
# EIP3 → EIP4 项目进度与路线 · 总览(2026-06-21) # EIP3 → EIP4 项目进度与路线 · 总览(2026-06-21)
> 维护日期:2026-06-21 | 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新能力)+ 下一步。 > 维护日期:2026-07-02(06-26 增量已并入;07-02 做过一轮文档-代码对抗核查对齐,见 §8 末)| 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新能力)+ 下一步。
> **本文取代 `项目进度与路线-总览-2026-06-17.md`**(口径刷新至 06-21,新增「06-17→06-21 增量交付」一节)。 > **本文取代 `归档/项目进度与路线-总览-2026-06-17.md`**(口径刷新至 06-21,新增「06-17→06-21 增量交付」一节;旧版已于 07-02 物理归档)。
> 配套权威:`README.md`(文档索引)、`架构设计.md`、`plans/2026-06-19-EIP4开发平台-架构方向-design.md`(方向 D1-D7)、`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`(主特性设计)、`framework定制视图-engineclass移植backlog-2026-06-17.md` + `framework定制视图-TODO-2026-06-17.md`(A 兼容台账)。 > 配套权威:`README.md`(文档索引)、`架构设计.md`、`plans/2026-06-19-EIP4开发平台-架构方向-design.md`(方向 D1-D7)、`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`(主特性设计)、`framework定制视图-engineclass移植backlog-2026-06-17.md` + `framework定制视图-TODO-2026-06-17.md`(A 兼容台账)。
> >
> 编制方法:6 路并行盘点(两仓 git 真相 / 设计计划 / AI 契约 / 现有索引 / 全量文档分级)→ 综合 → 3 路对抗核对(过报 / 漏报 / 文档整理),核对修正已并入正文。所有 git 短哈希均对两仓 origin/main 核实存在。 > 编制方法:6 路并行盘点(两仓 git 真相 / 设计计划 / AI 契约 / 现有索引 / 全量文档分级)→ 综合 → 3 路对抗核对(过报 / 漏报 / 文档整理),核对修正已并入正文。所有 git 短哈希均对两仓 origin/main 核实存在。
@@ -15,7 +15,9 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
- **A 兼容线**:通用模板 1363 基本可用;153 定制视图中 framework 推进过半、**业务 106 未动(最大块)**。 - **A 兼容线**:通用模板 1363 基本可用;153 定制视图中 framework 推进过半、**业务 106 未动(最大块)**。
- **B 新能力线本期里程碑突破**:「人走五环建新功能」低代码平台 **v1 全链交付并合入 origin/main 两仓**;设计器选型(amis-editor)拍板且 **DesignerPage 全闭环上线**(解除历史 P1 头号阻塞);AI 确定性(非 LLM)五环生产线**已合 main**。 - **B 新能力线本期里程碑突破**:「人走五环建新功能」低代码平台 **v1 全链交付并合入 origin/main 两仓**;设计器选型(amis-editor)拍板且 **DesignerPage 全闭环上线**(解除历史 P1 头号阻塞);AI 确定性(非 LLM)五环生产线**已合 main**。
- **安全基线(§10.1 四项 P0 + 评审追加 2 孪生 + Groovy 沙箱)2026-06-25 全数收口并 push**(platform `eba9ce1` / web `2a37251`),可达 RCE/越权/fail-open 已闭。 - **安全基线(§10.1 四项 P0 + 评审追加 2 孪生 + Groovy 沙箱)2026-06-25 全数收口并 push**(platform `eba9ce1` / web `2a37251`),可达 RCE/越权/fail-open 已闭。
- 项目仍在 **dev 环境**,生产上线工程化(A10)未起步。 - **报表保真层(套打 JOR)2026-06-25/26 重宿主 + 安全/OOM 收口全数完成并 push origin/main**(§11):SQLi 门 / IDOR 授权 / XXE / 并发·字节·超时·结果集封顶 / CVE 依赖替换 / 报表只读数据源;11 类 79 单测 + live e2e + 安全对抗复审,三批 merge `e6c73a4`/`dccca17`/`d697885`。
- **B3 在线流程 Modeler v1 全链交付并合 main(2026-07-02)**:可编辑存量/新建 BPMN→草稿→同人确认发布→部署 Flowable(中文 key 保真+EIP4 办理人/会签控件+发布门+审计),A2 审批线的「流程定义在线编辑」最后一块补齐。
- 项目仍在 **dev 环境**;生产上线工程化(A10)**MVP 骨架已合 main(2026-06-25)**:W1 Flyway(`db/migration/V1-V3`)+ W2-W4 容器化/nginx 单源/compose 编排(`deploy/` + 模块根 Dockerfile),切流执行 / 性能并发 / 灰度未做。
--- ---
@@ -40,7 +42,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
| 交付 | 仓 | git 证据 | | 交付 | 仓 | git 证据 |
|---|---|---| |---|---|---|
| **人走五环可视化新建特性 · 后端全链**(元数据建实体 / 引用列 → recipe 单步编译 → 默认流预览落库 → 发布产人审部署包 + 菜单注册) | platform | merge `75f942b`;`4400eab`(8094 真 DB 五环①②③④含引用列 OWNER→SYS_USER live e2e)、`303b4d0`(修 DesignFeatureController 多构造器漏 `@Autowired` 致 Spring 启动崩)。`/api/meta/{entities,attributes,entity,entity-types}` + `/api/design/{recipe/compile,flows,publish}`。418 单测 + live e2e | | **人走五环可视化新建特性 · 后端全链**(元数据建实体 / 引用列 → recipe 单步编译 → 默认流预览落库 → 发布产人审部署包 + 菜单注册) | platform | merge `75f942b`;`4400eab`(8094 真 DB 五环①②③④含引用列 OWNER→SYS_USER live e2e)、`303b4d0`(修 DesignFeatureController 多构造器漏 `@Autowired` 致 Spring 启动崩)。`/api/meta/{entities,attributes,entity,entity-types}` + `/api/design/{recipe/compile,flows,publish}`。418 单测 + live e2e |
| **人走五环 · 前端**(ModelerPage 建模器 + 引用列 picker + NewFeatureShell 五步编排壳 + AI①面 AiFeatureForm + admin-gated 路由) | web | merge `d1fd6ed`;`915443f/fef5e33/4e7a95c/2b261e3/4b9c933`(建模器 UI + meta/recipe/publish api 模块)、`8f94ba3/bfb076f/7153592/a6bd4b0`(编排壳 + 设计中心入口 + 五环 Playwright)、`4e0e974/4b564c6`(AI 入口恒 READY_FOR_HUMAN_REVIEW + M-Gate 渲染冒烟)。73 vitest + build | | **人走五环 · 前端**(ModelerPage 建模器 + 引用列 picker + NewFeatureShell 编排壳(四步向导:建实体/建子表/生成页/发布) + AI①面 AiFeatureForm + admin-gated 路由) | web | merge `d1fd6ed`;`915443f/fef5e33/4e7a95c/2b261e3/4b9c933`(建模器 UI + meta/recipe/publish api 模块)、`8f94ba3/bfb076f/7153592/a6bd4b0`(编排壳 + 设计中心入口 + 五环 Playwright)、`4e0e974/4b564c6`(AI 入口恒 READY_FOR_HUMAN_REVIEW + M-Gate 渲染冒烟)。73 vitest + build |
| **DesignerPage 实时设计器闭环上线**(amis-editor 打通:去 StrictMode 修空白屏 / 画布高度约束可滚 / 滚动条可见 / 设计中心独立 tab / `editor.html` CSS import 进 bundle 修生产构建 404)——**解除历史 P1 头号阻塞「DesignerPage 实测不可用」** | web | `2278cbc`(去 StrictMode 修空白屏)、`8603d0f`(滚动条可见)、`3abeefe`(画布可滚)、`f39661a`(设计中心独立 tab)、`ae0155e`(editor.html CSS 进 bundle 修生产构建 404)、`690f4c7`(dev 反代默认 8093 开箱即通) | | **DesignerPage 实时设计器闭环上线**(amis-editor 打通:去 StrictMode 修空白屏 / 画布高度约束可滚 / 滚动条可见 / 设计中心独立 tab / `editor.html` CSS import 进 bundle 修生产构建 404)——**解除历史 P1 头号阻塞「DesignerPage 实测不可用」** | web | `2278cbc`(去 StrictMode 修空白屏)、`8603d0f`(滚动条可见)、`3abeefe`(画布可滚)、`f39661a`(设计中心独立 tab)、`ae0155e`(editor.html CSS 进 bundle 修生产构建 404)、`690f4c7`(dev 反代默认 8093 开箱即通) |
| **主子表四件套**(建模 / 派生字段 金额=数量×单价 / 父级聚合 总额 SUM / 引用驱动联动 选物料带出单价规格) | platform + web | platform `b0daaaa/d71ad6f/ce544fa/ba8177e/63e6522/3e4264d`(含排除标准审计列让生成页真正可用);web `934c646/c735f24/df0ac72/4a107f3/b578d8d`(向导映射 UI + 真事件 e2e;单选 select 经 `selectedItems.<源>` 取值) | | **主子表四件套**(建模 / 派生字段 金额=数量×单价 / 父级聚合 总额 SUM / 引用驱动联动 选物料带出单价规格) | platform + web | platform `b0daaaa/d71ad6f/ce544fa/ba8177e/63e6522/3e4264d`(含排除标准审计列让生成页真正可用);web `934c646/c735f24/df0ac72/4a107f3/b578d8d`(向导映射 UI + 真事件 e2e;单选 select 经 `selectedItems.<源>` 取值) |
| **AI 确定性(非 LLM)五环增量生产线合 main + 写路径对齐 + 三道硬门收口** | platform | platform-ai + platform-cli 两 Maven 模块;`e550725…6c60383`(blueprint 编译器 + recipe 闸 + 渲染计划闸)、`d3b8846`(**M3a:net-new 标准写收敛到单一 `PageSchemaWriter`** = 单一写真相基石)、`1ff0d33/5f32050/6c60383`(AI-recipe 增改删对齐保真层服务流 `_ADD/_UPDATE/_DELETE`,含 tree-crud 写口径,非自创 `/api/entity` save)、`bac69d8`(typed-recipe 闸只作用 AI 草稿不误伤设计器 overlay)、`c379f5b`(AI 端点要求 admin)、`9aea6c1`(对外措辞收敛为 AI 辅助 + 人审)。`POST /api/ai/features/auto-develop` 终态恒 READY_FOR_HUMAN_REVIEW | | **AI 确定性(非 LLM)五环增量生产线合 main + 写路径对齐 + 三道硬门收口** | platform | platform-ai + platform-cli 两 Maven 模块;`e550725…6c60383`(blueprint 编译器 + recipe 闸 + 渲染计划闸)、`d3b8846`(**M3a:net-new 标准写收敛到单一 `PageSchemaWriter`** = 单一写真相基石)、`1ff0d33/5f32050/6c60383`(AI-recipe 增改删对齐保真层服务流 `_ADD/_UPDATE/_DELETE`,含 tree-crud 写口径,非自创 `/api/entity` save)、`bac69d8`(typed-recipe 闸只作用 AI 草稿不误伤设计器 overlay)、`c379f5b`(AI 端点要求 admin)、`9aea6c1`(对外措辞收敛为 AI 辅助 + 人审)。`POST /api/ai/features/auto-develop` 终态恒 READY_FOR_HUMAN_REVIEW |
@@ -56,16 +58,16 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
| ID | 工作块 | 档位 | 说明 | | ID | 工作块 | 档位 | 说明 |
|---|---|---|---| |---|---|---|---|
| **A0** | 通用模板 1363(转换器) | 🟢 | 基本可用。P0 三项(日历 type5 / 树 type3 / 组合 type6)源码 `598f4f9` 已实现,后续多轮全量重转重导已执行,运行库大概率已生效(**需复核**);残 P1 = 19 页缺 EDITFORM 映射 + onselected/filter/enableButton 脚本挂回 | | **A0** | 通用模板 1363(转换器) | 🟢 | 基本可用。P0 三项(日历 type5 / 树 type3 / 组合 type6)源码 `598f4f9` 已实现,后续多轮全量重转重导已执行,运行库大概率已生效(**需复核**);残 P1 = 19 页缺 EDITFORM 映射 + onselected/filter/enableButton 脚本挂回 |
| **A1** | 153 定制视图(framework 47 + 业务 106) | 🟠 | framework 除用户管理(parity,`bf7bb25/0d6fab4/17c449c`)外多项已移植(审批历史 / 我发起 / 脚本编辑器 / 工作日历 / treegrid),按 Java 类去重约 38 待写单元;**业务 106(源码 EIP-3.0 仓 3.1G)基本没动 = 最大块**;终判 158.75 人日卡 S1 止损评审 | | **A1** | 153 定制视图(framework 47 + 业务 106) | 🟠 | framework 除用户管理(parity,`bf7bb25/0d6fab4/17c449c`)外多项已移植(审批历史 / 我发起 / 脚本编辑器 / 工作日历 / treegrid),按 Java 类去重约 38 待写单元;**业务 106 基本没动 = 最大块**(源码已核实在本地 `../EIP-3.0/`,pm/hr/oa/dm 3.1G,2026-07-02);终判 158.75 人日卡 S1 止损评审 |
| **A2** | 流程审批优化 | 🟡 | ApprovalDrawer / WfTemplate 驱动审批 / 审批历史抽屉已 live;缺 amis 列表入口按钮接线、BPMN 流程图、流程定义 Modeler、监控按钮(撤回/结束/高级)、客户 BPMN 部署(前置①) | | **A2** | 流程审批优化 | 🟢 | ApprovalDrawer / WfTemplate 驱动审批 / 审批历史抽屉 / 监控按钮(撤回/结束/高级,早已 live)+ **2026-06-26 审批闭环批补齐**:协办(assist)/转阅(circulated)动作、BPMN 流程图查看(bpmn-js)、会签(BPMN 多实例,scriptUser 候选人解析移植)、会签进度「已会签 N/M」、**xerces 击穿修复**(report 古董 xerces 击穿全部 WfTemplate 解析,已钉 JDK 解析器)。均单测+live。仅剩**客户 BPMN 真实流转(前置①外部)**与**流程定义 Modeler(=B3)**。详见 `docs/plans/2026-06-25-审批闭环-实施计划.md`(main `c95eaee`) |
| **A3** | 报表系统(339) | 🟠 | 基本列表;套打 JOR(45) / 图表 ECharts / 打印 / 报表菜单树路由 降级,需独立立项(与 B6 同根) | | **A3** | 报表系统(339) | 🟢 | **套打 JOR 重宿主已完成**(复用客户预编译引擎 headless 渲染,328/339 type=200 为报表查看器 crud,`/api/report/render` 三格式 HTML/PDF/XLS + iframe 保真,push `53f3c25`)+ **保真层安全/OOM 收口已完成**(见 §11,三批 merge)。残:中文字体保真细化 / 钻取链接 / 完整客户库逐张对账;图表 ECharts、报表设计器 B6 仍未起步 |
| **A4** | 附件系统 | 🟠 | 双态组件已上线;缺图片预览、老附件物理文件迁移(下载 403)、DOCUMENT 全生命周期 | | **A4** | 附件系统 | 🟠 | 双态组件已上线;缺图片预览、老附件物理文件迁移(下载 403)、DOCUMENT 全生命周期 |
| **A5** | 消息 & 邮件 | 🟠 | 短消息发送 + 消息详情已移植;webmail(IMAP/SMTP)独立子系统未起步;已读联动未接 | | **A5** | 消息 & 邮件 | 🟠 | 短消息发送 + 消息详情已移植;webmail(IMAP/SMTP)独立子系统未起步;已读联动未接 |
| **A6** | 数据导入/导出 | 🔴 | 数据导入配置端点 `DataImportConfigController` 已落(c9e4d35);整体 FTP+Excel 导入管线 / Excel 导出未成体系 | | **A6** | 数据导入/导出 | 🔴 | 数据导入配置端点 `DataImportConfigController` 已落(c9e4d35);整体 FTP+Excel 导入管线 / Excel 导出未成体系 |
| **A7** | 定时任务/调度 | 🔴 | 调度运行时未起步;但「定时任务·设置提醒人」保真端点 `ScheduleJobNotifyController` 已交付(c9e4d35,拆 SENDINFO JSON 为 amis input-table 可编辑回写) | | **A7** | 定时任务/调度 | 🔴 | 调度运行时未起步;但「定时任务·设置提醒人」保真端点 `ScheduleJobNotifyController` 已交付(c9e4d35,拆 SENDINFO JSON 为 amis input-table 可编辑回写) |
| **A8** | RBAC/数据权限 parity | 🟡 | 菜单/用户/角色/部门/数据权限 5 块管理后台已建(CRUD + amis 页);用户管理达 parity,其余仍 demo 级未逐功能对照验收 | | **A8** | RBAC/数据权限 parity | 🟡 | 菜单/用户/角色/部门/数据权限 5 块管理后台已建(CRUD + amis 页);用户管理达 parity,其余仍 demo 级未逐功能对照验收 |
| **A9** | 个人设置/工作日历 | 🟠 | 工作日历视图已移植;个人设置(改密/年历)未起步 | | **A9** | 个人设置/工作日历 | 🟠 | 工作日历视图已移植;个人设置(改密/年历)未起步 |
| **A10** | 部署上线工程化 | 🔴(已出 design 待拍板) | 仍 dev(web 5173 + 后端 8093);生产构建 / 数据迁移 runbook 执行 / 性能并发 / 灰度未做(PG/Flowable Runbook 已备未执行切流)。**2026-06-25 已出工程化 design**(`plans/2026-06-25-A10-生产上线工程化-design.md`:现状底数 + 目标拓扑 + W1-W6 分解 + D1-D6 待拍板;MVP=W1 Flyway+W2 容器化+W3 nginx 单源+W4 compose 不卡环境可做) | | **A10** | 部署上线工程化 | 🟡(MVP 骨架已合 main,切流未执行) | 仍 dev(web 5173 + 后端 8093)。**2026-06-25 已落地 MVP 骨架**:design(`plans/2026-06-25-A10-生产上线工程化-design.md`,D1-D6 待拍板)+ **W1 Flyway 平台表迁移**(`platform-app/src/main/resources/db/migration/V1-V3`,本地 PG 真验,merge `f7675c9`)+ **W2-W4 容器化/nginx 单源/compose 编排**(`deploy/` compose+nginx.conf+.env.example+systemd、`platform-app`/`flowable-service` 模块根 Dockerfile,merge `97a0eb1`;后续 `fa3c92b` bootstrap 单一真相 / `2db44a6` 演示库自洽起栈)。**未做**:生产切流执行 / 数据迁移 runbook 实跑 / 性能并发 / 灰度(PG/Flowable Runbook 已备未执行) |
--- ---
@@ -76,7 +78,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
| **人走五环** | NocoBase 式建模器 + 实时设计器 v1 | 🟢 | **v1 全链交付 + live 验收 + 合 main 两仓**(platform 418 单测 / web 73 vitest)。五环①②③④(含引用列)+ AI①面恒 READY_FOR_HUMAN_REVIEW + production 人审部署包(requiresHumanApproval=true)+ 主子表四件套全完,红线全守。**v1 限简单 CRUD/树 recipe + 只建新不改表** | | **人走五环** | NocoBase 式建模器 + 实时设计器 v1 | 🟢 | **v1 全链交付 + live 验收 + 合 main 两仓**(platform 418 单测 / web 73 vitest)。五环①②③④(含引用列)+ AI①面恒 READY_FOR_HUMAN_REVIEW + production 人审部署包(requiresHumanApproval=true)+ 主子表四件套全完,红线全守。**v1 限简单 CRUD/树 recipe + 只建新不改表** |
| **B1** | 新设计器(低代码可视化) | 🟢 | **选型已拍板**:D1 签字下注 amis-editor(接受 amis-fork 6.13.0 冻结天花板 / bus factor≈1 自维护);形态 = NocoBase 式建模器 + 实时设计器,不做线性 wizard。**DesignerPage 已修到全闭环**(`2278cbc` 等 6 提交),原 P1 头号阻塞已解除 | | **B1** | 新设计器(低代码可视化) | 🟢 | **选型已拍板**:D1 签字下注 amis-editor(接受 amis-fork 6.13.0 冻结天花板 / bus factor≈1 自维护);形态 = NocoBase 式建模器 + 实时设计器,不做线性 wizard。**DesignerPage 已修到全闭环**(`2278cbc` 等 6 提交),原 P1 头号阻塞已解除 |
| **B2** | AI 模块 | 🟢 | **确定性(非 LLM)五环增量生产线已合 main**(超 PoC)。platform-ai + platform-cli 落地;终点恒人审、平台不内置生成 LLM(唯 LLM 修复 `HttpAiLlmRepairClient` 默认关、只修不生成)。落地 P0/P1/P2/P4/P5 第一版完成,P3 进行中 | | **B2** | AI 模块 | 🟢 | **确定性(非 LLM)五环增量生产线已合 main**(超 PoC)。platform-ai + platform-cli 落地;终点恒人审、平台不内置生成 LLM(唯 LLM 修复 `HttpAiLlmRepairClient` 默认关、只修不生成)。落地 P0/P1/P2/P4/P5 第一版完成,P3 进行中 |
| **B3** | 流程建模器 BPMN Modeler | 🔴 | 未起步(即 A2 缺的流程定义 Modeler) | | **B3** | 流程建模器 BPMN Modeler | 🟢 | **v1 全链交付并合 main(2026-07-02,platform+web)**。bpmn-js Modeler 可编辑存量/新建 BPMN 流程→存草稿(act_re_model)→同人确认发布→部署到 Flowable。含:可逆 id 净化(中文流程 key 保真 D7)、EIP4 侧板五控件(办理人/会签保真读回/formKey/扩展属性/监听器)、办理人表达式 codec(逐字对齐引擎)、activiti moddle 完整描述符(1512/1512 保真零丢失)、发布门(ProcessValidator+网关语义校验+超管门+审计 V4)、4 新建模板、Playwright e2e 三场景。17 任务 TDD+对抗评审+每阶段 live 验收(挡 3 真 bug 含 bpmn-js PascalCase 断部署)。设计+实施计划见 `plans/2026-07-02-在线流程Modeler-实施计划.md`。残:A10 生产加固 backlog(nginx 洞已修/引擎表达式白名单/网关内部鉴权)、空 content 语义校验、细粒度流程授权(v2)。BPMN 只读查看(A2 流程图)仍在 |
| **B4** | 生产级 UI/UE 组件体系 | 🟡 | L1 主题(amis-theme.css §10-15 密度/按钮/弹窗/字号)+ L2 行选中 `checkOnItemClick` + 设计中心 DesignCenterPage 已上线;剩选择框统一 / 主子表宿主 / 树编辑 Drawer / 审批待办 未完整(`组件设计体系-design-2026-06-15` 落地状态需对齐本矩阵) | | **B4** | 生产级 UI/UE 组件体系 | 🟡 | L1 主题(amis-theme.css §10-15 密度/按钮/弹窗/字号)+ L2 行选中 `checkOnItemClick` + 设计中心 DesignCenterPage 已上线;剩选择框统一 / 主子表宿主 / 树编辑 Drawer / 审批待办 未完整(`组件设计体系-design-2026-06-15` 落地状态需对齐本矩阵) |
| **B5** | 移动端 / 响应式 | 🔴 | 未起步 | | **B5** | 移动端 / 响应式 | 🔴 | 未起步 |
| **B6** | 报表设计器(自助报表) | 🔴 | 未起步(与 A3 同根待立项) | | **B6** | 报表设计器(自助报表) | 🔴 | 未起步(与 A3 同根待立项) |
@@ -97,7 +99,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
3. **【L】framework 业务 106 视图(pm/hr/oa/dm)engineclass delta 移植启动**:A1 真实大头。机制① `EngineclassDelta` 注册表 + 用户管理 Delta 移植方法论已就位可复用。*依赖:S1 止损评审定处置方式(见 §6)。* 3. **【L】framework 业务 106 视图(pm/hr/oa/dm)engineclass delta 移植启动**:A1 真实大头。机制① `EngineclassDelta` 注册表 + 用户管理 Delta 移植方法论已就位可复用。*依赖:S1 止损评审定处置方式(见 §6)。*
4. **【L】人走五环 v2**:ALTER 改已有表(引擎现零迁移路径)+ 主子表/审批/组合 tabs recipe 扩面(路线图 M7)。*须作为新 recipe 增量加入 blueprint,不得绕过门禁。依赖:v1(75f942b/d1fd6ed)+ 引擎 ALTER 安全通道(#2)。* 4. **【L】人走五环 v2**:ALTER 改已有表(引擎现零迁移路径)+ 主子表/审批/组合 tabs recipe 扩面(路线图 M7)。*须作为新 recipe 增量加入 blueprint,不得绕过门禁。依赖:v1(75f942b/d1fd6ed)+ 引擎 ALTER 安全通道(#2)。*
5. **【M】流程审批闭环收尾**:amis 列表入口按钮接线 + BPMN 流程图 + 监控按钮(撤回/结束/高级)+ 客户 BPMN 部署。*基础设施已全建,缺最后一公里。依赖:客户提供 BPMN(外部)。* 5. **【✅ 大部完成 2026-06-26】流程审批闭环**:协办/转阅/BPMN流程图/会签/会签进度/监控按钮/xerces修复 全部已做并合 main(`c95eaee`)。**仅剩**:客户 BPMN 真实流转(外部依赖)+ 流程定义 Modeler(=B3,S1 拍板)。*amis 列表入口按钮接线此前已 live(228 页 openApprovalDrawer)。*
6. **【M】AI 链与人工链部署包统一**:`DeploymentPackageBuilder` 下沉(platform-metadata 与 platform-ai 各一份)+ 净新标准页运行时 DELETE/回滚端点 + publish 写角色菜单授权(现仅 INSERT sys_menu,非超管不可见)。*影响人走五环 v1 完整可用。* 6. **【M】AI 链与人工链部署包统一**:`DeploymentPackageBuilder` 下沉(platform-metadata 与 platform-ai 各一份)+ 净新标准页运行时 DELETE/回滚端点 + publish 写角色菜单授权(现仅 INSERT sys_menu,非超管不可见)。*影响人走五环 v1 完整可用。*
### P2(立项 / 排期) ### P2(立项 / 排期)
@@ -144,6 +146,11 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
- 以下**已完成的一次性 plan/报告标为「归档候选」**(本次未物理移动,避免破坏现行文档中的相对引用;可后续批量 `git mv` 入 `归档/`):`plans/2026-06-14-onEvent脚本挂回修复-plan.md`、`plans/2026-06-14-提交审批桥接-design.md`、`plans/2026-06-14-新闻管理垂直切片-plan.md`、`plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan.md`、`plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md`、`CRUD-QA-发现与剩余-2026-06-14.md`、`C3压测基线.md`、`C5构建预演报告.md`。 - 以下**已完成的一次性 plan/报告标为「归档候选」**(本次未物理移动,避免破坏现行文档中的相对引用;可后续批量 `git mv` 入 `归档/`):`plans/2026-06-14-onEvent脚本挂回修复-plan.md`、`plans/2026-06-14-提交审批桥接-design.md`、`plans/2026-06-14-新闻管理垂直切片-plan.md`、`plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan.md`、`plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md`、`CRUD-QA-发现与剩余-2026-06-14.md`、`C3压测基线.md`、`C5构建预演报告.md`。
- 以下 design/契约文档**正文有过时点**,顶部加「现状以 06-21 总览为准」横幅并指明过时处:`组件设计体系-design-2026-06-15.md`(「未开始」已过时)、`AI_AGENT_AUTO_DEVELOPMENT.md`(「只覆盖最简单 CRUD recipe」已过时,实有 tree-crud + master-detail)、`AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md`(master-detail 列为未来 TODO,实已有 `master-detail-v1.yaml`)、`AI_AGENT_Nocobase_SOURCE_REVIEW.md`(P3 进度前后自相矛盾)。 - 以下 design/契约文档**正文有过时点**,顶部加「现状以 06-21 总览为准」横幅并指明过时处:`组件设计体系-design-2026-06-15.md`(「未开始」已过时)、`AI_AGENT_AUTO_DEVELOPMENT.md`(「只覆盖最简单 CRUD recipe」已过时,实有 tree-crud + master-detail)、`AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md`(master-detail 列为未来 TODO,实已有 `master-detail-v1.yaml`)、`AI_AGENT_Nocobase_SOURCE_REVIEW.md`(P3 进度前后自相矛盾)。
**2026-07-02 文档-代码对抗核查对齐**(5 路并行核对本文 §9/§10/§11 + A/B 矩阵全部声明 vs 两仓代码,48 条声明 46 条完全一致、无虚报):
- 修正本文与代码不一致处:A10 行 🔴→🟡(W1-W4 骨架 06-25 已合 main,本文此前低报);§9 P0② 表格「同族扩长」与对抗审查①矛盾(代码一律拒 TYPE 变更)已改;§10.2 render-plan 行号迁移至 `AiDraftGateValidator.java:246`;§11 报表单测 73→79;§2「五步编排壳」实为四步向导。
- 代码侧同步修正:`CandidateUsersHandler` 类级 javadoc(scriptUser 已于 06-26 接入,注释仍写「WARN 降级未接入」)。
- **归档候选物理归档执行**:上方列出的 8 份一次性 plan/报告 + `项目进度与路线-总览-2026-06-17.md`(已被取代)+ `plans/2026-06-20-人走五环建新功能-实施计划.md`(24 任务全完成)共 10 份 `git mv` 入 `归档/`,引用处(README 索引、M0剩余项登记、通用模板收口计划、架构方向-design)已同步改路径。
--- ---
## 9. P0/P1 实施记录(2026-06-21 续·已落地 + E2E 验证) ## 9. P0/P1 实施记录(2026-06-21 续·已落地 + E2E 验证)
@@ -152,17 +159,17 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
| 项 | 状态 | 交付 + 证据 | | 项 | 状态 | 交付 + 证据 |
|---|---|---| |---|---|---|
| **P0② AI 门禁 + 引擎 ALTER 安全通道** | ✅ 完成·已验证 | (a) `AlterTableSqlGuard`(legacy-core,只允许 加列/同族扩长/改可空,拒 DROP/RENAME/SET NOT NULL/多语句/小写绕过)+ `DataDicService.executeAlterSql` 通道 + `MetaController POST /api/meta/entity/{table}/attributes` 加列端点(saveAttr 元数据 + 受控 ALTER 物理表 + evictByTable + 补索引);(b) `PageSchemaController` `?strict` 分流 + `GET /api/page/schema/overlay/audit` 白名单对账端点;(c) `AiAgentService.applyLocalRelease` 织入 `AiToolRegistry.check`(安全门 advisory→**enforced**,非本机/越权写路径 403)。**单测**:Guard 15/0、alter DDL 2/0、安全门 22/0(含新 FORBIDDEN 测试,112 基线无回归)、strict+审计 28/0。**真库 e2e**:建实体→加 4 列(数值/整型/字符串/引用)→元数据齐 + psql 物理列全生效 + 负控(重复列/不存在表/DROP 形态拒)全绿。 | | **P0② AI 门禁 + 引擎 ALTER 安全通道** | ✅ 完成·已验证 | (a) `AlterTableSqlGuard`(legacy-core,只允许 加列/改可空——同族扩长即 ALTER COLUMN TYPE 已经下方对抗审查①移除,拒 DROP/RENAME/SET NOT NULL/TYPE 变更/多语句/小写绕过)+ `DataDicService.executeAlterSql` 通道 + `MetaController POST /api/meta/entity/{table}/attributes` 加列端点(saveAttr 元数据 + 受控 ALTER 物理表 + evictByTable + 补索引);(b) `PageSchemaController` `?strict` 分流 + `GET /api/page/schema/overlay/audit` 白名单对账端点;(c) `AiAgentService.applyLocalRelease` 织入 `AiToolRegistry.check`(安全门 advisory→**enforced**,非本机/越权写路径 403)。**单测**:Guard 15/0、alter DDL 2/0、安全门 22/0(含新 FORBIDDEN 测试,112 基线无回归)、strict+审计 28/0。**真库 e2e**:建实体→加 4 列(数值/整型/字符串/引用)→元数据齐 + psql 物理列全生效 + 负控(重复列/不存在表/DROP 形态拒)全绿。 |
| **P1④ 人走五环 v2 · 改表加列** | ✅ 完成·浏览器 E2E | 前端 `meta.ts alterEntity` + `ModelerPage` 行内「加字段」Dialog(复用 FieldTable);打破「v1 只建新不改表」。**build 绿**(tsc 无错)+ **vitest 73/73**。**浏览器 E2E**:`five-ring.spec.ts` 新增「改已有表加列(建模器加字段→元数据落库)」,与五环/主子表共 **5/5 绿**。recipe 扩面(M7 新页型)暂缓。 | | **P1④ 人走五环 v2 · 改表加列** | ✅ 完成·浏览器 E2E | 前端 `meta.ts alterEntity` + `ModelerPage` 行内「加字段」Dialog(复用 FieldTable);打破「v1 只建新不改表」。**build 绿**(tsc 无错)+ **vitest 73/73**。**浏览器 E2E**:`five-ring.spec.ts` 新增「改已有表加列(建模器加字段→元数据落库)」,与五环/主子表共 **5/5 绿**。recipe 扩面(M7 新页型)暂缓。 |
| **P1⑥ 运行时 DELETE + 菜单授权** | ✅ 完成·真库 e2e | `PageSchemaWriter.deleteStandard` + `DELETE /api/page/schema/{tpl}/standard`(@Transactional 对称撤销:删 schema+overlay+软删菜单+清 sys_role_menu);`MenuRegistrar.grantToRoles` + `PublishOrchestrator.grantMenuRoles` + `DesignFeatureController.publish` 透传 roleIds(缺省 warning)。**单测**:PageSchemaWriter 6/0、MenuRegistrar 4/0、PageSchemaController 28/0、DeploymentPackageBuilder 1/0(无回归)。**真库 e2e**:发布带 roleIds→授权写 sys_role_menu ✓、无 roleIds→warning 负控 ✓、DELETE 对称撤销(计数全对)+ GET→404 + psql 核对授权落库/清除 ✓。部署包下沉(builder unify)暂缓(纯重构、回归风险高、可见价值低)。 | | **P1⑥ 运行时 DELETE + 菜单授权** | ✅ 完成·真库 e2e | `PageSchemaWriter.deleteStandard` + `DELETE /api/page/schema/{tpl}/standard`(@Transactional 对称撤销:删 schema+overlay+软删菜单+清 sys_role_menu);`MenuRegistrar.grantToRoles` + `PublishOrchestrator.grantMenuRoles` + `DesignFeatureController.publish` 透传 roleIds(缺省 warning)。**单测**:PageSchemaWriter 6/0、MenuRegistrar 4/0、PageSchemaController 28/0、DeploymentPackageBuilder 1/0(无回归)。**真库 e2e**:发布带 roleIds→授权写 sys_role_menu ✓、无 roleIds→warning 负控 ✓、DELETE 对称撤销(计数全对)+ GET→404 + psql 核对授权落库/清除 ✓。部署包下沉(builder unify)暂缓(纯重构、回归风险高、可见价值低)。 |
| **P1⑤ 审批列表入口** | 🟡 接线完成·e2e 验证(运行时阻塞) | 列表入口接线**已 live**:228 个 sys_page_schema 含 `openApprovalDrawer` 按钮(psql 实证名实一致)+ 既有单测(registerApprovalAction 5/converter)。**浏览器 E2E**:新增 `approval-list-entry.spec.ts`(纯 mock)验证生产主路径「转换列表页按钮→选中行→openApprovalDrawer→AppShell→ApprovalDrawer 抽屉打开」1/1 绿。**外部阻塞**:点同意后真实流程流转/候选人计算需客户 BPMN(act 库 dev 不可达);BPMN 流程图编辑器=B3 级另案。 | | **P1⑤ 审批列表入口** | 🟡 接线完成·e2e 验证(运行时阻塞) | 列表入口接线**已 live**:228 个 sys_page_schema 含 `openApprovalDrawer` 按钮(psql 实证名实一致)+ 既有单测(registerApprovalAction 5/converter)。**浏览器 E2E**:新增 `approval-list-entry.spec.ts`(纯 mock)验证生产主路径「转换列表页按钮→选中行→openApprovalDrawer→AppShell→ApprovalDrawer 抽屉打开」1/1 绿。**外部阻塞**:点同意后真实流程流转/候选人计算需客户 BPMN(act 库 dev 不可达);BPMN 流程图编辑器=B3 级另案。 |
| **P1③ framework 业务 106 视图** | 🔴 未启动·待拍板 | 卡 S1 止损评审(§6 待拍板①:分期/第三方/扩预算),需客户决策方向,非本次。 | | **P1③ framework 业务 106 视图** | 🔴 未启动·待拍板 | 卡 S1 止损评审(§6 待拍板①:分期/第三方/扩预算),需客户决策方向。源码已在本地 `../EIP-3.0/`(2026-07-02 核实),仅剩决策一重阻塞。 |
**对抗审查收口(2026-06-21)**:实施完成后用 3-lens workflow 对自己的 P0②/P1⑥ 代码做对抗审查,揪出并修复 **4 major + 多 minor 真 bug**——①Guard 移除 ALTER COLUMN TYPE(静态守卫拿不到旧尺寸,缩短 `varchar(1)`/`numeric(1,0)` 会截断/溢出存量数据);②`addAttributes` 校验-写分离 + `@Transactional` + ALTER 失败抛异常(防孤儿元数据,PG 事务性 DDL 一起回滚);③`createEntity` 检查 `executeCreateSql` 返回值 + `@Transactional`(引擎拒建表不再静默成功);④`AiToolRegistry.isLocalEnv/isProductionEnv` 改 URI host 精确解析(防 `http://127.0.0.1.evil.com` 伪本地前缀绕过安全门);⑤`grantToRoles` 改 `INSERT...WHERE NOT EXISTS`(**实证 `sys_role_menu` 无唯一约束→`ON CONFLICT DO NOTHING` 不去重→重复发布插重复行**)+ `deleteStandard` trim/isactive 过滤 + `publish` roleIds 只接 String + `columnSqlType` 空 refTable 抛错。修复后全单测 + 双真库验收(含幂等 [2b])+ 浏览器 e2e 6/6 全绿。overlay 审计端点实跑:dev 库仅 1 overlay 用 `dialog`/`submit`(白名单偏窄,非存量页问题)。 **对抗审查收口(2026-06-21)**:实施完成后用 3-lens workflow 对自己的 P0②/P1⑥ 代码做对抗审查,揪出并修复 **4 major + 多 minor 真 bug**——①Guard 移除 ALTER COLUMN TYPE(静态守卫拿不到旧尺寸,缩短 `varchar(1)`/`numeric(1,0)` 会截断/溢出存量数据);②`addAttributes` 校验-写分离 + `@Transactional` + ALTER 失败抛异常(防孤儿元数据,PG 事务性 DDL 一起回滚);③`createEntity` 检查 `executeCreateSql` 返回值 + `@Transactional`(引擎拒建表不再静默成功);④`AiToolRegistry.isLocalEnv/isProductionEnv` 改 URI host 精确解析(防 `http://127.0.0.1.evil.com` 伪本地前缀绕过安全门);⑤`grantToRoles` 改 `INSERT...WHERE NOT EXISTS`(**实证 `sys_role_menu` 无唯一约束→`ON CONFLICT DO NOTHING` 不去重→重复发布插重复行**)+ `deleteStandard` trim/isactive 过滤 + `publish` roleIds 只接 String + `columnSqlType` 空 refTable 抛错。修复后全单测 + 双真库验收(含幂等 [2b])+ 浏览器 e2e 6/6 全绿。overlay 审计端点实跑:dev 库仅 1 overlay 用 `dialog`/`submit`(白名单偏窄,非存量页问题)。
**红线遵守**:引擎 ALTER 经 `AlterTableSqlGuard` 白名单(defense-in-depth:控制层 + 保真层双校验),只加列/恒可空、移除 TYPE 变更,杜绝破坏性 DDL;DDL 仍收口保真层单点;net-new 标准层删除收口 `PageSchemaWriter`,不裸 JDBC 旁路。 **红线遵守**:引擎 ALTER 经 `AlterTableSqlGuard` 白名单(defense-in-depth:控制层 + 保真层双校验),只加列/恒可空、移除 TYPE 变更,杜绝破坏性 DDL;DDL 仍收口保真层单点;net-new 标准层删除收口 `PageSchemaWriter`,不裸 JDBC 旁路。
**仍待(按优先级)**:P0②余项(存量 overlay 白名单 strict 化推进,审计端点已提供对账数据)/ P1④ recipe 扩面 M7 / P1⑥ 部署包下沉统一(已查:两生成器**当前逻辑等价无 bug**,统一是防未来漂移的纯重构,需改 AI 黄金测试,低优先)/ P1⑤ 真实流转(依赖客户 BPMN)/ **P1③ framework 业务 106 视图(双重阻塞:待 S1 拍板 + EIP-3.0 源码仓本地未克隆,无法分析迁移)**。 **仍待(按优先级)**:P0②余项(存量 overlay 白名单 strict 化推进,审计端点已提供对账数据)/ P1④ recipe 扩面 M7 / P1⑥ 部署包下沉统一(已查:两生成器**当前逻辑等价无 bug**,统一是防未来漂移的纯重构,需改 AI 黄金测试,低优先)/ P1⑤ 真实流转(依赖客户 BPMN)/ **P1③ framework 业务 106 视图(阻塞=待 S1 拍板;EIP-3.0 源码已核实在本地 `../EIP-3.0/`,2026-07-02)**。
--- ---
@@ -190,7 +197,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
| **RCE — `/api/script/execute` + `/api/poc/write-test`** | ✅ 已修(06-25) | `ScriptExecuteController.java:65→:193-198` 真执行请求体 Groovy(不受 facade 绑定约束=任意 Java/RCE),无 `@Profile`、无鉴权;`PocWriteTestController.java:181` `jdbcTemplate.execute("DROP TABLE IF EXISTS "+target)` 裸拼旁路 `DropTableSqlGuard`,无 `@Profile`。三个 `Poc*Controller` + 散落 `/api/poc/*` 随生产 jar 装配;全平台 `@PreAuthorize` 0 命中且无 `@EnableMethodSecurity` | 生产构建移除 / `@Profile("!prod")` 隔离全部 `Poc*`/`ScriptExecute` 端点;保留者加平台管理员级鉴权(开 `@EnableMethodSecurity`);新增 ArchUnit 规则禁生产源码出现 `Poc*` 的 `@RestController` | | **RCE — `/api/script/execute` + `/api/poc/write-test`** | ✅ 已修(06-25) | `ScriptExecuteController.java:65→:193-198` 真执行请求体 Groovy(不受 facade 绑定约束=任意 Java/RCE),无 `@Profile`、无鉴权;`PocWriteTestController.java:181` `jdbcTemplate.execute("DROP TABLE IF EXISTS "+target)` 裸拼旁路 `DropTableSqlGuard`,无 `@Profile`。三个 `Poc*Controller` + 散落 `/api/poc/*` 随生产 jar 装配;全平台 `@PreAuthorize` 0 命中且无 `@EnableMethodSecurity` | 生产构建移除 / `@Profile("!prod")` 隔离全部 `Poc*`/`ScriptExecute` 端点;保留者加平台管理员级鉴权(开 `@EnableMethodSecurity`);新增 ArchUnit 规则禁生产源码出现 `Poc*` 的 `@RestController` |
| **安全默认 fail-open** | ✅ 已修(06-25) | `SecurityConfig.java:68-71` `@Profile("!prod")`→`anyRequest().permitAll()`(default/local/ci/dev 全放行);prod 严格链(`:50-61`)存在但仅 `@Profile("prod")`,且**仓内无 `application-prod.yml`**=prod 必须显式激活否则默认洞开;`JwtService.java:44-55` 仅校验长度,`application.yml:29` dev 默认密钥能静默签发可伪造令牌 | 补 `application-prod.yml`(JWT secret 强制环境变量、缺省启动失败);**反转 fail-safe**:未知/无 profile 默认走严格链,`permitAll` 收窄到仅 `local\|ci\|test`;prod 若 JWT secret 仍为 dev 默认值则 fail-fast | | **安全默认 fail-open** | ✅ 已修(06-25) | `SecurityConfig.java:68-71` `@Profile("!prod")`→`anyRequest().permitAll()`(default/local/ci/dev 全放行);prod 严格链(`:50-61`)存在但仅 `@Profile("prod")`,且**仓内无 `application-prod.yml`**=prod 必须显式激活否则默认洞开;`JwtService.java:44-55` 仅校验长度,`application.yml:29` dev 默认密钥能静默签发可伪造令牌 | 补 `application-prod.yml`(JWT secret 强制环境变量、缺省启动失败);**反转 fail-safe**:未知/无 profile 默认走严格链,`permitAll` 收窄到仅 `local\|ci\|test`;prod 若 JWT secret 仍为 dev 默认值则 fail-fast |
| **`asUser/roles` 越权(prod 同样生效)** | ✅ 已修(06-25) | `EntityController.java:222-241` 客户端 `asUser/roles`(无 `@Profile` 的 `@RequestParam`)**优先于** `:247` JWT 绑定的 `UserSession.get()`,直驱 `DataPrivilegeServiceImpl` 行级数据权限,不校验是否等于 JWT 主体 | `asUser/roles` 测试通道 `@Profile("!prod")` 硬隔离;prod 引擎身份只能来自 JWT;确需 impersonation 须校验调用者持 `IMPERSONATE` 角色 | | **`asUser/roles` 越权(prod 同样生效)** | ✅ 已修(06-25) | `EntityController.java:222-241` 客户端 `asUser/roles`(无 `@Profile` 的 `@RequestParam`)**优先于** `:247` JWT 绑定的 `UserSession.get()`,直驱 `DataPrivilegeServiceImpl` 行级数据权限,不校验是否等于 JWT 主体 | `asUser/roles` 测试通道 `@Profile("!prod")` 硬隔离;prod 引擎身份只能来自 JWT;确需 impersonation 须校验调用者持 `IMPERSONATE` 角色 |
| **CI 孤儿=自动回归实质为零** | ✅ 已修(06-25) | `eip4-platform/.github/workflows/ci.yml` 是 GitHub Actions 语法但 origin=`git.latent.chat`(Gitea 不执行 GHA);`java-version "17"` 写死(项目 JDK21,即便能跑也编译失败=从未真跑过);`eip4-web` 无任何 CI | 把 `scripts/ci.sh` 迁成 `.gitea/workflows/ci.yml`(JDK 改 21)或公司 Jenkins;前端加最小 CI(vitest + `tsc -b`);Gitea 配 branch protection。**理由:P0 安全项修完后没有门禁防再退化。** | | **CI 孤儿=自动回归实质为零** | ✅ 已修(06-25) | `eip4-platform/.github/workflows/ci.yml` 是 GitHub Actions 语法但 origin=私有 Gitea(不执行 GHA);`java-version "17"` 写死(项目 JDK21,即便能跑也编译失败=从未真跑过);`eip4-web` 无任何 CI | 把 `scripts/ci.sh` 迁成 `.gitea/workflows/ci.yml`(JDK 改 21)或公司 Jenkins;前端加最小 CI(vitest + `tsc -b`);Gitea 配 branch protection。**理由:P0 安全项修完后没有门禁防再退化。** |
### 10.2 P1 — 稳定性 / 交付能力 / 验证体系 / 可维护性 ### 10.2 P1 — 稳定性 / 交付能力 / 验证体系 / 可维护性
@@ -198,8 +205,8 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
- **✅【已完成 2026-06-24·稳定性三件套】稳定性配置真空 · high**:原状=HikariCP `maximum-pool-size:5` + `statement_timeout` 全仓零命中 + perPage 无封顶 + `queryForRowSet` 全量物化,四者叠加=一个大/恶意查询(`perPage=999999`)即耗尽连接 + OOM。**已做**:① perPage 硬封顶——新增 `Pagination.clampPerPage`(上限 5000,护栏非产品限),接入 `FlowController.applyPaging` 与 `PickerController.list` 两处 REST 入口(`page` 不封,深翻页合法);② `statement_timeout`——base `application.yml` 加 `hikari.connection-init-sql: SET statement_timeout='${EIP4_DB_STATEMENT_TIMEOUT:120s}'`(dev/local 继承、prod 无 profile 亦继承 base,可环境变量放宽/设 0 关闭);③ 连接池 `maximum-pool-size` 5→20(prod 继承 base 受益)。**验证**:`PaginationTest` 3/3 + `FlowControllerTest`(含新「perPage 超大封顶」集成测试,经真实 `executeGet` 路径) + `PickerControllerTest` 无回归=68/68 绿;`SET statement_timeout='120s'` 经真实 PG(localhost:5433)执行 `SHOW`=2min 确认语法/取值正确;`application.yml` YAML 解析校验通过。**残留(独立较大项,未做)**:`SqlRowSet` 全量物化 → 导出走流式 `RowCallbackHandler`(属性能 P2,见 §10.3)。 - **✅【已完成 2026-06-24·稳定性三件套】稳定性配置真空 · high**:原状=HikariCP `maximum-pool-size:5` + `statement_timeout` 全仓零命中 + perPage 无封顶 + `queryForRowSet` 全量物化,四者叠加=一个大/恶意查询(`perPage=999999`)即耗尽连接 + OOM。**已做**:① perPage 硬封顶——新增 `Pagination.clampPerPage`(上限 5000,护栏非产品限),接入 `FlowController.applyPaging` 与 `PickerController.list` 两处 REST 入口(`page` 不封,深翻页合法);② `statement_timeout`——base `application.yml` 加 `hikari.connection-init-sql: SET statement_timeout='${EIP4_DB_STATEMENT_TIMEOUT:120s}'`(dev/local 继承、prod 无 profile 亦继承 base,可环境变量放宽/设 0 关闭);③ 连接池 `maximum-pool-size` 5→20(prod 继承 base 受益)。**验证**:`PaginationTest` 3/3 + `FlowControllerTest`(含新「perPage 超大封顶」集成测试,经真实 `executeGet` 路径) + `PickerControllerTest` 无回归=68/68 绿;`SET statement_timeout='120s'` 经真实 PG(localhost:5433)执行 `SHOW`=2min 确认语法/取值正确;`application.yml` YAML 解析校验通过。**残留(独立较大项,未做)**:`SqlRowSet` 全量物化 → 导出走流式 `RowCallbackHandler`(属性能 P2,见 §10.3)。
**【生产交付能力 — 意图与实现最大成体系缺口,对应 A10】** **【生产交付能力 — 意图与实现最大成体系缺口,对应 A10】**
- **Flyway 平台表迁移未实现 · medium · L**:`架构设计.md:36` 承诺 Flyway,全仓零命中;SYS_* 建表散落 bootstrap/`*_upsert.sql`/CLI 内嵌(`bootstrap-ai-agent.sql` 两份易漂移)。→ 引入 Flyway 收敛为 `V{n}__*.sql` 单一真相。 - **✅【已完成 2026-06-25·A10 W1】Flyway 平台表迁移**:`platform-app/src/main/resources/db/migration/V1__sys_page_schema.sql`/`V2__sys_datastatus.sql`/`V3__sys_ai_agent.sql` 单一真相,本地 PG 真验(merge `f7675c9`);`bootstrap-ai-agent.sql` 重复已去(`11e668a`/`fa3c92b` 收敛 bootstrap 单一真相)。
- **4 进程交付无 compose/Dockerfile/Nginx 配置 · medium · L**:`find docker-compose*` 零命中,切流/回滚仅停留文档。→ 补 `deploy/`(compose 四服务 + 健康检查 + `nginx.conf` 切流 upstream + `.env.example`)。 - **✅【已完成 2026-06-25·A10 W2-W4】compose/Dockerfile/Nginx 骨架**:`deploy/`(docker-compose.yml + nginx.conf + .env.example + systemd/ + postgres-init/)+ `platform-app/Dockerfile`、`flowable-service/Dockerfile`(merge `97a0eb1`,`2db44a6` 内置演示库自洽起栈)。**残留**:生产切流/灰度未执行(见 A10 行)。
- **✅【已完成 2026-06-24】可观测性近零**:原状=无 actuator/无健康端点/无 logback 配置/base 日志 DEBUG(prod 继承会刷屏)。**已做**:① platform-app 加 `spring-boot-starter-actuator`,`management` 只暴露 `health`(`probes.enabled` 开 liveness/readiness,`show-details/components: when-authorized` 匿名不泄露 db 等组件细节)——不上 Prometheus 全家桶,守中间件最小化;② `SecurityConfig.PUBLIC_PATHS` 加 `/actuator/health(/**)`,prod 链探针免认证可达;③ 新增 `logback-spring.xml`(控制台 + 50MB×14 天滚动文件,文件 appender 仅 dev/local/prod 启用、不污染单测);④ base `application.yml` 的 `com.dsasp`/`jdbc.core` 日志 DEBUG→INFO(prod 继承 INFO,dev 仍 DEBUG)。**验证**:真启动 dev profile(1.7s 起)curl `/actuator/health`=`200 {"status":"UP","groups":["liveness","readiness"]}`、`/health/readiness`=200 UP、`/health/liveness`=200 UP;SecurityProfileTest 3/3 + ArchitectureRulesTest 6/6 无回归。**残留**:prod JSON 结构化日志需 Spring Boot 3.4 内建或 logstash-encoder 依赖,留作后续(避免现在加依赖)。 - **✅【已完成 2026-06-24】可观测性近零**:原状=无 actuator/无健康端点/无 logback 配置/base 日志 DEBUG(prod 继承会刷屏)。**已做**:① platform-app 加 `spring-boot-starter-actuator`,`management` 只暴露 `health`(`probes.enabled` 开 liveness/readiness,`show-details/components: when-authorized` 匿名不泄露 db 等组件细节)——不上 Prometheus 全家桶,守中间件最小化;② `SecurityConfig.PUBLIC_PATHS` 加 `/actuator/health(/**)`,prod 链探针免认证可达;③ 新增 `logback-spring.xml`(控制台 + 50MB×14 天滚动文件,文件 appender 仅 dev/local/prod 启用、不污染单测);④ base `application.yml` 的 `com.dsasp`/`jdbc.core` 日志 DEBUG→INFO(prod 继承 INFO,dev 仍 DEBUG)。**验证**:真启动 dev profile(1.7s 起)curl `/actuator/health`=`200 {"status":"UP","groups":["liveness","readiness"]}`、`/health/readiness`=200 UP、`/health/liveness`=200 UP;SecurityProfileTest 3/3 + ArchitectureRulesTest 6/6 无回归。**残留**:prod JSON 结构化日志需 Spring Boot 3.4 内建或 logstash-encoder 依赖,留作后续(避免现在加依赖)。
**【验证体系】** **【验证体系】**
@@ -210,7 +217,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
**【可维护性核心】** **【可维护性核心】**
- **🟡【已完成安全半步 2026-06-24】【采纳自原文档 A5】AiLocalReleaseExecutor 裸写 sys_serviceflow/sys_menu**:**已做**——把执行器里所有裸 JDBC(sys_serviceflow UPSERT + sys_menu INSERT/UPDATE + ensureAiMenuParent + tableExists + 实体复用查询)下沉到新类 `platform-ai/.../service/AiReleaseWriter`,执行器只剩编排不再直接碰库;SQL 逐字保留(纯搬迁零行为变更)。**顺带补缺口**:新增 `AiReleaseWriterTest`(4 值断言:serviceflow 审计/`?::xml`/bool→int、菜单 INSERT 全列值、UPDATE 全字段、自动建「AI Agent」目录)——补上原 `AiLocalReleaseExecutorTest` 只查「SQL 含表名」的宽松缺口。**验证**:platform-ai 30/30 绿(黄金测试经搬迁仍绿=行为未变)。**未做(推迟为专项)**:与人走五环 `MenuRegistrar` 统一成单一写器——调查发现两者已实质分叉(本类 UPDATE 全字段 + operator 字面量 'AI_AGENT' + 顶级目录「AI Agent」vs MenuRegistrar 窄 UPDATE + `?` operator + 「新功能」),且各有钉死测试,真统一需重写两路测试 + 重验两条红线邻近路径(建议 live e2e),风险/工作量超「快速增量」,留作 A5 完整版专项。 - **🟡【已完成安全半步 2026-06-24】【采纳自原文档 A5】AiLocalReleaseExecutor 裸写 sys_serviceflow/sys_menu**:**已做**——把执行器里所有裸 JDBC(sys_serviceflow UPSERT + sys_menu INSERT/UPDATE + ensureAiMenuParent + tableExists + 实体复用查询)下沉到新类 `platform-ai/.../service/AiReleaseWriter`,执行器只剩编排不再直接碰库;SQL 逐字保留(纯搬迁零行为变更)。**顺带补缺口**:新增 `AiReleaseWriterTest`(4 值断言:serviceflow 审计/`?::xml`/bool→int、菜单 INSERT 全列值、UPDATE 全字段、自动建「AI Agent」目录)——补上原 `AiLocalReleaseExecutorTest` 只查「SQL 含表名」的宽松缺口。**验证**:platform-ai 30/30 绿(黄金测试经搬迁仍绿=行为未变)。**未做(推迟为专项)**:与人走五环 `MenuRegistrar` 统一成单一写器——调查发现两者已实质分叉(本类 UPDATE 全字段 + operator 字面量 'AI_AGENT' + 顶级目录「AI Agent」vs MenuRegistrar 窄 UPDATE + `?` operator + 「新功能」),且各有钉死测试,真统一需重写两路测试 + 重验两条红线邻近路径(建议 live e2e),风险/工作量超「快速增量」,留作 A5 完整版专项。
- **✅【已完成 2026-06-24】【采纳自原文档 A4】ArchUnit 规则扩充**:`ArchitectureRulesTest.java` 从 1 条扩到 **6 条**——3 条强制(保真层禁依赖现代层 / 库模块[converter·parity]不得依赖应用编排层 / 模块切片 `beFreeOfCycles` 无环)+ 3 条**棘轮**(控制器不得新增直用 `JdbcTemplate` / 不得新增 Controller→Controller 互注入 / 不得新增 `Poc*` 调试控制器)。棘轮以「已知债务清单」基线化存量(JdbcTemplate 26 个 / 互注入 4 个 / Poc 3 个),只挡新增、清单即待偿台账。**验证**:`mvn -pl platform-app test -Dtest=ArchitectureRulesTest` 6/6 绿;并以临时探针走完整 RED→GREEN(探针触发恰好 3 条棘轮失败、强制规则不受影响,证明非空绿)。**一处刻意偏离原文档**:未加「禁控制器调 `POJOCRUDService`/引擎」——因 `com.eip4.*→com.dsasp.*` 是双层制明确允许(现代层=保真层薄门面),真正的坏味道是控制器直拼原始 SQL(已由 JdbcTemplate 棘轮覆盖)。**后续**:随 A1/A3 把控制器 SQL 收口到 Service 后,从清单删项,清空即把棘轮升为强制规则。 - **✅【已完成 2026-06-24】【采纳自原文档 A4】ArchUnit 规则扩充**:`ArchitectureRulesTest.java` 从 1 条扩到 **6 条**——3 条强制(保真层禁依赖现代层 / 库模块[converter·parity]不得依赖应用编排层 / 模块切片 `beFreeOfCycles` 无环)+ 3 条**棘轮**(控制器不得新增直用 `JdbcTemplate` / 不得新增 Controller→Controller 互注入 / 不得新增 `Poc*` 调试控制器)。棘轮以「已知债务清单」基线化存量(JdbcTemplate 26 个 / 互注入 4 个 / Poc 3 个),只挡新增、清单即待偿台账。**验证**:`mvn -pl platform-app test -Dtest=ArchitectureRulesTest` 6/6 绿;并以临时探针走完整 RED→GREEN(探针触发恰好 3 条棘轮失败、强制规则不受影响,证明非空绿)。**一处刻意偏离原文档**:未加「禁控制器调 `POJOCRUDService`/引擎」——因 `com.eip4.*→com.dsasp.*` 是双层制明确允许(现代层=保真层薄门面),真正的坏味道是控制器直拼原始 SQL(已由 JdbcTemplate 棘轮覆盖)。**后续**:随 A1/A3 把控制器 SQL 收口到 Service 后,从清单删项,清空即把棘轮升为强制规则。
- **【采纳自原文档 D1】render-plan 无执行闭环 · high · M**:`AiAgentService.validateRenderPlanGate:987-1085` 纯字段校验,Playwright 全是注释,`READY_FOR_HUMAN_REVIEW` 不含渲染证据。→ 新增 headless render runner 真跑 renderTests 后回写 `runEvidence`。 - **【采纳自原文档 D1】render-plan 无执行闭环 · high · M**:`validateRenderPlanGate`(SRP 拆分后已迁至 `AiDraftGateValidator.java:246`)纯字段校验,Playwright 只在生成的人工指令字符串里,`READY_FOR_HUMAN_REVIEW` 不含渲染证据。→ 新增 headless render runner 真跑 renderTests 后回写 `runEvidence`。
- **✅【已完成 2026-06-25】AiAgentService(曾 1846 LOC)SRP 收窄**:原状=~28 public 入口 + 内联 9+ `validate*Gate` + 部署/回滚 SQL 生成 + 运行记录映射揉一类。**已做**:① 部署/回滚 SQL 簇 → `AiDeploymentSqlBuilder`(黄金串测试钉死红线 SQL 字节);② 草稿门禁电池(validateDraft + 各 `validate*Gate` + SchemaGate 懒加载状态 + 正则常量)→ `AiDraftGateValidator`(直测各类 pass/fail,D3 红线判定零变更)。主类 **1846→1329 行(-28%)** 收敛为薄编排门面(29 public 方法协调 store + 抽出的 collaborator)。**验证**:逐方法/逐字搬迁、行为零变更——AiAgentServiceTest 22/22 + AiAgentControllerTest 11/11 + pipeline 无回归,platform-ai 79 全绿 + 全 reactor `mvn clean install` 绿;新增 AiDeploymentSqlBuilderTest 8 + AiDraftGateValidatorTest 7。**有意丢弃 AiRunStore**:持久化已由现有 `AiAgentStore`(saveTask/saveDraft/saveRun/…)承担,另抽会重复。分支 `feat/ai-agent-service-split` --no-ff 合 main,origin/main=`285d601`。 - **✅【已完成 2026-06-25】AiAgentService(曾 1846 LOC)SRP 收窄**:原状=~28 public 入口 + 内联 9+ `validate*Gate` + 部署/回滚 SQL 生成 + 运行记录映射揉一类。**已做**:① 部署/回滚 SQL 簇 → `AiDeploymentSqlBuilder`(黄金串测试钉死红线 SQL 字节);② 草稿门禁电池(validateDraft + 各 `validate*Gate` + SchemaGate 懒加载状态 + 正则常量)→ `AiDraftGateValidator`(直测各类 pass/fail,D3 红线判定零变更)。主类 **1846→1329 行(-28%)** 收敛为薄编排门面(29 public 方法协调 store + 抽出的 collaborator)。**验证**:逐方法/逐字搬迁、行为零变更——AiAgentServiceTest 22/22 + AiAgentControllerTest 11/11 + pipeline 无回归,platform-ai 79 全绿 + 全 reactor `mvn clean install` 绿;新增 AiDeploymentSqlBuilderTest 8 + AiDraftGateValidatorTest 7。**有意丢弃 AiRunStore**:持久化已由现有 `AiAgentStore`(saveTask/saveDraft/saveRun/…)承担,另抽会重复。分支 `feat/ai-agent-service-split` --no-ff 合 main,origin/main=`285d601`。
- **【采纳自原文档 A1/A3】platform-metadata 过厚(31 Controller / 4 Service / 0 Repository)+ Controller 互注入 · medium · L**:`EntityController.java:46/:398` 直接注入并调用 `PickerController`。→ 抽 `PickerService`/`ReferenceResolutionService` 切断互注入;建 web/service/repository 分层(与 ArchUnit 合并做)。 - **【采纳自原文档 A1/A3】platform-metadata 过厚(31 Controller / 4 Service / 0 Repository)+ Controller 互注入 · medium · L**:`EntityController.java:46/:398` 直接注入并调用 `PickerController`。→ 抽 `PickerService`/`ReferenceResolutionService` 切断互注入;建 web/service/repository 分层(与 ArchUnit 合并做)。
- **🟡【有界安全修已完成 2026-06-25,完整支持仍 L】前端 scriptCommands 联动静默哑火**:原状=`scriptCommands.ts` 把 `setLabel/setRequired/setFilter/setOptions/setNullSelection/setStyle` 翻成 amis `setValue`,但核实 amis `setValue`(CmptAction)只读 `args.value`、丢弃语义 args → 运行时 no-op(且 `args.value` 为 undefined 经 onChange 路径可能清值);amis 全量 `registerAction` 无这些动词的内置 action。**已做(有界安全修,eip4-web origin/main=`68d797e`)**:6 个动词改为<strong>显式跳过(返回 null,translateCommands 自动过滤)+ 一次性 `console.warn`</strong>——消除清值风险、不再伪装「已处理」、不再用假绿单测掩盖;新增覆盖(跳过/整体过滤/告警去重),full vitest 83/83 + tsc -b 干净。**仍 L(未做)**:要让「动态必填/选项/过滤」真生效需<strong>转换器侧生成数据绑定 schema</strong>(`requiredOn`/`source` 绑数据变量)+ 重放改数据变量 + Playwright 真 DOM e2e,跨 platform-converter + eip4-web,对冻结 amis-fork 有回归面,需独立排期。 - **🟡【有界安全修已完成 2026-06-25,完整支持仍 L】前端 scriptCommands 联动静默哑火**:原状=`scriptCommands.ts` 把 `setLabel/setRequired/setFilter/setOptions/setNullSelection/setStyle` 翻成 amis `setValue`,但核实 amis `setValue`(CmptAction)只读 `args.value`、丢弃语义 args → 运行时 no-op(且 `args.value` 为 undefined 经 onChange 路径可能清值);amis 全量 `registerAction` 无这些动词的内置 action。**已做(有界安全修,eip4-web origin/main=`68d797e`)**:6 个动词改为<strong>显式跳过(返回 null,translateCommands 自动过滤)+ 一次性 `console.warn`</strong>——消除清值风险、不再伪装「已处理」、不再用假绿单测掩盖;新增覆盖(跳过/整体过滤/告警去重),full vitest 83/83 + tsc -b 干净。**仍 L(未做)**:要让「动态必填/选项/过滤」真生效需<strong>转换器侧生成数据绑定 schema</strong>(`requiredOn`/`source` 绑数据变量)+ 重放改数据变量 + Playwright 真 DOM e2e,跨 platform-converter + eip4-web,对冻结 amis-fork 有回归面,需独立排期。
@@ -243,4 +250,22 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁
--- ---
## 11. 报表保真层(套打 JOR)重宿主 + 安全/OOM 收口(2026-06-25/26)
真实报表 = jatools JOR 套打模板(633 个),**重宿主非重建**:复用客户预编译引擎在无界面环境 headless 渲染为 HTML/PDF/XLS。Phase 1-3(渲染服务 + `/api/report/render` 三格式 + `/api/report/frame` amis 信封 + 转换器对 type=200 产报表查看器 crud,铺全 339)已完成并 push(origin/main `53f3c25`)。其上做了一轮**安全 / 性能 / OOM 审计与收口**(8 维度审计 + 安全 reviewer 对抗复审,TDD + 真库 live e2e),分三批合入 origin/main:
| 批次 | 内容 | merge |
|---|---|---|
| 1 | SQLi 参数门(模板引用名白名单 + 字符白名单值校验 + 身份/数据域注入)/ IDOR 对象级菜单授权 / XXE(字节级拒 DOCTYPE,防 BOM/UTF-16 绕过)/ 渲染并发闸(429) / 产物字节上限(413) / DB `statement_timeout`+`socketTimeout` / 错误响应通用化 | `e6c73a4` |
| 2 | 残留收口:结果集 `maxResultBuffer` 驱动层封顶(防 `TYPE_SCROLL_INSENSITIVE` 全量物化 OOM)+ 多值 `IN (${LIST})` 逗号放行 | `dccca17` |
| 3 | CVE 依赖替换(commons-collections 3.0→3.2.2 / log4j 1.2.8→reload4j 1.2.25,引擎 jar 不可改但依赖可换)+ 报表只读数据源(`eip4.report.db.*`,未配回落主源,向后兼容)+ 只读账号 GRANT/巡检 SQL | `d697885` |
**审计头号风险**:报表 SQL 的 `${PARAM}` 经 jatools `evalTemplate` **字符串拼接**进 SQL 后 `prepareStatement` 执行(无占位符绑定)→ 全参数 SQL 注入。引擎为预编译 jar 不可改,故全部在包装层收口(`ReportParamGuard` 等 11 个类、79 单测)。
**关键验证**:数值上下文注入 `?PROJECTID=0 union select…` → 400;IDOR 非超管越权 → 403、超管 bypass → 200;`maxResultBuffer` 经独立 JDBC 探针在同款 `TYPE_SCROLL_INSENSITIVE` 路径实证超限即抛非 OOM;CVE 替换后依赖树/运行时 classpath 实证生效、live HTML/PDF=200 无 ClassNotFound。
**仍开口(引擎/部署层)**:凭据外泄不可在渲染层修(模板 `<Connection>` 经同一 `property("DBPassword")` 解析口令,巡检脚本实测当前 326 模板 0 处泄露)→ 真 containment = 只读 DB 账号(脚本已交付 `platform-report/docs/security/`,待运维执行并配 `eip4.report.db.*`);结果集 OOM 对多并发非完全封顶(`maxResultBuffer` 是单查询上限×并发数);裸 `DriverManager` 连接池化未做;`bsh`(jatools fork)/`itext`(只生成不解析 PDF)/`xerces 2.6.2`(XXE 已被前置 DOCTYPE 拒绝兜住) 三 CVE 件不可换,已记录理由。
---
*本文为人工可读的进度权威;逐视图细目见 framework backlog + TODO,方法论/部署 recipe 见用户管理 Delta 移植交接文档,特性设计见 plans/ 下 06-19/06-20 三份 design。架构改进待办见 §10(2026-06-24 并入,取代已删除的《EIP4 架构分析与改进建议》)。* *本文为人工可读的进度权威;逐视图细目见 framework backlog + TODO,方法论/部署 recipe 见用户管理 Delta 移植交接文档,特性设计见 plans/ 下 06-19/06-20 三份 design。架构改进待办见 §10(2026-06-24 并入,取代已删除的《EIP4 架构分析与改进建议》)。*

View File

@@ -38,9 +38,11 @@ import com.dsasp.server.wf.support.WfTypes;
* 仅用其 processInstanceId,经引擎运行时反查,避免对实现类的硬转型,与 PoC 桩同口径)。</li> * 仅用其 processInstanceId,经引擎运行时反查,避免对实现类的硬转型,与 PoC 桩同口径)。</li>
* </ol> * </ol>
* *
* <p><b>当前未接入的分支(WARN 降级,报告登记):</b>{@code scriptUser}(JUEL 脚本,26 处, * <p><b>分支覆盖现状:</b>{@code scriptUser}(JUEL 脚本)已于 2026-06-26 接入
* 需服务流脚本引擎,超独立服务精简边界)、{@code agentService} 代理人替换后处理(项目定制扩展)。 * {@link #resolveScriptUsers}(单变量直读流程变量 + 复杂表达式回退引擎 ExpressionManager 求值
* 占主导的 user/position/depart/formSpecifiedDimension/initiator 等类型(实测分布见报告)全部覆盖。</p> * + coerceUserList 归一,支撑招投标/总包合同/施工技术交底等会签流的 {@code ${APPLYUSERS}});
* 占主导的 user/position/depart/formSpecifiedDimension/initiator 等类型(实测分布见报告)全部覆盖。
* <b>仍未接入:</b>{@code agentService} 代理人替换后处理(项目定制扩展,WARN 降级)。</p>
*/ */
public class CandidateUsersHandler { public class CandidateUsersHandler {
@@ -86,11 +88,11 @@ public class CandidateUsersHandler {
? WfTypes.INITIATORLEADER : WfTypes.INITIATORDEPARTMANAGER; ? WfTypes.INITIATORLEADER : WfTypes.INITIATORDEPARTMANAGER;
users = directory.assignmentUser(t, userProperty.getContent(), beforeUser, null); users = directory.assignmentUser(t, userProperty.getContent(), beforeUser, null);
}else if(WfTypes.SCRIPTUSER.equals(userProperty.getType())){ }else if(WfTypes.SCRIPTUSER.equals(userProperty.getType())){
// 原版经 ScriptingEngines.evaluate(content,"juel",execution) 求值; // scriptUser:content 为 JUEL 表达式(会签等多实例办理人集合多用此类型,绝大多数形如 ${VARNAME},
// 独立服务不内置服务流脚本引擎(精简边界),WARN 降级,报告登记。 // 如招投标/总包合同/施工技术交底会签的 ${APPLYUSERS})。原版经服务流脚本引擎求值;此处优先按
log.warn("candidateUsersHandler: scriptUser(JUEL 脚本)分支独立服务暂未接入,跳过该项" // 单变量名直读流程变量(稳,无命令上下文依赖),复杂表达式回退 flowable 表达式管理器对 execution 求值,
+ "(影响面≈0.5%/26 处;命中则该任务无此类候选人,生产可监控)"); // 结果按 List/数组/逗号分隔串/单值归一为 userId 列表。修复前此分支 WARN 降级返空 → 这类会签节点无办理人被跳过。
users = new ArrayList<String>(); users = resolveScriptUsers(runtimeService, processInstanceId, execution, userProperty.getContent());
}else if(WfTypes.PROJECTROLETYPE.equals(userProperty.getType())){ }else if(WfTypes.PROJECTROLETYPE.equals(userProperty.getType())){
users = directory.getUsersByProjectRole(projectId, userProperty.getContent()); users = directory.getUsersByProjectRole(projectId, userProperty.getContent());
} }
@@ -207,6 +209,93 @@ public class CandidateUsersHandler {
} }
} }
/** {@code ${VAR}} 单变量名匹配(会签 scriptUser 绝大多数为此形态)。 */
private static final java.util.regex.Pattern SINGLE_VAR =
java.util.regex.Pattern.compile("\\$\\{\\s*([A-Za-z_][A-Za-z0-9_]*)\\s*\\}");
/**
* scriptUser 类型办理人解析:content 为 JUEL 表达式。绝大多数(含会签 {@code ${APPLYUSERS}})是单变量名,
* 优先直读该流程变量(稳,无命令上下文依赖);非单变量的复杂表达式回退 flowable 表达式管理器对 execution 求值。
* 结果按 List/数组/逗号分号(全/半角)分隔串/单值归一为去重 userId 列表;解析不出返回空(安全降级)。
*/
protected List<String> resolveScriptUsers(RuntimeService runtimeService, String processInstanceId,
Object execution, String content) {
if (content == null || content.isBlank()) {
return new ArrayList<String>();
}
Object value = null;
String varName = singleVarName(content);
if (varName != null && runtimeService != null && processInstanceId != null) {
value = getVariable(runtimeService, processInstanceId, varName);
}
if (value == null) {
value = evalExpression(execution, content);
}
List<String> users = coerceUserList(value);
if (users.isEmpty()) {
log.warn("candidateUsersHandler: scriptUser 表达式解析出空候选人 content={}(检查流程变量是否已设置)", content);
}
return users;
}
/** 单变量表达式 {@code ${VAR}} → 变量名;非单变量(复杂表达式/含运算)返回 null。 */
static String singleVarName(String content) {
if (content == null) {
return null;
}
java.util.regex.Matcher m = SINGLE_VAR.matcher(content.trim());
return m.matches() ? m.group(1) : null;
}
/** 把表达式求值结果归一为去重 userId 列表:支持 Collection/数组/逗号分号(全角半角)分隔串/单值。 */
static List<String> coerceUserList(Object value) {
List<String> out = new ArrayList<String>();
if (value == null) {
return out;
}
if (value instanceof java.util.Collection<?> col) {
for (Object o : col) {
addUser(out, o);
}
} else if (value instanceof Object[] arr) {
for (Object o : arr) {
addUser(out, o);
}
} else if (value instanceof String s) {
for (String part : s.split("[,;,;\\s]+")) {
addUser(out, part);
}
} else {
addUser(out, value);
}
return out;
}
private static void addUser(List<String> out, Object o) {
if (o == null) {
return;
}
String s = o.toString().trim();
if (!s.isEmpty() && !out.contains(s)) {
out.add(s);
}
}
/** 复杂 JUEL 表达式回退:命令上下文内经 flowable 表达式管理器对 execution(VariableScope)求值。 */
private Object evalExpression(Object execution, String content) {
try {
if (execution instanceof org.flowable.variable.api.delegate.VariableScope vs) {
var pec = org.flowable.engine.impl.context.Context.getProcessEngineConfiguration();
if (pec != null) {
return pec.getExpressionManager().createExpression(content).getValue(vs);
}
}
} catch (Exception e) {
log.warn("candidateUsersHandler: scriptUser 复杂表达式求值失败 content={}: {}", content, e.toString());
}
return null;
}
private static boolean isEmpty(String s) { private static boolean isEmpty(String s) {
return s == null || s.trim().isEmpty(); return s == null || s.trim().isEmpty();
} }

View File

@@ -26,4 +26,10 @@ public class ApprovalContextDto {
public boolean ended; public boolean ended;
/** 任务/实例是否挂起(挂起不可办理)。 */ /** 任务/实例是否挂起(挂起不可办理)。 */
public boolean suspended; public boolean suspended;
/** 是否会签(BPMN 多实例)任务:true 时下面三个计数有效,前端显「已会签 N/M」。 */
public boolean cosign;
/** 会签总人数(多实例 nrOfInstances)。 */
public int cosignTotal;
/** 会签已完成人数(多实例 nrOfCompletedInstances)。 */
public int cosignCompleted;
} }

View File

@@ -0,0 +1,134 @@
package com.eip4.flowservice.api;
import java.util.LinkedHashMap;
import java.util.LinkedHashSet;
import java.util.Map;
import java.util.Set;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
/**
* BPMN id 净化/还原(可逆双射)。
*
* <p>迁移的 1512 个真实流程里,1445 个的 process id 就是中文(如「总包合同交底」),BPMN 常把中文用作
* process/diagram/节点 id。bpmn-js / moddle 的 NCName 校验拒非 ASCII id → 整图无法渲染,且 moddle-xml
* 在 import 前就会拒中文 id。{@link #sanitize} 把非法(非 ASCII NCName)id 及其全部引用一致重写为安全
* ASCII id(稳定哈希),保存原→净化映射;{@link #restore} 依映射逆向还原——发布存量流程时把中文原 key
* 原样写回引擎,保证 process key 不变(D7 硬需求)。</p>
*
* <p><b>双射保证</b>:同一文档内两个不同中文 id 若哈希相同(Java String.hashCode 存在碰撞),基名冲突时
* 追加 {@code -2}/{@code -3} 序号;生成的净化 id 亦不与文档内既有合法 id 冲突。故净化后引用不串、restore
* 可精确逆向。<b>非碰撞场景</b>下净化输出与历史实现({@code "n"+hex(hashCode)})逐字节一致,保住查看器回归。</p>
*
* <p><b>restore 前缀安全</b>:还原一律复用 {@link #ID_ATTR} 正则逐个属性值精确匹配,绝不裸 {@code String.replace}
* 子串替换——否则净化 id {@code n1} 会误伤前缀相同的 {@code n1x}。映射外的 id(如设计器新增的 ASCII 节点)原样保留。</p>
*/
final class BpmnIdSanitizer {
private BpmnIdSanitizer() {
}
/** id/引用类属性(值须为合法 NCName);name/value 等展示属性不在内,避免改坏中文节点名。 */
static final Pattern ID_ATTR = Pattern.compile(
"\\b(id|bpmnElement|sourceRef|targetRef|attachedToRef|processRef|default)\\s*=\\s*\"([^\"]+)\"");
/** 净化结果:{@code xml}=净化后 XML;{@code idMap}=原 id→净化 id(双射,供 {@link #restore} 逆向)。 */
record Result(String xml, Map<String, String> idMap) {
}
/**
* 把 BPMN 里非法(非 ASCII NCName)的 id 及其全部引用一致重写为安全 ASCII id。
* 只重写 id/引用类属性,name 等展示属性不动。返回净化 XML 与「原 id→净化 id」映射。
*/
static Result sanitize(String xml) {
if (xml == null || xml.isEmpty()) {
return new Result(xml, Map.of());
}
// 先登记文档内所有合法 id,占位保证生成的净化 id 不与既有合法 id 冲突(双射 + restore 安全)。
Set<String> used = new LinkedHashSet<>();
Matcher scanLegal = ID_ATTR.matcher(xml);
while (scanLegal.find()) {
String val = scanLegal.group(2);
if (isValidNcName(val)) {
used.add(val);
}
}
// 收集非法 id → 唯一净化 id;基名冲突(含 hash 碰撞)时追加 -2/-3… 保双射。
Map<String, String> map = new LinkedHashMap<>();
Matcher scan = ID_ATTR.matcher(xml);
while (scan.find()) {
String val = scan.group(2);
if (!isValidNcName(val) && !map.containsKey(val)) {
String base = "n" + Integer.toHexString(val.hashCode() & 0x7fffffff);
String safe = base;
int seq = 2;
while (used.contains(safe)) {
safe = base + "-" + seq++;
}
map.put(val, safe);
used.add(safe);
}
}
if (map.isEmpty()) {
return new Result(xml, Map.of());
}
return new Result(rewrite(xml, map), map);
}
/**
* 依 {@code idMap}(原→净化)逆向还原:把净化 id 精确写回原 id。映射外的 id(如新增 ASCII 节点)原样保留。
* 逐个属性值精确匹配(复用 {@link #ID_ATTR}),前缀安全。
*/
static String restore(String xml, Map<String, String> idMap) {
if (xml == null || xml.isEmpty() || idMap == null || idMap.isEmpty()) {
return xml;
}
// 反转前校验双射:idMap 值(净化 id)重复会让 inverse 静默覆盖 → 还原错。fail-fast
// (T2.1 起 idMap 从 metaInfo JSON 反序列化,损坏数据须炸不能静默还原成别的 key)。
Map<String, String> inverse = new LinkedHashMap<>();
for (Map.Entry<String, String> e : idMap.entrySet()) {
String clash = inverse.put(e.getValue(), e.getKey());
if (clash != null) {
throw new IllegalArgumentException("idMap 非双射:净化 id \"" + e.getValue()
+ "\" 同时映射自 \"" + clash + "\" 与 \"" + e.getKey() + "\"");
}
}
return rewrite(xml, inverse);
}
/**
* 逐个 id/引用类属性值按 {@code map} 精确替换(命中才换,未命中原样)。前缀安全:只锚定完整属性值。
* 未改值的属性原样回写(append group(0) 原文),不重构 → 不归一 {@code id = "x"} 这类等号周围空白,保逐字节契约。
*/
private static String rewrite(String xml, Map<String, String> map) {
Matcher rw = ID_ATTR.matcher(xml);
StringBuilder sb = new StringBuilder();
while (rw.find()) {
String val = rw.group(2);
String repl = map.getOrDefault(val, val);
String replacement = repl.equals(val) ? rw.group(0) : rw.group(1) + "=\"" + repl + "\"";
rw.appendReplacement(sb, Matcher.quoteReplacement(replacement));
}
rw.appendTail(sb);
return sb.toString();
}
/** ASCII NCName:首字符字母/下划线,其余字母/数字/下划线/连字符/点;非 ASCII(中文等)视为非法。 */
private static boolean isValidNcName(String s) {
if (s == null || s.isEmpty()) {
return false;
}
char c0 = s.charAt(0);
if (!((c0 >= 'A' && c0 <= 'Z') || (c0 >= 'a' && c0 <= 'z') || c0 == '_')) {
return false;
}
for (int i = 1; i < s.length(); i++) {
char c = s.charAt(i);
if (!((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9')
|| c == '_' || c == '-' || c == '.')) {
return false;
}
}
return true;
}
}

View File

@@ -40,6 +40,8 @@ public class FlowController {
/** 默认审批流程 key:命名流程定义未部署时回退到此,保「提交审批」闭环可走(dev 无客户 BPMN 时)。 */ /** 默认审批流程 key:命名流程定义未部署时回退到此,保「提交审批」闭环可走(dev 无客户 BPMN 时)。 */
private static final String DEFAULT_APPROVAL_KEY = "EIP4_DEFAULT_APPROVAL"; private static final String DEFAULT_APPROVAL_KEY = "EIP4_DEFAULT_APPROVAL";
private static final int STATUS_PROCESSING = 2; private static final int STATUS_PROCESSING = 2;
/** 协办/转阅单次最多派发人数(防滥用刷任务,对齐人工选人场景的合理上限)。 */
private static final int MAX_FANOUT = 50;
private static final Set<String> WITHDRAW_COMMENT_WHITELIST = private static final Set<String> WITHDRAW_COMMENT_WHITELIST =
Set.of("回退", "主动召回", "更换任务处理人员"); Set.of("回退", "主动召回", "更换任务处理人员");
@@ -437,6 +439,168 @@ public class FlowController {
return ResponseEntity.ok(t != null ? TaskDto.of(t) : null); return ResponseEntity.ok(t != null ? TaskDto.of(t) : null);
} }
@PostMapping("/tasks/{taskId}/assist")
@org.springframework.transaction.annotation.Transactional
@Operation(summary = "协办(加签)",
description = "对齐老 ProcessCoreServiceImpl.createSubTask:为每个目标用户建一条独立子任务"
+ "(assignee=该用户,parentTaskId=当前任务,name=协办,formKey=父任务formKey 以便协办人渲染业务单据),父任务记意见。"
+ "子任务进协办人待办,办毕各自 complete,不阻断主任务办理。父任务不存在 → 404,targetUserIds 为空 → 400,超 "
+ MAX_FANOUT + " 人 → 400。整批 @Transactional 原子。")
public ResponseEntity<Map<String, Object>> assist(@PathVariable String taskId,
@RequestBody(required = false) Requests.ActionRequest req) {
List<String> userIds = targetUserIds(req);
ResponseEntity<Map<String, Object>> bad = validateFanout(userIds, "协办");
if (bad != null) {
return bad;
}
var parent = taskService.createTaskQuery().taskId(taskId).singleResult();
if (parent == null) {
return ResponseEntity.notFound().build();
}
// 协办子任务也带 formKey(取父任务 formKey),使协办人打开能渲染同一业务单据。
String formKey = formKeyResolver.resolve(parent.getFormKey(),
parent.getProcessDefinitionId(), parent.getTaskDefinitionKey());
addCommentIfPresent(taskId, parent, req == null ? null : req.comment);
for (String userId : userIds) {
org.flowable.task.api.Task sub = taskService.newTask();
sub.setAssignee(userId);
sub.setParentTaskId(taskId);
sub.setName("协办");
if (formKey != null) {
sub.setFormKey(formKey);
}
taskService.saveTask(sub);
}
Map<String, Object> r = new java.util.LinkedHashMap<>();
r.put("assisted", true);
r.put("count", userIds.size());
r.put("taskId", taskId);
return ResponseEntity.ok(r);
}
@PostMapping("/tasks/{taskId}/circulate")
@org.springframework.transaction.annotation.Transactional
@Operation(summary = "转阅(抄送)",
description = "对齐老 ProcessCoreServiceImpl.createNewTask:为每个目标用户建一条只读转阅任务"
+ "(name=转阅,assignee=该用户,parentTaskId=当前任务,formKey=父任务formKey 以便转阅人渲染同一业务单据)。"
+ "转阅不阻断、不推进主流程。父任务不存在 → 404,targetUserIds 为空 → 400,超 " + MAX_FANOUT
+ " 人 → 400。整批 @Transactional 原子。")
public ResponseEntity<Map<String, Object>> circulate(@PathVariable String taskId,
@RequestBody(required = false) Requests.ActionRequest req) {
List<String> userIds = targetUserIds(req);
ResponseEntity<Map<String, Object>> bad = validateFanout(userIds, "转阅");
if (bad != null) {
return bad;
}
var parent = taskService.createTaskQuery().taskId(taskId).singleResult();
if (parent == null) {
return ResponseEntity.notFound().build();
}
String formKey = formKeyResolver.resolve(parent.getFormKey(),
parent.getProcessDefinitionId(), parent.getTaskDefinitionKey());
addCommentIfPresent(taskId, parent, req == null ? null : req.comment);
for (String userId : userIds) {
org.flowable.task.api.Task copy = taskService.newTask();
copy.setName("转阅");
copy.setAssignee(userId);
// 用 setFormKey(而非塞 description)使审批渲染路径 FormKeyResolver 直接命中。
if (formKey != null) {
copy.setFormKey(formKey);
}
copy.setParentTaskId(taskId);
taskService.saveTask(copy);
}
Map<String, Object> r = new java.util.LinkedHashMap<>();
r.put("circulated", true);
r.put("count", userIds.size());
r.put("taskId", taskId);
return ResponseEntity.ok(r);
}
/** 协办/转阅派发人数校验:空 → 400「需指定」;超 {@link #MAX_FANOUT} → 400。合法返回 null。 */
private ResponseEntity<Map<String, Object>> validateFanout(List<String> userIds, String verb) {
if (userIds.isEmpty()) {
return ResponseEntity.badRequest().body(errorBody(verb + "需指定 targetUserIds"));
}
if (userIds.size() > MAX_FANOUT) {
return ResponseEntity.badRequest().body(errorBody(verb + "人数超过上限 " + MAX_FANOUT));
}
return null;
}
/** 协办/转阅目标用户:优先 targetUserIds 列表,回退单个 targetUserId;去空白去重。 */
private static List<String> targetUserIds(Requests.ActionRequest req) {
java.util.LinkedHashSet<String> set = new java.util.LinkedHashSet<>();
if (req != null && req.targetUserIds != null) {
for (String u : req.targetUserIds) {
if (u != null && !u.isBlank()) {
set.add(u.trim());
}
}
}
if (req != null && req.targetUserId != null && !req.targetUserId.isBlank()) {
set.add(req.targetUserId.trim());
}
return new java.util.ArrayList<>(set);
}
/** 父任务存在且意见非空时记入流程评论(对齐老 addComment:用父任务的 processInstanceId)。 */
private void addCommentIfPresent(String taskId, org.flowable.task.api.Task parent, String comment) {
if (parent != null && comment != null && !comment.isBlank()) {
taskService.addComment(taskId, parent.getProcessInstanceId(), comment);
}
}
/** 父任务回溯出的业务上下文(供协办/转阅独立任务渲染同一业务单据)。 */
private record ParentContext(String processInstanceId, String formKey,
String processDefinitionId, String taskDefinitionKey) {
}
/** 按 parentTaskId 取父任务的业务上下文:运行库优先,否则历史库;都查不到返回 null。 */
private ParentContext resolveParentContext(String parentTaskId) {
var p = taskService.createTaskQuery().taskId(parentTaskId).singleResult();
if (p != null) {
return new ParentContext(p.getProcessInstanceId(), p.getFormKey(),
p.getProcessDefinitionId(), p.getTaskDefinitionKey());
}
HistoricTaskInstance hp = historyService.createHistoricTaskInstanceQuery()
.taskId(parentTaskId).singleResult();
if (hp != null) {
return new ParentContext(hp.getProcessInstanceId(), hp.getFormKey(),
hp.getProcessDefinitionId(), hp.getTaskDefinitionKey());
}
return null;
}
private static boolean isBlank(String s) {
return s == null || s.isBlank();
}
/**
* 会签(BPMN 多实例)进度:沿执行树从任务执行向上找带 {@code nrOfInstances} 局部变量的多实例根执行,
* 读总人数/已完成数填入 dto(前端显「已会签 N/M」)。非多实例任务找不到 → 不改 dto(cosign=false)。
*/
private void fillCosign(ApprovalContextDto dto, String executionId) {
String execId = executionId;
for (int depth = 0; depth < 12 && !isBlank(execId); depth++) {
Map<String, Object> locals;
try {
locals = runtimeService.getVariablesLocal(execId);
} catch (RuntimeException e) {
return;
}
if (locals != null && locals.get("nrOfInstances") instanceof Number total) {
dto.cosign = true;
dto.cosignTotal = total.intValue();
dto.cosignCompleted = locals.get("nrOfCompletedInstances") instanceof Number done
? done.intValue() : 0;
return;
}
var exec = runtimeService.createExecutionQuery().executionId(execId).singleResult();
execId = exec != null ? exec.getParentId() : null;
}
}
@GetMapping("/tasks/{taskId}/approval-context") @GetMapping("/tasks/{taskId}/approval-context")
@Operation(summary = "任务审批上下文", @Operation(summary = "任务审批上下文",
description = "聚合返回 WfTemplate 驱动审批界面所需事实:formKey(=view_wftemplate_id,经 FormKeyResolver 历史回补)、" description = "聚合返回 WfTemplate 驱动审批界面所需事实:formKey(=view_wftemplate_id,经 FormKeyResolver 历史回补)、"
@@ -453,13 +617,49 @@ public class FlowController {
dto.processDefinitionId = t.getProcessDefinitionId(); dto.processDefinitionId = t.getProcessDefinitionId();
dto.taskDefinitionKey = t.getTaskDefinitionKey(); dto.taskDefinitionKey = t.getTaskDefinitionKey();
dto.suspended = t.isSuspended(); dto.suspended = t.isSuspended();
dto.formKey = formKeyResolver.resolve(t.getFormKey(), t.getProcessDefinitionId(), t.getTaskDefinitionKey()); fillCosign(dto, t.getExecutionId());
dto.startFormKey = startFormKeyResolver.resolve(t.getProcessDefinitionId());
ProcessInstance pi = runtimeService.createProcessInstanceQuery() String formKeyRaw = t.getFormKey();
.processInstanceId(t.getProcessInstanceId()).singleResult(); String procDefId = t.getProcessDefinitionId();
if (pi != null) { String taskDefKey = t.getTaskDefinitionKey();
dto.businessKey = pi.getBusinessKey(); String pid = t.getProcessInstanceId();
dto.ended = false;
// 协办/转阅是独立任务(无 processInstanceId/businessKey):沿 parentTaskId 回溯父任务取业务上下文,
// 使协办人/转阅人打开能渲染同一业务单据。同时避免下面用 null pid 查 runtime 抛 IllegalArgument。
if (isBlank(pid) && !isBlank(t.getParentTaskId())) {
ParentContext pc = resolveParentContext(t.getParentTaskId());
if (pc != null) {
pid = pc.processInstanceId();
if (isBlank(formKeyRaw)) {
formKeyRaw = pc.formKey();
}
if (isBlank(procDefId)) {
procDefId = pc.processDefinitionId();
}
if (isBlank(taskDefKey)) {
taskDefKey = pc.taskDefinitionKey();
}
dto.processInstanceId = pid; // 让前端轨迹/business-data 能定位父流程
}
}
dto.formKey = formKeyResolver.resolve(formKeyRaw, procDefId, taskDefKey);
dto.startFormKey = startFormKeyResolver.resolve(procDefId);
if (!isBlank(pid)) {
ProcessInstance pi = runtimeService.createProcessInstanceQuery()
.processInstanceId(pid).singleResult();
if (pi != null) {
dto.businessKey = pi.getBusinessKey();
dto.ended = false;
} else {
// 父流程可能已进历史(协办/转阅后主流程已结束)
var hpi = historyService.createHistoricProcessInstanceQuery()
.processInstanceId(pid).singleResult();
if (hpi != null) {
dto.businessKey = hpi.getBusinessKey();
dto.ended = hpi.getEndTime() != null;
}
}
} }
return ResponseEntity.ok(dto); return ResponseEntity.ok(dto);
} }

View File

@@ -0,0 +1,202 @@
package com.eip4.flowservice.api;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;
import org.flowable.engine.HistoryService;
import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService;
import org.flowable.engine.history.HistoricProcessInstance;
import org.flowable.engine.repository.ProcessDefinition;
import org.flowable.engine.runtime.ProcessInstance;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.http.ResponseEntity;
import org.springframework.util.StreamUtils;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
/**
* 流程图(BPMN)查看端点:返回流程定义的 BPMN 2.0 XML + 当前/历史活动节点,供前端 bpmn-js 渲染并高亮。
*
* <p>迁移的 1512 个流程定义中 1501(99.3%)含 BPMNDI 布局段,bpmn-js 可直接据此排版。
* 节点名为中文 → 用前端 bpmn-js(浏览器字体)而非服务端出图(PNG 中文易乱码且需服务器字体)。</p>
*
* <p>只读:仅查询引擎,不改任何流程/任务/业务数据。运行中实例取运行库 procDefId 与当前节点;
* 已结束实例回退历史库取 procDefId(无当前节点)。实例不存在返回 {@code found=false}(前端降级)。</p>
*/
@RestController
@RequestMapping("/api/flow")
@Tag(name = "流程图", description = "BPMN XML + 当前/历史节点(bpmn-js 渲染高亮)")
public class ProcessDiagramController {
private static final Logger log = LoggerFactory.getLogger(ProcessDiagramController.class);
private final RepositoryService repositoryService;
private final RuntimeService runtimeService;
private final HistoryService historyService;
public ProcessDiagramController(RepositoryService repositoryService, RuntimeService runtimeService,
HistoryService historyService) {
this.repositoryService = repositoryService;
this.runtimeService = runtimeService;
this.historyService = historyService;
}
@GetMapping("/process/{processInstanceId}/diagram")
@Operation(summary = "流程图数据",
description = "返回 {found, bpmnXml, activeActivityIds(当前停留), finishedActivityIds(已走过)}。"
+ "运行中实例取运行库 procDefId + getActiveActivityIds;已结束取历史库 procDefId(无当前节点);"
+ "实例不存在 found=false。bpmnXml = repositoryService.getProcessModel(procDefId)。")
public ResponseEntity<Map<String, Object>> diagram(@PathVariable String processInstanceId) {
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("processInstanceId", processInstanceId);
// procDefId:运行库优先(含当前活动节点),否则历史库(已结束)
ProcessInstance pi = runtimeService.createProcessInstanceQuery()
.processInstanceId(processInstanceId).singleResult();
String procDefId = pi != null ? pi.getProcessDefinitionId() : null;
boolean running = pi != null;
if (procDefId == null) {
HistoricProcessInstance hpi = historyService.createHistoricProcessInstanceQuery()
.processInstanceId(processInstanceId).singleResult();
procDefId = hpi != null ? hpi.getProcessDefinitionId() : null;
}
if (procDefId == null) {
resp.put("found", false);
resp.put("activeActivityIds", List.of());
resp.put("finishedActivityIds", List.of());
return ResponseEntity.ok(resp);
}
String bpmnXml = readProcessModel(procDefId);
if (bpmnXml == null) {
resp.put("found", false);
resp.put("activeActivityIds", List.of());
resp.put("finishedActivityIds", List.of());
return ResponseEntity.ok(resp);
}
// 当前停留节点(仅运行中实例有)
List<String> active = running ? safeActiveActivityIds(processInstanceId) : List.of();
// 已走过的历史节点
List<String> finished = historyService.createHistoricActivityInstanceQuery()
.processInstanceId(processInstanceId).finished().list().stream()
.map(a -> a.getActivityId())
.filter(id -> id != null && !id.isBlank())
.distinct()
.collect(Collectors.toList());
// 迁移的 BPMN 常用中文做 process/diagram id(如「招投标工程评审流程」),bpmn-js/moddle 的 NCName
// 校验拒非 ASCII id → 整图「no diagram to display」。服务端把非法 id 及其所有引用一致重写为安全 ASCII id
// (只动 id/ref 类属性,不碰 name;活动 id 多为 sid-* 合法),并同步重映射当前/历史节点 id。
List<String> mutableActive = new java.util.ArrayList<>(active);
List<String> mutableFinished = new java.util.ArrayList<>(finished);
String safeXml = sanitizeBpmnIds(bpmnXml, mutableActive, mutableFinished);
resp.put("found", true);
resp.put("bpmnXml", safeXml);
resp.put("activeActivityIds", mutableActive);
resp.put("finishedActivityIds", mutableFinished);
return ResponseEntity.ok(resp);
}
@GetMapping("/process-definitions/{procDefId}/source")
@Operation(summary = "按流程定义 id 取净化源 XML",
description = "返回 {procDefId, found, bpmnXml(净化后), idMap(原id→净化id), procDefKey, version},供 bpmn-js Modeler 在线编辑载入。"
+ "流程定义不存在 / BPMN 读取失败或为空 → found=false(HTTP 200,前端降级)。"
+ "中文 process id 经 BpmnIdSanitizer 可逆净化,idMap 供发布时逆向还原原 key(D7)。")
public ResponseEntity<Map<String, Object>> source(@PathVariable String procDefId) {
ProcessDefinition def = repositoryService.createProcessDefinitionQuery()
.processDefinitionId(procDefId).singleResult();
return sourceResponse(procDefId, def);
}
@GetMapping("/process-definitions/by-key/{key}/source")
@Operation(summary = "按流程 key 取最新版净化源 XML",
description = "返回与 by-id 端点完全相同的形状 {procDefId, found, bpmnXml, idMap, procDefKey, version},"
+ "供 Modeler 打开器按真流程 key 载入(process-select 的 source='model' 项 id 是 act_re_model id 而非 procDefId,"
+ "by-id 永远 found:false → 改用本端点)。processDefinitionKey(key).latestVersion() 取最新版,key 不存在 found:false。")
public ResponseEntity<Map<String, Object>> sourceByKey(@PathVariable String key) {
ProcessDefinition def = repositoryService.createProcessDefinitionQuery()
.processDefinitionKey(key).latestVersion().singleResult();
String procDefId = def == null ? null : def.getId();
return sourceResponse(procDefId, def);
}
/**
* 按已解析的流程定义构建源响应(by-id / by-key 共用,逻辑单一不复制):净化 XML + 原→净化 idMap + key/version。
* {@code def==null}(不存在)或 BPMN 空/读失败 → {@code found:false}(HTTP 200,前端降级)。
* {@code procDefId} 是读取部署 BPMN 资源用的定义 id(by-id=入参、by-key=解析出的最新版 id),命中时随响应回显。
*/
private ResponseEntity<Map<String, Object>> sourceResponse(String procDefId, ProcessDefinition def) {
Map<String, Object> resp = new LinkedHashMap<>();
if (procDefId != null) {
resp.put("procDefId", procDefId);
}
if (def == null) {
resp.put("found", false);
return ResponseEntity.ok(resp);
}
String bpmnXml = readProcessModel(procDefId);
if (bpmnXml == null || bpmnXml.isBlank()) {
log.warn("[流程源] BPMN 为空或读取失败 procDefId={}", procDefId);
resp.put("found", false);
return ResponseEntity.ok(resp);
}
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(bpmnXml);
resp.put("found", true);
resp.put("bpmnXml", r.xml());
resp.put("idMap", r.idMap());
resp.put("procDefKey", def.getKey());
resp.put("version", def.getVersion());
return ResponseEntity.ok(resp);
}
/**
* 把 BPMN 里非法(非 ASCII NCName)的 id 及其全部引用一致重写为安全 ASCII id,使 bpmn-js 能解析渲染,
* 并同步重映射 active/finished 节点 id。净化算法委托 {@link BpmnIdSanitizer}(含可逆映射与 hash 碰撞消解)。
*/
static String sanitizeBpmnIds(String xml, List<String> active, List<String> finished) {
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
Map<String, String> map = r.idMap();
active.replaceAll(id -> map.getOrDefault(id, id));
finished.replaceAll(id -> map.getOrDefault(id, id));
return r.xml();
}
/** 读流程定义 BPMN XML(getProcessModel 返回部署的 BPMN 资源流)。读失败返回 null(前端降级)。 */
private String readProcessModel(String procDefId) {
try (InputStream is = repositoryService.getProcessModel(procDefId)) {
if (is == null) {
return null;
}
return StreamUtils.copyToString(is, StandardCharsets.UTF_8);
} catch (Exception e) {
log.warn("[流程图] 读取 BPMN 失败 procDefId={}: {}", procDefId, e.toString());
return null;
}
}
/** getActiveActivityIds 对已结束/不存在实例会抛异常 → 包裹降级为空。 */
private List<String> safeActiveActivityIds(String processInstanceId) {
try {
List<String> ids = runtimeService.getActiveActivityIds(processInstanceId);
return ids == null ? List.of() : ids;
} catch (RuntimeException e) {
log.debug("[流程图] 取当前节点降级 pi={}: {}", processInstanceId, e.toString());
return List.of();
}
}
}

View File

@@ -0,0 +1,620 @@
package com.eip4.flowservice.api;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.Date;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.regex.Pattern;
import java.util.stream.Collectors;
import org.flowable.bpmn.converter.BpmnXMLConverter;
import org.flowable.bpmn.model.BpmnModel;
import org.flowable.common.engine.impl.util.io.StringStreamSource;
import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService;
import org.flowable.engine.repository.Model;
import org.flowable.engine.repository.ProcessDefinition;
import org.flowable.validation.ProcessValidator;
import org.flowable.validation.ProcessValidatorFactory;
import org.flowable.validation.ValidationError;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.util.StreamUtils;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
/**
* 流程草稿 CRUD(flowable 原生 Model API 存 act_re_model,本控制器为全仓首次启用 Model API)。
*
* <p>在线 Modeler 的草稿仓:编辑中的 BPMN 存为 flowable Model(editorSource=BPMN XML,metaInfo=EIP4 元数据 JSON),
* 不进部署库;发布(T3.1)时才 restore 中文原 key + 校验门 + deploy。act_re_model 表已有 143 行存量、schema 已在,
* {@code databaseSchemaUpdate=false} 不涉 DDL。</p>
*
* <p><b>存量隔离</b>:本控制器建的草稿一律 {@code setCategory("eip4")},{@link #list()} 只查该分类,
* 库里 143 条老 shape act_re_model(旧 metaInfo + 可能悬空 editorSource)不进 Modeler 列表、避免打不开。</p>
*
* <p>写入前 XML 一律过解析守卫({@link #parseGuard}):①字节级拒 DOCTYPE(XXE 门);②{@link BpmnXMLConverter}
* 以 {@code validateSchema=false}(草稿是半成品,不做严格 XSD——bpmn-js 默认命名空间输出与严格 XSD 已知固有不兼容,
* 完整校验属部署门)+ {@code enableSafeBpmnXml=true}(加固解析器,双保险防外部实体)解析。坏 XML 返 422 且绝不落库;
* 422 只回通用文案,原始解析原因仅进日志。守卫异常就地 catch 转 422,不逸出到 {@code FlowExceptionHandler}
* (那里 FlowableException→400,语义不符)。
* {@code from-procdef} 复用「按 procDefId 读部署 BPMN」逻辑(本控制器自带 {@link #readProcessModel} 小方法,
* 零改动 ProcessDiagramController)→ {@link BpmnIdSanitizer#sanitize} 净化中文 id → 建草稿,
* 原→净化映射连同源 procDefId/原 key 写进 metaInfo,供发布逆向还原。</p>
*
* <p><b>鉴权</b>:本控制器随 flowable-service 跑在裸 8089,进程本身无鉴权栈;所有写端点
* (POST/PUT/from-procdef)必须经 platform-flow-gateway 的超管门访问(T2.2),生产环境 8089 不对外暴露。</p>
*/
@RestController
@RequestMapping("/api/flow")
@Tag(name = "流程草稿", description = "flowable Model API 草稿 CRUD(act_re_model)+ 从流程定义建草稿")
public class ProcessModelController {
private static final Logger log = LoggerFactory.getLogger(ProcessModelController.class);
/** EIP4 草稿分类:建草稿时打此标,list() 只查此分类,隔离库里 143 条老 shape 存量 act_re_model。 */
static final String EIP4_CATEGORY = "eip4";
/** DOCTYPE 门 prolog 扫描字节上限(BOM/XML 声明/注释/DOCTYPE 都在最前)。 */
private static final int PROLOG_SCAN_BYTES = 8192;
/**
* bpmn-js {@code saveXML} 补的 {@code <*:incoming>/<*:outgoing>} 文本引用元素(前缀可选:bpmn/bpmn2/默认)。
* 发布前整体剥除——Flowable 从 {@code sequenceFlow} 的 sourceRef/targetRef 自行推导入出边,这些元素冗余;
* 且它们把节点/流 id 存为<b>元素文本</b>(非属性),{@link BpmnIdSanitizer#restore} 只还原属性位不碰文本
* → 不剥则落库「属性=中文原 key、文本引用=净化 id」的脏 XML(T1.3 评审 I-2)。
*/
private static final Pattern FLOW_REF_ELEMENT = Pattern.compile(
"<(?:[\\w.-]+:)?(?:incoming|outgoing)>[^<]*</(?:[\\w.-]+:)?(?:incoming|outgoing)>");
private final RepositoryService repositoryService;
private final RuntimeService runtimeService;
private final ProcessValidator processValidator;
private final ObjectMapper objectMapper = new ObjectMapper();
@Autowired
public ProcessModelController(RepositoryService repositoryService, RuntimeService runtimeService) {
this(repositoryService, runtimeService, new ProcessValidatorFactory().createDefaultProcessValidator());
}
/**
* 单参构造:既有草稿 CRUD 单测保留零改动地 {@code new ProcessModelController(repositoryService)}
* (那些用例不触发发布/影响路径,无需 RuntimeService/校验器)。
*/
ProcessModelController(RepositoryService repositoryService) {
this(repositoryService, null, new ProcessValidatorFactory().createDefaultProcessValidator());
}
/**
* 全参构造:发布/影响端点单测注入 <b>mock</b> {@link ProcessValidator}
* ({@code ProcessValidatorFactory} 产的默认校验器无法 mock,须构造注入以断言 ERROR-vs-WARNING 分支)。
*/
ProcessModelController(RepositoryService repositoryService, RuntimeService runtimeService,
ProcessValidator processValidator) {
this.repositoryService = repositoryService;
this.runtimeService = runtimeService;
this.processValidator = processValidator;
}
@GetMapping("/models")
@Operation(summary = "草稿列表",
description = "createModelQuery().modelCategory(\"eip4\").orderByLastUpdateTime().desc() → "
+ "{models:[{id,name,key,lastUpdateTime(ISO)}]}。只列 EIP4 建的草稿,隔离存量 act_re_model。")
public ResponseEntity<Map<String, Object>> list() {
List<Map<String, Object>> models = repositoryService.createModelQuery()
.modelCategory(EIP4_CATEGORY)
.orderByLastUpdateTime().desc().list().stream()
.map(m -> {
Map<String, Object> row = new LinkedHashMap<>();
row.put("id", m.getId());
row.put("name", m.getName());
row.put("key", m.getKey());
row.put("lastUpdateTime", toIso(m.getLastUpdateTime()));
return row;
})
.collect(Collectors.toList());
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("models", models);
return ResponseEntity.ok(resp);
}
@GetMapping("/models/{id}")
@Operation(summary = "取草稿",
description = "getModel + getModelEditorSource → {found,id,name,key,bpmnXml,metaInfo}。"
+ "草稿不存在或编辑源为空 → {found:false}(HTTP 200,前端降级)。")
public ResponseEntity<Map<String, Object>> get(@PathVariable String id) {
Map<String, Object> resp = new LinkedHashMap<>();
Model model = repositoryService.getModel(id);
if (model == null) {
resp.put("found", false);
return ResponseEntity.ok(resp);
}
byte[] source = repositoryService.getModelEditorSource(id);
if (source == null) {
resp.put("found", false);
return ResponseEntity.ok(resp);
}
resp.put("found", true);
resp.put("id", model.getId());
resp.put("name", model.getName());
resp.put("key", model.getKey());
resp.put("bpmnXml", new String(source, StandardCharsets.UTF_8));
resp.put("metaInfo", model.getMetaInfo());
return ResponseEntity.ok(resp);
}
@PostMapping("/models")
@Operation(summary = "建草稿",
description = "body {name,key,bpmnXml,metaInfo?}。name/key 空白→422;XML 过 BpmnXMLConverter 解析守卫"
+ "(坏 XML→422 不落库);过门后 newModel+setCategory(eip4)+saveModel+addModelEditorSource → {modelId}。")
public ResponseEntity<Map<String, Object>> create(@RequestBody CreateModelRequest req) {
// key 是 T3.1 部署资源名/中文原 key 还原的依赖,name 用于列表展示:空白一律拒。
if (isBlank(req.name) || isBlank(req.key)) {
return status(HttpStatus.UNPROCESSABLE_ENTITY, "name 与 key 不能为空");
}
ResponseEntity<Map<String, Object>> rejected = parseGuard(req.bpmnXml);
if (rejected != null) {
return rejected;
}
Model model = repositoryService.newModel();
model.setName(req.name);
model.setKey(req.key);
model.setCategory(EIP4_CATEGORY);
if (req.metaInfo != null) {
model.setMetaInfo(req.metaInfo);
}
repositoryService.saveModel(model);
repositoryService.addModelEditorSource(model.getId(), req.bpmnXml.getBytes(StandardCharsets.UTF_8));
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("modelId", model.getId());
return ResponseEntity.ok(resp);
}
@PutMapping("/models/{id}")
@Operation(summary = "更新草稿",
description = "草稿不存在→404;更新 name/metaInfo(仅当请求提供,避免覆盖 eip4IdMap)与 editorSource(XML 同守卫 422) → {status:0}。")
public ResponseEntity<Map<String, Object>> update(@PathVariable String id, @RequestBody UpdateModelRequest req) {
Model model = repositoryService.getModel(id);
if (model == null) {
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
}
ResponseEntity<Map<String, Object>> rejected = parseGuard(req.bpmnXml);
if (rejected != null) {
return rejected;
}
if (req.name != null) {
model.setName(req.name);
}
// metaInfo 仅当请求显式提供时更新:草稿存 eip4IdMap 于 metaInfo,普通保存不重发 metaInfo 时不能抹掉它。
if (req.metaInfo != null) {
model.setMetaInfo(req.metaInfo);
}
repositoryService.saveModel(model);
repositoryService.addModelEditorSource(id, req.bpmnXml.getBytes(StandardCharsets.UTF_8));
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("status", 0);
return ResponseEntity.ok(resp);
}
@DeleteMapping("/models/{id}")
@Operation(summary = "删草稿",
description = "草稿不存在→404;存在则 deleteModel(id)(连带 editorSource/metaInfo 一并删) → {status:0}。")
public ResponseEntity<Map<String, Object>> delete(@PathVariable String id) {
Model model = repositoryService.getModel(id);
if (model == null) {
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
}
repositoryService.deleteModel(id);
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("status", 0);
return ResponseEntity.ok(resp);
}
@PostMapping("/models/from-procdef")
@Operation(summary = "从流程定义建草稿",
description = "body {procDefId}。读部署 BPMN → BpmnIdSanitizer.sanitize 净化中文 id → 建草稿"
+ "(name/key=procDef,editorSource=净化 XML,metaInfo={eip4IdMap,sourceProcDefId,originalKey}) → {modelId}。"
+ "procDef 不存在或 BPMN 空 → {found:false}(HTTP 200,前端降级)。")
public ResponseEntity<Map<String, Object>> fromProcDef(@RequestBody FromProcDefRequest req) {
ProcessDefinition def = repositoryService.createProcessDefinitionQuery()
.processDefinitionId(req.procDefId).singleResult();
if (def == null) {
return found(false);
}
String bpmnXml = readProcessModel(req.procDefId);
if (bpmnXml == null || bpmnXml.isBlank()) {
return found(false);
}
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(bpmnXml);
Map<String, Object> meta = new LinkedHashMap<>();
meta.put("eip4IdMap", r.idMap());
meta.put("sourceProcDefId", req.procDefId);
meta.put("originalKey", def.getKey());
String metaInfoJson;
try {
metaInfoJson = objectMapper.writeValueAsString(meta);
} catch (Exception e) {
// 纯 Map<String,String/Object> 序列化理论上不会失败;防御性 500
log.error("[流程草稿] metaInfo 序列化失败 procDefId={}", req.procDefId, e);
return status(HttpStatus.INTERNAL_SERVER_ERROR, "metaInfo 序列化失败");
}
Model model = repositoryService.newModel();
model.setName(def.getName());
model.setKey(def.getKey());
model.setCategory(EIP4_CATEGORY);
model.setMetaInfo(metaInfoJson);
repositoryService.saveModel(model);
repositoryService.addModelEditorSource(model.getId(), r.xml().getBytes(StandardCharsets.UTF_8));
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("modelId", model.getId());
return ResponseEntity.ok(resp);
}
@PostMapping("/models/{id}/deploy")
@Operation(summary = "发布草稿为流程定义",
description = "草稿不存在→404;还原 eip4IdMap 里的中文原 key(存量流程 D7 硬需求,新建流程无 idMap 跳过)+"
+ "剥除 bpmn-js 补的 incoming/outgoing 文本引用 → 引擎 ProcessValidator 语义校验(仅 ERROR 级阻断,"
+ "返 422 {errors:[{activityId,problem,defaultDescription}]} 不部署;WARNING 放行)→ "
+ "createDeployment().disableSchemaValidation()(只跳 XSD:bpmn-js 默认命名空间与严格 XSD 已知不兼容,"
+ "语义校验已在上一步)部署 → {status:0,deploymentId,processKey,newVersion}。")
public ResponseEntity<Map<String, Object>> deploy(@PathVariable String id) {
Model model = repositoryService.getModel(id);
if (model == null) {
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
}
byte[] source = repositoryService.getModelEditorSource(id);
if (source == null) {
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿源为空,无法发布: " + id);
}
String deployXml;
BpmnModel bpmnModel;
try {
// resolveIdMap 在 try 内:存量草稿 metaInfo 不可读/丢 eip4IdMap 时 fail-fast(评审 I1),不静默跳过还原。
Map<String, String> idMap = resolveIdMap(model.getMetaInfo());
deployXml = prepareDeployXml(new String(source, StandardCharsets.UTF_8), idMap);
// XXE 兜底:还原后 XML 再过字节级 DOCTYPE 守卫(与 parseGuard 同源防御);enableSafeBpmnXml 亦禁 DOCTYPE,双保险。
if (hasDoctypeInBytes(deployXml.getBytes(StandardCharsets.UTF_8))) {
log.warn("[流程发布] 拒绝: 还原后 XML 含 DOCTYPE 声明(XXE 防御) id={}", id);
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
}
// validateSchema=false:bpmn-js 默认命名空间输出与严格 XSD 已知不兼容,语义交给下方 ProcessValidator;
// enableSafeBpmnXml=true:加固解析器关外部实体/DTD。
bpmnModel = new BpmnXMLConverter().convertToBpmnModel(new StringStreamSource(deployXml), false, true);
} catch (IllegalStateException e) {
// resolveIdMap 的 fail-fast:存量草稿 metaInfo 不可读/丢 eip4IdMap,还原不出中文原 key→拒发,防落库 nXXX 坏 key(D7)。
log.warn("[流程发布] id 映射不可用 id={}: {}", id, e.toString());
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿 id 映射不可用,无法还原原 key");
} catch (IllegalArgumentException e) {
// BpmnIdSanitizer.restore 的 fail-fast:idMap 非双射(metaInfo 损坏)——须炸不能静默还原成别的 key。
log.warn("[流程发布] id 还原失败(idMap 损坏) id={}: {}", id, e.toString());
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿 id 映射损坏,无法还原原 key");
} catch (Exception e) {
log.warn("[流程发布] BPMN 解析失败 id={}: {}", id, e.toString());
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
}
// 引擎校验门:区分 ERROR/WARNING,只 ERROR 级阻断部署。此处仅引擎「结构」校验(节点连通/网关/多实例等);
// EIP4 「语义」校验(formKey 存在于 view_wftemplate、办理人/会签内嵌 JSON 白名单)在网关 ModelSemanticValidator(T3.2)。
List<Map<String, Object>> blocking = new ArrayList<>();
for (ValidationError ve : processValidator.validate(bpmnModel)) {
if (ve.isWarning()) {
log.info("[流程发布] 校验告警(放行) id={} activityId={} problem={} desc={}",
id, ve.getActivityId(), ve.getProblem(), ve.getDefaultDescription());
continue;
}
Map<String, Object> err = new LinkedHashMap<>();
err.put("activityId", ve.getActivityId());
err.put("problem", ve.getProblem());
err.put("defaultDescription", ve.getDefaultDescription());
blocking.add(err);
}
if (!blocking.isEmpty()) {
log.warn("[流程发布] ProcessValidator 拒绝 id={} errorCount={}", id, blocking.size());
Map<String, Object> body = new LinkedHashMap<>();
body.put("status", 1);
body.put("msg", "流程校验未通过");
body.put("errors", blocking);
return ResponseEntity.status(HttpStatus.UNPROCESSABLE_ENTITY).body(body);
}
// 部署资源名用中文原 key(仅 act_ge_bytearray 名,不决定 process key——后者取自 XML 的 <process id>)。
String resource = model.getKey() + ".bpmn20.xml";
var deployment = repositoryService.createDeployment()
.disableSchemaValidation()
.name(model.getName())
.addString(resource, deployXml)
.deploy();
var deployed = repositoryService.createProcessDefinitionQuery()
.deploymentId(deployment.getId()).singleResult();
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("status", 0);
resp.put("deploymentId", deployment.getId());
resp.put("processKey", deployed != null ? deployed.getKey() : model.getKey());
resp.put("newVersion", deployed != null ? deployed.getVersion() : 0);
return ResponseEntity.ok(resp);
}
@GetMapping("/models/{id}/impact")
@Operation(summary = "发布影响摘要",
description = "草稿不存在→404;还原后解析 processKey → {processKey,currentVersion(该 key 最新已部署版本,"
+ "无则 0),runningInstances(该 key 运行中实例数)}。供同人确认弹窗展示「新版本/旧版本实例不受影响」。")
public ResponseEntity<Map<String, Object>> impact(@PathVariable String id) {
Model model = repositoryService.getModel(id);
if (model == null) {
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
}
byte[] source = repositoryService.getModelEditorSource(id);
if (source == null) {
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿源为空: " + id);
}
String processKey;
try {
// impact 是只读预览:resolveIdMap 抛(存量草稿 metaInfo 不可读)/半成品草稿解析失败,一律回退 model.key
// ——from-procdef 建草稿的 model.key 就是中文原 key(创建时 setKey(def.getKey())),回退即得正确 processKey,
// 不该因草稿未完成/元数据损坏而 500;真正阻断坏 key 部署由 deploy 端点 fail-fast 负责。
// 无独立 DOCTYPE 字节守卫:impact 只查计数不部署,且 convertToBpmnModel 的 enableSafeBpmnXml=true 已禁 DOCTYPE/外部实体。
Map<String, String> idMap = resolveIdMap(model.getMetaInfo());
String deployXml = prepareDeployXml(new String(source, StandardCharsets.UTF_8), idMap);
BpmnModel bpmnModel = new BpmnXMLConverter()
.convertToBpmnModel(new StringStreamSource(deployXml), false, true);
var mainProcess = bpmnModel.getMainProcess();
processKey = mainProcess != null ? mainProcess.getId() : model.getKey();
} catch (Exception e) {
log.warn("[流程发布] 影响摘要解析失败,回退 model.key id={}: {}", id, e.toString());
processKey = model.getKey();
}
var latest = repositoryService.createProcessDefinitionQuery()
.processDefinitionKey(processKey).latestVersion().singleResult();
long runningInstances = runtimeService.createProcessInstanceQuery()
.processDefinitionKey(processKey).count();
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("processKey", processKey);
resp.put("currentVersion", latest != null ? latest.getVersion() : 0);
resp.put("runningInstances", runningInstances);
return ResponseEntity.ok(resp);
}
/**
* 发布/影响摘要前的 XML 规范化:①{@link #FLOW_REF_ELEMENT} 剥除 bpmn-js 补的 incoming/outgoing 文本引用元素;
* ②{@link BpmnIdSanitizer#restore} 依 {@code idMap} 把净化 id 还原为中文原 key(idMap 空=新建流程,原样返回)。
* restore 在剥除后跑:文本引用已消除,还原只作用于属性位,最终部署 XML 无残留净化 id。
* idMap 非双射时 restore fail-fast 抛 {@link IllegalArgumentException},由调用方转 422。
*/
private static String prepareDeployXml(String xml, Map<String, String> idMap) {
String stripped = FLOW_REF_ELEMENT.matcher(xml).replaceAll("");
return BpmnIdSanitizer.restore(stripped, idMap);
}
/** from-procdef 建草稿写入 metaInfo 的存量标记键(其一存在即表明本草稿源自既有流程定义,editorSource 是净化 XML)。 */
private static final String[] FROM_PROCDEF_MARKERS = {"sourceProcDefId", "originalKey"};
/**
* 从 metaInfo JSON 取 {@code eip4IdMap}(原→净化),供 {@link BpmnIdSanitizer#restore} 还原中文原 key。
*
* <p><b>坏 key 地雷收口(评审 I1)</b>:绝不把「idMap 不可读」静默塌成「空 idMap→跳过还原」——那会让 from-procdef
* 存量草稿(editorSource 的 {@code <process id>} 是净化 {@code nXXX})在 metaInfo 损坏时静默部署出 key=nXXX 而非
* 中文原 key(HTTP 200 无声,违 D7;且与 restore 非双射 fail-fast 自相矛盾)。据 from-procdef 写的
* {@link #FROM_PROCDEF_MARKERS} 判存量草稿:</p>
* <ul>
* <li>metaInfo 空/null → 真·新建,空 Map(跳过还原,key 原样)。</li>
* <li>metaInfo 非空但 JSON 解析失败 → 损坏,{@link IllegalStateException} fail-fast(调用方转 422)。</li>
* <li>解析成功、{@code eip4IdMap} <b>存在</b>(是 Map,含空 {@code {}})→ 直接用(空=全 ASCII 存量流程无需还原,正常)。</li>
* <li>解析成功、{@code eip4IdMap} <b>缺失/非 Map</b> 且带 from-procdef 标记 → 存量草稿丢了映射,无法还原原 key,
* {@link IllegalStateException} fail-fast(宁拒不发坏 key)。</li>
* <li>解析成功、无 {@code eip4IdMap} 且无标记 → 真·新建(前端另存了别的 metaInfo),空 Map 正常放行。</li>
* </ul>
*/
private Map<String, String> resolveIdMap(String metaInfo) {
if (metaInfo == null || metaInfo.isBlank()) {
return Map.of();
}
Map<String, Object> meta;
try {
meta = objectMapper.readValue(metaInfo, new TypeReference<Map<String, Object>>() {});
} catch (Exception e) {
// 非空 metaInfo 却解析不了=损坏,不能猜它是不是存量草稿→一律 fail-fast(宁拒不发可能的坏 key)。
throw new IllegalStateException("metaInfo 无法解析,无法确认 id 映射: " + e, e);
}
Object raw = meta.get("eip4IdMap");
if (raw instanceof Map<?, ?> m) {
// eip4IdMap 存在(即使空):空=全 ASCII 存量流程无需还原,直接用。
Map<String, String> idMap = new LinkedHashMap<>();
for (Map.Entry<?, ?> e : m.entrySet()) {
idMap.put(String.valueOf(e.getKey()), String.valueOf(e.getValue()));
}
return idMap;
}
// eip4IdMap 缺失/非 Map:带 from-procdef 标记=存量草稿丢了映射(editorSource 是净化 XML)→fail-fast 防坏 key。
for (String marker : FROM_PROCDEF_MARKERS) {
if (meta.containsKey(marker)) {
throw new IllegalStateException(
"存量草稿 metaInfo 缺 eip4IdMap,无法还原净化 id 为中文原 key(marker=" + marker + ")");
}
}
return Map.of(); // 无标记=真·新建,key 原样部署。
}
/**
* BPMN 解析守卫:过则返回 {@code null}(放行),坏 XML 返回 422 ResponseEntity({status:1,msg})。
* 就地 catch 一切异常,不让引擎 XMLException/FlowableException 逸出到全局 advice(那里映射成 400,语义不符)。
*
* <p><b>两道关</b>:①解析前字节级 {@link #hasDoctypeInBytes} 拒 DOCTYPE 声明(XXE 兜底,不依赖 flowable
* 内部 {@code supportDTD=false} 实现);②{@code convertToBpmnModel(source, validateSchema, enableSafeBpmnXml)}
* 解析——{@code validateSchema=false}:草稿是可视化工具编辑的半成品,<b>不做</b>严格 BPMN 2.0 XSD 校验。
* bpmn-js {@code saveXML} 用默认命名空间(无前缀 definitions/process)重序列化,Flowable 严格 Xerces XSD 校验
* 会拒({@code cvc-complex-type.2.4.a})——这是 bpmn-js(面向 BPMN 模型,非字节级 XSD 合规)与严格 XSD 的
* <b>已知固有不兼容</b>;完整校验属部署门(T3.1 {@code ProcessValidator} 在解析后的模型上跑,非 XSD)。
* {@code validateSchema=false} 仍解析(非良构 XML 抛→422);{@code enableSafeBpmnXml=true} 保加固解析器
* (禁外部 DTD/参数实体/DOCTYPE),双保险关 XXE/SSRF。</p>
*
* <p>422 只回通用文案;原始解析原因(可能含内部路径/实体细节)仅进 {@code log.warn},不回显给调用方。</p>
*/
private ResponseEntity<Map<String, Object>> parseGuard(String xml) {
// ① XXE 兜底:解析前字节级拒 DOCTYPE。按 StringStreamSource 喂解析器的 UTF-8 字节视角扫描(含 BOM/UTF-16
// 识别),消除「扫描端 vs 解析端编码错位」绕过。null XML 同走 422(与解析必抛等价)。
if (xml == null || hasDoctypeInBytes(xml.getBytes(StandardCharsets.UTF_8))) {
log.warn("[流程草稿] BPMN 拒绝: {}", xml == null ? "空 XML" : "含 DOCTYPE 声明(XXE 防御)");
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
}
try {
// ② validateSchema=false(不做严格 XSD)+ enableSafeBpmnXml=true(加固解析器);详见方法 javadoc。
new BpmnXMLConverter().convertToBpmnModel(new StringStreamSource(xml), false, true);
return null;
} catch (Exception e) {
log.warn("[流程草稿] BPMN 解析守卫拒绝: {}", e.toString());
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
}
}
/**
* 字节级 DOCTYPE 检测(XXE 门):按 BOM / 无 BOM 的 UTF-16 空字节特征识别编码后解码 prolog,再走
* {@link #hasDoctype}。消除「扫描端与解析端编码视角不一致」的绕过(UTF-8 BOM / UTF-16 会让纯字节扫描漏判
* {@code <!DOCTYPE},而 xerces 仍按 BOM 正确解析触发 XXE)。移植 platform-report {@code ReportXmlGuard}
* (flowable-service 不依赖 platform-* 模块,故就地复刻,不引依赖)。
*/
static boolean hasDoctypeInBytes(byte[] raw) {
if (raw == null || raw.length == 0) {
return false;
}
java.nio.charset.Charset cs;
int off = 0;
int u0 = raw[0] & 0xFF;
int u1 = raw.length > 1 ? raw[1] & 0xFF : -1;
int u2 = raw.length > 2 ? raw[2] & 0xFF : -1;
if (u0 == 0xEF && u1 == 0xBB && u2 == 0xBF) {
cs = StandardCharsets.UTF_8;
off = 3; // UTF-8 BOM
} else if (u0 == 0xFF && u1 == 0xFE) {
cs = StandardCharsets.UTF_16LE;
off = 2; // UTF-16LE BOM
} else if (u0 == 0xFE && u1 == 0xFF) {
cs = StandardCharsets.UTF_16BE;
off = 2; // UTF-16BE BOM
} else if (u0 == '<' && u1 == 0x00) {
cs = StandardCharsets.UTF_16LE; // 无 BOM UTF-16LE(ASCII 起始字符夹空字节)
} else if (u0 == 0x00 && u1 == '<') {
cs = StandardCharsets.UTF_16BE; // 无 BOM UTF-16BE
} else {
cs = StandardCharsets.ISO_8859_1; // UTF-8 / Latin1:prolog 为 ASCII,字节级保真扫描
}
int scanLen = Math.min(raw.length - off, PROLOG_SCAN_BYTES);
return hasDoctype(new String(raw, off, scanLen, cs));
}
/**
* 文档 prolog(根元素之前)是否含 DOCTYPE 声明(大小写不敏感)。正确跳过 XML 声明 {@code <?xml?>} 与注释
* {@code <!-- -->},命中根元素起始标签即停(元素内容里的字面 {@code <!DOCTYPE} 文本不算)。
*/
static boolean hasDoctype(String xml) {
if (xml == null) {
return false;
}
int i = 0;
int n = xml.length();
while (i < n) {
char c = xml.charAt(i);
if (c == ' ' || c == '\t' || c == '\n' || c == '\r' || c == '') {
i++;
continue;
}
if (c != '<') {
return false; // prolog 里非标记的文本 → 视为无 DOCTYPE
}
if (xml.regionMatches(true, i, "<!DOCTYPE", 0, 9)) {
return true;
}
if (xml.startsWith("<!--", i)) { // 注释:整段跳过
int end = xml.indexOf("-->", i + 4);
if (end < 0) {
return false;
}
i = end + 3;
continue;
}
if (xml.startsWith("<?", i)) { // XML 声明 / 处理指令:整段跳过
int end = xml.indexOf("?>", i + 2);
if (end < 0) {
return false;
}
i = end + 2;
continue;
}
return false; // 到达根元素起始标签,prolog 结束,无 DOCTYPE
}
return false;
}
/** 读流程定义部署 BPMN XML(getProcessModel 返回资源流)。读失败/为空返回 null(前端降级)。 */
private String readProcessModel(String procDefId) {
try (InputStream is = repositoryService.getProcessModel(procDefId)) {
if (is == null) {
return null;
}
return StreamUtils.copyToString(is, StandardCharsets.UTF_8);
} catch (Exception e) {
log.warn("[流程草稿] 读取 BPMN 失败 procDefId={}: {}", procDefId, e.toString());
return null;
}
}
private static ResponseEntity<Map<String, Object>> found(boolean value) {
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("found", value);
return ResponseEntity.ok(resp);
}
private static ResponseEntity<Map<String, Object>> status(HttpStatus httpStatus, String msg) {
Map<String, Object> body = new LinkedHashMap<>();
body.put("status", 1);
body.put("msg", msg);
return ResponseEntity.status(httpStatus).body(body);
}
/** {@link Date} → ISO-8601 UTC 字符串(如 {@code 1970-01-01T00:00:00Z});null 原样透传。 */
private static String toIso(Date d) {
return d == null ? null : d.toInstant().toString();
}
/** null 或纯空白(含全角/半角空格)视为空白。 */
private static boolean isBlank(String s) {
return s == null || s.isBlank();
}
/** 建草稿入参。 */
public static class CreateModelRequest {
public String name;
public String key;
public String bpmnXml;
public String metaInfo;
}
/** 更新草稿入参(editorSource 走 bpmnXml;name/metaInfo 为 null 表示不改)。 */
public static class UpdateModelRequest {
public String name;
public String bpmnXml;
public String metaInfo;
}
/** 从流程定义建草稿入参。 */
public static class FromProcDefRequest {
public String procDefId;
}
}

View File

@@ -39,8 +39,10 @@ public final class Requests {
public static class ActionRequest { public static class ActionRequest {
/** 审批意见(记入流程评论)。 */ /** 审批意见(记入流程评论)。 */
public String comment; public String comment;
/** 目标用户(转办/协办/转阅用;reject/reback 不需要)。 */ /** 目标用户(转办用;reject/reback 不需要)。 */
public String targetUserId; public String targetUserId;
/** 多目标用户(协办/转阅:老系统用 MultiSelectField 选多人,每人各建一条子/转阅任务)。 */
public java.util.List<String> targetUserIds;
} }
/** /**

View File

@@ -16,15 +16,15 @@ flowable:
datasource: datasource:
# Hikari 原生属性名 jdbc-url(@ConfigurationProperties 绑到已 build 的 HikariDataSource, # Hikari 原生属性名 jdbc-url(@ConfigurationProperties 绑到已 build 的 HikariDataSource,
# 须用 jdbc-url 而非 url,否则报 "jdbcUrl is required with driverClassName") # 须用 jdbc-url 而非 url,否则报 "jdbcUrl is required with driverClassName")
jdbc-url: ${FLOWABLE_JDBC_URL:jdbc:postgresql://localhost:5433/eip4flow?currentSchema=eip3} jdbc-url: ${FLOWABLE_JDBC_URL:jdbc:postgresql://localhost:5433/eip4?currentSchema=eip3}
username: ${FLOWABLE_JDBC_USER:zhengwr} username: ${FLOWABLE_JDBC_USER:zhengwr}
password: ${FLOWABLE_JDBC_PASS:} password: ${FLOWABLE_JDBC_PASS:}
driver-class-name: org.postgresql.Driver driver-class-name: org.postgresql.Driver
biz: biz:
datasource: datasource:
# F2-13: 本地验证用本地 eip4dev(5435 不可达,人名解析正降级) # F2-13: 本地验证用合并库 eip4(业务+流程同库;原 eip4dev 已并入)。5435 不可达,人名解析正降级。
jdbc-url: ${BIZ_JDBC_URL:jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3} jdbc-url: ${BIZ_JDBC_URL:jdbc:postgresql://localhost:5433/eip4?currentSchema=eip3}
username: ${BIZ_JDBC_USER:zhengwr} username: ${BIZ_JDBC_USER:zhengwr}
password: ${BIZ_JDBC_PASS:} password: ${BIZ_JDBC_PASS:}
driver-class-name: org.postgresql.Driver driver-class-name: org.postgresql.Driver

View File

@@ -0,0 +1,64 @@
package com.dsasp.server.wf.user.assignee;
import static org.assertj.core.api.Assertions.assertThat;
import java.util.Arrays;
import java.util.List;
import org.junit.jupiter.api.Test;
/**
* scriptUser 会签办理人解析的纯函数单测(同包以访问包级 helper):
* 单变量名提取 + 求值结果归一为 userId 列表。修复前 scriptUser 分支 WARN 降级返空,
* 致招投标/总包合同/施工技术交底等会签节点(集合用 ${APPLYUSERS})无办理人被跳过。
*/
class CandidateUsersScriptUserTest {
@Test
void singleVarName_提取简单变量() {
assertThat(CandidateUsersHandler.singleVarName("${APPLYUSERS}")).isEqualTo("APPLYUSERS");
assertThat(CandidateUsersHandler.singleVarName(" ${ APPLYUSERS } ")).isEqualTo("APPLYUSERS");
}
@Test
void singleVarName_复杂表达式返回null() {
assertThat(CandidateUsersHandler.singleVarName("${a + b}")).isNull();
assertThat(CandidateUsersHandler.singleVarName("${users[0]}")).isNull();
assertThat(CandidateUsersHandler.singleVarName("ADMIN")).isNull();
assertThat(CandidateUsersHandler.singleVarName(null)).isNull();
}
@Test
void coerceUserList_支持List() {
assertThat(CandidateUsersHandler.coerceUserList(List.of("u1", "u2")))
.containsExactly("u1", "u2");
}
@Test
void coerceUserList_支持数组() {
assertThat(CandidateUsersHandler.coerceUserList(new String[] { "u1", "u2" }))
.containsExactly("u1", "u2");
}
@Test
void coerceUserList_逗号分号全角半角分隔串() {
assertThat(CandidateUsersHandler.coerceUserList("u1,u2; u3,u4;u5"))
.containsExactly("u1", "u2", "u3", "u4", "u5");
}
@Test
void coerceUserList_单值() {
assertThat(CandidateUsersHandler.coerceUserList("ADMIN")).containsExactly("ADMIN");
}
@Test
void coerceUserList_去重去空白() {
assertThat(CandidateUsersHandler.coerceUserList(Arrays.asList(" u1 ", "u1", "", "u2", null)))
.containsExactly("u1", "u2");
}
@Test
void coerceUserList_null返回空() {
assertThat(CandidateUsersHandler.coerceUserList(null)).isEmpty();
}
}

View File

@@ -0,0 +1,223 @@
package com.eip4.flowservice.api;
import static org.assertj.core.api.Assertions.assertThat;
import java.util.LinkedHashMap;
import java.util.Map;
import org.junit.jupiter.api.Test;
/**
* BpmnIdSanitizer 可逆双射单测:净化(中文 id→安全 ASCII)与还原(restore)严格互逆,
* 覆盖 hash 碰撞消解、restore 前缀安全、合法 id 不动、混合场景。
*
* <p>非碰撞净化输出须与 ProcessDiagramController 旧实现逐字节一致(由既有 ProcessDiagramControllerTest 兜底),
* 本类聚焦「可逆」这一新增契约。</p>
*/
class BpmnIdSanitizerTest {
/** 中文 process id + processRef/sourceRef/targetRef/default/attachedToRef 全引用面净化→restore 须逐字节还原。 */
@Test
void 净化后还原_逐字节等于原文() {
String xml = """
<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL">
<process id="总包合同交底" name="总包合同交底">
<startEvent id="start"/>
<userTask id="审批" name="审批人"/>
<boundaryEvent id="超时" attachedToRef="审批"/>
<exclusiveGateway id="gw" default="回退"/>
<sequenceFlow id="回退" sourceRef="gw" targetRef="审批"/>
<sequenceFlow id="通过" sourceRef="审批" targetRef="end"/>
<endEvent id="end"/>
</process>
<collaboration id="collab">
<participant id="part" processRef="总包合同交底"/>
</collaboration>
<bpmndi:BPMNDiagram id="di" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI">
<bpmndi:BPMNPlane bpmnElement="总包合同交底"/>
</bpmndi:BPMNDiagram>
</definitions>""";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
// 中文 id 不再出现在 id/引用类属性中;name 展示属性照旧保留中文
assertThat(r.xml()).doesNotContain("id=\"总包合同交底\"");
assertThat(r.xml()).doesNotContain("processRef=\"总包合同交底\"");
assertThat(r.xml()).doesNotContain("attachedToRef=\"审批\"");
assertThat(r.xml()).contains("name=\"总包合同交底\"");
assertThat(r.xml()).contains("name=\"审批人\"");
// idMap 覆盖全部 5 个中文 id(合法 ASCII id 不入 map)
assertThat(r.idMap()).containsOnlyKeys("总包合同交底", "审批", "超时", "回退", "通过");
// restore 逐字节还原
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/**
* hash 碰撞消解:Java String.hashCode 下 "中Aa" 与 "中BB" 撞哈希('A'*31+'a' == 'B'*31+'B' == 2112),
* 二者又都是非法 NCName(含中文)→ 旧实现会撞成同一净化 id(非双射)。sanitize 须给两者不同净化 id,restore 仍完整还原。
*/
@Test
void 撞哈希两中文id_净化后仍双射可逆() {
// 前置自证:确实撞哈希
assertThat("中Aa".hashCode()).isEqualTo("中BB".hashCode());
String xml = """
<definitions>
<process id="p">
<userTask id="中Aa"/>
<userTask id="中BB"/>
<sequenceFlow id="f1" sourceRef="中Aa" targetRef="中BB"/>
</process>
</definitions>""";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
String s1 = r.idMap().get("中Aa");
String s2 = r.idMap().get("中BB");
// 双射:两净化 id 互不相同(否则 sourceRef/targetRef 引用会串)
assertThat(s1).isNotNull();
assertThat(s2).isNotNull();
assertThat(s1).isNotEqualTo(s2);
// 碰撞消解序号:其一为基名,另一为基名 +"-2"
assertThat(s1 + "|" + s2).containsPattern("-2");
// 净化后中文 id 消失
assertThat(r.xml()).doesNotContain("中Aa");
assertThat(r.xml()).doesNotContain("中BB");
// restore 逐字节还原(引用不串)
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/**
* restore 前缀安全:idMap 同时含净化 id "n1" 与 "n1x"(后者以前者为前缀)。
* 裸 String.replace("n1",..) 会把 "n1x" 误伤成 "<orig1>x";必须锚定完整属性值精确匹配。
*/
@Test
void restore前缀安全_n1不误伤n1x() {
Map<String, String> idMap = new LinkedHashMap<>();
idMap.put("原A", "n1");
idMap.put("原B", "n1x");
String xml = "<userTask id=\"n1x\"/><sequenceFlow id=\"f\" sourceRef=\"n1\" targetRef=\"n1x\"/>";
String out = BpmnIdSanitizer.restore(xml, idMap);
assertThat(out).isEqualTo("<userTask id=\"原B\"/><sequenceFlow id=\"f\" sourceRef=\"原A\" targetRef=\"原B\"/>");
assertThat(out).doesNotContain("原Ax"); // 无前缀误伤
assertThat(out).doesNotContain("n1x");
assertThat(out).doesNotContain("n1\"");
}
/** 全合法 NCName id:不改写,idMap 为空,restore 无副作用。 */
@Test
void 合法NCName_id不改写_映射为空() {
String xml = "<process id=\"p\"><userTask id=\"sid-A\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"p\" targetRef=\"sid-A\" default=\"f1\"/></process>";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
assertThat(r.idMap()).isEmpty();
assertThat(r.xml()).isEqualTo(xml);
// 空 idMap 的 restore 原样返回
assertThat(BpmnIdSanitizer.restore(xml, r.idMap())).isEqualTo(xml);
}
/** 混合:部分中文部分合法,只映射中文者;合法 id 原样保留;restore 还原。 */
@Test
void 混合_只映射中文id_合法id原样保留() {
String xml = "<process id=\"审批流程\"><userTask id=\"legalTask\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"审批流程\" targetRef=\"legalTask\"/></process>";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
assertThat(r.idMap()).containsOnlyKeys("审批流程");
assertThat(r.xml()).contains("id=\"legalTask\"");
assertThat(r.xml()).contains("targetRef=\"legalTask\"");
assertThat(r.xml()).doesNotContain("审批流程");
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/** restore 只回写映射内 id;净化后新增的 ASCII 节点 id(不在 idMap)原样保留。 */
@Test
void restore只回写映射内id_新增ascii_id保留() {
Map<String, String> idMap = new LinkedHashMap<>();
idMap.put("审批", "n5");
// n9 是设计器新增节点,不在 idMap → restore 不得改动
String xml = "<userTask id=\"n5\"/><userTask id=\"n9\"/>"
+ "<sequenceFlow id=\"f\" sourceRef=\"n5\" targetRef=\"n9\"/>";
String out = BpmnIdSanitizer.restore(xml, idMap);
assertThat(out).isEqualTo("<userTask id=\"审批\"/><userTask id=\"n9\"/>"
+ "<sequenceFlow id=\"f\" sourceRef=\"审批\" targetRef=\"n9\"/>");
}
/** null/空 XML 防御:不抛,idMap 为空。 */
@Test
void 空xml不抛_映射为空() {
assertThat(BpmnIdSanitizer.sanitize(null).idMap()).isEmpty();
assertThat(BpmnIdSanitizer.sanitize("").idMap()).isEmpty();
assertThat(BpmnIdSanitizer.restore(null, Map.of())).isNull();
assertThat(BpmnIdSanitizer.restore("<a/>", Map.of())).isEqualTo("<a/>");
}
/**
* 生成的净化 id 不与文档内既有合法字面 id 冲突(used 占位契约)。
* "审批".hashCode()&0x7fffffff 的 hex 恰为 b7af8 → 基名 "nb7af8" 与合法字面 id "nb7af8" 撞
* → sanitize 须让 审批 映射为 nb7af8-2(否则 restore 会误改那个合法 id),restore 逐字节还原。
*/
@Test
void 净化id不与既有合法id冲突_让位加序号() {
assertThat(Integer.toHexString("审批".hashCode() & 0x7fffffff)).isEqualTo("b7af8"); // 前置自证
String xml = """
<process id="p">
<userTask id="nb7af8"/>
<userTask id="审批"/>
<sequenceFlow id="f" sourceRef="nb7af8" targetRef="审批"/>
</process>""";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
// 中文 id 让位到 -2;既有合法字面 id nb7af8 原样不动、不入 map
assertThat(r.idMap()).containsOnlyKeys("审批");
assertThat(r.idMap().get("审批")).isEqualTo("nb7af8-2");
assertThat(r.xml()).contains("id=\"nb7af8\"");
assertThat(r.xml()).contains("sourceRef=\"nb7af8\"");
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/**
* M-1 逐字节契约:未改值的合法属性(含等号周围空白)须原样回写,不被重构归一。
* 即便 map 非空(另有中文 id 被改),带空白的合法属性 round-trip 后原文不变。
*/
@Test
void 未改值属性含等号空白_原样保留不归一() {
// legalTask 用 `id = "..."`(等号带空格)合法写法;审批 是被净化的中文 id → map 非空
String xml = "<userTask id = \"legalTask\"/>"
+ "<userTask id=\"审批\"/>"
+ "<sequenceFlow id=\"f\" sourceRef=\"legalTask\" targetRef=\"审批\"/>";
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
// 审批被改;legalTask 的等号空白写法逐字保留(旧实现会归一成 id="legalTask")
assertThat(r.idMap()).containsOnlyKeys("审批");
assertThat(r.xml()).contains("id = \"legalTask\"");
// round-trip 后原文逐字节不变
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
}
/** M-2 fail-fast:idMap 值(净化 id)重复=非双射(损坏 metaInfo),restore 抛而非静默还原错。 */
@Test
void restore_idMap值重复_抛非双射异常() {
Map<String, String> broken = new LinkedHashMap<>();
broken.put("原A", "n1");
broken.put("原B", "n1"); // 两个原 id 映到同一净化 id → 反转会静默覆盖
String xml = "<userTask id=\"n1\"/>";
org.assertj.core.api.Assertions.assertThatThrownBy(() -> BpmnIdSanitizer.restore(xml, broken))
.isInstanceOf(IllegalArgumentException.class)
.hasMessageContaining("非双射")
.hasMessageContaining("n1");
}
}

View File

@@ -330,4 +330,163 @@ class FlowControllerTest {
.andExpect(status().isOk()) .andExpect(status().isOk())
.andExpect(org.springframework.test.web.servlet.result.MockMvcResultMatchers.content().string("1509")); .andExpect(org.springframework.test.web.servlet.result.MockMvcResultMatchers.content().string("1509"));
} }
// ---------------------------------------------------------------- 协办(assist) / 转阅(circulate)
@Test
void 协办缺少目标用户返回400() throws Exception {
mvc.perform(post("/api/flow/tasks/task-9/assist")
.contentType("application/json")
.content("{\"comment\":\"请协助\"}"))
.andExpect(status().isBadRequest());
}
@Test
void 协办为每个目标用户建子任务并记意见() throws Exception {
// 父任务查得(取 processInstanceId 记意见)
when(taskService.createTaskQuery()).thenReturn(taskQuery);
when(taskQuery.taskId("task-9")).thenReturn(taskQuery);
Task parent = org.mockito.Mockito.mock(Task.class);
when(parent.getProcessInstanceId()).thenReturn("pi-9");
when(taskQuery.singleResult()).thenReturn(parent);
// 每次 newTask() 返回一个新子任务桩
Task sub = org.mockito.Mockito.mock(Task.class);
when(taskService.newTask()).thenReturn(sub);
mvc.perform(post("/api/flow/tasks/task-9/assist")
.contentType("application/json")
.content("{\"comment\":\"请协助\",\"targetUserIds\":[\"u-a\",\"u-b\"]}"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.assisted").value(true))
.andExpect(jsonPath("$.count").value(2));
// 两个子任务:各设受托人/父任务/名称「协办」后保存
verify(sub).setAssignee("u-a");
verify(sub).setAssignee("u-b");
verify(sub, org.mockito.Mockito.times(2)).setParentTaskId("task-9");
verify(sub, org.mockito.Mockito.times(2)).setName("协办");
verify(taskService, org.mockito.Mockito.times(2)).saveTask(sub);
verify(taskService).addComment("task-9", "pi-9", "请协助");
}
@Test
void 转阅为每个目标用户建转阅任务并存formKey() throws Exception {
when(taskService.createTaskQuery()).thenReturn(taskQuery);
when(taskQuery.taskId("task-10")).thenReturn(taskQuery);
Task parent = org.mockito.Mockito.mock(Task.class);
when(parent.getProcessInstanceId()).thenReturn("pi-10");
when(parent.getFormKey()).thenReturn("wf-tpl-77"); // FormKeyResolver: 原始非空直接返回
when(taskQuery.singleResult()).thenReturn(parent);
Task copy = org.mockito.Mockito.mock(Task.class);
when(taskService.newTask()).thenReturn(copy);
mvc.perform(post("/api/flow/tasks/task-10/circulate")
.contentType("application/json")
.content("{\"comment\":\"请阅\",\"targetUserIds\":[\"u-c\"]}"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.circulated").value(true))
.andExpect(jsonPath("$.count").value(1));
verify(copy).setName("转阅");
verify(copy).setAssignee("u-c");
verify(copy).setFormKey("wf-tpl-77"); // 用 setFormKey 而非 description,审批渲染 FormKeyResolver 直接命中
verify(copy).setParentTaskId("task-10");
verify(taskService).saveTask(copy);
}
@Test
void 转阅父任务不存在返回404() throws Exception {
when(taskService.createTaskQuery()).thenReturn(taskQuery);
when(taskQuery.taskId("nope")).thenReturn(taskQuery);
when(taskQuery.singleResult()).thenReturn(null);
mvc.perform(post("/api/flow/tasks/nope/circulate")
.contentType("application/json")
.content("{\"targetUserIds\":[\"u-c\"]}"))
.andExpect(status().isNotFound());
}
@Test
void 协办独立任务approvalContext回溯父任务取业务上下文() throws Exception {
// 协办/转阅建的是独立任务:无 processInstanceId,有 parentTaskId。审批上下文须回溯父任务取 businessKey/formKey,
// 否则协办人/转阅人打开看不到业务单据(code review HIGH 修复点)。
when(taskService.createTaskQuery()).thenReturn(taskQuery);
Task sub = org.mockito.Mockito.mock(Task.class);
when(sub.getName()).thenReturn("协办");
when(sub.getProcessInstanceId()).thenReturn(null);
when(sub.getParentTaskId()).thenReturn("parent-1");
when(sub.getFormKey()).thenReturn(null);
TaskQuery subQuery = org.mockito.Mockito.mock(TaskQuery.class);
when(taskQuery.taskId("sub-1")).thenReturn(subQuery);
when(subQuery.singleResult()).thenReturn(sub);
// 父任务:真实流程任务,带 processInstanceId/formKey
Task parent = org.mockito.Mockito.mock(Task.class);
when(parent.getProcessInstanceId()).thenReturn("pi-1");
when(parent.getFormKey()).thenReturn("wf-77");
when(parent.getProcessDefinitionId()).thenReturn("def-1");
when(parent.getTaskDefinitionKey()).thenReturn("node-a");
TaskQuery parentQuery = org.mockito.Mockito.mock(TaskQuery.class);
when(taskQuery.taskId("parent-1")).thenReturn(parentQuery);
when(parentQuery.singleResult()).thenReturn(parent);
// 父流程实例 businessKey
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("pi-1")).thenReturn(processInstanceQuery);
ProcessInstance pi = org.mockito.Mockito.mock(ProcessInstance.class);
when(pi.getBusinessKey()).thenReturn("BK-1");
when(processInstanceQuery.singleResult()).thenReturn(pi);
mvc.perform(get("/api/flow/tasks/sub-1/approval-context"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.formKey").value("wf-77"))
.andExpect(jsonPath("$.businessKey").value("BK-1"))
.andExpect(jsonPath("$.processInstanceId").value("pi-1"));
}
@Test
void 会签任务approvalContext回填会签进度() throws Exception {
// 会签(多实例)任务:approval-context 沿执行树向上找带 nrOfInstances 的多实例根执行,回填进度
when(taskService.createTaskQuery()).thenReturn(taskQuery);
when(taskQuery.taskId("mi-1")).thenReturn(taskQuery);
Task t = org.mockito.Mockito.mock(Task.class);
when(t.getProcessInstanceId()).thenReturn("pi-mi");
when(t.getExecutionId()).thenReturn("exec-leaf");
when(taskQuery.singleResult()).thenReturn(t);
// fillCosign:叶执行无 nrOfInstances → 向上到根执行命中
when(runtimeService.getVariablesLocal("exec-leaf")).thenReturn(java.util.Map.of());
when(runtimeService.getVariablesLocal("exec-root"))
.thenReturn(java.util.Map.of("nrOfInstances", 3, "nrOfCompletedInstances", 1));
var execQuery = org.mockito.Mockito.mock(org.flowable.engine.runtime.ExecutionQuery.class);
when(runtimeService.createExecutionQuery()).thenReturn(execQuery);
when(execQuery.executionId("exec-leaf")).thenReturn(execQuery);
org.flowable.engine.runtime.Execution leaf = org.mockito.Mockito.mock(org.flowable.engine.runtime.Execution.class);
when(leaf.getParentId()).thenReturn("exec-root");
when(execQuery.singleResult()).thenReturn(leaf);
// 业务实例查不到(聚焦会签字段),走 PI null 分支
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("pi-mi")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(null);
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.processInstanceId("pi-mi")).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.singleResult()).thenReturn(null);
mvc.perform(get("/api/flow/tasks/mi-1/approval-context"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.cosign").value(true))
.andExpect(jsonPath("$.cosignTotal").value(3))
.andExpect(jsonPath("$.cosignCompleted").value(1));
}
@Test
void 协办超过上限返回400() throws Exception {
StringBuilder ids = new StringBuilder("[");
for (int i = 0; i < 51; i++) {
ids.append(i == 0 ? "" : ",").append("\"u").append(i).append("\"");
}
ids.append("]");
mvc.perform(post("/api/flow/tasks/t/assist")
.contentType("application/json")
.content("{\"targetUserIds\":" + ids + "}"))
.andExpect(status().isBadRequest());
}
} }

View File

@@ -0,0 +1,257 @@
package com.eip4.flowservice.api;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.when;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import java.io.ByteArrayInputStream;
import java.nio.charset.StandardCharsets;
import java.util.List;
import org.flowable.engine.HistoryService;
import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService;
import org.flowable.engine.history.HistoricActivityInstance;
import org.flowable.engine.history.HistoricActivityInstanceQuery;
import org.flowable.engine.history.HistoricProcessInstance;
import org.flowable.engine.history.HistoricProcessInstanceQuery;
import org.flowable.engine.repository.ProcessDefinition;
import org.flowable.engine.repository.ProcessDefinitionQuery;
import org.flowable.engine.runtime.ProcessInstance;
import org.flowable.engine.runtime.ProcessInstanceQuery;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
/**
* 流程图端点薄层单测:mock 引擎,验证 BPMN XML 透出 + 当前/历史节点收敛 + 实例不存在降级。
*/
@ExtendWith(MockitoExtension.class)
class ProcessDiagramControllerTest {
@Mock RepositoryService repositoryService;
@Mock RuntimeService runtimeService;
@Mock HistoryService historyService;
@Mock ProcessInstanceQuery processInstanceQuery;
@Mock HistoricProcessInstanceQuery historicProcessInstanceQuery;
@Mock HistoricActivityInstanceQuery historicActivityInstanceQuery;
@Mock ProcessDefinitionQuery processDefinitionQuery;
MockMvc mvc;
@BeforeEach
void setUp() {
ProcessDiagramController controller = new ProcessDiagramController(repositoryService, runtimeService, historyService);
mvc = MockMvcBuilders.standaloneSetup(controller).build();
}
@Test
void 运行中流程返回XML与当前及历史节点() throws Exception {
ProcessInstance pi = org.mockito.Mockito.mock(ProcessInstance.class);
when(pi.getProcessDefinitionId()).thenReturn("def-1");
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("pi-1")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(pi);
when(runtimeService.getActiveActivityIds("pi-1")).thenReturn(List.of("task_b"));
String xml = "<?xml version=\"1.0\"?><definitions><process id=\"p\"/></definitions>";
when(repositoryService.getProcessModel("def-1"))
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
HistoricActivityInstance a1 = org.mockito.Mockito.mock(HistoricActivityInstance.class);
when(a1.getActivityId()).thenReturn("task_a");
when(historyService.createHistoricActivityInstanceQuery()).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.processInstanceId("pi-1")).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.finished()).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.list()).thenReturn(List.<HistoricActivityInstance>of(a1));
mvc.perform(get("/api/flow/process/pi-1/diagram"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.bpmnXml").value(xml))
.andExpect(jsonPath("$.activeActivityIds[0]").value("task_b"))
.andExpect(jsonPath("$.finishedActivityIds[0]").value("task_a"));
}
@Test
void 已结束流程走历史取XML无当前节点() throws Exception {
// 运行库查不到
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId("pi-2")).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(null);
// 历史库查得 procDefId
HistoricProcessInstance hpi = org.mockito.Mockito.mock(HistoricProcessInstance.class);
when(hpi.getProcessDefinitionId()).thenReturn("def-2");
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.processInstanceId("pi-2")).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.singleResult()).thenReturn(hpi);
String xml = "<definitions/>";
when(repositoryService.getProcessModel("def-2"))
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
when(historyService.createHistoricActivityInstanceQuery()).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.processInstanceId("pi-2")).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.finished()).thenReturn(historicActivityInstanceQuery);
when(historicActivityInstanceQuery.list()).thenReturn(List.<HistoricActivityInstance>of());
mvc.perform(get("/api/flow/process/pi-2/diagram"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.bpmnXml").value(xml))
.andExpect(jsonPath("$.activeActivityIds").isEmpty());
}
@Test
void 实例不存在返回found_false不报错() throws Exception {
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
when(processInstanceQuery.processInstanceId(eq("nope"))).thenReturn(processInstanceQuery);
when(processInstanceQuery.singleResult()).thenReturn(null);
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.processInstanceId("nope")).thenReturn(historicProcessInstanceQuery);
when(historicProcessInstanceQuery.singleResult()).thenReturn(null);
mvc.perform(get("/api/flow/process/nope/diagram"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
@Test
void sanitizeBpmnIds_中文id重写为安全ascii并同步引用与节点() {
// 迁移 BPMN 用中文 process id + 中文 diagram id,bpmn-js 拒非 ASCII NCName。重写后引用须一致,name 不动。
String xml = "<definitions>"
+ "<process id=\"招投标流程\" name=\"招投标流程\">"
+ "<userTask id=\"sid-A\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"招投标流程\" targetRef=\"sid-A\"/>"
+ "</process>"
+ "<bpmndi:BPMNDiagram id=\"BPMNDiagram_招投标流程\">"
+ "<bpmndi:BPMNPlane bpmnElement=\"招投标流程\"/>"
+ "</bpmndi:BPMNDiagram></definitions>";
List<String> active = new java.util.ArrayList<>(List.of("sid-A"));
List<String> finished = new java.util.ArrayList<>(List.of("招投标流程"));
String out = ProcessDiagramController.sanitizeBpmnIds(xml, active, finished);
// 中文 id 不再出现在 id/ref 属性里,但 name 保留中文
org.junit.jupiter.api.Assertions.assertFalse(out.contains("id=\"招投标流程\""));
org.junit.jupiter.api.Assertions.assertFalse(out.contains("bpmnElement=\"招投标流程\""));
org.junit.jupiter.api.Assertions.assertFalse(out.contains("sourceRef=\"招投标流程\""));
org.junit.jupiter.api.Assertions.assertTrue(out.contains("name=\"招投标流程\"")); // 展示名不动
org.junit.jupiter.api.Assertions.assertTrue(out.contains("id=\"sid-A\"")); // 合法 id 不动
// 同一中文 id 的所有引用映射到同一安全 id(process id 与 sourceRef/bpmnElement 一致)
java.util.regex.Matcher m = java.util.regex.Pattern.compile("<process id=\"(n[0-9a-f]+)\"").matcher(out);
org.junit.jupiter.api.Assertions.assertTrue(m.find());
String safe = m.group(1);
org.junit.jupiter.api.Assertions.assertTrue(out.contains("sourceRef=\"" + safe + "\""));
org.junit.jupiter.api.Assertions.assertTrue(out.contains("bpmnElement=\"" + safe + "\""));
// 历史节点 id 同步重映射,当前节点 sid-A 不变
org.junit.jupiter.api.Assertions.assertEquals(safe, finished.get(0));
org.junit.jupiter.api.Assertions.assertEquals("sid-A", active.get(0));
}
@Test
void source_按procDefId返净化XML与idMap及key版本() throws Exception {
// 存量流程 process id 为中文(如「总包合同交底」),moddle 载入前须净化;端点透出原→净化映射供发布时逆向。
ProcessDefinition def = org.mockito.Mockito.mock(ProcessDefinition.class);
when(def.getKey()).thenReturn("总包合同交底");
when(def.getVersion()).thenReturn(3);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("def-1")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(def);
String xml = "<definitions>"
+ "<process id=\"总包合同交底\" name=\"总包合同交底\">"
+ "<userTask id=\"sid-A\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"总包合同交底\" targetRef=\"sid-A\"/>"
+ "</process></definitions>";
when(repositoryService.getProcessModel("def-1"))
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
mvc.perform(get("/api/flow/process-definitions/def-1/source"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.procDefKey").value("总包合同交底"))
.andExpect(jsonPath("$.version").value(3))
// idMap 非空且含中文原 key;净化后 XML 的 id 属性不再含中文(name 展示位不受影响)
.andExpect(jsonPath("$.idMap").isNotEmpty())
.andExpect(jsonPath("$.idMap['总包合同交底']").isNotEmpty())
.andExpect(jsonPath("$.bpmnXml",
org.hamcrest.Matchers.not(org.hamcrest.Matchers.containsString("id=\"总包合同交底\""))))
// sequenceFlow 的 sourceRef 引用也须随 process id 一致重写,不白放(评审 M-1)
.andExpect(jsonPath("$.bpmnXml",
org.hamcrest.Matchers.not(org.hamcrest.Matchers.containsString("sourceRef=\"总包合同交底\""))));
}
@Test
void source_定义不存在返found_false() throws Exception {
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("nope")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(null);
mvc.perform(get("/api/flow/process-definitions/nope/source"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
@Test
void sourceByKey_按key命中返最新版净化XML与idMap及版本() throws Exception {
// process-select options 的 source='model' 项 id 是 act_re_model id(非 procDefId),by-id 永远 found:false;
// 打开器改用 option.key(真流程 key)走本端点。latestVersion() 在两版本(v1/v2)里取 v2。
ProcessDefinition v2 = org.mockito.Mockito.mock(ProcessDefinition.class);
when(v2.getId()).thenReturn("总包合同交底:2:aa22");
when(v2.getKey()).thenReturn("总包合同交底");
when(v2.getVersion()).thenReturn(2);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionKey("总包合同交底")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.latestVersion()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(v2);
String xml = "<definitions>"
+ "<process id=\"总包合同交底\" name=\"总包合同交底\">"
+ "<userTask id=\"sid-A\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"总包合同交底\" targetRef=\"sid-A\"/>"
+ "</process></definitions>";
when(repositoryService.getProcessModel("总包合同交底:2:aa22"))
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
mvc.perform(get("/api/flow/process-definitions/by-key/{key}/source", "总包合同交底"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.procDefId").value("总包合同交底:2:aa22"))
.andExpect(jsonPath("$.procDefKey").value("总包合同交底"))
.andExpect(jsonPath("$.version").value(2))
.andExpect(jsonPath("$.idMap['总包合同交底']").isNotEmpty())
.andExpect(jsonPath("$.bpmnXml",
org.hamcrest.Matchers.not(org.hamcrest.Matchers.containsString("id=\"总包合同交底\""))));
}
@Test
void sourceByKey_key不存在返found_false() throws Exception {
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionKey("无此流程")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.latestVersion()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(null);
mvc.perform(get("/api/flow/process-definitions/by-key/{key}/source", "无此流程"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
@Test
void source_读取XML异常返found_false不抛500() throws Exception {
ProcessDefinition def = org.mockito.Mockito.mock(ProcessDefinition.class);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("def-x")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(def);
when(repositoryService.getProcessModel("def-x")).thenThrow(new RuntimeException("boom"));
mvc.perform(get("/api/flow/process-definitions/def-x/source"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
}

View File

@@ -0,0 +1,743 @@
package com.eip4.flowservice.api;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.anyString;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.never;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.delete;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.put;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import java.io.ByteArrayInputStream;
import java.nio.charset.StandardCharsets;
import java.util.Date;
import java.util.List;
import org.flowable.engine.RepositoryService;
import org.flowable.engine.RuntimeService;
import org.flowable.engine.repository.Deployment;
import org.flowable.engine.repository.DeploymentBuilder;
import org.flowable.engine.repository.Model;
import org.flowable.engine.repository.ModelQuery;
import org.flowable.engine.repository.ProcessDefinition;
import org.flowable.engine.repository.ProcessDefinitionQuery;
import org.flowable.engine.runtime.ProcessInstanceQuery;
import org.flowable.validation.ProcessValidator;
import org.flowable.validation.ValidationError;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.ArgumentCaptor;
import org.mockito.Mock;
import org.mockito.Mockito;
import org.mockito.junit.jupiter.MockitoExtension;
import org.springframework.http.MediaType;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
/**
* 流程草稿 CRUD 端点薄层单测:mock RepositoryService + Model API(newModel/saveModel/addModelEditorSource/
* getModelEditorSource/createModelQuery),验证列表/取草稿/建草稿(坏 XML 不落库)/PUT 404/from-procdef
* 净化 XML 与 idMap 落 metaInfo。standaloneSetup 不挂 FlowExceptionHandler——422/404 由控制器本地 ResponseEntity
* 显式产出(不经引擎异常映射)。
*/
@ExtendWith(MockitoExtension.class)
class ProcessModelControllerTest {
@Mock RepositoryService repositoryService;
@Mock ModelQuery modelQuery;
@Mock ProcessDefinitionQuery processDefinitionQuery;
MockMvc mvc;
// 最小 schema 合法 BPMN(default ns=BPMN20 MODEL)。
private static final String VALID_BPMN = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" targetNamespace=\"http://eip4\">"
+ "<process id=\"p1\" name=\"p1\">"
+ "<startEvent id=\"start\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"start\" targetRef=\"end\"/>"
+ "<endEvent id=\"end\"/>"
+ "</process></definitions>";
// bpmn-js saveXML 风格:默认命名空间(无前缀 definitions/process)+ 带前缀 BPMNDI 布局段。
// 此处 BPMNDiagram 排在 process 之前(触发严格 XSD 的 cvc-complex-type.2.4.a 序列违例——definitions 内容
// 模型要求 rootElement* 在 BPMNDiagram* 之前)——模拟 bpmn-js 输出被严格 XSD 拒的真实故障族。
// 草稿保存关 validateSchema 后应良构解析通过 → 200。
private static final String BPMN_JS_STYLE = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\""
+ " xmlns:bpmndi=\"http://www.omg.org/spec/BPMN/20100524/DI\""
+ " xmlns:dc=\"http://www.omg.org/spec/DD/20100524/DC\""
+ " xmlns:di=\"http://www.omg.org/spec/DD/20100524/DI\""
+ " id=\"Definitions_1\" targetNamespace=\"http://bpmn.io/schema/bpmn\">"
+ "<bpmndi:BPMNDiagram id=\"BPMNDiagram_1\">"
+ "<bpmndi:BPMNPlane id=\"BPMNPlane_1\" bpmnElement=\"Process_1\">"
+ "<bpmndi:BPMNShape id=\"StartEvent_1_di\" bpmnElement=\"StartEvent_1\">"
+ "<dc:Bounds x=\"152\" y=\"82\" width=\"36\" height=\"36\"/>"
+ "</bpmndi:BPMNShape></bpmndi:BPMNPlane></bpmndi:BPMNDiagram>"
+ "<process id=\"Process_1\" isExecutable=\"true\">"
+ "<startEvent id=\"StartEvent_1\" name=\"开始\"/>"
+ "</process></definitions>";
// 含 DOCTYPE 声明(XXE 面):正文良构、关严格 XSD 后本可解析,但字节级 DOCTYPE 守卫必须拒。
private static final String DOCTYPE_XML = "<?xml version=\"1.0\"?>"
+ "<!DOCTYPE definitions [<!ENTITY xxe \"payload\">]>"
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\">"
+ "<process id=\"p1\"><startEvent id=\"s\"/></process></definitions>";
// 存量流程编辑器导出态(发布路径 fixture):process id + sequenceFlow id 原为中文,已被 sanitize 成净化 id
// (n1a2b3c / nflow1 / nflow2);bpmn-js saveXML 给流节点补了 <incoming>/<outgoing> 文本引用(内含净化 id)。
// metaInfo.eip4IdMap 记「中文原 id→净化 id」,发布时 restore 逆向还原。model.key=中文原 key「总包合同交底」。
private static final String DRAFT_SANITIZED_XML = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" targetNamespace=\"http://eip4\">"
+ "<process id=\"n1a2b3c\" name=\"总包合同交底\" isExecutable=\"true\">"
+ "<startEvent id=\"start1\"><outgoing>nflow1</outgoing></startEvent>"
+ "<userTask id=\"taskA\" name=\"交底\"><incoming>nflow1</incoming><outgoing>nflow2</outgoing></userTask>"
+ "<endEvent id=\"end1\"><incoming>nflow2</incoming></endEvent>"
+ "<sequenceFlow id=\"nflow1\" sourceRef=\"start1\" targetRef=\"taskA\"/>"
+ "<sequenceFlow id=\"nflow2\" sourceRef=\"taskA\" targetRef=\"end1\"/>"
+ "</process></definitions>";
// 对应上面 fixture 的 metaInfo:eip4IdMap 三条(process + 两条 sequenceFlow) + sourceProcDefId + 中文 originalKey。
private static final String DRAFT_META_INFO = "{\"eip4IdMap\":{\"总包合同交底\":\"n1a2b3c\","
+ "\"流转1\":\"nflow1\",\"流转2\":\"nflow2\"},\"sourceProcDefId\":\"def-1\",\"originalKey\":\"总包合同交底\"}";
@BeforeEach
void setUp() {
ProcessModelController controller = new ProcessModelController(repositoryService);
mvc = MockMvcBuilders.standaloneSetup(controller).build();
}
@Test
void 列表只查eip4分类并按最近更新降序返回id名key时间() throws Exception {
Model m = Mockito.mock(Model.class);
when(m.getId()).thenReturn("m1");
when(m.getName()).thenReturn("总包合同交底");
when(m.getKey()).thenReturn("总包合同交底");
when(m.getLastUpdateTime()).thenReturn(new Date(0L)); // 1970-01-01T00:00:00Z
when(repositoryService.createModelQuery()).thenReturn(modelQuery);
when(modelQuery.modelCategory("eip4")).thenReturn(modelQuery);
when(modelQuery.orderByLastUpdateTime()).thenReturn(modelQuery);
when(modelQuery.desc()).thenReturn(modelQuery);
when(modelQuery.list()).thenReturn(List.of(m));
mvc.perform(get("/api/flow/models"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.models[0].id").value("m1"))
.andExpect(jsonPath("$.models[0].name").value("总包合同交底"))
.andExpect(jsonPath("$.models[0].key").value("总包合同交底"))
.andExpect(jsonPath("$.models[0].lastUpdateTime").value("1970-01-01T00:00:00Z"));
// 列表只列 EIP4 建的草稿:隔离库里 143 条老 shape 存量 act_re_model(打不开)
verify(modelQuery).modelCategory("eip4");
}
@Test
void 取草稿返回XML与metaInfo() throws Exception {
Model m = Mockito.mock(Model.class);
when(m.getId()).thenReturn("m1");
when(m.getName()).thenReturn("总包合同交底");
when(m.getKey()).thenReturn("总包合同交底");
when(m.getMetaInfo()).thenReturn("{\"eip4IdMap\":{\"总包合同交底\":\"n1\"}}");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn("<definitions/>".getBytes(StandardCharsets.UTF_8));
mvc.perform(get("/api/flow/models/m1"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.id").value("m1"))
.andExpect(jsonPath("$.key").value("总包合同交底"))
.andExpect(jsonPath("$.bpmnXml").value("<definitions/>"))
.andExpect(jsonPath("$.metaInfo").value("{\"eip4IdMap\":{\"总包合同交底\":\"n1\"}}"));
}
@Test
void 取草稿_model不存在返found_false() throws Exception {
when(repositoryService.getModel("nope")).thenReturn(null);
mvc.perform(get("/api/flow/models/nope"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
@Test
void 取草稿_editorSource为空返found_false() throws Exception {
Model m = Mockito.mock(Model.class);
when(repositoryService.getModel("m2")).thenReturn(m);
when(repositoryService.getModelEditorSource("m2")).thenReturn(null);
mvc.perform(get("/api/flow/models/m2"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
}
@Test
void 建草稿_合法XML落库返modelId() throws Exception {
Model m = Mockito.mock(Model.class);
when(m.getId()).thenReturn("newid");
when(repositoryService.newModel()).thenReturn(m);
String body = "{\"name\":\"新流程\",\"key\":\"newproc\",\"bpmnXml\":"
+ jsonString(VALID_BPMN) + ",\"metaInfo\":\"{}\"}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isOk())
.andExpect(jsonPath("$.modelId").value("newid"));
verify(m).setName("新流程");
verify(m).setKey("newproc");
verify(m).setCategory("eip4"); // 建草稿打 EIP4 分类,供 list() 过滤隔离存量
verify(repositoryService).saveModel(m);
ArgumentCaptor<byte[]> src = ArgumentCaptor.forClass(byte[].class);
verify(repositoryService).addModelEditorSource(eq("newid"), src.capture());
org.junit.jupiter.api.Assertions.assertTrue(
new String(src.getValue(), StandardCharsets.UTF_8).contains("<process id=\"p1\""));
}
@Test
void 建草稿_空白name或key返422且不落库() throws Exception {
// key 是 T3.1 部署资源名/中文原 key 还原的依赖:空白一律拒,在解析守卫之前拦。
String body = "{\"name\":\" \",\"key\":\"\",\"bpmnXml\":" + jsonString(VALID_BPMN) + "}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1))
.andExpect(jsonPath("$.msg").isNotEmpty());
verify(repositoryService, never()).newModel();
verify(repositoryService, never()).saveModel(any());
}
@Test
void 建草稿_坏XML返422且不落库() throws Exception {
String body = "{\"name\":\"坏流程\",\"key\":\"bad\",\"bpmnXml\":"
+ jsonString("<definitions><broken") + "}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1))
.andExpect(jsonPath("$.msg").isNotEmpty());
// 解析守卫先于任何写:坏 XML 一律不落库
verify(repositoryService, never()).newModel();
verify(repositoryService, never()).saveModel(any());
verify(repositoryService, never()).addModelEditorSource(anyString(), any());
}
@Test
void 建草稿_bpmnJs默认命名空间输出_关严格XSD后200落库() throws Exception {
// 回归锚点:bpmn-js saveXML 默认命名空间输出被严格 XSD 拒(改前必红=422)。草稿保存不该做完整 XSD 校验
// (完整校验属部署时 ProcessValidator,非 XSD)→ 关 validateSchema 后良构解析通过 → 200 建草稿成功。
Model m = Mockito.mock(Model.class);
when(m.getId()).thenReturn("draft-js");
when(repositoryService.newModel()).thenReturn(m);
String body = "{\"name\":\"新流程\",\"key\":\"newproc\",\"bpmnXml\":" + jsonString(BPMN_JS_STYLE) + "}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isOk())
.andExpect(jsonPath("$.modelId").value("draft-js"));
verify(repositoryService).saveModel(m);
verify(repositoryService).addModelEditorSource(eq("draft-js"), any());
}
@Test
void 建草稿_含DOCTYPE声明_字节级XXE守卫返422不落库() throws Exception {
// 正文良构(关 XSD 后本可解析),但 DOCTYPE 声明是 XXE 面 → 解析前字节级守卫拒,不依赖 flowable 内部实现。
String body = "{\"name\":\"x\",\"key\":\"k\",\"bpmnXml\":" + jsonString(DOCTYPE_XML) + "}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).saveModel(any());
verify(repositoryService, never()).addModelEditorSource(anyString(), any());
}
@Test
void 建草稿_非良构XML_关严格XSD后仍返422不落库() throws Exception {
// 关 validateSchema=false 仅关严格 XSD,仍解析:标签不匹配是非良构 XML,解析必抛 → 422。
String body = "{\"name\":\"x\",\"key\":\"k\",\"bpmnXml\":"
+ jsonString("<definitions><process></definitions>") + "}";
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).saveModel(any());
}
@Test
void 更新_草稿不存在返404() throws Exception {
when(repositoryService.getModel("nope")).thenReturn(null);
String body = "{\"name\":\"x\",\"bpmnXml\":" + jsonString(VALID_BPMN) + "}";
mvc.perform(put("/api/flow/models/nope").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isNotFound())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).saveModel(any());
}
@Test
void 更新_合法XML更新name与editorSource返status0() throws Exception {
Model m = Mockito.mock(Model.class);
when(repositoryService.getModel("m1")).thenReturn(m);
String body = "{\"name\":\"改名\",\"bpmnXml\":" + jsonString(VALID_BPMN) + ",\"metaInfo\":\"{}\"}";
mvc.perform(put("/api/flow/models/m1").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0));
verify(m).setName("改名");
verify(m).setMetaInfo("{}");
verify(repositoryService).saveModel(m);
verify(repositoryService).addModelEditorSource(eq("m1"), any());
}
@Test
void 更新_只带name不带metaInfo时不改metaInfo() throws Exception {
// 草稿的 eip4IdMap 存于 metaInfo,普通保存草稿只发 name+XML 不重发 metaInfo:此时绝不能 setMetaInfo(null)
// 抹掉它——这是 T3.1 发布逆向还原原 key 的命根契约。
Model m = Mockito.mock(Model.class);
when(repositoryService.getModel("m1")).thenReturn(m);
String body = "{\"name\":\"只改名\",\"bpmnXml\":" + jsonString(VALID_BPMN) + "}";
mvc.perform(put("/api/flow/models/m1").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0));
verify(m).setName("只改名");
verify(m, never()).setMetaInfo(any());
verify(repositoryService).saveModel(m);
verify(repositoryService).addModelEditorSource(eq("m1"), any());
}
@Test
void 更新_坏XML返422且不落库() throws Exception {
Model m = Mockito.mock(Model.class);
when(repositoryService.getModel("m1")).thenReturn(m);
String body = "{\"name\":\"x\",\"bpmnXml\":" + jsonString("<nope") + "}";
mvc.perform(put("/api/flow/models/m1").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).saveModel(any());
verify(repositoryService, never()).addModelEditorSource(anyString(), any());
}
@Test
void 删草稿_存在则删除返status0() throws Exception {
Model m = Mockito.mock(Model.class);
when(repositoryService.getModel("m1")).thenReturn(m);
mvc.perform(delete("/api/flow/models/m1"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0));
verify(repositoryService).deleteModel("m1");
}
@Test
void 删草稿_不存在返404不删除() throws Exception {
when(repositoryService.getModel("nope")).thenReturn(null);
mvc.perform(delete("/api/flow/models/nope"))
.andExpect(status().isNotFound())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).deleteModel(anyString());
}
@Test
void fromProcDef_净化XML与idMap落metaInfo() throws Exception {
// 存量流程 process id 为中文,from-procdef 净化后建草稿:editorSource 无中文 id,metaInfo JSON 含
// eip4IdMap + sourceProcDefId + 中文 originalKey(发布时逆向还原原 key)。
ProcessDefinition def = Mockito.mock(ProcessDefinition.class);
when(def.getName()).thenReturn("总包合同交底");
when(def.getKey()).thenReturn("总包合同交底");
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("def-1")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(def);
String xml = "<definitions>"
+ "<process id=\"总包合同交底\" name=\"总包合同交底\">"
+ "<userTask id=\"sid-A\"/>"
+ "<sequenceFlow id=\"f1\" sourceRef=\"总包合同交底\" targetRef=\"sid-A\"/>"
+ "</process></definitions>";
when(repositoryService.getProcessModel("def-1"))
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
Model m = Mockito.mock(Model.class);
when(m.getId()).thenReturn("draft-1");
when(repositoryService.newModel()).thenReturn(m);
String body = "{\"procDefId\":\"def-1\"}";
mvc.perform(post("/api/flow/models/from-procdef").contentType(MediaType.APPLICATION_JSON).content(body))
.andExpect(status().isOk())
.andExpect(jsonPath("$.modelId").value("draft-1"));
verify(m).setName("总包合同交底");
verify(m).setKey("总包合同交底");
verify(m).setCategory("eip4"); // from-procdef 建的草稿同样打 EIP4 分类
// metaInfo:JSON 含 eip4IdMap + sourceProcDefId + 中文 originalKey
ArgumentCaptor<String> meta = ArgumentCaptor.forClass(String.class);
verify(m).setMetaInfo(meta.capture());
String metaJson = meta.getValue();
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("eip4IdMap"), metaJson);
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("\"sourceProcDefId\":\"def-1\""), metaJson);
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("\"originalKey\":\"总包合同交底\""), metaJson);
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("总包合同交底"), metaJson); // idMap 键含中文原 id
// editorSource:净化后 XML 不再含中文 id(id/ref 属性),name 保留中文
ArgumentCaptor<byte[]> src = ArgumentCaptor.forClass(byte[].class);
verify(repositoryService).addModelEditorSource(eq("draft-1"), src.capture());
String savedXml = new String(src.getValue(), StandardCharsets.UTF_8);
org.junit.jupiter.api.Assertions.assertFalse(savedXml.contains("id=\"总包合同交底\""), savedXml);
org.junit.jupiter.api.Assertions.assertFalse(savedXml.contains("sourceRef=\"总包合同交底\""), savedXml);
org.junit.jupiter.api.Assertions.assertTrue(savedXml.contains("name=\"总包合同交底\""), savedXml);
}
@Test
void fromProcDef_procDef不存在返found_false不落库() throws Exception {
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("nope")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(null);
mvc.perform(post("/api/flow/models/from-procdef")
.contentType(MediaType.APPLICATION_JSON).content("{\"procDefId\":\"nope\"}"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
verify(repositoryService, never()).newModel();
}
@Test
void fromProcDef_BPMN读取为空返found_false不落库() throws Exception {
// procDef 存在但部署 BPMN 资源读不出(getProcessModel 返 null)→ 降级 found:false,不建空草稿。
ProcessDefinition def = Mockito.mock(ProcessDefinition.class);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionId("def-empty")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(def);
when(repositoryService.getProcessModel("def-empty")).thenReturn(null);
mvc.perform(post("/api/flow/models/from-procdef")
.contentType(MediaType.APPLICATION_JSON).content("{\"procDefId\":\"def-empty\"}"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(false));
verify(repositoryService, never()).newModel();
}
// ===== T3.1 发布(deploy)/ 影响摘要(impact) =====
/** 建带 mock ProcessValidator + RuntimeService 的控制器与 MockMvc(发布/影响端点专用,校验器须可 mock)。 */
private MockMvc deployMvc(RuntimeService runtimeService, ProcessValidator validator) {
return MockMvcBuilders.standaloneSetup(
new ProcessModelController(repositoryService, runtimeService, validator)).build();
}
@Test
void 发布_还原中文原key与剥除incoming_outgoing后部署XML无残留净化id且disableSchemaValidation() throws Exception {
Model m = Mockito.mock(Model.class);
when(m.getName()).thenReturn("总包合同交底");
when(m.getKey()).thenReturn("总包合同交底"); // 中文原 key(from-procdef 时存,发布资源名/还原目标)
when(m.getMetaInfo()).thenReturn(DRAFT_META_INFO);
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
// 校验器无 ERROR → 放行部署。
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
when(validator.validate(any())).thenReturn(List.of());
// 部署链 mock:disableSchemaValidation().name().addString().deploy()。
DeploymentBuilder db = Mockito.mock(DeploymentBuilder.class);
when(repositoryService.createDeployment()).thenReturn(db);
when(db.disableSchemaValidation()).thenReturn(db);
when(db.name(any())).thenReturn(db);
when(db.addString(anyString(), anyString())).thenReturn(db);
Deployment dep = Mockito.mock(Deployment.class);
when(dep.getId()).thenReturn("dep-1");
when(db.deploy()).thenReturn(dep);
ProcessDefinition deployed = Mockito.mock(ProcessDefinition.class);
when(deployed.getKey()).thenReturn("总包合同交底");
when(deployed.getVersion()).thenReturn(2);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.deploymentId("dep-1")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(deployed);
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0))
.andExpect(jsonPath("$.deploymentId").value("dep-1"))
.andExpect(jsonPath("$.processKey").value("总包合同交底"))
.andExpect(jsonPath("$.newVersion").value(2));
// disableSchemaValidation 必被调用(防有人回退成严格 XSD,咬 bpmn-js 默认命名空间输出→cvc-complex-type)。
verify(db).disableSchemaValidation();
// 捕获部署 XML:属性位还原为中文原 key/流 id,incoming/outgoing 文本引用剥除 → 全程无残留净化 id。
ArgumentCaptor<String> deployXml = ArgumentCaptor.forClass(String.class);
verify(db).addString(eq("总包合同交底.bpmn20.xml"), deployXml.capture());
String xml = deployXml.getValue();
org.junit.jupiter.api.Assertions.assertTrue(xml.contains("id=\"总包合同交底\""), xml);
org.junit.jupiter.api.Assertions.assertTrue(xml.contains("id=\"流转1\""), xml);
org.junit.jupiter.api.Assertions.assertTrue(xml.contains("id=\"流转2\""), xml);
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("n1a2b3c"), "残留净化 process id: " + xml);
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("nflow1"), "残留净化流 id(incoming/outgoing 未剥除): " + xml);
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("nflow2"), "残留净化流 id(incoming/outgoing 未剥除): " + xml);
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("<incoming>"), "incoming 元素未剥除: " + xml);
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("<outgoing>"), "outgoing 元素未剥除: " + xml);
}
@Test
void 发布_ProcessValidator_ERROR级返422带明细且不部署() throws Exception {
Model m = Mockito.mock(Model.class);
// metaInfo 默认 null → 无 idMap(新建流程分支,不还原);getKey 在 ERROR 返回前不会被读,不 stub 免 strict-stub。
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(VALID_BPMN.getBytes(StandardCharsets.UTF_8));
ValidationError err = new ValidationError();
err.setActivityId("taskA");
err.setProblem("flowable-usertask-no-assignment");
err.setDefaultDescription("用户任务无办理人");
err.setWarning(false);
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
when(validator.validate(any())).thenReturn(List.of(err));
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1))
.andExpect(jsonPath("$.errors[0].activityId").value("taskA"))
.andExpect(jsonPath("$.errors[0].problem").value("flowable-usertask-no-assignment"))
.andExpect(jsonPath("$.errors[0].defaultDescription").value("用户任务无办理人"));
// ERROR 级校验失败 → 绝不部署。
verify(repositoryService, never()).createDeployment();
}
@Test
void 发布_ProcessValidator仅WARNING放行部署() throws Exception {
Model m = Mockito.mock(Model.class);
when(m.getName()).thenReturn("新流程");
when(m.getKey()).thenReturn("newproc");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(VALID_BPMN.getBytes(StandardCharsets.UTF_8));
ValidationError warn = new ValidationError();
warn.setActivityId("taskA");
warn.setProblem("some-warning");
warn.setWarning(true);
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
when(validator.validate(any())).thenReturn(List.of(warn));
DeploymentBuilder db = Mockito.mock(DeploymentBuilder.class);
when(repositoryService.createDeployment()).thenReturn(db);
when(db.disableSchemaValidation()).thenReturn(db);
when(db.name(any())).thenReturn(db);
when(db.addString(anyString(), anyString())).thenReturn(db);
Deployment dep = Mockito.mock(Deployment.class);
when(dep.getId()).thenReturn("dep-2");
when(db.deploy()).thenReturn(dep);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.deploymentId("dep-2")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(null); // 查不到也不炸:回退 model.key/0
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0))
.andExpect(jsonPath("$.deploymentId").value("dep-2"))
.andExpect(jsonPath("$.processKey").value("newproc"))
.andExpect(jsonPath("$.newVersion").value(0));
// 仅 WARNING → 放行:部署照常发生。
verify(db).deploy();
}
@Test
void 发布_草稿不存在返404不部署() throws Exception {
when(repositoryService.getModel("nope")).thenReturn(null);
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(post("/api/flow/models/nope/deploy"))
.andExpect(status().isNotFound())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).createDeployment();
}
@Test
void 影响摘要_还原后解析processKey返当前版本与运行实例数() throws Exception {
Model m = Mockito.mock(Model.class);
// processKey 取自还原后 XML 的 <process id>(=总包合同交底),不读 model.getKey → 不 stub 免 strict-stub。
when(m.getMetaInfo()).thenReturn(DRAFT_META_INFO);
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
ProcessDefinition latest = Mockito.mock(ProcessDefinition.class);
when(latest.getVersion()).thenReturn(3);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.processDefinitionKey("总包合同交底")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.latestVersion()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(latest);
RuntimeService runtimeService = Mockito.mock(RuntimeService.class);
ProcessInstanceQuery piq = Mockito.mock(ProcessInstanceQuery.class);
when(runtimeService.createProcessInstanceQuery()).thenReturn(piq);
when(piq.processDefinitionKey("总包合同交底")).thenReturn(piq);
when(piq.count()).thenReturn(5L);
MockMvc localMvc = deployMvc(runtimeService, Mockito.mock(ProcessValidator.class));
localMvc.perform(get("/api/flow/models/m1/impact"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.processKey").value("总包合同交底"))
.andExpect(jsonPath("$.currentVersion").value(3))
.andExpect(jsonPath("$.runningInstances").value(5));
}
@Test
void 影响摘要_草稿不存在返404() throws Exception {
when(repositoryService.getModel("nope")).thenReturn(null);
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(get("/api/flow/models/nope/impact"))
.andExpect(status().isNotFound())
.andExpect(jsonPath("$.status").value(1));
}
@Test
void 发布_非双射idMap_restore_fail_fast返422不部署() throws Exception {
// metaInfo 的 eip4IdMap 两个中文原 id 映射到同一净化 id(n1)→restore 反转检测到非双射抛 IllegalArgumentException
// →deploy catch→422,绝不部署(损坏映射还原会指错 key)。
Model m = Mockito.mock(Model.class);
when(m.getMetaInfo()).thenReturn("{\"eip4IdMap\":{\"总包合同交底\":\"n1\",\"其他流程\":\"n1\"}}");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1))
.andExpect(jsonPath("$.msg").isNotEmpty());
verify(repositoryService, never()).createDeployment();
}
@Test
void 发布_存量草稿metaInfo缺eip4IdMap_fail_fast返422不部署() throws Exception {
// I1 坏 key 地雷:from-procdef 标记(sourceProcDefId/originalKey)在但 eip4IdMap 键丢了→editorSource 是净化 nXXX
// 却无从还原→绝不能静默塌成「空 idMap 跳过还原」部署出 key=nXXX(违 D7)→resolveIdMap fail-fast→422 不部署。
Model m = Mockito.mock(Model.class);
when(m.getMetaInfo()).thenReturn("{\"sourceProcDefId\":\"def-1\",\"originalKey\":\"总包合同交底\"}");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1))
.andExpect(jsonPath("$.msg").isNotEmpty());
verify(repositoryService, never()).createDeployment();
}
@Test
void 发布_metaInfo解析失败_fail_fast返422不部署() throws Exception {
// 非空 metaInfo 却是坏 JSON:无从确认是不是存量草稿→宁拒不发(可能的坏 key)→resolveIdMap fail-fast→422 不部署。
Model m = Mockito.mock(Model.class);
when(m.getMetaInfo()).thenReturn("{坏JSON不可解析");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).createDeployment();
}
@Test
void 发布_存量草稿eip4IdMap为空_全ASCII流程不误拒正常部署() throws Exception {
// 防 I1 修过头:from-procdef 的全 ASCII 存量流程 sanitize 出空 eip4IdMap {}(present),editorSource 本就是 ASCII key,
// 无需还原→eip4IdMap 存在(空)即「可用」,不该被 fail-fast 误拒→正常部署。
Model m = Mockito.mock(Model.class);
when(m.getName()).thenReturn("ascii流程");
when(m.getKey()).thenReturn("asciiKey");
when(m.getMetaInfo())
.thenReturn("{\"eip4IdMap\":{},\"sourceProcDefId\":\"def-1\",\"originalKey\":\"asciiKey\"}");
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(VALID_BPMN.getBytes(StandardCharsets.UTF_8));
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
when(validator.validate(any())).thenReturn(List.of());
DeploymentBuilder db = Mockito.mock(DeploymentBuilder.class);
when(repositoryService.createDeployment()).thenReturn(db);
when(db.disableSchemaValidation()).thenReturn(db);
when(db.name(any())).thenReturn(db);
when(db.addString(anyString(), anyString())).thenReturn(db);
Deployment dep = Mockito.mock(Deployment.class);
when(dep.getId()).thenReturn("dep-3");
when(db.deploy()).thenReturn(dep);
ProcessDefinition deployed = Mockito.mock(ProcessDefinition.class);
when(deployed.getKey()).thenReturn("p1");
when(deployed.getVersion()).thenReturn(1);
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.deploymentId("dep-3")).thenReturn(processDefinitionQuery);
when(processDefinitionQuery.singleResult()).thenReturn(deployed);
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0))
.andExpect(jsonPath("$.processKey").value("p1"));
verify(db).deploy();
}
@Test
void 发布_editorSource含DOCTYPE_字节级XXE守卫返422不部署() throws Exception {
// deploy 路径自带的字节级 DOCTYPE 守卫(还原后 XML 再过一道):即便存储的 editorSource 含 DOCTYPE(理论不该,
// 因写入端已拒),部署也在解析前拒,绝不部署。
Model m = Mockito.mock(Model.class);
// metaInfo 默认 null→真·新建分支,resolveIdMap 返空,prepareDeployXml 剥除+空还原=原样→deployXml 仍含 DOCTYPE。
when(repositoryService.getModel("m1")).thenReturn(m);
when(repositoryService.getModelEditorSource("m1"))
.thenReturn(DOCTYPE_XML.getBytes(StandardCharsets.UTF_8));
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
localMvc.perform(post("/api/flow/models/m1/deploy"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1));
verify(repositoryService, never()).createDeployment();
}
/** 把任意字符串编成 JSON 字符串字面量(转义引号/反斜杠/换行),用于拼请求体。 */
private static String jsonString(String s) {
StringBuilder sb = new StringBuilder("\"");
for (int i = 0; i < s.length(); i++) {
char c = s.charAt(i);
switch (c) {
case '"' -> sb.append("\\\"");
case '\\' -> sb.append("\\\\");
case '\n' -> sb.append("\\n");
case '\r' -> sb.append("\\r");
case '\t' -> sb.append("\\t");
default -> sb.append(c);
}
}
return sb.append("\"").toString();
}
}

View File

@@ -16,7 +16,9 @@ server:
spring: spring:
datasource: datasource:
url: jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3 # 合并库 eip4:业务表 + flowable(act_*) 同库(对齐生产单库拓扑),跨库报表(审批意见等)可直接 join。
# 原分库 eip4dev(业务)/eip4flow(流程)保留作回滚。覆盖:SPRING_DATASOURCE_URL。
url: ${SPRING_DATASOURCE_URL:jdbc:postgresql://localhost:5433/eip4?currentSchema=eip3}
username: zhengwr username: zhengwr
password: password:
hikari: hikari:

View File

@@ -0,0 +1,18 @@
-- Flyway 迁移 V4:在线流程 Modeler 发布审计表(sys_flow_deploy_audit)。
-- 记录每次草稿→流程定义部署:谁(operator)/何时(deployed_at)/发布了哪个草稿(model_id)/产生的部署(deployment_id)/
-- 流程 key(可能中文,如「总包合同交底」)+新版本号。供合规审计与发布追溯(D2 同人确认部署的审计要求)。
-- 平台表(非引擎表 act_re_*),走 Flyway;写入收口网关 FlowDeployAuditService。
-- 幂等:配合 baseline-on-migrate,既有库已有此表也安全。
CREATE TABLE IF NOT EXISTS sys_flow_deploy_audit (
id bigserial NOT NULL,
model_id varchar(64),
deployment_id varchar(64),
process_key varchar(255),
new_version integer,
operator varchar(64),
deployed_at timestamptz NOT NULL DEFAULT now(),
CONSTRAINT pk_sys_flow_deploy_audit PRIMARY KEY (id)
);
-- 按流程 key + 时间倒查发布历史(某流程被谁何时发布过哪些版本)。
CREATE INDEX IF NOT EXISTS idx_sys_flow_deploy_audit_key ON sys_flow_deploy_audit (process_key, deployed_at);

View File

@@ -64,8 +64,18 @@ public final class EngineContextBinder {
* DB 校验 {@code TRIM(account)='admin'}(精确小写)。不放宽成大小写不敏感,避免因 {@code SYS_USER.ACCOUNT} * DB 校验 {@code TRIM(account)='admin'}(精确小写)。不放宽成大小写不敏感,避免因 {@code SYS_USER.ACCOUNT}
* 无唯一约束、建号去重又区分大小写而把 {@code 'Admin'} 这类变体账号静默提权(安全评审 M-1)。</li> * 无唯一约束、建号去重又区分大小写而把 {@code 'Admin'} 这类变体账号静默提权(安全评审 M-1)。</li>
* </ul> * </ul>
*
* <p><b>时效性(time-of-check)</b>:userId/account 均取自 JWT claim(token 签发时的身份快照),
* <strong>不实时查库</strong>。故在 token 有效期内,若 admin 账号被改名/停用/降权,本判定仍按签发时结果放行——
* 由 token TTL 兜底,安全敏感的提权变更需配合短 TTL 或主动吊销 token 方能即时生效。
*
* <p>公开为 {@code public static} 供网关层复用(流程 Modeler 超管门,flowable-service 裸 8089
* 无安全栈 → 超管门唯一落点在网关,T1.6)。{@code null} 主体安全返回 {@code false}(未认证即非超管)。
*/ */
private static boolean isSystemAdmin(AuthPrincipal principal) { public static boolean isSystemAdmin(AuthPrincipal principal) {
if (principal == null) {
return false;
}
String adminId = LoggedInUser.ADMIN.trim(); // "ADMIN" String adminId = LoggedInUser.ADMIN.trim(); // "ADMIN"
String userId = principal.userId(); String userId = principal.userId();
if (userId != null && adminId.equalsIgnoreCase(userId.trim())) { if (userId != null && adminId.equalsIgnoreCase(userId.trim())) {

View File

@@ -0,0 +1,75 @@
package com.eip4.platform.auth.security;
import static org.assertj.core.api.Assertions.assertThat;
import java.util.List;
import org.junit.jupiter.api.Test;
import com.dsasp.server.common.user.service.LoggedInUser;
/**
* {@link EngineContextBinder#isSystemAdmin} 判定单测:与全站 {@code requireAdmin} 逐口径对齐。
*
* <p>本方法在 T1.6 由 {@code private} 提升为 {@code public static},供 platform-flow-gateway 的
* 流程 Modeler 超管门复用(网关层唯一保护点)。这里锁定其行为契约,防提升可见性后被随意放宽:
* ADMIN 大小写不敏感 + 去补白、account 大小写敏感等于 admin、含 "admin" 字样的普通用户不误判、null 安全。
*/
class EngineContextBinderAdminTest {
private static AuthPrincipal user(String userId, String account) {
return new AuthPrincipal(userId, account, "n", null, null, List.of());
}
@Test
void userId为ADMIN_判超管() {
assertThat(EngineContextBinder.isSystemAdmin(user("ADMIN", "someacct"))).isTrue();
}
@Test
void userId小写admin_大小写不敏感判超管() {
assertThat(EngineContextBinder.isSystemAdmin(user("admin", "someacct"))).isTrue();
}
@Test
void userId带补白_去补白后判超管() {
// 引擎 CURRENTUSER 是 CHAR(36) 补白常量("ADMIN" + 31 空格),trim 后判真
assertThat(EngineContextBinder.isSystemAdmin(user(LoggedInUser.ADMIN, "someacct"))).isTrue();
assertThat(EngineContextBinder.isSystemAdmin(user(" ADMIN ", "someacct"))).isTrue();
}
@Test
void account为admin_userId非admin_判超管() {
assertThat(EngineContextBinder.isSystemAdmin(user("U1", "admin"))).isTrue();
assertThat(EngineContextBinder.isSystemAdmin(user("U1", " admin "))).isTrue();
}
@Test
void account大小写敏感_Admin变体不判超管() {
// SYS_USER.ACCOUNT 无唯一约束,'Admin' 这类变体账号不得静默提权(安全评审 M-1)
assertThat(EngineContextBinder.isSystemAdmin(user("U1", "Admin"))).isFalse();
}
@Test
void 含admin字样的普通用户_不误判() {
assertThat(EngineContextBinder.isSystemAdmin(user("USER_ADMINISTRATOR", "user_admin"))).isFalse();
}
@Test
void 普通用户_非超管() {
assertThat(EngineContextBinder.isSystemAdmin(user("U1", "zhangsan"))).isFalse();
}
@Test
void userId空串或空白且account非admin_非超管() {
// principal 非 null 但 userId 空/空白(trim 后非 ADMIN),account 也非 admin → 两分支均判假,不越权
assertThat(EngineContextBinder.isSystemAdmin(user("", "zhangsan"))).isFalse();
assertThat(EngineContextBinder.isSystemAdmin(user(" ", "zhangsan"))).isFalse();
assertThat(EngineContextBinder.isSystemAdmin(user(null, "zhangsan"))).isFalse();
}
@Test
void null主体_null安全返回false() {
assertThat(EngineContextBinder.isSystemAdmin(null)).isFalse();
}
}

View File

@@ -806,15 +806,27 @@ public class TemplateToAmisConverter {
String navTitle = UiTypeMapper.firstNonBlank(b.attributeValue("funcname"), btnName); String navTitle = UiTypeMapper.firstNonBlank(b.attributeValue("funcname"), btnName);
String pkCol = table + "_ID"; String pkCol = table + "_ID";
boolean needSelected = !"false".equals(b.attributeValue("isneedselected")); boolean needSelected = !"false".equals(b.attributeValue("isneedselected"));
boolean reportNoSearch = "true".equals(b.attributeValue("reportnosearch"));
btn.put("actionType", "dialog"); btn.put("actionType", "dialog");
if (needSelected) { if (needSelected) {
btn.put("disabledOn", DISABLED_ON_NO_SELECTION); btn.put("disabledOn", DISABLED_ON_NO_SELECTION);
} }
Map<String, Object> dlg = buildNavigationDialog(navTitle, funcId, pkCol, needSelected, result); // 单据套打打印(reportnosearch + funcid→type=200 报表):老系统语义=对选中行直接出图、无查询表单。
btn.put("dialog", dlg); // → 直接 iframe 渲染 /api/report/render,按目标报表 <search> 参数名注入选中行同名列。
result.note("button[navigation] " + btnName + " → dialog service schemaApi=/api/page/schema/" // (原通用导航嵌报表查看器会把报表唯一的主键选择字段被 F3-1 剔除,选中行主键到不了 render → 空白单据。)
+ funcId + "(funcname=" + navTitle + ",注入默认查询 " + pkCol + "=选中行主键" List<String> reportParams = reportNoSearch ? loadReportSearchParams(funcId) : List.of();
+ (needSelected ? ",需选中" : "") + ")"); if (!reportParams.isEmpty()) {
btn.put("dialog", buildReportPrintDialog(navTitle, funcId, reportParams));
result.note("button[navigation] " + btnName + " → 套打直接渲染 /api/report/render/"
+ funcId + "(reportnosearch,参数 " + String.join(",", reportParams)
+ "=选中行同名列;funcname=" + navTitle + ")");
} else {
Map<String, Object> dlg = buildNavigationDialog(navTitle, funcId, pkCol, needSelected, result);
btn.put("dialog", dlg);
result.note("button[navigation] " + btnName + " → dialog service schemaApi=/api/page/schema/"
+ funcId + "(funcname=" + navTitle + ",注入默认查询 " + pkCol + "=选中行主键"
+ (needSelected ? ",需选中" : "") + ")");
}
} }
default -> result.note("button[" + btnType + "] " + btnName + " → 普通按钮占位"); default -> result.note("button[" + btnType + "] " + btnName + " → 普通按钮占位");
} }
@@ -921,6 +933,77 @@ public class TemplateToAmisConverter {
return dlg; return dlg;
} }
/**
* 单据套打打印:navigation {@code reportnosearch=true} 按钮的目标 funcid 若指向 type=200 报表,
* 返回该报表 {@code <search>} 的参数名列表(调用方按选中行同名列回填 {@code ${selectedItems[0].P}})。
* 非报表 / 无 search 参 / 无库 / 查询异常 → 空表(调用方回退普通导航弹窗),保持零回归。
*/
private List<String> loadReportSearchParams(String funcId) {
if (funcId == null || funcId.isBlank() || jdbcTemplate == null) {
return List.of();
}
try {
List<String> xmls = jdbcTemplate.query(
"SELECT xml::text FROM view_template WHERE trim(view_template_id) = ? AND type = 200",
(rs, n) -> rs.getString(1), funcId.trim());
if (xmls.isEmpty() || xmls.get(0) == null || xmls.get(0).isBlank()) {
return List.of();
}
Element search = DocumentHelper.parseText(xmls.get(0)).getRootElement().element("search");
if (search == null) {
return List.of();
}
List<String> params = new ArrayList<>();
for (Element f : search.elements("field")) {
String n = f.attributeValue("name", "");
if (n != null && !n.isBlank() && !params.contains(n.trim())) {
params.add(n.trim());
}
}
return params;
} catch (Exception e) {
return List.of();
}
}
/**
* 单据套打打印弹窗(navigation reportnosearch + funcid→type=200 报表):直接 iframe 渲染目标报表,
* 把选中行同名列按报表 {@code <search>} 参数名注入 dialog data({@code ${selectedItems[0].P}},按钮作用域求值),
* iframe / 导出 URL 内引用 {@code ${P}};无查询表单(reportnosearch 语义)。+ 导出 PDF/Excel + 关闭。
*
* <p>参数名为元数据字段名(IDENT,无 URL 特殊字符),裸拼安全;{@code ${P}} 须保持字面量供 amis 运行时插值。
* 服务端 {@code ReportParamGuard} 仅放行报表 {@code <search>} 引用的参数并做白名单校验,越权/注入再过一道。
*/
private Map<String, Object> buildReportPrintDialog(String title, String funcId, List<String> params) {
String tid = funcId.trim();
Map<String, Object> dlg = new LinkedHashMap<>();
dlg.put("type", "dialog");
dlg.put("title", title);
dlg.put("size", "lg");
Map<String, Object> data = new LinkedHashMap<>();
StringBuilder qp = new StringBuilder();
for (String p : params) {
data.put(p, selectedSingleIdExpr(p)); // ${selectedItems[0].P}
qp.append('&').append(p).append("=${").append(p).append('}');
}
dlg.put("data", data);
String renderBase = "/api/report/render/" + tid + "?format=";
Map<String, Object> html = new LinkedHashMap<>();
html.put("type", "html");
html.put("html", "<iframe src=\"" + renderBase + "html" + qp
+ "\" style=\"width:100%;min-height:680px;border:0;\" frameborder=\"0\"></iframe>");
dlg.put("body", html);
List<Map<String, Object>> actions = new ArrayList<>();
actions.add(reportExportButton("导出PDF", renderBase + "pdf" + qp));
actions.add(reportExportButton("导出Excel", renderBase + "xls" + qp));
actions.add(new LinkedHashMap<>(Map.of("type", "button", "actionType", "close", "label", "关闭")));
dlg.put("actions", actions);
return dlg;
}
/** /**
* F2-17 / 服务流分派:构造 dialog body 为 service 加载 /api/page/schema/{templateId} 的 dialog。 * F2-17 / 服务流分派:构造 dialog body 为 service 加载 /api/page/schema/{templateId} 的 dialog。
* *

View File

@@ -23,6 +23,7 @@ import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.core.RowCallbackHandler; import org.springframework.jdbc.core.RowCallbackHandler;
import org.springframework.jdbc.core.RowMapper;
/** /**
* 各段转换规则单测(P4 转换器扩展)。JdbcTemplate 用 Mockito 桩,离线运行—— * 各段转换规则单测(P4 转换器扩展)。JdbcTemplate 用 Mockito 桩,离线运行——
@@ -1676,6 +1677,83 @@ class TemplateToAmisConverterTest {
assertEquals("tpl", tpl.get("type")); assertEquals("tpl", tpl.get("type"));
} }
/**
* 套打打印根因修复:navigation 按钮 {@code reportnosearch='true'} 且 funcid→type=200 报表
* → 「套打直接渲染」弹窗:iframe 指向 {@code /api/report/render} 并按目标报表 {@code <search>}
* 参数名注入选中行同名列({@code ${selectedItems[0].P}}),无查询表单。
*
* <p>修「打印内容空白」:原路径把报表查看器嵌入弹窗,报表唯一的主键选择字段被 F3-1 剔除,
* 选中行主键到不了 render → SQL 用设计期默认 ID(库内不存在)→ 空白单据。
*/
@Test
@SuppressWarnings("unchecked")
void crud_navigation打印reportnosearch_直接渲染套打带选中行参数() {
JdbcTemplate jdbc = mock(JdbcTemplate.class);
// 源 crud 实体表(resolveTableName)故意设为 PM_DEMO,证明参数取自报表 <search> 而非源 pkCol
lenient().when(jdbc.queryForObject(any(String.class), eq(String.class), any(Object[].class)))
.thenReturn("PM_DEMO");
// 目标报表(type=200) XML:search 单字段=主键 OA_OFFICE_PURCHASEAPPLY_ID
String reportXml = "<report entityid='r1'><search>"
+ "<field name='OA_OFFICE_PURCHASEAPPLY_ID' designName='主键' uitype='SelectDialog' required='true'/>"
+ "</search><reportfile>x</reportfile></report>";
lenient().when(jdbc.query(any(String.class), any(RowMapper.class), any(Object[].class)))
.thenReturn(List.of(reportXml));
TemplateToAmisConverter c = new TemplateToAmisConverter(jdbc);
String xml = "<crud entityid='e1'><display/>"
+ "<button type='navigation' name='打印' funcid='0a47a300-report'"
+ " funcname='办公用品采购申请单' reportnosearch='true' isneedselected='true'/></crud>";
ConversionResult r = c.convertGraded(xml, new ArrayList<>(), noPage);
Map<String, Object> crud = body(r.getSchema());
List<Object> toolbar = (List<Object>) crud.get("headerToolbar");
Map<String, Object> btn = (Map<String, Object>) toolbar.get(0);
assertEquals("打印", btn.get("label"));
assertEquals("dialog", btn.get("actionType"));
assertEquals("${!selectedItems || selectedItems.length === 0}", btn.get("disabledOn"));
Map<String, Object> dlg = (Map<String, Object>) btn.get("dialog");
assertEquals("办公用品采购申请单", dlg.get("title"));
// 选中行同名列注入 dialog data(键名=报表参数名,取自报表 <search>,非源 PM_DEMO_ID)
Map<String, Object> data = (Map<String, Object>) dlg.get("data");
assertEquals("${selectedItems[0].OA_OFFICE_PURCHASEAPPLY_ID}", data.get("OA_OFFICE_PURCHASEAPPLY_ID"));
assertNull(data.get("PM_DEMO_ID"), "参数应来自报表 <search>,不是源 crud 主键");
// body = html iframe → /api/report/render 带参数(无 service、无查询表单)
Map<String, Object> bodyEl = (Map<String, Object>) dlg.get("body");
assertEquals("html", bodyEl.get("type"));
String html = (String) bodyEl.get("html");
assertTrue(html.contains("<iframe"), "应直接 iframe 渲染报表");
assertTrue(html.contains("/api/report/render/0a47a300-report?format=html"), html);
assertTrue(html.contains("OA_OFFICE_PURCHASEAPPLY_ID=${OA_OFFICE_PURCHASEAPPLY_ID}"), html);
// 导出 PDF 按钮指向 render(format=pdf) 带同参
List<Map<String, Object>> actions = (List<Map<String, Object>>) dlg.get("actions");
boolean hasPdf = actions.stream().anyMatch(a -> "导出PDF".equals(a.get("label"))
&& String.valueOf(a.get("url")).contains("format=pdf")
&& String.valueOf(a.get("url")).contains("OA_OFFICE_PURCHASEAPPLY_ID=${OA_OFFICE_PURCHASEAPPLY_ID}"));
assertTrue(hasPdf, "应有导出PDF按钮带选中行参数");
}
/** reportnosearch=true 但 funcid 非 type=200 报表(查询空) → 回退普通导航弹窗(service 加载目标页),不误走直接渲染。 */
@Test
@SuppressWarnings("unchecked")
void crud_navigation_reportnosearch非报表回退普通导航() {
JdbcTemplate jdbc = mock(JdbcTemplate.class);
lenient().when(jdbc.queryForObject(any(String.class), eq(String.class), any(Object[].class)))
.thenReturn("PM_DEMO");
// jdbc.query 未桩 → Mockito 默认返回空 list → 非报表
TemplateToAmisConverter c = new TemplateToAmisConverter(jdbc);
String xml = "<crud entityid='e1'><display/>"
+ "<button type='navigation' name='打印' funcid='not-a-report'"
+ " funcname='X' reportnosearch='true' isneedselected='true'/></crud>";
ConversionResult r = c.convertGraded(xml, new ArrayList<>(), noPage);
Map<String, Object> crud = body(r.getSchema());
List<Object> toolbar = (List<Object>) crud.get("headerToolbar");
Map<String, Object> btn = (Map<String, Object>) toolbar.get(0);
Map<String, Object> dlg = (Map<String, Object>) btn.get("dialog");
Map<String, Object> svc = (Map<String, Object>) dlg.get("body");
assertEquals("service", svc.get("type"), "非报表应回退普通导航 service 弹窗");
assertEquals("get:/api/page/schema/not-a-report?format=amis", svc.get("schemaApi"));
}
@Test @Test
void crud_isshowFalse按钮跳过() { void crud_isshowFalse按钮跳过() {
String xml = "<crud entityid='e1'><display/>" String xml = "<crud entityid='e1'><display/>"

View File

@@ -0,0 +1,66 @@
package com.eip4.platform.flowgateway.aggregate;
import java.util.Map;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;
/**
* 流程发布审计:每次草稿→流程定义部署成功后,记一行 {@code sys_flow_deploy_audit}
* (谁 operator / 何时 deployed_at / 发布了哪个草稿 model_id / 产生的 deployment_id / 流程 key + 新版本号),
* 供合规审计与发布追溯(D2 同人确认部署的审计要求)。表由 Flyway V4 建(平台表,非引擎表)。
*
* <p><b>为何是 @Service 而非控制器直查</b>:{@code @RestController} 直持 {@link JdbcTemplate} 触架构棘轮
* ({@code 控制器不得新增直用JdbcTemplate}),审计 INSERT 与字段抽取收口到本 Service。</p>
*
* <p><b>旁路写、不反噬部署</b>:本记录发生在下游部署<b>已成功</b>之后。写审计失败(如库抖动)绝不能让整个
* 发布请求变 500——那会误导用户以为发布失败而重试,产生重复部署。故 {@link #record} 就地吞异常记 error,
* 不上抛。审计缺失可事后追查,重复部署不可逆。</p>
*/
@Service
public class FlowDeployAuditService {
private static final Logger log = LoggerFactory.getLogger(FlowDeployAuditService.class);
static final String INSERT_SQL =
"INSERT INTO sys_flow_deploy_audit (model_id, deployment_id, process_key, new_version, operator) "
+ "VALUES (?, ?, ?, ?, ?)";
private final JdbcTemplate jdbcTemplate;
public FlowDeployAuditService(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
/**
* 从下游 deploy 结果 Map 抽 {@code deploymentId/processKey/newVersion} 落审计行。
*
* @param modelId 被发布的草稿 id
* @param deployResult flowable-service deploy 返回体({status,deploymentId,processKey,newVersion})
* @param operator 操作者(= principal.userId(),超管门已保证非空)
*/
public void record(String modelId, Map<String, Object> deployResult, String operator) {
String deploymentId = str(deployResult, "deploymentId");
String processKey = str(deployResult, "processKey");
Integer newVersion = intOf(deployResult, "newVersion");
try {
jdbcTemplate.update(INSERT_SQL, modelId, deploymentId, processKey, newVersion, operator);
} catch (RuntimeException e) {
// 部署已成功,审计是旁路记录:写失败不回滚不上抛(否则用户误判发布失败→重试→重复部署)。
log.error("[发布审计] 写入 sys_flow_deploy_audit 失败(部署已成功,不回滚) modelId={} operator={}: {}",
modelId, operator, e.toString());
}
}
private static String str(Map<String, Object> m, String key) {
Object v = m == null ? null : m.get(key);
return v == null ? null : String.valueOf(v);
}
private static Integer intOf(Map<String, Object> m, String key) {
Object v = m == null ? null : m.get(key);
return v instanceof Number n ? n.intValue() : null;
}
}

View File

@@ -0,0 +1,290 @@
package com.eip4.platform.flowgateway.aggregate;
import java.io.StringReader;
import java.util.ArrayList;
import java.util.List;
import java.util.Set;
import java.util.regex.Pattern;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.NamedNodeMap;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;
import org.xml.sax.InputSource;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
/**
* 发布门 EIP4 <b>语义</b>校验(网关层):flowable-service 的 {@code ProcessValidator} 只做引擎<b>结构</b>校验
* (节点连通/网关/多实例配置),本校验器补 EIP4 特有的三项运行期正确性约束,返回 {@code List<String>} 错误清单
* (空=通过),供网关 deploy 端点 fail-fast 返 422 且<b>不部署</b>。
*
* <ol>
* <li><b>办理人 / 会签内嵌 JSON</b>:userTask 的 {@code activiti:candidateUsers} 与多实例
* {@code activiti:collection}——凡以 EIP4 handler 前缀
* ({@code candidateUsersHandler.getCandidateUsers} / {@code multiInstanceUsersHandler.getUsers})开头者,
* 内容段花括号全角【】→半角后必须 <b>JSON 可解析</b>、{@code items} <b>非空</b>({@code items:[]} 的 MI
* collection 运行期会炸——仅「JSON 可解析 + type 白名单」不够,T2.4 评审补充)、且每个
* {@code items[].type} ∈ {@link #TYPE_WHITELIST}。非 handler 前缀的裸值(如 {@code ${var}} / 逗号分隔用户)
* 非 EIP4 codec 产物,放行不套 JSON 白名单(避免误拒合法 Flowable 裸值)。</li>
* <li><b>formKey 存在性</b>:userTask 的 {@code activiti:formKey}(= view_wftemplate_id)若存在,必须命中
* {@code view_wftemplate}({@link JdbcTemplate} count 查询);读库异常按全站降级惯例<b>放行</b>该项
* (不因基础设施抖动阻断部署,引用完整性检查跳过并记告警)。</li>
* <li><b>会签完成条件</b>:{@code completionCondition} 允许「三预设 或 保留的自定义非空表达式」
* (T2.4 已实现自定义保留态,别把存量自定义条件拒了)——匹配预设正则则通过,非预设但<b>非空</b>放行
* (仅记 info 告警不阻断),仅<b>空白</b>视为错误。</li>
* </ol>
*
* <p><b>XML 解析</b>:照 {@link WfTemplateService#parseXml} 钉 JDK 内置解析器
* (防 platform-report 带入的上古 xerces 击穿 JAXP 1.4),禁 DOCTYPE / 外部实体(XXE 门)。非命名空间感知,
* 按<b>本地名</b>匹配元素/属性(兼容 bpmn-js 默认命名空间输出与 {@code activiti:}/{@code flowable:} 前缀)。</p>
*
* <p><b>为何是 @Service 而非控制器直查</b>:{@code @RestController} 直持 {@link JdbcTemplate} 触架构棘轮
* ({@code 控制器不得新增直用JdbcTemplate});且 XML 解析 + JSON 白名单逻辑本就该收口成可独立单测的领域件。</p>
*/
@Service
public class ModelSemanticValidator {
private static final Logger log = LoggerFactory.getLogger(ModelSemanticValidator.class);
/** 办理人 handler 表达式前缀,逐字对齐 {@code BasePropertiesConverter} CANDIDATESERVICE(:34)。 */
private static final String CANDIDATE_PREFIX = "${candidateUsersHandler.getCandidateUsers(execution,'";
/** 会签 handler 表达式前缀,逐字对齐 {@code BasePropertiesConverter} MULTIINSTANCESERVICE(:35)。 */
private static final String MULTI_PREFIX = "${multiInstanceUsersHandler.getUsers(execution,'";
private static final String SUFFIX = "')}";
/**
* 办理人/会签项合法 type。<b>权威集 = flowable-service {@code WfTypes} 的 16 个配置类型 + {@code OrgDirectoryJdbc}
* 运行期分派</b>(非 BasePropertiesConverter——它只 setType,不做白名单)。网关不依赖 flowable-service 故此处复刻
* 常量值;<b>WfTypes 新增类型时两处必须同步</b>。此前只列 10 种会 422 误拒含 {@code initiatorDepartManager}
* (实测 24 文档)/{@code fixedDimension}(12 文档)等运行期完全支持的存量流程(from-procdef 载入→编辑无关节点→发布)。
*/
static final Set<String> TYPE_WHITELIST = Set.of(
"user", "roles", "depart", "position", "initiator",
"initiatorDepartManager", "initiatorLeader", "initiatorSubordinate", "initiatorDepart",
"sameToTask", "beforeTaskLeader", "beforeTaskDepartManager",
"fixedDimension", "formSpecifiedDimension", "projectRoleType", "scriptUser");
/** 会签完成条件三预设(与 Eip4Panel.tsx:60-77 逐字一致):全票 / 过半 / 指定数。 */
private static final Pattern COMPLETION_ALL =
Pattern.compile("^\\$\\{nrOfCompletedInstances/nrOfInstances==1\\}$");
private static final Pattern COMPLETION_MAJORITY =
Pattern.compile("^\\$\\{nrOfCompletedInstances/nrOfInstances>0\\.5\\}$");
private static final Pattern COMPLETION_COUNT =
Pattern.compile("^\\$\\{nrOfCompletedInstances>=\\d+\\}$");
/** formKey 存在性查询(bpchar 列比较忽略尾部补白,传裸 UUID 即可,对齐 WfTemplateService.readXml)。 */
static final String FORMKEY_EXISTS_SQL =
"SELECT count(*) FROM view_wftemplate WHERE view_wftemplate_id = ?";
private final JdbcTemplate jdbcTemplate;
private final ObjectMapper objectMapper = new ObjectMapper();
public ModelSemanticValidator(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
/** 校验 bpmn XML,返回错误清单(空=通过)。任何解析异常归一为一条「解析失败」错误,不抛。 */
public List<String> validate(String bpmnXml) {
List<String> errors = new ArrayList<>();
if (bpmnXml == null || bpmnXml.isBlank()) {
errors.add("BPMN 源为空,无法校验");
return errors;
}
Document doc;
try {
doc = parse(bpmnXml);
} catch (Exception e) {
// 含 DOCTYPE(XXE 门 disallow-doctype-decl 抛)/非良构 XML → 统一拒;细节仅进日志,不回显。
log.warn("[发布语义] BPMN 解析失败: {}", e.toString());
errors.add("BPMN 解析失败,无法校验语义");
return errors;
}
for (Element userTask : elementsByLocalName(doc, "userTask")) {
String label = nodeLabel(userTask);
validateHandlerJson(attrByLocalName(userTask, "candidateUsers"), CANDIDATE_PREFIX,
label, "办理人", errors);
validateFormKey(attrByLocalName(userTask, "formKey"), label, errors);
}
for (Element mi : elementsByLocalName(doc, "multiInstanceLoopCharacteristics")) {
String label = enclosingUserTaskLabel(mi);
validateHandlerJson(attrByLocalName(mi, "collection"), MULTI_PREFIX, label, "会签人员", errors);
validateCompletionCondition(mi, label, errors);
}
return errors;
}
// ---------------------------------------------------------------- 校验分项
/**
* 办理人/会签内嵌 JSON 校验:仅当值以 {@code prefix}(EIP4 handler)开头才校验;解析失败/items 空/type 非白名单
* 各追加一条错误(type 逐项报,一个节点多个坏 type 出多条)。
*/
private void validateHandlerJson(String value, String prefix, String label, String role, List<String> errors) {
if (value == null || value.isBlank() || !value.startsWith(prefix)) {
return; // 无配置 或 非 EIP4 handler 裸值:非本校验器职责
}
if (!value.endsWith(SUFFIX)) {
errors.add("节点『" + label + "』的" + role + "表达式格式错误(缺尾部 " + SUFFIX + ")");
return;
}
String content = value.substring(prefix.length(), value.length() - SUFFIX.length());
// 全角【】→半角(对齐 CandidateUsersHandler:54 运行期还原),再 JSON 解析。
String json = content.replace("【", "{").replace("】", "}");
JsonNode root;
try {
root = objectMapper.readTree(json);
} catch (Exception e) {
errors.add("节点『" + label + "』的" + role + "配置 JSON 无法解析");
return;
}
JsonNode items = root.get("items");
if (items == null || !items.isArray() || items.isEmpty()) {
errors.add("节点『" + label + "』的" + role + "为空(items 为空),运行期会异常");
return;
}
for (JsonNode item : items) {
JsonNode type = item.get("type");
if (type == null || !type.isTextual() || !TYPE_WHITELIST.contains(type.asText())) {
errors.add("节点『" + label + "』的" + role + "含非法 type:"
+ (type == null || type.isNull() ? "(缺失)" : type.asText()));
}
}
}
/** formKey 存在性:非空则查 view_wftemplate;不存在报错,读库异常降级放行(记告警)。 */
private void validateFormKey(String formKey, String label, List<String> errors) {
if (formKey == null || formKey.isBlank()) {
return;
}
String key = formKey.trim();
try {
Integer c = jdbcTemplate.queryForObject(FORMKEY_EXISTS_SQL, Integer.class, key);
if (c == null || c == 0) {
errors.add("节点『" + label + "』的表单 formKey 不存在于模板库(view_wftemplate):" + key);
}
} catch (RuntimeException e) {
// 读库抖动不阻断发布(全站降级惯例);该项引用完整性检查跳过并记告警。
log.warn("[发布语义] formKey 存在性校验读库降级(跳过该项) formKey={}: {}", key, e.toString());
}
}
/** 会签完成条件:present+空白=错误;非空放行(非预设仅记 info 告警,保留 T2.4 自定义态)。 */
private void validateCompletionCondition(Element mi, String label, List<String> errors) {
Element cc = firstChildByLocalName(mi, "completionCondition");
if (cc == null) {
return; // 无完成条件:多实例全部完成才结束,合法。
}
String body = cc.getTextContent();
if (body == null || body.isBlank()) {
errors.add("节点『" + label + "』的会签完成条件为空");
return;
}
String trimmed = body.trim();
if (!isPresetCompletion(trimmed)) {
log.info("[发布语义] 节点『{}』会签完成条件为自定义表达式(放行,保留 T2.4 自定义态): {}", label, trimmed);
}
}
private static boolean isPresetCompletion(String body) {
return COMPLETION_ALL.matcher(body).matches()
|| COMPLETION_MAJORITY.matcher(body).matches()
|| COMPLETION_COUNT.matcher(body).matches();
}
// ---------------------------------------------------------------- DOM 小工具(按本地名,兼容前缀/默认命名空间)
private static Document parse(String xml) throws Exception {
DocumentBuilderFactory f = newJdkDbf();
f.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true);
f.setFeature("http://xml.org/sax/features/external-general-entities", false);
f.setFeature("http://xml.org/sax/features/external-parameter-entities", false);
f.setExpandEntityReferences(false);
DocumentBuilder b = f.newDocumentBuilder();
return b.parse(new InputSource(new StringReader(xml)));
}
/** JDK 内置 DocumentBuilderFactory(钉实现类,防 platform-report 上古 xerces 击穿;对齐 WfTemplateService)。 */
private static DocumentBuilderFactory newJdkDbf() {
try {
return DocumentBuilderFactory.newInstance(
"com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl", null);
} catch (Throwable t) {
return DocumentBuilderFactory.newInstance();
}
}
private static List<Element> elementsByLocalName(Document doc, String localName) {
NodeList all = doc.getElementsByTagName("*");
List<Element> out = new ArrayList<>();
for (int i = 0; i < all.getLength(); i++) {
Node n = all.item(i);
if (n.getNodeType() == Node.ELEMENT_NODE && localName.equals(localName(n.getNodeName()))) {
out.add((Element) n);
}
}
return out;
}
/** 取元素下第一个指定本地名的直接子元素。 */
private static Element firstChildByLocalName(Element parent, String localName) {
NodeList children = parent.getChildNodes();
for (int i = 0; i < children.getLength(); i++) {
Node n = children.item(i);
if (n.getNodeType() == Node.ELEMENT_NODE && localName.equals(localName(n.getNodeName()))) {
return (Element) n;
}
}
return null;
}
/** 按本地名取属性值(兼容 {@code activiti:}/{@code flowable:} 前缀与无前缀),无则 null。 */
private static String attrByLocalName(Element e, String localName) {
NamedNodeMap attrs = e.getAttributes();
for (int i = 0; i < attrs.getLength(); i++) {
Node a = attrs.item(i);
if (localName.equals(localName(a.getNodeName()))) {
String v = a.getNodeValue();
return v == null || v.isEmpty() ? null : v;
}
}
return null;
}
/** 上溯到最近的 userTask 祖先取其名(会签 collection/完成条件的节点上下文)。 */
private static String enclosingUserTaskLabel(Element mi) {
Node p = mi.getParentNode();
while (p != null && p.getNodeType() == Node.ELEMENT_NODE) {
if ("userTask".equals(localName(p.getNodeName()))) {
return nodeLabel((Element) p);
}
p = p.getParentNode();
}
return "会签节点";
}
private static String nodeLabel(Element e) {
String name = attrByLocalName(e, "name");
if (name != null && !name.isBlank()) {
return name;
}
String id = attrByLocalName(e, "id");
return id != null && !id.isBlank() ? id : "(未命名节点)";
}
private static String localName(String qname) {
int c = qname.indexOf(':');
return c < 0 ? qname : qname.substring(c + 1);
}
}

View File

@@ -0,0 +1,80 @@
package com.eip4.platform.flowgateway.aggregate;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.core.RowMapper;
import org.springframework.stereotype.Service;
/**
* wftemplate 选择器数据源:为在线流程 Modeler 的办理人/会签 formKey 下拉提供 {@code {id,name}} 列表。
*
* <p><b>为何是 Service 而非控制器直查</b>:{@code @RestController} 直持 {@link JdbcTemplate} 拼 SQL 会让
* 现代层退化成第二个「SQL 散落层」(架构棘轮 {@code 控制器不得新增直用JdbcTemplate} 禁止新增此类),
* 故 SQL 收口到本 Service,控制器只保留超管门 + 透传。</p>
*
* <p><b>名称来源实证(information_schema)</b>:{@code view_wftemplate}(1016 行已迁移)<b>无独立名称列</b>
* (仅 {@code view_wftemplate_id CHAR + xml + isactive + 审计列}),{@code <form>} 根标签也无 title/name
* 属性(0/1016);唯一人类可读名来自 XML 的 {@code entityid} → {@code sys_entity.name}(378 模板带 entityid,
* 339 解析出中文名,如「通知管理」)。故 name = 解析出的实体名,无则回退 id;{@code view_wftemplate_id} 是
* CHAR 补白列 → RowMapper 内 trim。读库异常降级({@code degraded:true}),不 500 阻断设计器。</p>
*/
@Service
public class WfTemplatePickerService {
private static final Logger log = LoggerFactory.getLogger(WfTemplatePickerService.class);
/** 选择器 SQL:view_wftemplate_id + entityid→sys_entity.name(LEFT JOIN + 正则抽 entityid),isactive=1,名称升序。 */
static final String WFTEMPLATES_SQL =
"SELECT t.view_wftemplate_id AS id, se.name AS name "
+ "FROM view_wftemplate t "
+ "LEFT JOIN sys_entity se "
+ " ON se.sys_entity_id = substring(CAST(t.xml AS text) FROM 'entityid=\"([0-9a-fA-F-]+)\"') "
+ "WHERE t.isactive = 1 "
+ "ORDER BY se.name NULLS LAST, t.view_wftemplate_id";
/** 单行 → {@code {id(trim 补白),name(实体名,空则回退 id)}}。 */
static final RowMapper<Map<String, Object>> WFTEMPLATE_ROW = (rs, rowNum) -> {
String id = rs.getString("id");
if (id != null) {
id = id.trim();
}
String name = rs.getString("name");
Map<String, Object> row = new LinkedHashMap<>();
row.put("id", id);
row.put("name", (name != null && !name.isBlank()) ? name : id);
return row;
};
private final JdbcTemplate jdbcTemplate;
public WfTemplatePickerService(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
/**
* 选择器列表。正常 → {@code {templates:[{id,name}]}};读库异常降级 → {@code {templates:[], degraded:true}}
* (正常路径<b>不带</b> degraded 键,前端可据此区分「真无模板」与「读库失败」并提示重试)。
*/
public Map<String, Object> listTemplates() {
List<Map<String, Object>> templates;
boolean degraded = false;
try {
templates = jdbcTemplate.query(WFTEMPLATES_SQL, WFTEMPLATE_ROW);
} catch (RuntimeException e) {
log.warn("view_wftemplate 选择器读取降级为空列表: {}", e.toString());
templates = List.of();
degraded = true;
}
Map<String, Object> resp = new LinkedHashMap<>();
resp.put("templates", templates);
if (degraded) {
resp.put("degraded", true);
}
return resp;
}
}

View File

@@ -110,10 +110,23 @@ public class WfTemplateService {
} }
} }
/** JAXP 1.4 兼容的 DocumentBuilderFactory:钉到 JDK 内置实现,绕开 platform-report(jatools)带入的
* 上古 xerces-eip3.jar(2004) —— 后者不实现 setFeature(JAXP 1.4),classpath 发现机制选中它会致
* AbstractMethodError,击穿 WfTemplate 全部 XML 解析。显式指定 JDK 实现类(总在),不删/不动 report 的 xerces。 */
private static DocumentBuilderFactory newJdkDbf() {
try {
return DocumentBuilderFactory.newInstance(
"com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl", null);
} catch (Throwable t) {
// 极端兜底:JDK 实现类不可用时回退默认发现(正常 JDK 21 不会走到这)
return DocumentBuilderFactory.newInstance();
}
}
/** DOM 解析模板 XML(禁 DOCTYPE/外部实体,防 XXE)。public 供单测直接验证解析(纯函数)。 */ /** DOM 解析模板 XML(禁 DOCTYPE/外部实体,防 XXE)。public 供单测直接验证解析(纯函数)。 */
public WfTemplateMeta parseXml(String xml) { public WfTemplateMeta parseXml(String xml) {
try { try {
DocumentBuilderFactory f = DocumentBuilderFactory.newInstance(); DocumentBuilderFactory f = newJdkDbf();
f.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true); f.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true);
f.setFeature("http://xml.org/sax/features/external-general-entities", false); f.setFeature("http://xml.org/sax/features/external-general-entities", false);
f.setFeature("http://xml.org/sax/features/external-parameter-entities", false); f.setFeature("http://xml.org/sax/features/external-parameter-entities", false);

View File

@@ -19,4 +19,10 @@ public class ApprovalContextDto {
public String businessKey; public String businessKey;
public boolean ended; public boolean ended;
public boolean suspended; public boolean suspended;
/** 是否会签(BPMN 多实例)任务。 */
public boolean cosign;
/** 会签总人数。 */
public int cosignTotal;
/** 会签已完成人数。 */
public int cosignCompleted;
} }

View File

@@ -8,17 +8,33 @@ import org.springframework.http.HttpStatusCode;
* <p>与 {@link FlowServiceUnavailableException} 区分:那个是"引擎进程不可达"(→ 503); * <p>与 {@link FlowServiceUnavailableException} 区分:那个是"引擎进程不可达"(→ 503);
* 这个是"引擎在线但拒绝了这次操作"(原状态码透传给调用方,保留 Flowable 语义, * 这个是"引擎在线但拒绝了这次操作"(原状态码透传给调用方,保留 Flowable 语义,
* 如挂起拒办 409、参数错 400)。 * 如挂起拒办 409、参数错 400)。
*
* <p><b>responseBody(可空)</b>:携带下游原始响应体,供 {@code FlowGatewayExceptionHandler} 透传结构化错误
* ——如流程发布下游 422 的 {@code {errors:[{activityId,problem,defaultDescription}]}}(引擎 ProcessValidator 结构校验)
* 需并入网关响应,与网关语义校验 422 的顶层 {@code errors} 契约统一(T3.2 评审 I-2:此前只留状态码丢体,
* 结构化错误到不了前端)。旧两参构造(无体)保留,非发布路径不受影响。
*/ */
public class FlowRemoteException extends RuntimeException { public class FlowRemoteException extends RuntimeException {
private final HttpStatusCode status; private final HttpStatusCode status;
private final String responseBody;
public FlowRemoteException(HttpStatusCode status, String message) { public FlowRemoteException(HttpStatusCode status, String message) {
this(status, message, null);
}
public FlowRemoteException(HttpStatusCode status, String message, String responseBody) {
super(message); super(message);
this.status = status; this.status = status;
this.responseBody = responseBody;
} }
public HttpStatusCode getStatus() { public HttpStatusCode getStatus() {
return status; return status;
} }
/** 下游原始响应体(可空);供 handler 解析并透传结构化 errors。 */
public String getResponseBody() {
return responseBody;
}
} }

View File

@@ -170,6 +170,36 @@ public class FlowableClient {
Map.of("delegateUserId", delegateUserId), Void.class); Map.of("delegateUserId", delegateUserId), Void.class);
} }
/**
* 协办(加签):为每个 userId 建一条子任务。对应 flowable-service
* {@code POST /api/flow/tasks/{taskId}/assist}。
*/
@SuppressWarnings("unchecked")
public Map<String, Object> assist(String taskId, List<String> userIds, String comment) {
return post("协办", "/api/flow/tasks/" + taskId + "/assist",
actionBody(userIds, comment), Map.class);
}
/**
* 转阅(抄送):为每个 userId 建一条只读转阅任务。对应 flowable-service
* {@code POST /api/flow/tasks/{taskId}/circulate}。
*/
@SuppressWarnings("unchecked")
public Map<String, Object> circulate(String taskId, List<String> userIds, String comment) {
return post("转阅", "/api/flow/tasks/" + taskId + "/circulate",
actionBody(userIds, comment), Map.class);
}
/** 协办/转阅请求体:targetUserIds(必) + comment(可空)。 */
private static Map<String, Object> actionBody(List<String> userIds, String comment) {
Map<String, Object> body = new java.util.LinkedHashMap<>();
body.put("targetUserIds", userIds == null ? List.of() : userIds);
if (comment != null && !comment.isBlank()) {
body.put("comment", comment);
}
return body;
}
/** /**
* 查流程实例(供办理后判定是否结束以回写业务状态)。 * 查流程实例(供办理后判定是否结束以回写业务状态)。
* 实例不存在(404)返回 null;运行中 {@code ended=false},已结束 {@code ended=true}。 * 实例不存在(404)返回 null;运行中 {@code ended=false},已结束 {@code ended=true}。
@@ -184,6 +214,149 @@ public class FlowableClient {
.body(ProcessInstanceDto.class)); .body(ProcessInstanceDto.class));
} }
/**
* 流程图数据(BPMN XML + 当前/历史节点)。对应 flowable-service
* {@code GET /api/flow/process/{processInstanceId}/diagram}。供前端 bpmn-js 渲染高亮。
*/
@SuppressWarnings("unchecked")
public Map<String, Object> diagram(String processInstanceId) {
return execute("流程图", () -> restClient.get()
.uri("/api/flow/process/{id}/diagram", processInstanceId)
.retrieve()
.body(Map.class));
}
/**
* 按流程定义 id 取净化源 XML(供 bpmn-js Modeler 在线编辑载入)。对应 flowable-service
* {@code GET /api/flow/process-definitions/{procDefId}/source},返回体
* {@code {procDefId, found, bpmnXml(净化后), idMap(原id→净化id), procDefKey, version}}。
*
* <p><b>中文 procDefId 编码</b>:真实 procDefId 形如 {@code 总包合同交底:3:<uuid>}(中文 key + 冒号)。
* procDefId 作为 uri 变量传入({@code .uri(template, procDefId)}),由 {@code RestClient} 严格编码
* (中文 percent 编码、冒号 → {@code %3A});<b>绝不字符串拼 URL</b>(拼接会把冒号当分隔符裸传,
* 且中文可能编码不一致)。
*/
@SuppressWarnings("unchecked")
public Map<String, Object> procDefSource(String procDefId) {
return execute("流程源", () -> restClient.get()
.uri("/api/flow/process-definitions/{id}/source", procDefId)
.retrieve()
.body(Map.class));
}
/**
* 按流程 key 取最新版净化源 XML(供 Modeler 打开器按真流程 key 载入)。对应 flowable-service
* {@code GET /api/flow/process-definitions/by-key/{key}/source},返回体与 {@link #procDefSource} 同形状。
*
* <p>process-select 的 {@code source='model'} 选项 id 是 act_re_model id 而非 procDefId,
* by-id 端点永远 {@code found:false} → 打开器改用真流程 key 走本路。key 同样作为 uri 变量严格编码
* (纯中文 key percent 编码),<b>绝不字符串拼 URL</b>。
*/
@SuppressWarnings("unchecked")
public Map<String, Object> procDefSourceByKey(String key) {
return execute("流程源(按key)", () -> restClient.get()
.uri("/api/flow/process-definitions/by-key/{key}/source", key)
.retrieve()
.body(Map.class));
}
// ---------------------------------------------------------------- 草稿 Model API 转发(T2.2)
/**
* 草稿列表。对应 flowable-service {@code GET /api/flow/models},返回体
* {@code {models:[{id,name,key,lastUpdateTime}]}} 原样透传(flowable-service 已按 EIP4 分类过滤)。
*/
@SuppressWarnings("unchecked")
public Map<String, Object> listModels() {
return execute("草稿列表", () -> restClient.get()
.uri("/api/flow/models")
.retrieve()
.body(Map.class));
}
/**
* 取草稿(editorSource + metaInfo)。对应 flowable-service {@code GET /api/flow/models/{id}},返回体
* {@code {found,id,name,key,bpmnXml,metaInfo}} 原样透传;草稿不存在下游返 {@code found:false}。
*
* <p>{@code id} 走 uri 模板变量严格编码(禁字符串拼接)。</p>
*/
@SuppressWarnings("unchecked")
public Map<String, Object> getModel(String id) {
return execute("取草稿", () -> restClient.get()
.uri("/api/flow/models/{id}", id)
.retrieve()
.body(Map.class));
}
/**
* 建草稿。对应 flowable-service {@code POST /api/flow/models},请求体 {@code {name,key,bpmnXml,metaInfo?}}
* 经 Jackson 序列化转发,返回 {@code {modelId}};坏 XML 下游 422 → {@link FlowRemoteException} 透传。
*/
@SuppressWarnings("unchecked")
public Map<String, Object> createModel(Object body) {
return post("建草稿", "/api/flow/models", body, Map.class);
}
/**
* 更新草稿。对应 flowable-service {@code PUT /api/flow/models/{id}},请求体 {@code {name?,bpmnXml,metaInfo?}}
* 经 Jackson 序列化转发,返回 {@code {status:0}};草稿不存在下游 404 / 坏 XML 422 → {@link FlowRemoteException} 透传。
*
* <p>{@code id} 走 uri 模板变量严格编码(禁字符串拼接)。</p>
*/
@SuppressWarnings("unchecked")
public Map<String, Object> updateModel(String id, Object body) {
return put("更新草稿", "/api/flow/models/{id}", body, Map.class, id);
}
/**
* 从流程定义建草稿。对应 flowable-service {@code POST /api/flow/models/from-procdef},请求体
* {@code {procDefId}} 经 Jackson 序列化转发,返回 {@code {modelId}};procDef 不存在下游返 {@code found:false}。
*/
@SuppressWarnings("unchecked")
public Map<String, Object> modelFromProcDef(Object body) {
return post("从流程定义建草稿", "/api/flow/models/from-procdef", body, Map.class);
}
/**
* 删草稿。对应 flowable-service {@code DELETE /api/flow/models/{id}},返回 {@code {status:0}};
* 草稿不存在下游 404 → {@link FlowRemoteException} 透传。
*
* <p>{@code id} 走 uri 模板变量严格编码(禁字符串拼接)。DELETE 幂等——{@link #execute} 连接级重试安全
* (重放同一 DELETE 落到同一 id,删已删=下游 404,不产生额外副作用)。</p>
*/
@SuppressWarnings("unchecked")
public Map<String, Object> deleteModel(String id) {
return delete("删草稿", "/api/flow/models/{id}", Map.class, id);
}
/**
* 发布草稿为流程定义(T3.2)。对应 flowable-service {@code POST /api/flow/models/{id}/deploy},无请求体,
* 返回 {@code {status:0,deploymentId,processKey,newVersion}};下游 ProcessValidator 拒 → 422 /
* 草稿不存在 → 404 → {@link FlowRemoteException} 透传。{@code id} 走 uri 模板变量严格编码(禁字符串拼接)。
*
* <p><b>幂等性</b>:部署<b>非幂等</b>(每次 deploy 产生新版本)——{@link #execute} 的连接级重试存在重复部署窗口
* (产生 vN 与 vN+1 内容相同的冗余版本)。接受该风险:①网关↔flowable-service 同机链路,连接级瞬时故障概率极低;
* ②冗余新版本无害(运行中实例留旧版本,新起用 latest);③语义级 4xx/5xx(校验拒)由 {@link #execute} 保证
* <b>绝不</b>重试,故校验失败无重复窗口。发布前网关 {@code ModelSemanticValidator} 已挡住绝大多数坏草稿。</p>
*/
@SuppressWarnings("unchecked")
public Map<String, Object> deployModel(String id) {
return post("发布草稿", "/api/flow/models/{id}/deploy", Map.of(), Map.class, id);
}
/**
* 发布影响摘要(T3.2)。对应 flowable-service {@code GET /api/flow/models/{id}/impact},返回
* {@code {processKey,currentVersion,runningInstances}};草稿不存在 → 404 {@link FlowRemoteException} 透传。
* {@code id} 走 uri 模板变量严格编码(禁字符串拼接)。
*/
@SuppressWarnings("unchecked")
public Map<String, Object> modelImpact(String id) {
return execute("发布影响", () -> restClient.get()
.uri("/api/flow/models/{id}/impact", id)
.retrieve()
.body(Map.class));
}
/** 按发起人查询历史流程实例。对应 flowable-service {@code GET /api/flow/process/started}。 */ /** 按发起人查询历史流程实例。对应 flowable-service {@code GET /api/flow/process/started}。 */
public List<ProcessInstanceDto> started(String startedBy, int firstResult, int maxResults) { public List<ProcessInstanceDto> started(String startedBy, int firstResult, int maxResults) {
return execute("发起流程列表", () -> restClient.get() return execute("发起流程列表", () -> restClient.get()
@@ -235,6 +408,12 @@ public class FlowableClient {
.body(TASK_LIST)); .body(TASK_LIST));
} }
/**
* POST 转发。<b>幂等性</b>:POST 非幂等——{@link #execute} 的<b>连接级</b>重试(连不上/读超时后重放)
* 存在重复创建窗口。接受该风险的理由:①草稿创建廉价且可覆盖(重复草稿人工删即可,非扣款类不可逆副作用);
* ②本地网关↔flowable-service 同机链路,连接级瞬时故障概率极低。语义级 4xx/5xx 由 {@link #execute} 保证
* <b>绝不</b>重试,故业务错无重复窗口。对比 {@link #put}(覆盖写幂等,重试安全)。
*/
private <T> T post(String op, String path, Object body, Class<T> respType) { private <T> T post(String op, String path, Object body, Class<T> respType) {
return execute(op, () -> restClient.post() return execute(op, () -> restClient.post()
.uri(path) .uri(path)
@@ -251,6 +430,46 @@ public class FlowableClient {
.body(respType)); .body(respType));
} }
/**
* POST 转发(uri 模板 + 变量版):{@code uriTemplate}+{@code uriVars} 走 RestClient 严格编码
* ({@code id} 作 uri 变量,禁字符串拼接)。谓词固定 POST 但路径含变量段(如 {@code /models/{id}/deploy})。
* 幂等性/重试语义与四参 {@link #post(String, String, Object, Class)} 一致(非幂等,连接级重试有重复窗口);
* 具体端点的重复风险由调用方 javadoc 声明。四参调用因固定元数优先绑定,不与本重载歧义。
*/
private <T> T post(String op, String uriTemplate, Object body, Class<T> respType, Object... uriVars) {
return execute(op, () -> restClient.post()
.uri(uriTemplate, uriVars)
.body(body == null ? Map.of() : body)
.retrieve()
.body(respType));
}
/**
* PUT 转发(RestClient 无既有封装 → 照 {@link #post} 补)。{@code uriTemplate}+{@code uriVars} 走 RestClient
* 严格编码({@code id} 作 uri 变量,禁字符串拼接);连接级重试 + 4xx/5xx 透传语义与 post 一致。
*
* <p><b>幂等性</b>:PUT 是覆盖写、天然幂等 → {@link #execute} 的连接级重试<b>安全</b>(重放同一 PUT 落到同一
* 草稿 id,不产生额外副作用),无 {@link #post} 那种重复创建窗口。</p>
*/
private <T> T put(String op, String uriTemplate, Object body, Class<T> respType, Object... uriVars) {
return execute(op, () -> restClient.put()
.uri(uriTemplate, uriVars)
.body(body == null ? Map.of() : body)
.retrieve()
.body(respType));
}
/**
* DELETE 转发(RestClient 无既有封装 → 照 {@link #put} 补)。{@code uriTemplate}+{@code uriVars} 走 RestClient
* 严格编码({@code id} 作 uri 变量,禁字符串拼接);无请求体;连接级重试 + 4xx/5xx 透传语义与 put 一致(幂等)。
*/
private <T> T delete(String op, String uriTemplate, Class<T> respType, Object... uriVars) {
return execute(op, () -> restClient.delete()
.uri(uriTemplate, uriVars)
.retrieve()
.body(respType));
}
/** /**
* 统一执行:连接级故障带退避重试 maxRetries 次,耗尽 → 503 语义;业务错(4xx/5xx)立即透传不重试。 * 统一执行:连接级故障带退避重试 maxRetries 次,耗尽 → 503 语义;业务错(4xx/5xx)立即透传不重试。
*/ */
@@ -271,10 +490,12 @@ public class FlowableClient {
sleepBackoff(); sleepBackoff();
} }
} catch (RestClientResponseException e) { } catch (RestClientResponseException e) {
// 业务级:引擎在线但返回 4xx/5xx(如挂起拒办 409)——透传原状态码,绝不重试 // 业务级:引擎在线但返回 4xx/5xx(如挂起拒办 409)——透传原状态码,绝不重试。
// 携带原始响应体:发布下游 422 的结构化 errors(activityId/problem) 交 handler 并入网关响应(评审 I-2)。
HttpStatusCode status = e.getStatusCode(); HttpStatusCode status = e.getStatusCode();
log.debug("flowable-service {}调用返回业务状态 {}: {}", op, status, e.getMessage()); log.debug("flowable-service {}调用返回业务状态 {}: {}", op, status, e.getMessage());
throw new FlowRemoteException(status, "flowable-service " + op + "返回 " + status.value()); throw new FlowRemoteException(status, "flowable-service " + op + "返回 " + status.value(),
e.getResponseBodyAsString());
} }
} }
// 重试耗尽仍连不上 —— 熔断降级为 503 语义 // 重试耗尽仍连不上 —— 熔断降级为 503 语义

View File

@@ -117,6 +117,10 @@ public class ApprovalController {
resp.put("processInstanceId", ctx == null ? null : ctx.processInstanceId); resp.put("processInstanceId", ctx == null ? null : ctx.processInstanceId);
resp.put("ended", ctx != null && ctx.ended); resp.put("ended", ctx != null && ctx.ended);
resp.put("suspended", ctx != null && ctx.suspended); resp.put("suspended", ctx != null && ctx.suspended);
// 会签(多实例)进度:前端显「已会签 N/M」
resp.put("cosign", ctx != null && ctx.cosign);
resp.put("cosignTotal", ctx == null ? 0 : ctx.cosignTotal);
resp.put("cosignCompleted", ctx == null ? 0 : ctx.cosignCompleted);
// 业务表单页面:生效表单模板(任务/开始节点)的 pageid 命中 sys_page_schema 优先——即老审批页用的同一张页面; // 业务表单页面:生效表单模板(任务/开始节点)的 pageid 命中 sys_page_schema 优先——即老审批页用的同一张页面;
// 都没有再退该业务表标准 editform。前端据此渲染只读业务单据。 // 都没有再退该业务表标准 editform。前端据此渲染只读业务单据。
@@ -203,7 +207,8 @@ public class ApprovalController {
@Operation(summary = "审批动作分派(按 WfTemplate 按钮 type)", @Operation(summary = "审批动作分派(按 WfTemplate 按钮 type)",
description = "approve=complete+回写 SYS_DATASTATUS(结束 3/未结束 2);reject=终止流程+回写 4;" description = "approve=complete+回写 SYS_DATASTATUS(结束 3/未结束 2);reject=终止流程+回写 4;"
+ "reback=退回发起+回写 5;agent=委托给 targetUserId。协办/转阅暂未实现(返回 400)。") + "reback=退回发起+回写 5;agent=委托给 targetUserId;assist=协办(为 targetUserIds 各建子任务);"
+ "circulated=转阅(为 targetUserIds 各建只读转阅任务)。")
@PostMapping("/api/task/{taskId}/action") @PostMapping("/api/task/{taskId}/action")
public ResponseEntity<Map<String, Object>> action(@PathVariable String taskId, public ResponseEntity<Map<String, Object>> action(@PathVariable String taskId,
@RequestBody GatewayRequests.ApprovalActionRequest req) { @RequestBody GatewayRequests.ApprovalActionRequest req) {
@@ -224,7 +229,8 @@ public class ApprovalController {
case "reject" -> reject(taskId, req); case "reject" -> reject(taskId, req);
case "reback" -> reback(taskId, req); case "reback" -> reback(taskId, req);
case "agent" -> agent(taskId, req); case "agent" -> agent(taskId, req);
case "assist", "circulated" -> badRequest("暂不支持「" + labelOf(type) + "」,请用转办(agent)"); case "assist" -> assist(taskId, req);
case "circulated" -> circulate(taskId, req);
default -> badRequest("未知审批动作: " + type); default -> badRequest("未知审批动作: " + type);
}; };
} }
@@ -313,7 +319,7 @@ public class ApprovalController {
private ResponseEntity<Map<String, Object>> approve(String taskId, GatewayRequests.ApprovalActionRequest req) { private ResponseEntity<Map<String, Object>> approve(String taskId, GatewayRequests.ApprovalActionRequest req) {
Map<String, Object> vars = new LinkedHashMap<>(); Map<String, Object> vars = new LinkedHashMap<>();
vars.put("approveResult", "agree"); vars.put("approveResult", "agree");
flowableClient.complete(taskId, vars, req.comment); flowableClient.complete(taskId, vars, agreeComment(req.comment));
boolean ended = isProcessEnded(req.processInstanceId); boolean ended = isProcessEnded(req.processInstanceId);
String table = resolveTable(req.tableName, req.businessKey); String table = resolveTable(req.tableName, req.businessKey);
@@ -326,6 +332,19 @@ public class ApprovalController {
return ResponseEntity.ok(r); return ResponseEntity.ok(r);
} }
/**
* 「同意」审批意见归一:保证以「同意」开头,对齐老系统并使报表审批段可见
* (报表 SQL 按 {@code message_ LIKE '同意%'} 匹配、{@code regexp_replace(message_,'^同意:|^同意','')} 取意见)。
* 空意见 → {@code "同意"};已以「同意」开头 → 原样;否则 → {@code "同意:" + 意见}。
*/
static String agreeComment(String opinion) {
String s = opinion == null ? "" : opinion.trim();
if (s.isEmpty()) {
return "同意";
}
return s.startsWith("同意") ? s : "同意:" + s;
}
/** 拒绝:终止流程(引擎 deleteProcessInstance)+回写 SYS_DATASTATUS=4(驳回)。 */ /** 拒绝:终止流程(引擎 deleteProcessInstance)+回写 SYS_DATASTATUS=4(驳回)。 */
private ResponseEntity<Map<String, Object>> reject(String taskId, GatewayRequests.ApprovalActionRequest req) { private ResponseEntity<Map<String, Object>> reject(String taskId, GatewayRequests.ApprovalActionRequest req) {
Map<String, Object> engine = flowableClient.reject(taskId, req.comment); Map<String, Object> engine = flowableClient.reject(taskId, req.comment);
@@ -364,6 +383,50 @@ public class ApprovalController {
return ResponseEntity.ok(r); return ResponseEntity.ok(r);
} }
/** 协办(加签):为每个目标用户建一条子任务(引擎 createSubTask),不阻断主任务。 */
private ResponseEntity<Map<String, Object>> assist(String taskId, GatewayRequests.ApprovalActionRequest req) {
List<String> users = targetUsers(req);
if (users.isEmpty()) {
return badRequest("协办需指定 targetUserIds");
}
Map<String, Object> engine = flowableClient.assist(taskId, users, req.comment);
Map<String, Object> r = ok("assist");
r.put("assisted", true);
r.put("count", engine != null ? engine.get("count") : users.size());
r.put("targetUserIds", users);
return ResponseEntity.ok(r);
}
/** 转阅(抄送):为每个目标用户建一条只读转阅任务(引擎 createNewTask),不推进主流程。 */
private ResponseEntity<Map<String, Object>> circulate(String taskId, GatewayRequests.ApprovalActionRequest req) {
List<String> users = targetUsers(req);
if (users.isEmpty()) {
return badRequest("转阅需指定 targetUserIds");
}
Map<String, Object> engine = flowableClient.circulate(taskId, users, req.comment);
Map<String, Object> r = ok("circulated");
r.put("circulated", true);
r.put("count", engine != null ? engine.get("count") : users.size());
r.put("targetUserIds", users);
return ResponseEntity.ok(r);
}
/** 协办/转阅目标用户:优先 targetUserIds 列表,回退单个 targetUserId;去空白去重。 */
private static List<String> targetUsers(GatewayRequests.ApprovalActionRequest req) {
java.util.LinkedHashSet<String> set = new java.util.LinkedHashSet<>();
if (req.targetUserIds != null) {
for (String u : req.targetUserIds) {
if (u != null && !u.isBlank()) {
set.add(u.trim());
}
}
}
if (req.targetUserId != null && !req.targetUserId.isBlank()) {
set.add(req.targetUserId.trim());
}
return new ArrayList<>(set);
}
// ---------------------------------------------------------------- 小工具 // ---------------------------------------------------------------- 小工具
/** 直接回写业务状态(reject/reback 是显式终态转移,不走单调守卫)。businessKey 空则不写。 */ /** 直接回写业务状态(reject/reback 是显式终态转移,不走单调守卫)。businessKey 空则不写。 */
@@ -476,8 +539,4 @@ public class ApprovalController {
Object v = m == null ? null : m.get(key); Object v = m == null ? null : m.get(key);
return v == null ? null : String.valueOf(v); return v == null ? null : String.valueOf(v);
} }
private static String labelOf(String type) {
return "assist".equals(type) ? "协办" : "转阅";
}
} }

View File

@@ -1,7 +1,10 @@
package com.eip4.platform.flowgateway.web; package com.eip4.platform.flowgateway.web;
import java.util.LinkedHashMap;
import java.util.Map; import java.util.Map;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.http.HttpStatus; import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.ExceptionHandler;
@@ -9,6 +12,8 @@ import org.springframework.web.bind.annotation.RestControllerAdvice;
import com.eip4.platform.flowgateway.client.FlowRemoteException; import com.eip4.platform.flowgateway.client.FlowRemoteException;
import com.eip4.platform.flowgateway.client.FlowServiceUnavailableException; import com.eip4.platform.flowgateway.client.FlowServiceUnavailableException;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
/** /**
* 流程网关异常 → 干净 HTTP 语义(只管本网关 client 抛出的两类异常,不拦其他)。 * 流程网关异常 → 干净 HTTP 语义(只管本网关 client 抛出的两类异常,不拦其他)。
@@ -17,12 +22,17 @@ import com.eip4.platform.flowgateway.client.FlowServiceUnavailableException;
* <li>{@link FlowServiceUnavailableException}(引擎进程不可达,重试耗尽)→ <b>503</b> * <li>{@link FlowServiceUnavailableException}(引擎进程不可达,重试耗尽)→ <b>503</b>
* Service Unavailable —— 待办聚合在引擎宕机/网络分区时返回明确的服务不可用语义,而非 500 堆栈。</li> * Service Unavailable —— 待办聚合在引擎宕机/网络分区时返回明确的服务不可用语义,而非 500 堆栈。</li>
* <li>{@link FlowRemoteException}(引擎在线但拒绝,如挂起拒办 409)→ <b>透传原状态码</b>, * <li>{@link FlowRemoteException}(引擎在线但拒绝,如挂起拒办 409)→ <b>透传原状态码</b>,
* 保留 Flowable 语义。</li> * 保留 Flowable 语义;若下游响应体带结构化 {@code errors} 数组(如发布 422 的引擎结构校验错误
* {@code [{activityId,problem,defaultDescription}]}),<b>并入</b>网关响应顶层 {@code errors},
* 与网关语义校验 422 的顶层 {@code errors} 契约统一(评审 I-2)。</li>
* </ul> * </ul>
*/ */
@RestControllerAdvice(basePackages = "com.eip4.platform.flowgateway") @RestControllerAdvice(basePackages = "com.eip4.platform.flowgateway")
public class FlowGatewayExceptionHandler { public class FlowGatewayExceptionHandler {
private static final Logger log = LoggerFactory.getLogger(FlowGatewayExceptionHandler.class);
private static final ObjectMapper MAPPER = new ObjectMapper();
@ExceptionHandler(FlowServiceUnavailableException.class) @ExceptionHandler(FlowServiceUnavailableException.class)
public ResponseEntity<Map<String, Object>> onUnavailable(FlowServiceUnavailableException e) { public ResponseEntity<Map<String, Object>> onUnavailable(FlowServiceUnavailableException e) {
return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE) return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE)
@@ -34,10 +44,33 @@ public class FlowGatewayExceptionHandler {
@ExceptionHandler(FlowRemoteException.class) @ExceptionHandler(FlowRemoteException.class)
public ResponseEntity<Map<String, Object>> onRemote(FlowRemoteException e) { public ResponseEntity<Map<String, Object>> onRemote(FlowRemoteException e) {
return ResponseEntity.status(e.getStatus()) Map<String, Object> body = new LinkedHashMap<>();
.body(Map.of( body.put("status", e.getStatus().value());
"status", e.getStatus().value(), body.put("error", "FLOW_REMOTE_ERROR");
"error", "FLOW_REMOTE_ERROR", body.put("message", e.getMessage());
"message", e.getMessage())); Object errors = extractErrors(e.getResponseBody());
if (errors != null) {
body.put("errors", errors);
}
return ResponseEntity.status(e.getStatus()).body(body);
}
/**
* 从下游原始响应体抽结构化 {@code errors} 数组(非空才返回)。下游体非 JSON / 无 errors / 空数组 → null
* (回原 FLOW_REMOTE_ERROR 信封,不加 errors 键)。防御性:解析失败静默降级,不让异常翻译再抛异常。
*/
private static Object extractErrors(String responseBody) {
if (responseBody == null || responseBody.isBlank()) {
return null;
}
try {
JsonNode errors = MAPPER.readTree(responseBody).get("errors");
if (errors != null && errors.isArray() && !errors.isEmpty()) {
return MAPPER.convertValue(errors, Object.class);
}
} catch (Exception ex) {
log.debug("下游响应体非 JSON 或无 errors,回原信封: {}", ex.toString());
}
return null;
} }
} }

View File

@@ -50,8 +50,10 @@ public final class GatewayRequests {
/** WfTemplate 按钮 id:服务器侧据此重解析该按钮的 servicename(自定义服务流)并执行,不信前端直传服务名。 */ /** WfTemplate 按钮 id:服务器侧据此重解析该按钮的 servicename(自定义服务流)并执行,不信前端直传服务名。 */
public String buttonId; public String buttonId;
public String comment; public String comment;
/** 转办/协办/转阅的目标用户。 */ /** 转办的目标用户(单人)。 */
public String targetUserId; public String targetUserId;
/** 协办/转阅的目标用户(多人,老系统用 MultiSelectField 选多人,各建一条子/转阅任务)。 */
public java.util.List<String> targetUserIds;
public String businessKey; public String businessKey;
public String processInstanceId; public String processInstanceId;
public String tableName; public String tableName;

View File

@@ -0,0 +1,266 @@
package com.eip4.platform.flowgateway.web;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.security.core.annotation.AuthenticationPrincipal;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import com.eip4.platform.auth.security.AuthPrincipal;
import com.eip4.platform.auth.security.EngineContextBinder;
import com.eip4.platform.flowgateway.aggregate.FlowDeployAuditService;
import com.eip4.platform.flowgateway.aggregate.ModelSemanticValidator;
import com.eip4.platform.flowgateway.aggregate.WfTemplatePickerService;
import com.eip4.platform.flowgateway.client.FlowableClient;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
/**
* 在线流程 Modeler 网关门面:把 flowable-service 的流程定义/草稿能力经<b>超管门</b>暴露给设计器前端。
*
* <p>flowable-service 裸 8089 无 Spring Security → 流程编辑/部署面的鉴权唯一落点在本网关层。
* 本控制器所有端点先过超管门({@link #requireSuperAdmin},委托 {@link EngineContextBinder#isSystemAdmin},
* 与全站 {@code requireAdmin} 逐口径对齐),非超管返回 403,过门后转发 {@link FlowableClient},返回体原样透传。
*
* <p>阶段 1(T1.6):只读载入存量流程源 XML。阶段 2(T2.2):草稿 CRUD 五端点转发(list/get/create/update/
* from-procdef,对齐 flowable-service {@code ProcessModelController} 契约)+ 办理人/会签 formKey 选择器数据源
* {@code /wftemplates}(读业务库 {@code view_wftemplate})。发布门在阶段 3 接入。</p>
*/
@Tag(name = "流程 Modeler 网关", description = "流程设计器:超管门 + flowable-service 转发(存量源载入/草稿/发布)")
@RestController
@RequestMapping("/api/workflow")
public class ProcessModelerController {
private final FlowableClient flowableClient;
private final WfTemplatePickerService wfTemplatePickerService;
private final ModelSemanticValidator semanticValidator;
private final FlowDeployAuditService deployAuditService;
public ProcessModelerController(FlowableClient flowableClient,
WfTemplatePickerService wfTemplatePickerService,
ModelSemanticValidator semanticValidator,
FlowDeployAuditService deployAuditService) {
this.flowableClient = flowableClient;
this.wfTemplatePickerService = wfTemplatePickerService;
this.semanticValidator = semanticValidator;
this.deployAuditService = deployAuditService;
}
// ---------------------------------------------------------------- 存量流程源载入(T1.6)
@Operation(summary = "按流程定义 id 取净化源 XML(超管)",
description = "超管门后转发 flowable-service /api/flow/process-definitions/{procDefId}/source,"
+ "返回 {procDefId, found, bpmnXml(净化后), idMap, procDefKey, version} 供 bpmn-js Modeler 载入。"
+ "非超管 403。中文 procDefId 由 FlowableClient 以 uri 变量严格编码转发。")
@GetMapping("/process-definitions/{procDefId}/source")
public ResponseEntity<Map<String, Object>> source(@AuthenticationPrincipal AuthPrincipal principal,
@PathVariable String procDefId) {
ResponseEntity<Map<String, Object>> denied = requireSuperAdmin(principal);
if (denied != null) {
return denied;
}
return ResponseEntity.ok(flowableClient.procDefSource(procDefId));
}
@Operation(summary = "按流程 key 取最新版净化源 XML(超管)",
description = "超管门后转发 flowable-service /api/flow/process-definitions/by-key/{key}/source,"
+ "返回与 by-id 端点同形状。打开器对 process-select 的 source='model' 选项改用真流程 key 走本路"
+ "(该选项 id 是 act_re_model id 非 procDefId,by-id 永远 found:false)。非超管 403。"
+ "中文 key 由 FlowableClient 以 uri 变量严格编码转发。")
@GetMapping("/process-definitions/by-key/{key}/source")
public ResponseEntity<Map<String, Object>> sourceByKey(@AuthenticationPrincipal AuthPrincipal principal,
@PathVariable String key) {
ResponseEntity<Map<String, Object>> denied = requireSuperAdmin(principal);
if (denied != null) {
return denied;
}
return ResponseEntity.ok(flowableClient.procDefSourceByKey(key));
}
// ---------------------------------------------------------------- 草稿 CRUD 转发(T2.2)
@Operation(summary = "草稿列表(超管)",
description = "超管门后转发 flowable-service GET /api/flow/models,返回 {models:[{id,name,key,lastUpdateTime}]}。")
@GetMapping("/models")
public ResponseEntity<Map<String, Object>> listModels(@AuthenticationPrincipal AuthPrincipal principal) {
ResponseEntity<Map<String, Object>> denied = requireSuperAdmin(principal);
if (denied != null) {
return denied;
}
return ResponseEntity.ok(flowableClient.listModels());
}
@Operation(summary = "取草稿(超管)",
description = "超管门后转发 flowable-service GET /api/flow/models/{id},返回 {found,id,name,key,bpmnXml,metaInfo}。"
+ "id 由 FlowableClient 以 uri 变量严格编码转发。")
@GetMapping("/models/{id}")
public ResponseEntity<Map<String, Object>> getModel(@AuthenticationPrincipal AuthPrincipal principal,
@PathVariable String id) {
ResponseEntity<Map<String, Object>> denied = requireSuperAdmin(principal);
if (denied != null) {
return denied;
}
return ResponseEntity.ok(flowableClient.getModel(id));
}
@Operation(summary = "建草稿(超管)",
description = "超管门后转发 flowable-service POST /api/flow/models,body {name,key,bpmnXml,metaInfo?},"
+ "返回 {modelId}。坏 XML 下游 422 经既有 handler 透传。")
@PostMapping("/models")
public ResponseEntity<Map<String, Object>> createModel(@AuthenticationPrincipal AuthPrincipal principal,
@RequestBody Map<String, Object> body) {
ResponseEntity<Map<String, Object>> denied = requireSuperAdmin(principal);
if (denied != null) {
return denied;
}
return ResponseEntity.ok(flowableClient.createModel(body));
}
@Operation(summary = "更新草稿(超管)",
description = "超管门后转发 flowable-service PUT /api/flow/models/{id},body {name?,bpmnXml,metaInfo?},"
+ "返回 {status:0}。草稿不存在 404 / 坏 XML 422 经既有 handler 透传。id 以 uri 变量严格编码转发。")
@PutMapping("/models/{id}")
public ResponseEntity<Map<String, Object>> updateModel(@AuthenticationPrincipal AuthPrincipal principal,
@PathVariable String id,
@RequestBody Map<String, Object> body) {
ResponseEntity<Map<String, Object>> denied = requireSuperAdmin(principal);
if (denied != null) {
return denied;
}
return ResponseEntity.ok(flowableClient.updateModel(id, body));
}
@Operation(summary = "从流程定义建草稿(超管)",
description = "超管门后转发 flowable-service POST /api/flow/models/from-procdef,body {procDefId},"
+ "返回 {modelId}(净化 id 映射落 metaInfo)。procDef 不存在下游返 {found:false}。")
@PostMapping("/models/from-procdef")
public ResponseEntity<Map<String, Object>> modelFromProcDef(@AuthenticationPrincipal AuthPrincipal principal,
@RequestBody Map<String, Object> body) {
ResponseEntity<Map<String, Object>> denied = requireSuperAdmin(principal);
if (denied != null) {
return denied;
}
return ResponseEntity.ok(flowableClient.modelFromProcDef(body));
}
@Operation(summary = "删草稿(超管)",
description = "超管门后转发 flowable-service DELETE /api/flow/models/{id},返回 {status:0}。"
+ "草稿不存在 404 经既有 handler 透传。id 以 uri 变量严格编码转发。")
@DeleteMapping("/models/{id}")
public ResponseEntity<Map<String, Object>> deleteModel(@AuthenticationPrincipal AuthPrincipal principal,
@PathVariable String id) {
ResponseEntity<Map<String, Object>> denied = requireSuperAdmin(principal);
if (denied != null) {
return denied;
}
return ResponseEntity.ok(flowableClient.deleteModel(id));
}
// ---------------------------------------------------------------- 发布门(T3.2)
/**
* <b>TOCTOU 已接受风险(评审 I-3)</b>:本端点先 {@link FlowableClient#getModel} 读草稿源做语义校验,再由下游
* deploy 重新读 editorSource 部署——两次读之间存在并发 PUT 改写草稿的窗口(校验的是旧内容、部署的是新内容)。
* v1 <b>接受</b>该风险,不做 content-hash 乐观锁 409:①发布是超管手动、低频、通常单人操作,并发改写窗口极窄;
* ②非安全洞(超管门已限定调用者,下游 deploy 仍过引擎 ProcessValidator 结构校验兜底);③content-hash 409
* 对 v1 过重(需前端拿版本号回传+冲突重试 UI)。与 {@link FlowableClient} 幂等段同风格声明,v2 有多人协同编辑
* 需求再引入乐观锁。
*/
@Operation(summary = "发布草稿为流程定义(超管 + 语义校验门 + 审计)",
description = "超管门 → 取草稿源 XML(FlowableClient.getModel)→ EIP4 语义校验"
+ "(ModelSemanticValidator:办理人/会签内嵌 JSON items 非空+type 白名单、formKey 存在于 view_wftemplate、"
+ "completionCondition 预设∪自定义)→ 有错返 422 {status:1,msg,errors} <b>不部署</b>;过则转发 flowable-service "
+ "POST /api/flow/models/{id}/deploy(引擎 ProcessValidator 结构校验+id 还原中文原 key+部署)→ 成功后写"
+ " sys_flow_deploy_audit(operator=principal.userId())→ 透传下游 {status,deploymentId,processKey,newVersion}。"
+ "草稿不存在/源为空 → 404。非超管 403。")
@PostMapping("/models/{id}/deploy")
public ResponseEntity<Map<String, Object>> deploy(@AuthenticationPrincipal AuthPrincipal principal,
@PathVariable String id) {
ResponseEntity<Map<String, Object>> denied = requireSuperAdmin(principal);
if (denied != null) {
return denied;
}
// 取草稿源 XML 供语义校验(办理人/会签 JSON、formKey 在草稿态即定,与部署时 id 还原无关)。
Map<String, Object> model = flowableClient.getModel(id);
String bpmnXml = (model != null && Boolean.TRUE.equals(model.get("found"))
&& model.get("bpmnXml") instanceof String s) ? s : null;
if (bpmnXml == null || bpmnXml.isBlank()) {
return error(HttpStatus.NOT_FOUND, "草稿不存在或源为空: " + id);
}
// EIP4 语义校验门:非空错误清单 → 422 不部署(引擎结构校验在下游 deploy,二者互补)。
List<String> errors = semanticValidator.validate(bpmnXml);
if (!errors.isEmpty()) {
Map<String, Object> body = new LinkedHashMap<>();
body.put("status", 1);
body.put("msg", "流程语义校验未通过");
body.put("errors", errors);
return ResponseEntity.status(HttpStatus.UNPROCESSABLE_ENTITY).body(body);
}
// 转发部署(下游还原中文原 key + ProcessValidator 结构校验 + deploy)。
Map<String, Object> result = flowableClient.deployModel(id);
// 部署成功后旁路写审计(收口 @Service,避免 @RestController 直用 JdbcTemplate 触架构棘轮);写失败不反噬部署。
deployAuditService.record(id, result, principal.userId());
return ResponseEntity.ok(result);
}
@Operation(summary = "发布影响摘要(超管)",
description = "超管门后转发 flowable-service GET /api/flow/models/{id}/impact,返回"
+ " {processKey,currentVersion,runningInstances} 供同人确认弹窗展示。草稿不存在 → 下游 404 透传。非超管 403。")
@GetMapping("/models/{id}/impact")
public ResponseEntity<Map<String, Object>> impact(@AuthenticationPrincipal AuthPrincipal principal,
@PathVariable String id) {
ResponseEntity<Map<String, Object>> denied = requireSuperAdmin(principal);
if (denied != null) {
return denied;
}
return ResponseEntity.ok(flowableClient.modelImpact(id));
}
// ---------------------------------------------------------------- formKey 选择器数据源(T2.2)
@Operation(summary = "wftemplate 选择器数据源(超管)",
description = "超管门后经 WfTemplatePickerService 读业务库 view_wftemplate(isactive=1) → {templates:[{id,name}]},"
+ "供办理人/会签 formKey 下拉选择。name 取 XML entityid→sys_entity.name(无则回退 id),"
+ "view_wftemplate_id 去 CHAR 补白。读库异常降级 {templates:[], degraded:true}(不 500 阻断设计器)。")
@GetMapping("/wftemplates")
public ResponseEntity<Map<String, Object>> wftemplates(@AuthenticationPrincipal AuthPrincipal principal) {
ResponseEntity<Map<String, Object>> denied = requireSuperAdmin(principal);
if (denied != null) {
return denied;
}
// SQL 收口 WfTemplatePickerService(@Service):@RestController 不得直用 JdbcTemplate(架构棘轮)。
return ResponseEntity.ok(wfTemplatePickerService.listTemplates());
}
// ---------------------------------------------------------------- 超管门
/**
* 统一超管门:超管返回 {@code null}(放行),非超管/无身份返回 403 ResponseEntity({status:1,msg})。
* 所有端点入口调用,防漏门(T1.6 评审 M-3)。403 信封与既有网关端点逐字对齐。
*/
private static ResponseEntity<Map<String, Object>> requireSuperAdmin(AuthPrincipal principal) {
if (EngineContextBinder.isSystemAdmin(principal)) {
return null;
}
return error(HttpStatus.FORBIDDEN, "仅系统管理员可用");
}
/** 统一错误信封 {status:1,msg}(与全站网关端点逐字对齐)。 */
private static ResponseEntity<Map<String, Object>> error(HttpStatus httpStatus, String msg) {
Map<String, Object> body = new LinkedHashMap<>();
body.put("status", 1);
body.put("msg", msg);
return ResponseEntity.status(httpStatus).body(body);
}
}

View File

@@ -359,6 +359,12 @@ public class TodoController {
return ResponseEntity.ok(nodes); return ResponseEntity.ok(nodes);
} }
@Operation(summary = "流程图(BPMN)", description = "透传 flowable-service:返回流程定义 BPMN XML + 当前/历史活动节点,供前端 bpmn-js 渲染并高亮当前停留节点")
@GetMapping("/api/workflow/process/{processInstanceId}/diagram")
public ResponseEntity<Map<String, Object>> diagram(@PathVariable String processInstanceId) {
return ResponseEntity.ok(flowableClient.diagram(processInstanceId));
}
@Operation(summary = "委托任务", description = "将任务委托给指定用户(delegateUserId),assignee 变受托人,owner 记原办理人") @Operation(summary = "委托任务", description = "将任务委托给指定用户(delegateUserId),assignee 变受托人,owner 记原办理人")
@PostMapping("/api/task/{id}/delegate") @PostMapping("/api/task/{id}/delegate")
public ResponseEntity<Map<String, Object>> delegate(@PathVariable String id, public ResponseEntity<Map<String, Object>> delegate(@PathVariable String id,

View File

@@ -0,0 +1,137 @@
package com.eip4.platform.flowgateway;
import static org.assertj.core.api.Assertions.assertThat;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.verifyNoInteractions;
import static org.mockito.Mockito.when;
import java.util.List;
import java.util.Map;
import org.junit.jupiter.api.Test;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import com.dsasp.server.common.core.service.FlowExcuteService;
import com.eip4.platform.flowgateway.aggregate.BusinessRecordLoader;
import com.eip4.platform.flowgateway.aggregate.BusinessSummaryService;
import com.eip4.platform.flowgateway.aggregate.WfTemplateService;
import com.eip4.platform.flowgateway.client.FlowableClient;
import com.eip4.platform.flowgateway.web.ApprovalController;
import com.eip4.platform.flowgateway.web.GatewayRequests;
import com.eip4.platform.flowgateway.writeback.StatusWriteback;
import com.eip4.platform.metadata.flow.UserColumnResolver;
/**
* 审批动作分派单测:聚焦协办(assist)/转阅(circulated)新接线——按 type 转调 FlowableClient,
* targetUserIds 列表归一(去空白去重、回退单值),无目标用户 → 400。
*/
class ApprovalControllerActionTest {
private final FlowableClient flowableClient = mock(FlowableClient.class);
private final WfTemplateService wfTemplateService = mock(WfTemplateService.class);
private final BusinessSummaryService businessSummaryService = mock(BusinessSummaryService.class);
private final StatusWriteback statusWriteback = mock(StatusWriteback.class);
private final FlowExcuteService flowExcuteService = mock(FlowExcuteService.class);
private final BusinessRecordLoader businessRecordLoader = mock(BusinessRecordLoader.class);
private final UserColumnResolver userColumnResolver = mock(UserColumnResolver.class);
private final ApprovalController controller = new ApprovalController(flowableClient, wfTemplateService,
businessSummaryService, statusWriteback, flowExcuteService, businessRecordLoader, userColumnResolver);
private GatewayRequests.ApprovalActionRequest req(String type) {
GatewayRequests.ApprovalActionRequest r = new GatewayRequests.ApprovalActionRequest();
r.actionType = type;
return r;
}
@Test
void assist_buildsSubTasksForEachUser() {
GatewayRequests.ApprovalActionRequest r = req("assist");
r.targetUserIds = List.of("u-a", "u-b");
r.comment = "请协助";
when(flowableClient.assist("t1", List.of("u-a", "u-b"), "请协助"))
.thenReturn(Map.of("count", 2));
ResponseEntity<Map<String, Object>> resp = controller.action("t1", r);
assertThat(resp.getStatusCode().is2xxSuccessful()).isTrue();
assertThat(resp.getBody()).containsEntry("action", "assist")
.containsEntry("assisted", true)
.containsEntry("count", 2);
verify(flowableClient).assist("t1", List.of("u-a", "u-b"), "请协助");
}
@Test
void circulated_buildsReadonlyTasksForEachUser() {
GatewayRequests.ApprovalActionRequest r = req("circulated");
r.targetUserIds = List.of("u-c");
when(flowableClient.circulate("t2", List.of("u-c"), null))
.thenReturn(Map.of("count", 1));
ResponseEntity<Map<String, Object>> resp = controller.action("t2", r);
assertThat(resp.getStatusCode().is2xxSuccessful()).isTrue();
assertThat(resp.getBody()).containsEntry("action", "circulated")
.containsEntry("circulated", true)
.containsEntry("count", 1);
verify(flowableClient).circulate("t2", List.of("u-c"), null);
}
@Test
void assist_dedupesAndFallsBackToSingleTargetUserId() {
GatewayRequests.ApprovalActionRequest r = req("assist");
r.targetUserIds = List.of(" u-a ", "u-a"); // 去空白后重复
r.targetUserId = "u-z"; // 单值并入
when(flowableClient.assist("t3", List.of("u-a", "u-z"), null))
.thenReturn(Map.of("count", 2));
ResponseEntity<Map<String, Object>> resp = controller.action("t3", r);
assertThat(resp.getStatusCode().is2xxSuccessful()).isTrue();
verify(flowableClient).assist("t3", List.of("u-a", "u-z"), null);
}
/**
* 同意意见落 act_hi_comment 必须以「同意」开头——报表审批段按 {@code message LIKE '同意%'} 匹配
* 并 {@code regexp_replace} 去前缀取意见。空意见 → 默认「同意」(修审批意见在报表不显示=原因B go-forward)。
*/
@Test
void approve_blankComment_recordsDefault同意() {
ResponseEntity<Map<String, Object>> resp = controller.action("t1", req("approve"));
assertThat(resp.getStatusCode().is2xxSuccessful()).isTrue();
verify(flowableClient).complete(eq("t1"), any(), eq("同意"));
}
@Test
void approve_withOpinion_prefixesWith同意() {
GatewayRequests.ApprovalActionRequest r = req("approve");
r.comment = "已审核无误";
controller.action("t2", r);
verify(flowableClient).complete(eq("t2"), any(), eq("同意:已审核无误"));
}
@Test
void approve_opinionAlreadyStartsWith同意_keptAsIs() {
GatewayRequests.ApprovalActionRequest r = req("approve");
r.comment = "同意,按计划执行";
controller.action("t3", r);
verify(flowableClient).complete(eq("t3"), any(), eq("同意,按计划执行"));
}
@Test
void assist_withoutTargets_returns400() {
ResponseEntity<Map<String, Object>> resp = controller.action("t4", req("assist"));
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST);
verifyNoInteractions(flowableClient);
}
@Test
void circulated_withoutTargets_returns400() {
ResponseEntity<Map<String, Object>> resp = controller.action("t5", req("circulated"));
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.BAD_REQUEST);
verifyNoInteractions(flowableClient);
}
}

View File

@@ -0,0 +1,63 @@
package com.eip4.platform.flowgateway;
import static org.assertj.core.api.Assertions.assertThatCode;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.anyString;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;
import java.util.LinkedHashMap;
import java.util.Map;
import org.junit.jupiter.api.Test;
import org.springframework.dao.DataAccessResourceFailureException;
import org.springframework.jdbc.core.JdbcTemplate;
import com.eip4.platform.flowgateway.aggregate.FlowDeployAuditService;
/**
* 部署审计 Service 单测:从 deploy 下游结果抽字段 INSERT sys_flow_deploy_audit;写库异常吞掉不反噬已成功的部署。
* SQL 收口到本 @Service(@RestController 不得直用 JdbcTemplate,架构棘轮)。
*/
class FlowDeployAuditServiceTest {
private final JdbcTemplate jdbcTemplate = mock(JdbcTemplate.class);
private final FlowDeployAuditService service = new FlowDeployAuditService(jdbcTemplate);
@Test
void record_从下游结果抽全字段INSERT() {
Map<String, Object> result = new LinkedHashMap<>();
result.put("status", 0);
result.put("deploymentId", "dep-9");
result.put("processKey", "总包合同交底");
result.put("newVersion", 4);
service.record("m1", result, "ADMIN");
// SQL 用 anyString()(照 WfTemplatePickerServiceTest 惯例,不耦合具体语句);断言抽出的字段值与顺序。
verify(jdbcTemplate).update(anyString(),
eq("m1"), eq("dep-9"), eq("总包合同交底"), eq(4), eq("ADMIN"));
}
@Test
void record_newVersion数字归一为Integer_processKey缺失传null() {
Map<String, Object> result = new LinkedHashMap<>();
result.put("deploymentId", "dep-1");
// 无 processKey/newVersion:抽为 null,不炸
service.record("m2", result, "ADMIN");
verify(jdbcTemplate).update(anyString(),
eq("m2"), eq("dep-1"), eq((Object) null), eq((Object) null), eq("ADMIN"));
}
@Test
void record_写库异常被吞不抛_部署已成功不回滚() {
when(jdbcTemplate.update(anyString(), any(), any(), any(), any(), any()))
.thenThrow(new DataAccessResourceFailureException("db down"));
Map<String, Object> result = Map.of("deploymentId", "d", "processKey", "k", "newVersion", 1);
assertThatCode(() -> service.record("m3", result, "ADMIN")).doesNotThrowAnyException();
}
}

View File

@@ -2,6 +2,11 @@ package com.eip4.platform.flowgateway;
import static org.assertj.core.api.Assertions.assertThat; import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy; import static org.assertj.core.api.Assertions.assertThatThrownBy;
import static org.hamcrest.Matchers.allOf;
import static org.hamcrest.Matchers.containsString;
import static org.hamcrest.Matchers.endsWith;
import static org.hamcrest.Matchers.not;
import static org.hamcrest.Matchers.startsWith;
import static org.springframework.test.web.client.match.MockRestRequestMatchers.jsonPath; import static org.springframework.test.web.client.match.MockRestRequestMatchers.jsonPath;
import static org.springframework.test.web.client.match.MockRestRequestMatchers.method; import static org.springframework.test.web.client.match.MockRestRequestMatchers.method;
import static org.springframework.test.web.client.match.MockRestRequestMatchers.requestTo; import static org.springframework.test.web.client.match.MockRestRequestMatchers.requestTo;
@@ -199,4 +204,311 @@ class FlowableClientTest {
assertThat(result).containsEntry("businessKey", "BK-1"); assertThat(result).containsEntry("businessKey", "BK-1");
server.verify(); server.verify();
} }
// ---- 流程源(Modeler 载入):中文 procDefId 编码硬验收(T1.4 评审 M-2) ----
/**
* 真实 procDefId 形如 {@code 总包合同交底:3:<uuid>}(中文 key + 冒号进 path segment)。
* procDefId 必须作为 uri 变量被严格编码转发——冒号编码为 {@code %3A}、中文 percent 编码,绝无裸传。
* 关键判别:字符串拼接会把冒号当 path 分隔符保留裸 {@code ':'};只有 uri 变量展开才会编码成 {@code %3A}。
*/
@Test
void 取流程源_中文procDefId作为uri变量严格编码不裸传() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
String procDefId = "总包合同交底:3:abc123";
server.expect(ExpectedCount.once(), requestTo(allOf(
startsWith("http://localhost:8089/api/flow/process-definitions/"),
endsWith("/source"),
containsString("%3A3%3Aabc123"), // 两个冒号均编码为 %3A(证明走 uri 变量非拼接)
not(containsString("总包合同交底"))))) // 中文未裸传(已 percent 编码)
.andExpect(method(HttpMethod.GET))
.andRespond(withSuccess("{\"found\":true,\"procDefKey\":\"总包合同交底\",\"version\":3}",
MediaType.APPLICATION_JSON));
FlowableClient client = new FlowableClient(builder.build(), p);
Map<String, Object> resp = client.procDefSource(procDefId);
assertThat(resp).containsEntry("procDefKey", "总包合同交底");
assertThat(resp).containsEntry("found", true);
server.verify();
}
/**
* by-key 端点:process-select options 的 source='model' 项 id 非 procDefId,打开器改用真流程 key 走此路。
* 纯中文 key「总包合同交底」作为 uri 变量严格编码转发——percent 编码,绝无裸中文。
*/
@Test
void 取流程源按key_纯中文key作为uri变量严格编码不裸传() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
String key = "总包合同交底";
server.expect(ExpectedCount.once(), requestTo(allOf(
startsWith("http://localhost:8089/api/flow/process-definitions/by-key/"),
endsWith("/source"),
containsString("%E6%80%BB"), // 「总」的 UTF-8 percent 编码,证明已编码
not(containsString("总包合同交底"))))) // 中文未裸传
.andExpect(method(HttpMethod.GET))
.andRespond(withSuccess("{\"found\":true,\"procDefKey\":\"总包合同交底\",\"version\":2}",
MediaType.APPLICATION_JSON));
FlowableClient client = new FlowableClient(builder.build(), p);
Map<String, Object> resp = client.procDefSourceByKey(key);
assertThat(resp).containsEntry("procDefKey", "总包合同交底");
assertThat(resp).containsEntry("found", true);
server.verify();
}
@Test
void 取流程源_下游4xx透传FlowRemote且不重试() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), // 业务错不重试
requestTo("http://localhost:8089/api/flow/process-definitions/X/source"))
.andExpect(method(HttpMethod.GET))
.andRespond(withStatus(HttpStatus.BAD_REQUEST).body("bad procDefId"));
FlowableClient client = new FlowableClient(builder.build(), p);
assertThatThrownBy(() -> client.procDefSource("X"))
.isInstanceOf(FlowRemoteException.class)
.satisfies(e -> assertThat(((FlowRemoteException) e).getStatus().value()).isEqualTo(400));
server.verify();
}
// ---- 草稿 Model API 转发(T2.2):list/get/create/update/from-procdef ----
// flowable-service ProcessModelController(T2.1) 契约:GET/POST/PUT /api/flow/models[/{id}]
// + POST /api/flow/models/from-procdef。全部返 Map 原样透传;POST/PUT body 经 Jackson 序列化转发;
// {id} 走 uri 模板变量严格编码(禁拼接);下游 4xx 透传 FlowRemoteException。
@Test
void 草稿列表_GET_models解析models数组() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), requestTo("http://localhost:8089/api/flow/models"))
.andExpect(method(HttpMethod.GET))
.andRespond(withSuccess(
"{\"models\":[{\"id\":\"m1\",\"name\":\"总包合同交底\",\"key\":\"总包合同交底\"}]}",
MediaType.APPLICATION_JSON));
FlowableClient client = new FlowableClient(builder.build(), p);
Map<String, Object> resp = client.listModels();
@SuppressWarnings("unchecked")
List<Map<String, Object>> models = (List<Map<String, Object>>) resp.get("models");
assertThat(models).hasSize(1);
assertThat(models.get(0)).containsEntry("id", "m1").containsEntry("name", "总包合同交底");
server.verify();
}
@Test
void 取草稿_GET_models按id透传() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), requestTo("http://localhost:8089/api/flow/models/m1"))
.andExpect(method(HttpMethod.GET))
.andRespond(withSuccess("{\"found\":true,\"id\":\"m1\",\"bpmnXml\":\"<definitions/>\"}",
MediaType.APPLICATION_JSON));
FlowableClient client = new FlowableClient(builder.build(), p);
Map<String, Object> resp = client.getModel("m1");
assertThat(resp).containsEntry("found", true).containsEntry("bpmnXml", "<definitions/>");
server.verify();
}
@Test
void 建草稿_POST_models_body原样透传() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), requestTo("http://localhost:8089/api/flow/models"))
.andExpect(method(HttpMethod.POST))
.andExpect(jsonPath("$.name").value("总包合同交底"))
.andExpect(jsonPath("$.key").value("总包合同交底"))
.andExpect(jsonPath("$.bpmnXml").value("<definitions/>"))
.andRespond(withSuccess("{\"modelId\":\"m9\"}", MediaType.APPLICATION_JSON));
FlowableClient client = new FlowableClient(builder.build(), p);
Map<String, Object> body = new java.util.LinkedHashMap<>();
body.put("name", "总包合同交底");
body.put("key", "总包合同交底");
body.put("bpmnXml", "<definitions/>");
Map<String, Object> resp = client.createModel(body);
assertThat(resp).containsEntry("modelId", "m9");
server.verify();
}
@Test
void 更新草稿_PUT_models按id_body原样透传() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), requestTo("http://localhost:8089/api/flow/models/m1"))
.andExpect(method(HttpMethod.PUT))
.andExpect(jsonPath("$.bpmnXml").value("<definitions id=\"a\"/>"))
.andRespond(withSuccess("{\"status\":0}", MediaType.APPLICATION_JSON));
FlowableClient client = new FlowableClient(builder.build(), p);
Map<String, Object> body = new java.util.LinkedHashMap<>();
body.put("bpmnXml", "<definitions id=\"a\"/>");
Map<String, Object> resp = client.updateModel("m1", body);
assertThat(resp).containsEntry("status", 0);
server.verify();
}
@Test
void 从流程定义建草稿_POST_from_procdef_body原样透传() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), requestTo("http://localhost:8089/api/flow/models/from-procdef"))
.andExpect(method(HttpMethod.POST))
.andExpect(jsonPath("$.procDefId").value("总包合同交底:3:abc123"))
.andRespond(withSuccess("{\"modelId\":\"m7\"}", MediaType.APPLICATION_JSON));
FlowableClient client = new FlowableClient(builder.build(), p);
Map<String, Object> resp = client.modelFromProcDef(Map.of("procDefId", "总包合同交底:3:abc123"));
assertThat(resp).containsEntry("modelId", "m7");
server.verify();
}
@Test
void 草稿转发_下游4xx透传FlowRemote且不重试() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), // 业务错不重试
requestTo("http://localhost:8089/api/flow/models"))
.andExpect(method(HttpMethod.POST))
.andRespond(withStatus(HttpStatus.UNPROCESSABLE_ENTITY).body("BPMN 解析失败"));
FlowableClient client = new FlowableClient(builder.build(), p);
assertThatThrownBy(() -> client.createModel(Map.of("bpmnXml", "<bad>")))
.isInstanceOf(FlowRemoteException.class)
.satisfies(e -> assertThat(((FlowRemoteException) e).getStatus().value()).isEqualTo(422));
server.verify();
}
@Test
void 删草稿_DELETE_models按id透传() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), requestTo("http://localhost:8089/api/flow/models/m1"))
.andExpect(method(HttpMethod.DELETE))
.andRespond(withSuccess("{\"status\":0}", MediaType.APPLICATION_JSON));
FlowableClient client = new FlowableClient(builder.build(), p);
Map<String, Object> resp = client.deleteModel("m1");
assertThat(resp).containsEntry("status", 0);
server.verify();
}
@Test
void 删草稿_下游404透传FlowRemote且不重试() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), // 业务错不重试
requestTo("http://localhost:8089/api/flow/models/nope"))
.andExpect(method(HttpMethod.DELETE))
.andRespond(withStatus(HttpStatus.NOT_FOUND).body("草稿不存在"));
FlowableClient client = new FlowableClient(builder.build(), p);
assertThatThrownBy(() -> client.deleteModel("nope"))
.isInstanceOf(FlowRemoteException.class)
.satisfies(e -> assertThat(((FlowRemoteException) e).getStatus().value()).isEqualTo(404));
server.verify();
}
// ---- 发布/影响转发(T3.2):POST /api/flow/models/{id}/deploy、GET /api/flow/models/{id}/impact ----
@Test
void 发布草稿_POST_models_id_deploy_透传下游结果() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), requestTo("http://localhost:8089/api/flow/models/m1/deploy"))
.andExpect(method(HttpMethod.POST))
.andRespond(withSuccess(
"{\"status\":0,\"deploymentId\":\"dep-9\",\"processKey\":\"总包合同交底\",\"newVersion\":4}",
MediaType.APPLICATION_JSON));
FlowableClient client = new FlowableClient(builder.build(), p);
Map<String, Object> resp = client.deployModel("m1");
assertThat(resp).containsEntry("deploymentId", "dep-9").containsEntry("processKey", "总包合同交底")
.containsEntry("newVersion", 4);
server.verify();
}
@Test
void 发布草稿_下游422透传FlowRemote且不重试() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), // 业务错不重试(引擎 ProcessValidator 拒)
requestTo("http://localhost:8089/api/flow/models/m1/deploy"))
.andExpect(method(HttpMethod.POST))
.andRespond(withStatus(HttpStatus.UNPROCESSABLE_ENTITY).body("流程校验未通过"));
FlowableClient client = new FlowableClient(builder.build(), p);
assertThatThrownBy(() -> client.deployModel("m1"))
.isInstanceOf(FlowRemoteException.class)
.satisfies(e -> assertThat(((FlowRemoteException) e).getStatus().value()).isEqualTo(422));
server.verify();
}
@Test
void 发布_下游422结构化errors体被FlowRemoteException携带_不丢弃() {
// 评审 I-2:execute 曾只留状态码丢响应体,引擎结构校验 errors 到不了前端。现携带原始体供 handler 透传。
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
String engineBody = "{\"status\":1,\"msg\":\"流程校验未通过\",\"errors\":"
+ "[{\"activityId\":\"t1\",\"problem\":\"flowable-noOutgoingSeq\",\"defaultDescription\":\"节点未连出边\"}]}";
server.expect(ExpectedCount.once(), requestTo("http://localhost:8089/api/flow/models/m1/deploy"))
.andExpect(method(HttpMethod.POST))
.andRespond(withStatus(HttpStatus.UNPROCESSABLE_ENTITY)
.body(engineBody).contentType(MediaType.APPLICATION_JSON));
FlowableClient client = new FlowableClient(builder.build(), p);
assertThatThrownBy(() -> client.deployModel("m1"))
.isInstanceOf(FlowRemoteException.class)
.satisfies(e -> {
FlowRemoteException fre = (FlowRemoteException) e;
assertThat(fre.getStatus().value()).isEqualTo(422);
assertThat(fre.getResponseBody()).contains("activityId").contains("节点未连出边");
});
server.verify();
}
@Test
void 发布影响_GET_models_id_impact_透传下游结果() {
FlowGatewayProperties p = props();
RestClient.Builder builder = RestClient.builder().baseUrl(p.getBaseUrl());
MockRestServiceServer server = MockRestServiceServer.bindTo(builder).build();
server.expect(ExpectedCount.once(), requestTo("http://localhost:8089/api/flow/models/m1/impact"))
.andExpect(method(HttpMethod.GET))
.andRespond(withSuccess(
"{\"processKey\":\"总包合同交底\",\"currentVersion\":3,\"runningInstances\":7}",
MediaType.APPLICATION_JSON));
FlowableClient client = new FlowableClient(builder.build(), p);
Map<String, Object> resp = client.modelImpact("m1");
assertThat(resp).containsEntry("processKey", "总包合同交底").containsEntry("currentVersion", 3)
.containsEntry("runningInstances", 7);
server.verify();
}
} }

View File

@@ -0,0 +1,265 @@
package com.eip4.platform.flowgateway;
import static org.assertj.core.api.Assertions.assertThat;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.anyString;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.never;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;
import java.util.List;
import org.junit.jupiter.api.Test;
import org.springframework.dao.DataAccessResourceFailureException;
import org.springframework.jdbc.core.JdbcTemplate;
import com.eip4.platform.flowgateway.aggregate.ModelSemanticValidator;
/**
* 发布语义校验器单测:办理人/会签内嵌 JSON(全角【】)items 非空 + type 白名单、formKey 存在于
* view_wftemplate、completionCondition 预设∪自定义(自定义不阻断)。返回 {@code List<String>} 空=通过。
*
* <p>fixture 逐字复刻 §0 真实形态:candidateUsers/collection 值是引擎 handler 表达式,内容段花括号全角【】、
* XML 属性内引号 {@code &quot;}(DOM 解码回真引号后 validator 再 replace 全角→半角 JSON.parse)。
*/
class ModelSemanticValidatorTest {
private final JdbcTemplate jdbcTemplate = mock(JdbcTemplate.class);
private final ModelSemanticValidator validator = new ModelSemanticValidator(jdbcTemplate);
private static final String CANDIDATE_PREFIX = "${candidateUsersHandler.getCandidateUsers(execution,'";
private static final String MULTI_PREFIX = "${multiInstanceUsersHandler.getUsers(execution,'";
private static final String SUFFIX = "')}";
/** formKey 存在性查询恒返回给定 count(一次 stub 覆盖所有 formKey)。 */
private void formKeyCount(int count) {
when(jdbcTemplate.queryForObject(anyString(), eq(Integer.class), any())).thenReturn(count);
}
/** 办理人/会签内容段:半角 JSON → 花括号全角【】(方括号保持半角,逐字对齐存储态)。 */
private static String toStored(String halfWidthJson) {
return halfWidthJson.replace("{", "【").replace("}", "】");
}
private static String candidateExpr(String itemsJson) {
return CANDIDATE_PREFIX + toStored("{\"items\":" + itemsJson + "}") + SUFFIX;
}
private static String multiExpr(String itemsJson) {
return MULTI_PREFIX + toStored("{\"items\":" + itemsJson + "}") + SUFFIX;
}
/** XML 属性值转义(内嵌 JSON 双引号 → &quot;)。 */
private static String attr(String s) {
return s.replace("&", "&amp;").replace("\"", "&quot;").replace("<", "&lt;");
}
private static String bpmn(String processInner) {
return "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" "
+ "xmlns:activiti=\"http://activiti.org/bpmn\" targetNamespace=\"n\">"
+ "<process id=\"p1\" name=\"流程\">" + processInner + "</process></definitions>";
}
private static String userTaskWithCandidate(String name, String candidateExpr) {
return "<userTask id=\"t1\" name=\"" + name + "\" activiti:candidateUsers=\""
+ attr(candidateExpr) + "\"/>";
}
private static String cosignUserTask(String name, String collectionExpr, String completion) {
String cc = completion == null ? ""
: "<completionCondition>" + attr(completion) + "</completionCondition>";
return "<userTask id=\"t2\" name=\"" + name + "\">"
+ "<multiInstanceLoopCharacteristics isSequential=\"false\" activiti:collection=\""
+ attr(collectionExpr) + "\" activiti:elementVariable=\"assignee\">" + cc
+ "</multiInstanceLoopCharacteristics></userTask>";
}
// ---------------------------------------------------------------- 通过
@Test
void 合法流程_办理人items非空白名单_formKey存在_预设完成条件_零错误() {
formKeyCount(1);
String xml = bpmn(
"<userTask id=\"t1\" name=\"审批\" activiti:formKey=\"wft-1\" activiti:candidateUsers=\""
+ attr(candidateExpr("[{\"type\":\"user\",\"content\":\"u1,u2\",\"isCandidate\":true}]"))
+ "\"/>"
+ cosignUserTask("会签", multiExpr("[{\"type\":\"depart\",\"content\":\"d1\"}]"),
"${nrOfCompletedInstances/nrOfInstances==1}"));
assertThat(validator.validate(xml)).isEmpty();
}
@Test
void 裸userTask无办理人无formKey_不属本校验器职责_零错误() {
String xml = bpmn("<userTask id=\"t1\" name=\"纯节点\"/>");
assertThat(validator.validate(xml)).isEmpty();
// 无 formKey → 不查库
verify(jdbcTemplate, never()).queryForObject(anyString(), eq(Integer.class), any());
}
@Test
void 非handler裸候选值_非EIP4codec产物_放行不校验JSON() {
// 直接写 ${someVar} 等裸表达式:非 EIP4 办理人 handler 形态,不套 JSON 白名单(避免误拒合法 Flowable 裸值)
String xml = bpmn("<userTask id=\"t1\" name=\"节点\" activiti:candidateUsers=\"${someVar}\"/>");
assertThat(validator.validate(xml)).isEmpty();
}
@Test
void M1_flowable前缀candidateUsers_按本地名匹配同样校验() {
// 语料有 flowable 命名空间文档(3docs);按本地名匹配,flowable:candidateUsers 与 activiti: 同样被校验。
String xml = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" "
+ "xmlns:flowable=\"http://flowable.org/bpmn\" targetNamespace=\"n\">"
+ "<process id=\"p1\" name=\"流程\">"
+ "<userTask id=\"t1\" name=\"flowable节点\" flowable:candidateUsers=\""
+ attr(candidateExpr("[{\"type\":\"bogusType\",\"content\":\"x\"}]")) + "\"/>"
+ "</process></definitions>";
List<String> errors = validator.validate(xml);
assertThat(errors).hasSize(1);
assertThat(errors.get(0)).contains("flowable节点").contains("bogusType");
}
@Test
void M2_新增4种type放行_锁I1白名单对齐WfTypes() {
// roles/initiatorLeader/initiatorDepartManager/fixedDimension:WfTypes 配置类型、OrgDirectoryJdbc 运行期支持,
// 但旧 10 种白名单缺失。实测 initiatorDepartManager(24 文档)/fixedDimension(12 文档)真存量命中→曾会 422 误拒。
for (String type : new String[]{"roles", "initiatorLeader", "initiatorDepartManager", "fixedDimension",
"initiatorSubordinate", "initiatorDepart"}) {
String xml = bpmn(userTaskWithCandidate("节点",
candidateExpr("[{\"type\":\"" + type + "\",\"content\":\"x\"}]")));
assertThat(validator.validate(xml)).as("type=%s 应放行", type).isEmpty();
}
}
// ---------------------------------------------------------------- 办理人 JSON 错误
@Test
void 办理人items为空数组_error() {
String xml = bpmn(userTaskWithCandidate("空办理人", candidateExpr("[]")));
List<String> errors = validator.validate(xml);
assertThat(errors).hasSize(1);
assertThat(errors.get(0)).contains("空办理人").contains("为空");
}
@Test
void 办理人type非白名单_error() {
String xml = bpmn(userTaskWithCandidate("坏type",
candidateExpr("[{\"type\":\"bogusType\",\"content\":\"x\"}]")));
List<String> errors = validator.validate(xml);
assertThat(errors).hasSize(1);
assertThat(errors.get(0)).contains("坏type").contains("bogusType");
}
@Test
void 办理人JSON无法解析_error() {
// 内容段坏 JSON(缺闭合)——全角还原后仍非法
String bad = CANDIDATE_PREFIX + toStored("{\"items\":[{\"type\":") + SUFFIX;
String xml = bpmn("<userTask id=\"t1\" name=\"坏JSON\" activiti:candidateUsers=\""
+ attr(bad) + "\"/>");
List<String> errors = validator.validate(xml);
assertThat(errors).hasSize(1);
assertThat(errors.get(0)).contains("坏JSON").contains("JSON");
}
@Test
void 办理人多个type_逐项报非法() {
String xml = bpmn(userTaskWithCandidate("多项",
candidateExpr("[{\"type\":\"user\",\"content\":\"a\"},"
+ "{\"type\":\"bad1\",\"content\":\"b\"},{\"type\":\"bad2\",\"content\":\"c\"}]")));
List<String> errors = validator.validate(xml);
assertThat(errors).hasSize(2);
assertThat(errors).anyMatch(e -> e.contains("bad1")).anyMatch(e -> e.contains("bad2"));
}
// ---------------------------------------------------------------- 会签 collection + 完成条件
@Test
void 会签collection的items为空_error() {
formKeyCount(1);
String xml = bpmn(cosignUserTask("空会签", multiExpr("[]"),
"${nrOfCompletedInstances/nrOfInstances==1}"));
List<String> errors = validator.validate(xml);
assertThat(errors).hasSize(1);
assertThat(errors.get(0)).contains("空会签").contains("为空");
}
@Test
void 会签自定义完成条件_不阻断_零错误() {
// T2.4 保留自定义完成条件态:非三预设的合法表达式必须放行(别把存量自定义条件拒了)
String xml = bpmn(cosignUserTask("过六成会签",
multiExpr("[{\"type\":\"user\",\"content\":\"u1\"}]"),
"${nrOfCompletedInstances/nrOfInstances>0.6}"));
assertThat(validator.validate(xml)).isEmpty();
}
@Test
void 会签过半预设_不阻断_零错误() {
String xml = bpmn(cosignUserTask("过半会签",
multiExpr("[{\"type\":\"user\",\"content\":\"u1\"}]"),
"${nrOfCompletedInstances/nrOfInstances>0.5}"));
assertThat(validator.validate(xml)).isEmpty();
}
@Test
void 会签指定数预设_不阻断_零错误() {
String xml = bpmn(cosignUserTask("三票会签",
multiExpr("[{\"type\":\"user\",\"content\":\"u1\"}]"),
"${nrOfCompletedInstances>=3}"));
assertThat(validator.validate(xml)).isEmpty();
}
@Test
void 会签完成条件空白_error() {
String xml = bpmn(cosignUserTask("空条件会签",
multiExpr("[{\"type\":\"user\",\"content\":\"u1\"}]"), " "));
List<String> errors = validator.validate(xml);
assertThat(errors).hasSize(1);
assertThat(errors.get(0)).contains("空条件会签").contains("完成条件");
}
// ---------------------------------------------------------------- formKey 存在性
@Test
void formKey不存在于模板库_error() {
formKeyCount(0);
String xml = bpmn("<userTask id=\"t1\" name=\"带表单\" activiti:formKey=\"ghost-uuid\"/>");
List<String> errors = validator.validate(xml);
assertThat(errors).hasSize(1);
assertThat(errors.get(0)).contains("带表单").contains("ghost-uuid").contains("view_wftemplate");
}
@Test
void formKey读库异常_降级放行不阻断部署() {
when(jdbcTemplate.queryForObject(anyString(), eq(Integer.class), any()))
.thenThrow(new DataAccessResourceFailureException("db down"));
String xml = bpmn("<userTask id=\"t1\" name=\"带表单\" activiti:formKey=\"wft-1\"/>");
// 读库抖动不因基础设施问题阻断发布(全站降级惯例),该项引用完整性检查跳过
assertThat(validator.validate(xml)).isEmpty();
}
// ---------------------------------------------------------------- XML 层防御
@Test
void 坏XML_error不抛() {
List<String> errors = validator.validate("<definitions><process</bad>");
assertThat(errors).isNotEmpty();
assertThat(errors.get(0)).contains("解析");
}
@Test
void 含DOCTYPE_XXE防御_error() {
String evil = "<?xml version=\"1.0\"?><!DOCTYPE foo [<!ENTITY x \"y\">]>"
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\"><process id=\"p\"/></definitions>";
List<String> errors = validator.validate(evil);
assertThat(errors).isNotEmpty();
}
@Test
void 空XML_error() {
assertThat(validator.validate(" ")).isNotEmpty();
assertThat(validator.validate(null)).isNotEmpty();
}
}

View File

@@ -0,0 +1,495 @@
package com.eip4.platform.flowgateway;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.anyString;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.never;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.delete;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.put;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
import java.util.List;
import java.util.Map;
import org.junit.jupiter.api.Test;
import org.springframework.core.MethodParameter;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
import org.springframework.web.bind.support.WebDataBinderFactory;
import org.springframework.web.context.request.NativeWebRequest;
import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.method.support.ModelAndViewContainer;
import com.eip4.platform.auth.security.AuthPrincipal;
import com.eip4.platform.flowgateway.aggregate.FlowDeployAuditService;
import com.eip4.platform.flowgateway.aggregate.ModelSemanticValidator;
import com.eip4.platform.flowgateway.aggregate.WfTemplatePickerService;
import com.eip4.platform.flowgateway.client.FlowRemoteException;
import com.eip4.platform.flowgateway.client.FlowServiceUnavailableException;
import com.eip4.platform.flowgateway.client.FlowableClient;
import com.eip4.platform.flowgateway.web.FlowGatewayExceptionHandler;
import com.eip4.platform.flowgateway.web.ProcessModelerController;
/**
* 流程 Modeler 网关转发单测:超管门 + source 透传 + 引擎不可达上抛(由既有 handler 映射 503)。
* 中文 procDefId 全链编码在 {@link FlowableClientTest} 覆盖(客户端层),此处覆盖门控与透传语义。
*/
class ProcessModelerControllerTest {
private final FlowableClient flowableClient = mock(FlowableClient.class);
private final WfTemplatePickerService wfTemplatePickerService = mock(WfTemplatePickerService.class);
private final ModelSemanticValidator semanticValidator = mock(ModelSemanticValidator.class);
private final FlowDeployAuditService deployAuditService = mock(FlowDeployAuditService.class);
private final ProcessModelerController controller = new ProcessModelerController(
flowableClient, wfTemplatePickerService, semanticValidator, deployAuditService);
/** 真实形态:中文 key + 冒号分隔的 procDefId。 */
private static final String CN_PROCDEF = "总包合同交底:3:abc123";
private static AuthPrincipal admin() {
return new AuthPrincipal("ADMIN", "admin", "管理员", null, null, List.of());
}
/** 含 "admin" 字样但非超管的普通用户(account=user_admin ≠ admin)。 */
private static AuthPrincipal normalUser() {
return new AuthPrincipal("U1", "user_admin", "张三", "D1", "O1", List.of("R1"));
}
@Test
void 超管_透传下游净化源XML返回200() {
Map<String, Object> downstream = Map.of("found", true, "procDefKey", "总包合同交底",
"bpmnXml", "<definitions/>", "idMap", Map.of("总包合同交底", "n1a2b3"), "version", 3);
when(flowableClient.procDefSource(CN_PROCDEF)).thenReturn(downstream);
ResponseEntity<Map<String, Object>> resp = controller.source(admin(), CN_PROCDEF);
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(resp.getBody()).isEqualTo(downstream);
verify(flowableClient).procDefSource(CN_PROCDEF);
}
@Test
void 非超管_403且不触发下游调用() {
ResponseEntity<Map<String, Object>> resp = controller.source(normalUser(), CN_PROCDEF);
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
assertThat(resp.getBody()).containsEntry("status", 1).containsEntry("msg", "仅系统管理员可用");
verify(flowableClient, never()).procDefSource(anyString());
}
@Test
void 无身份_403且不触发下游调用() {
ResponseEntity<Map<String, Object>> resp = controller.source(null, CN_PROCDEF);
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
assertThat(resp.getBody()).containsEntry("status", 1);
verify(flowableClient, never()).procDefSource(anyString());
}
@Test
void 引擎不可达_异常上抛由既有handler映射503() {
when(flowableClient.procDefSource(CN_PROCDEF))
.thenThrow(new FlowServiceUnavailableException("flowable-service 不可达", null));
// 控制器不吞异常:FlowServiceUnavailableException 上抛 → FlowGatewayExceptionHandler.onUnavailable 映射 503
assertThatThrownBy(() -> controller.source(admin(), CN_PROCDEF))
.isInstanceOf(FlowServiceUnavailableException.class);
verify(flowableClient).procDefSource(CN_PROCDEF);
}
// ---- by-key:process-select options=model 的语义缺口修复,打开器用真流程 key ----
private static final String CN_KEY = "总包合同交底";
@Test
void byKey_超管_透传下游源XML返回200() {
Map<String, Object> downstream = Map.of("found", true, "procDefId", "总包合同交底:2:aa22",
"procDefKey", "总包合同交底", "bpmnXml", "<definitions/>", "idMap", Map.of(), "version", 2);
when(flowableClient.procDefSourceByKey(CN_KEY)).thenReturn(downstream);
ResponseEntity<Map<String, Object>> resp = controller.sourceByKey(admin(), CN_KEY);
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(resp.getBody()).isEqualTo(downstream);
verify(flowableClient).procDefSourceByKey(CN_KEY);
}
@Test
void byKey_非超管_403且不触发下游调用() {
ResponseEntity<Map<String, Object>> resp = controller.sourceByKey(normalUser(), CN_KEY);
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
assertThat(resp.getBody()).containsEntry("status", 1).containsEntry("msg", "仅系统管理员可用");
verify(flowableClient, never()).procDefSourceByKey(anyString());
}
// ---- 胶水层(MockMvc + FlowGatewayExceptionHandler):I-1 ----
// 覆盖三件此前直调单测碰不到的真实 MVC 行为:①引擎不可达经既有 handler 出 503 通用信封
// (FlowGatewayExceptionHandler 全仓首个测试) ②正常路径 200 透传 ③MVC 层把 percent 编码中文 path
// variable 正确解码回原串交给控制器。@AuthenticationPrincipal 在 standalone 无 Security 上下文,
// 用自定义参数解析器恒注入超管(门控通过与否由直调单测覆盖,这里只验 MVC 编码/异常映射管道)。
private MockMvc glueMvc() {
HandlerMethodArgumentResolver adminPrincipal = new HandlerMethodArgumentResolver() {
@Override
public boolean supportsParameter(MethodParameter parameter) {
return AuthPrincipal.class.equals(parameter.getParameterType());
}
@Override
public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mav,
NativeWebRequest req, WebDataBinderFactory bf) {
return admin();
}
};
return MockMvcBuilders.standaloneSetup(controller)
.setControllerAdvice(new FlowGatewayExceptionHandler())
.setCustomArgumentResolvers(adminPrincipal)
.build();
}
@Test
void 胶水_byId_MVC解码percent中文pathVar并200透传() throws Exception {
Map<String, Object> downstream = Map.of("found", true, "procDefKey", "总包合同交底", "version", 3);
when(flowableClient.procDefSource(CN_PROCDEF)).thenReturn(downstream);
glueMvc().perform(get("/api/workflow/process-definitions/{procDefId}/source", CN_PROCDEF))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true))
.andExpect(jsonPath("$.procDefKey").value("总包合同交底"));
// 关键:MVC 层把 %E6.. / %3A 解码回「总包合同交底:3:abc123」原串交给控制器(③编码提取正确)
verify(flowableClient).procDefSource(CN_PROCDEF);
}
@Test
void 胶水_byId_引擎不可达经handler出503通用信封() throws Exception {
when(flowableClient.procDefSource(CN_PROCDEF))
.thenThrow(new FlowServiceUnavailableException("flowable-service 不可达", null));
glueMvc().perform(get("/api/workflow/process-definitions/{procDefId}/source", CN_PROCDEF))
.andExpect(status().isServiceUnavailable())
.andExpect(jsonPath("$.status").value(503))
.andExpect(jsonPath("$.error").value("FLOW_SERVICE_UNAVAILABLE"));
}
@Test
void 胶水_byKey_MVC解码percent中文pathVar并200透传() throws Exception {
Map<String, Object> downstream = Map.of("found", true, "procDefKey", "总包合同交底", "version", 2);
when(flowableClient.procDefSourceByKey(CN_KEY)).thenReturn(downstream);
glueMvc().perform(get("/api/workflow/process-definitions/by-key/{key}/source", CN_KEY))
.andExpect(status().isOk())
.andExpect(jsonPath("$.found").value(true));
verify(flowableClient).procDefSourceByKey(CN_KEY);
}
@Test
void 胶水_byKey_引擎不可达经handler出503通用信封() throws Exception {
when(flowableClient.procDefSourceByKey(CN_KEY))
.thenThrow(new FlowServiceUnavailableException("flowable-service 不可达", null));
glueMvc().perform(get("/api/workflow/process-definitions/by-key/{key}/source", CN_KEY))
.andExpect(status().isServiceUnavailable())
.andExpect(jsonPath("$.error").value("FLOW_SERVICE_UNAVAILABLE"));
}
// ---- 草稿 CRUD 五端点转发(T2.2):每端点 admin 200 透传 + 非超管 403。
// 两次调用(admin+非超管同参)后 verify 下游恰调 1 次 → 证明门确实拦下了非超管调用(若漏门会是 2 次)。----
@Test
void 草稿列表_超管透传200_非超管403门拦下游() {
Map<String, Object> downstream = Map.of("models", List.of(Map.of("id", "m1", "name", "总包合同交底")));
when(flowableClient.listModels()).thenReturn(downstream);
ResponseEntity<Map<String, Object>> ok = controller.listModels(admin());
assertThat(ok.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(ok.getBody()).isEqualTo(downstream);
ResponseEntity<Map<String, Object>> denied = controller.listModels(normalUser());
assertThat(denied.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
assertThat(denied.getBody()).containsEntry("status", 1).containsEntry("msg", "仅系统管理员可用");
verify(flowableClient).listModels(); // 恰 1 次(仅超管):非超管被门拦,未落下游
}
@Test
void 取草稿_超管透传200_非超管403门拦下游() {
Map<String, Object> downstream = Map.of("found", true, "id", "m1", "bpmnXml", "<definitions/>");
when(flowableClient.getModel("m1")).thenReturn(downstream);
ResponseEntity<Map<String, Object>> ok = controller.getModel(admin(), "m1");
assertThat(ok.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(ok.getBody()).isEqualTo(downstream);
ResponseEntity<Map<String, Object>> denied = controller.getModel(normalUser(), "m1");
assertThat(denied.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
verify(flowableClient).getModel("m1"); // 恰 1 次(仅超管)
}
@Test
void 建草稿_超管透传200_非超管403门拦下游() {
Map<String, Object> req = Map.of("name", "总包合同交底", "key", "总包合同交底", "bpmnXml", "<definitions/>");
Map<String, Object> downstream = Map.of("modelId", "m9");
when(flowableClient.createModel(req)).thenReturn(downstream);
ResponseEntity<Map<String, Object>> ok = controller.createModel(admin(), req);
assertThat(ok.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(ok.getBody()).isEqualTo(downstream);
ResponseEntity<Map<String, Object>> denied = controller.createModel(normalUser(), req);
assertThat(denied.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
verify(flowableClient).createModel(req); // 恰 1 次(仅超管):漏门会是 2 次
}
@Test
void 更新草稿_超管透传200_非超管403门拦下游() {
Map<String, Object> req = Map.of("bpmnXml", "<definitions id=\"a\"/>");
Map<String, Object> downstream = Map.of("status", 0);
when(flowableClient.updateModel("m1", req)).thenReturn(downstream);
ResponseEntity<Map<String, Object>> ok = controller.updateModel(admin(), "m1", req);
assertThat(ok.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(ok.getBody()).isEqualTo(downstream);
ResponseEntity<Map<String, Object>> denied = controller.updateModel(normalUser(), "m1", req);
assertThat(denied.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
verify(flowableClient).updateModel("m1", req); // 恰 1 次(仅超管)
}
@Test
void 从流程定义建草稿_超管透传200_非超管403门拦下游() {
Map<String, Object> req = Map.of("procDefId", CN_PROCDEF);
Map<String, Object> downstream = Map.of("modelId", "m7");
when(flowableClient.modelFromProcDef(req)).thenReturn(downstream);
ResponseEntity<Map<String, Object>> ok = controller.modelFromProcDef(admin(), req);
assertThat(ok.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(ok.getBody()).isEqualTo(downstream);
ResponseEntity<Map<String, Object>> denied = controller.modelFromProcDef(normalUser(), req);
assertThat(denied.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
verify(flowableClient).modelFromProcDef(req); // 恰 1 次(仅超管)
}
@Test
void 无身份_建草稿403且不触发下游() {
ResponseEntity<Map<String, Object>> resp = controller.createModel(null, Map.of("name", "x"));
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
assertThat(resp.getBody()).containsEntry("status", 1);
verify(flowableClient, never()).createModel(any());
}
@Test
void 删草稿_超管透传200_非超管403门拦下游() {
Map<String, Object> downstream = Map.of("status", 0);
when(flowableClient.deleteModel("m1")).thenReturn(downstream);
ResponseEntity<Map<String, Object>> ok = controller.deleteModel(admin(), "m1");
assertThat(ok.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(ok.getBody()).isEqualTo(downstream);
ResponseEntity<Map<String, Object>> denied = controller.deleteModel(normalUser(), "m1");
assertThat(denied.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
assertThat(denied.getBody()).containsEntry("status", 1).containsEntry("msg", "仅系统管理员可用");
verify(flowableClient).deleteModel("m1"); // 恰 1 次(仅超管):非超管被门拦,未落下游
}
@Test
void 胶水_删草稿_下游404经handler透传() throws Exception {
when(flowableClient.deleteModel("nope"))
.thenThrow(new FlowRemoteException(HttpStatus.NOT_FOUND, "flowable-service 删草稿返回 404"));
glueMvc().perform(delete("/api/workflow/models/{id}", "nope"))
.andExpect(status().isNotFound())
.andExpect(jsonPath("$.status").value(404))
.andExpect(jsonPath("$.error").value("FLOW_REMOTE_ERROR"));
}
// ---- 422 胶水透传:下游坏 XML 422 经既有 FlowGatewayExceptionHandler 出 FLOW_REMOTE_ERROR 信封 ----
@Test
void 胶水_建草稿_下游422经handler透传() throws Exception {
when(flowableClient.createModel(any()))
.thenThrow(new FlowRemoteException(HttpStatus.UNPROCESSABLE_ENTITY, "flowable-service 建草稿返回 422"));
glueMvc().perform(post("/api/workflow/models")
.contentType(MediaType.APPLICATION_JSON)
.content("{\"name\":\"x\",\"key\":\"k\",\"bpmnXml\":\"<bad>\"}"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(422))
.andExpect(jsonPath("$.error").value("FLOW_REMOTE_ERROR"));
}
// ---- wftemplates 选择器:控制器只验门 + 透传 WfTemplatePickerService 结果(SQL/trim/降级细节在 WfTemplatePickerServiceTest)----
@Test
void wftemplates_超管_透传service结果200() {
Map<String, Object> downstream = Map.of("templates",
List.of(Map.of("id", "wft-0001", "name", "通知管理")));
when(wfTemplatePickerService.listTemplates()).thenReturn(downstream);
ResponseEntity<Map<String, Object>> resp = controller.wftemplates(admin());
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(resp.getBody()).isEqualTo(downstream);
verify(wfTemplatePickerService).listTemplates();
}
@Test
void wftemplates_非超管_403且不调service() {
ResponseEntity<Map<String, Object>> resp = controller.wftemplates(normalUser());
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
assertThat(resp.getBody()).containsEntry("status", 1).containsEntry("msg", "仅系统管理员可用");
verify(wfTemplatePickerService, never()).listTemplates();
}
// ---- PUT 路由胶水(M-3):MockMvc 真走 PUT /api/workflow/models/{id},验路径匹配 + @PathVariable 绑定 + 200 透传 ----
@Test
void 胶水_更新草稿_PUT路由绑定pathVar并200透传() throws Exception {
Map<String, Object> downstream = Map.of("status", 0);
when(flowableClient.updateModel(eq("m1"), any())).thenReturn(downstream);
glueMvc().perform(put("/api/workflow/models/{id}", "m1")
.contentType(MediaType.APPLICATION_JSON)
.content("{\"bpmnXml\":\"<definitions/>\"}"))
.andExpect(status().isOk())
.andExpect(jsonPath("$.status").value(0));
// 路由匹配 PUT 谓词 + {id} 绑定到 "m1" 交给控制器
verify(flowableClient).updateModel(eq("m1"), any());
}
// ---- 发布门(T3.2):超管门 → 语义校验 → 转发部署 → 审计 INSERT。语义 fail 零转发零审计;非超管零触达。----
@Test
void 发布_超管语义通过_转发部署并写审计_operator为userId() {
when(flowableClient.getModel("m1"))
.thenReturn(Map.of("found", true, "bpmnXml", "<definitions/>"));
when(semanticValidator.validate("<definitions/>")).thenReturn(List.of());
Map<String, Object> deployed = Map.of("status", 0, "deploymentId", "dep-9",
"processKey", "总包合同交底", "newVersion", 4);
when(flowableClient.deployModel("m1")).thenReturn(deployed);
ResponseEntity<Map<String, Object>> resp = controller.deploy(admin(), "m1");
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(resp.getBody()).isEqualTo(deployed);
verify(flowableClient).deployModel("m1");
// 审计收口到 @Service,operator=principal.userId()="ADMIN"(超管门已保证 principal 非空)
verify(deployAuditService).record("m1", deployed, "ADMIN");
}
@Test
void 发布_语义校验失败_422带明细_零转发零审计() {
when(flowableClient.getModel("m1"))
.thenReturn(Map.of("found", true, "bpmnXml", "<definitions/>"));
when(semanticValidator.validate("<definitions/>"))
.thenReturn(List.of("节点『会签』的办理人为空(items 为空)"));
ResponseEntity<Map<String, Object>> resp = controller.deploy(admin(), "m1");
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.UNPROCESSABLE_ENTITY);
assertThat(resp.getBody()).containsEntry("status", 1);
assertThat(resp.getBody().get("errors")).isEqualTo(List.of("节点『会签』的办理人为空(items 为空)"));
verify(flowableClient, never()).deployModel(anyString()); // 校验拦截:绝不部署
verify(deployAuditService, never()).record(anyString(), any(), anyString()); // 未部署不写审计
}
@Test
void 发布_非超管_403_零触达下游与校验() {
ResponseEntity<Map<String, Object>> resp = controller.deploy(normalUser(), "m1");
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
assertThat(resp.getBody()).containsEntry("status", 1).containsEntry("msg", "仅系统管理员可用");
verify(flowableClient, never()).getModel(anyString());
verify(flowableClient, never()).deployModel(anyString());
verify(semanticValidator, never()).validate(anyString());
verify(deployAuditService, never()).record(anyString(), any(), anyString());
}
@Test
void 发布_草稿不存在_404_不校验不部署() {
when(flowableClient.getModel("nope")).thenReturn(Map.of("found", false));
ResponseEntity<Map<String, Object>> resp = controller.deploy(admin(), "nope");
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.NOT_FOUND);
assertThat(resp.getBody()).containsEntry("status", 1);
verify(semanticValidator, never()).validate(anyString());
verify(flowableClient, never()).deployModel(anyString());
verify(deployAuditService, never()).record(anyString(), any(), anyString());
}
@Test
void 影响摘要_超管_透传下游200() {
Map<String, Object> downstream = Map.of("processKey", "总包合同交底",
"currentVersion", 3, "runningInstances", 7);
when(flowableClient.modelImpact("m1")).thenReturn(downstream);
ResponseEntity<Map<String, Object>> resp = controller.impact(admin(), "m1");
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.OK);
assertThat(resp.getBody()).isEqualTo(downstream);
verify(flowableClient).modelImpact("m1");
}
@Test
void 影响摘要_非超管_403_零触达下游() {
ResponseEntity<Map<String, Object>> resp = controller.impact(normalUser(), "m1");
assertThat(resp.getStatusCode()).isEqualTo(HttpStatus.FORBIDDEN);
verify(flowableClient, never()).modelImpact(anyString());
}
// ---- 胶水:发布 422 语义信封经 MVC 出(status:1 + errors 数组);发布路由 POST /{id}/deploy 绑定 ----
@Test
void 胶水_发布_语义422信封含errors数组() throws Exception {
when(flowableClient.getModel("m1"))
.thenReturn(Map.of("found", true, "bpmnXml", "<definitions/>"));
when(semanticValidator.validate("<definitions/>"))
.thenReturn(List.of("节点『审批』的表单 formKey 不存在于模板库(view_wftemplate):ghost"));
glueMvc().perform(post("/api/workflow/models/{id}/deploy", "m1"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.status").value(1))
.andExpect(jsonPath("$.errors[0]").value(
"节点『审批』的表单 formKey 不存在于模板库(view_wftemplate):ghost"));
verify(flowableClient, never()).deployModel(anyString());
}
@Test
void 胶水_发布_语义过但下游引擎422结构化errors经handler并入顶层() throws Exception {
// I-2:语义门放行 → 转发 deploy → 下游引擎 ProcessValidator 结构校验 422(对象式 errors) → handler 并入网关响应。
// 两条 422 契约统一:顶层 errors(语义=字符串数组 / 引擎=对象数组),前端 T3.3 同一渲染。
when(flowableClient.getModel("m1"))
.thenReturn(Map.of("found", true, "bpmnXml", "<definitions/>"));
when(semanticValidator.validate("<definitions/>")).thenReturn(List.of()); // 语义过
String engineBody = "{\"status\":1,\"msg\":\"流程校验未通过\",\"errors\":"
+ "[{\"activityId\":\"t1\",\"problem\":\"noOutgoing\",\"defaultDescription\":\"节点未连出边\"}]}";
when(flowableClient.deployModel("m1")).thenThrow(
new FlowRemoteException(HttpStatus.UNPROCESSABLE_ENTITY,
"flowable-service 发布草稿返回 422", engineBody));
glueMvc().perform(post("/api/workflow/models/{id}/deploy", "m1"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.error").value("FLOW_REMOTE_ERROR"))
.andExpect(jsonPath("$.errors[0].activityId").value("t1"))
.andExpect(jsonPath("$.errors[0].defaultDescription").value("节点未连出边"));
}
}

View File

@@ -0,0 +1,65 @@
package com.eip4.platform.flowgateway;
import static org.assertj.core.api.Assertions.assertThat;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.anyString;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.when;
import java.sql.ResultSet;
import java.util.List;
import java.util.Map;
import org.junit.jupiter.api.Test;
import org.springframework.dao.DataAccessResourceFailureException;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.core.RowMapper;
import com.eip4.platform.flowgateway.aggregate.WfTemplatePickerService;
/**
* wftemplate 选择器 Service 单测:RowMapper trim CHAR 补白 + 无实体名回退 id + 读库异常降级。
* SQL 收口到本 Service(@RestController 不得直用 JdbcTemplate,架构棘轮),故这些细节从控制器测试搬到这里。
*/
class WfTemplatePickerServiceTest {
private final JdbcTemplate jdbcTemplate = mock(JdbcTemplate.class);
private final WfTemplatePickerService service = new WfTemplatePickerService(jdbcTemplate);
@SuppressWarnings({"unchecked", "rawtypes"})
@Test
void listTemplates_trim补白并回退id_正常不带degraded() {
// mock JdbcTemplate 反射调真实 RowMapper:第一行有实体名(取名+trim补白),第二行无名(回退 trim 后的 id)
when(jdbcTemplate.query(anyString(), any(RowMapper.class))).thenAnswer(inv -> {
RowMapper<Map<String, Object>> rm = inv.getArgument(1);
ResultSet named = mock(ResultSet.class);
when(named.getString("id")).thenReturn("wft-0001 "); // CHAR(36) 补白
when(named.getString("name")).thenReturn("通知管理");
ResultSet unnamed = mock(ResultSet.class);
when(unnamed.getString("id")).thenReturn("wft-0002 ");
when(unnamed.getString("name")).thenReturn(null); // 无 entityid/实体名 → 回退 id
return List.of(rm.mapRow(named, 0), rm.mapRow(unnamed, 1));
});
Map<String, Object> resp = service.listTemplates();
List<Map<String, Object>> templates = (List<Map<String, Object>>) resp.get("templates");
assertThat(templates).hasSize(2);
assertThat(templates.get(0)).containsEntry("id", "wft-0001").containsEntry("name", "通知管理");
assertThat(templates.get(1)).containsEntry("id", "wft-0002").containsEntry("name", "wft-0002");
assertThat(resp).doesNotContainKey("degraded"); // 正常路径不带 degraded 键
}
@SuppressWarnings({"unchecked", "rawtypes"})
@Test
void listTemplates_读库异常_降级空列表带degraded不抛() {
when(jdbcTemplate.query(anyString(), any(RowMapper.class)))
.thenThrow(new DataAccessResourceFailureException("db down"));
Map<String, Object> resp = service.listTemplates();
List<Map<String, Object>> templates = (List<Map<String, Object>>) resp.get("templates");
assertThat(templates).isEmpty();
assertThat(resp).containsEntry("degraded", true); // 降级分支带标记(正常路径无此键)
}
}

View File

@@ -123,9 +123,21 @@ public class DataImportExcelParser {
}; };
} }
/** JAXP 1.4 兼容的 DocumentBuilderFactory:钉到 JDK 内置实现,绕开 platform-report(jatools)带入的
* 上古 xerces-eip3.jar(2004)——后者不实现 setFeature(JAXP 1.4),fat jar 里被 classpath 发现选中会致
* AbstractMethodError。显式指定 JDK 实现类(总在),不删/不动 report 的 xerces。 */
private static DocumentBuilderFactory newJdkDbf() {
try {
return DocumentBuilderFactory.newInstance(
"com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl", null);
} catch (Throwable t) {
return DocumentBuilderFactory.newInstance();
}
}
private List<Map<String, Object>> parseSpreadsheetXml(byte[] bytes, String sheetName, int firstRow) { private List<Map<String, Object>> parseSpreadsheetXml(byte[] bytes, String sheetName, int firstRow) {
try { try {
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); DocumentBuilderFactory factory = newJdkDbf();
factory.setNamespaceAware(true); factory.setNamespaceAware(true);
factory.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true); factory.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true);
Document document = factory.newDocumentBuilder().parse(new ByteArrayInputStream(bytes)); Document document = factory.newDocumentBuilder().parse(new ByteArrayInputStream(bytes));

View File

@@ -0,0 +1,25 @@
-- 凭据外泄巡检:找出 type=200 报表模板里把 property("DB...") 用在 <Connection> 之外的可疑模板
-- =============================================================================
-- <Connection> 内的 ${property("DBJdbcUrl/DBUser/DBPassword")} 是引擎解析连接所需,合法
-- (本库实测 326 个模板如此)。出现在 <Connection> 之外(如某单元格/SQL select 列)即可疑:
-- 渲染时会把库连接信息渲进输出 → 凭据外泄。建议纳入迁移/上线检查,命中即人工核查并清理。
-- 粗筛口径:property("DBPassword") 出现次数 > <Connection 元素个数。
-- =============================================================================
SET search_path = eip3;
WITH counts AS (
SELECT
trim(view_template_id) AS template_id,
name,
(char_length(xml::text) - char_length(replace(xml::text, 'property("DBPassword"', '')))
/ char_length('property("DBPassword"') AS pw_uses,
(char_length(lower(xml::text)) - char_length(replace(lower(xml::text), '<connection', '')))
/ char_length('<connection') AS conn_cnt
FROM view_template
WHERE type = 200
AND position('property("DBPassword"' IN xml::text) > 0
)
SELECT template_id, name, pw_uses, conn_cnt
FROM counts
WHERE pw_uses > conn_cnt
ORDER BY pw_uses - conn_cnt DESC;

View File

@@ -0,0 +1,30 @@
-- 报表专用「只读最小权」DB 账号 —— 残留 1(凭据外泄)+ SQLi 的爆炸半径收口
-- =============================================================================
-- 背景:报表 SQL 由 jatools 引擎以 JatoolsConfig 注入的 DBUser 身份执行。默认回落主数据源
-- (spring.datasource.*),与主应用同账号、高权限。改为指向本只读账号后:
-- * 即便某模板含 ${property("DBPassword")} 被渲出,泄露的也只是只读账号口令;
-- * 报表 SQL 注入(已被 ReportParamGuard 收口)即便被绕过,也只能读、不能写。
--
-- 用法:
-- 1) 在报表库执行本脚本(改掉 PASSWORD);
-- 2) 配置 eip4.report.db.username / eip4.report.db.password / eip4.report.db.url 指向它
-- (未配置则 JatoolsConfig 回落 spring.datasource.*,行为不变)。
-- =============================================================================
-- 1) 建只读登录角色(口令请改)
CREATE ROLE eip4_report_ro WITH LOGIN PASSWORD 'CHANGE_ME_STRONG';
-- 2) 只授 eip3 schema 的 USAGE + 现有及未来表的 SELECT
GRANT USAGE ON SCHEMA eip3 TO eip4_report_ro;
GRANT SELECT ON ALL TABLES IN SCHEMA eip3 TO eip4_report_ro;
ALTER DEFAULT PRIVILEGES IN SCHEMA eip3 GRANT SELECT ON TABLES TO eip4_report_ro;
-- 3) 会话级强制只读 + 服务端硬超时(与 JatoolsConfig 注入的 statement_timeout 双保险)
ALTER ROLE eip4_report_ro SET default_transaction_read_only = on;
ALTER ROLE eip4_report_ro SET statement_timeout = '30s';
-- 4) 显式收回建表等危险权限(默认通常已无,显式声明意图)
REVOKE CREATE ON SCHEMA eip3 FROM eip4_report_ro;
-- 注意:default_transaction_read_only=on 会让一切写/DDL 失败。若个别报表确需写
-- (jatools 的 "="-前缀执行路径,报表查看场景罕见),需单独评估,不应放进只读报表账号。

View File

@@ -57,11 +57,15 @@
<dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>zxing</artifactId><version>eip3</version></dependency> <dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>zxing</artifactId><version>eip3</version></dependency>
<!-- 引擎运行期依赖的旧版 commons / log4j1 / jaxen / xerces。给独立坐标避免与平台托管版本误判去重。 --> <!-- 引擎运行期依赖的旧版 commons / log4j1 / jaxen / xerces。给独立坐标避免与平台托管版本误判去重。 -->
<dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>commons-beanutils</artifactId><version>eip3</version></dependency> <dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>commons-beanutils</artifactId><version>eip3</version></dependency>
<dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>commons-collections</artifactId><version>eip3</version></dependency> <!-- 安全升级:commons-collections 3.0 → 3.2.2,关掉 InvokerTransformer 反序列化 gadget(CVE-2015-7501)。
引擎源码不直接引用 commons-collections,3.2.x API 向后兼容,且 3.2.2 已在本地仓。 -->
<dependency><groupId>commons-collections</groupId><artifactId>commons-collections</artifactId><version>3.2.2</version></dependency>
<dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>commons-httpclient</artifactId><version>eip3</version></dependency> <dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>commons-httpclient</artifactId><version>eip3</version></dependency>
<dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>commons-lang</artifactId><version>eip3</version></dependency> <dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>commons-lang</artifactId><version>eip3</version></dependency>
<dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>commons-logging</artifactId><version>eip3</version></dependency> <dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>commons-logging</artifactId><version>eip3</version></dependency>
<dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>log4j</artifactId><version>eip3</version></dependency> <!-- 安全升级:log4j 1.2.8 → reload4j 1.2.25(drop-in,关 SocketServer/JMSAppender 等 RCE CVE)。
引擎仅用 org.apache.log4j.Logger / PropertyConfigurator,reload4j 同包同 API 完全兼容。 -->
<dependency><groupId>ch.qos.reload4j</groupId><artifactId>reload4j</artifactId><version>1.2.25</version></dependency>
<dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>jaxen</artifactId><version>eip3</version></dependency> <dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>jaxen</artifactId><version>eip3</version></dependency>
<dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>xerces</artifactId><version>eip3</version></dependency> <dependency><groupId>com.dsasp.thirdparty</groupId><artifactId>xerces</artifactId><version>eip3</version></dependency>

View File

@@ -41,13 +41,15 @@ public class JatoolsConfig {
private static final Logger log = LoggerFactory.getLogger(JatoolsConfig.class); private static final Logger log = LoggerFactory.getLogger(JatoolsConfig.class);
@Value("${spring.datasource.url:jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3}") // 报表查询连接:优先用报表专用数据源 eip4.report.db.*(供配置独立的<strong>只读最小权账号</strong>,
// 收口 SQLi/凭据外泄的爆炸半径),未配置则回落主数据源 spring.datasource.*(向后兼容,默认零行为变化)。
@Value("${eip4.report.db.url:${spring.datasource.url:jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3}}")
private String jdbcUrl; private String jdbcUrl;
@Value("${spring.datasource.username:zhengwr}") @Value("${eip4.report.db.username:${spring.datasource.username:zhengwr}}")
private String dbUser; private String dbUser;
@Value("${spring.datasource.password:}") @Value("${eip4.report.db.password:${spring.datasource.password:}}")
private String dbPassword; private String dbPassword;
@Value("${eip4.report.company:EIP4}") @Value("${eip4.report.company:EIP4}")
@@ -61,6 +63,13 @@ public class JatoolsConfig {
@Value("${eip4.report.db.socket-timeout-sec:35}") @Value("${eip4.report.db.socket-timeout-sec:35}")
private int socketTimeoutSec; private int socketTimeoutSec;
/**
* 报表查询的驱动结果集缓冲上限(pgjdbc maxResultBuffer,如 {@code 60p}=最大堆 60% / {@code 256m};空=不设)。
* 引擎用 TYPE_SCROLL_INSENSITIVE 整集物化,无此上限时海量结果集可在产出前 OOM;设此值则超限抛异常而非 OOM。
*/
@Value("${eip4.report.db.max-result-buffer:60p}")
private String maxResultBuffer;
/** /**
* PDF 导出兜底字体(CJK 保真)候选路径,按序探测,取首个可加载者注册为 * PDF 导出兜底字体(CJK 保真)候选路径,按序探测,取首个可加载者注册为
* iText {@code DefaultFontMapper.defaultFont}。覆盖 macOS(本地验证)与常见 Linux 路径。 * iText {@code DefaultFontMapper.defaultFont}。覆盖 macOS(本地验证)与常见 Linux 路径。
@@ -96,8 +105,11 @@ public class JatoolsConfig {
p.setProperty("font.dirs", p.setProperty("font.dirs",
"/System/Library/Fonts;/Library/Fonts;" "/System/Library/Fonts;/Library/Fonts;"
+ "/usr/share/fonts;/usr/share/fonts/truetype;/usr/local/share/fonts"); + "/usr/share/fonts;/usr/share/fonts/truetype;/usr/local/share/fonts");
// 报表模板 <Connection> 解析到 EIP4 数据源(URL 追加 statement_timeout/socketTimeout 超时加固) // 报表模板 <Connection> 解析到 EIP4 数据源:追加 statement_timeout/socketTimeout 超时加固
String hardenedUrl = appendPgTimeouts(jdbcUrl == null ? "" : jdbcUrl, statementTimeoutMs, socketTimeoutSec); // + maxResultBuffer 结果集缓冲上限(防全量物化 OOM)
String hardenedUrl = appendPgResultBufferCap(
appendPgTimeouts(jdbcUrl == null ? "" : jdbcUrl, statementTimeoutMs, socketTimeoutSec),
maxResultBuffer);
p.setProperty("DBJdbcUrl", hardenedUrl); p.setProperty("DBJdbcUrl", hardenedUrl);
p.setProperty("DBUser", dbUser == null ? "" : dbUser); p.setProperty("DBUser", dbUser == null ? "" : dbUser);
p.setProperty("DBPassword", dbPassword == null ? "" : dbPassword); p.setProperty("DBPassword", dbPassword == null ? "" : dbPassword);
@@ -158,6 +170,22 @@ public class JatoolsConfig {
* 仅作用于 {@code jdbc:postgresql} URL;已含同名参数则不重复(幂等);非正值则跳过对应项; * 仅作用于 {@code jdbc:postgresql} URL;已含同名参数则不重复(幂等);非正值则跳过对应项;
* null/空/非 PG URL 原样返回。 * null/空/非 PG URL 原样返回。
*/ */
/**
* 给 PostgreSQL JDBC URL 追加 pgjdbc {@code maxResultBuffer}(残留 2 收口):限制驱动为单条结果集
* 缓冲的内存上限,超出即抛异常而非 OOM —— 对 jatools 引擎用的 {@code TYPE_SCROLL_INSENSITIVE}
* (客户端整集物化)尤为关键。值如 {@code 60p}(占最大堆 60%)或 {@code 256m}。仅作用于
* {@code jdbc:postgresql} URL;空值/已含同参/非 PG URL 原样返回。
*/
static String appendPgResultBufferCap(String url, String maxResultBuffer) {
if (url == null || url.isBlank() || !url.startsWith("jdbc:postgresql")
|| maxResultBuffer == null || maxResultBuffer.isBlank()
|| url.contains("maxResultBuffer=")) {
return url;
}
char sep = url.indexOf('?') >= 0 ? '&' : '?';
return url + sep + "maxResultBuffer=" + maxResultBuffer.trim();
}
static String appendPgTimeouts(String url, long statementTimeoutMs, int socketTimeoutSec) { static String appendPgTimeouts(String url, long statementTimeoutMs, int socketTimeoutSec) {
if (url == null || url.isBlank() || !url.startsWith("jdbc:postgresql")) { if (url == null || url.isBlank() || !url.startsWith("jdbc:postgresql")) {
return url; return url;

View File

@@ -64,6 +64,10 @@ public class ReportController {
@Value("${eip4.report.require-menu-grant:true}") @Value("${eip4.report.require-menu-grant:true}")
private boolean requireMenuGrant; private boolean requireMenuGrant;
/** 报表公司名(注入模板自定义 COMPANY 参数,覆盖设计期占位"XXXXXX公司")。与 JatoolsConfig 同源配置,部署时设为客户公司名。 */
@Value("${eip4.report.company:EIP4}")
private String reportCompany;
public ReportController(ReportService reportService, public ReportController(ReportService reportService,
ReportTemplateRepository templateRepository, ReportTemplateRepository templateRepository,
Environment environment) { Environment environment) {
@@ -217,7 +221,15 @@ public class ReportController {
new String(xmlBytes, StandardCharsets.ISO_8859_1)); new String(xmlBytes, StandardCharsets.ISO_8859_1));
Map<String, String> client = collectReportParams(request); Map<String, String> client = collectReportParams(request);
Map<String, String> safe = ReportParamGuard.sanitizeClientParams(client, referenced); Map<String, String> safe = ReportParamGuard.sanitizeClientParams(client, referenced);
return ReportParamGuard.applyTrustedIdentity(safe, referenced, trustedIdentity()); Map<String, String> withId = ReportParamGuard.applyTrustedIdentity(safe, referenced, trustedIdentity());
// COMPANY 经 jatools =COMPANY 绑定(非 ${}),按声明探测注入公司名,覆盖占位"XXXXXX公司"。
// 优先取客户系统配置(sys_application_config[com.dsasp.server.organize.COMPANY]),缺失再回退 eip4.report.company。
String company = templateRepository.loadCompanyName();
if (company == null || company.isBlank()) {
company = reportCompany;
}
return ReportParamGuard.applyConfiguredCompany(withId,
new String(xmlBytes, StandardCharsets.ISO_8859_1), company);
} }
/** /**

View File

@@ -48,8 +48,12 @@ public final class ReportParamGuard {
private static final Pattern IDENT = Pattern.compile("[A-Za-z_][A-Za-z0-9_]*"); private static final Pattern IDENT = Pattern.compile("[A-Za-z_][A-Za-z0-9_]*");
/** 多字符危险子串:行注释 {@code --}、类型转换 {@code ::}(白名单已排除其它注释/星号字符)。 */ /** 多字符危险子串:行注释 {@code --}、类型转换 {@code ::}(白名单已排除其它注释/星号字符)。 */
private static final Pattern UNSAFE_SUBSTR = Pattern.compile("--|::"); private static final Pattern UNSAFE_SUBSTR = Pattern.compile("--|::");
/** 除字母/数字(含 CJK)外允许的安全标点:ID/编码/日期所需。<strong>不含空格</strong>是挡住无引号注入的关键。 */ /**
private static final String EXTRA_SAFE_CHARS = "-_./:"; * 除字母/数字(含 CJK)外允许的安全标点:ID/编码/日期/多值 IN 列表所需。
* <strong>不含空格/括号/引号/等号</strong>是挡住无引号注入的关键;逗号安全(单独无法构成
* UNION/子查询/注释/堆叠,后者均需空格/括号/引号/分号)。
*/
private static final String EXTRA_SAFE_CHARS = "-_./:,";
/** /**
* 从模板文本里抽出所有在 {@code ${...}} 宏内出现过的标识符 token(自校准白名单)。 * 从模板文本里抽出所有在 {@code ${...}} 宏内出现过的标识符 token(自校准白名单)。
@@ -139,4 +143,26 @@ public final class ReportParamGuard {
} }
return out; return out;
} }
/** 报表标题等用的公司名参数。模板常把它声明为自定义参数,默认值是占位符如「XXXXXX公司」。 */
static final String COMPANY_PARAM = "COMPANY";
/**
* 模板声明了 {@code COMPANY} 变量/参数时,注入服务端配置的公司名(覆盖设计期占位默认,如「XXXXXX公司」)。
*
* <p>{@code COMPANY} 经 jatools {@code =COMPANY} 表达式绑定(非 {@code ${}} 宏),不在
* {@link #extractReferencedParamNames} 覆盖内,故单独按声明 token 探测。值来自服务端配置
* ({@code eip4.report.company}),非客户端输入,无需走 {@link #isSafeValue}(且公司名常含中文/空格)。
*
* @param company 配置的真实公司名;空 / 模板未声明 COMPANY → 原样返回(保持占位,零回归)
*/
static Map<String, String> applyConfiguredCompany(Map<String, String> params, String templateXml, String company) {
if (company == null || company.isBlank() || templateXml == null
|| !(templateXml.contains("Name=\"COMPANY\"") || templateXml.contains("<Name>COMPANY</Name>"))) {
return params == null ? Map.of() : params;
}
Map<String, String> out = new LinkedHashMap<>(params == null ? Map.of() : params);
out.put(COMPANY_PARAM, company);
return out;
}
} }

View File

@@ -34,6 +34,11 @@ public class ReportTemplateRepository {
private static final String NAME_SQL = private static final String NAME_SQL =
"SELECT name FROM eip3.view_template WHERE trim(view_template_id) = ? AND type = 200"; "SELECT name FROM eip3.view_template WHERE trim(view_template_id) = ? AND type = 200";
/** 报表抬头公司名:取自客户系统配置 {@code sys_application_config} 的固定键(dsasp 全局参数)。 */
private static final String COMPANY_CONFIG_KEY = "com.dsasp.server.organize.COMPANY";
private static final String COMPANY_SQL =
"SELECT value FROM eip3.sys_application_config WHERE trim(sys_application_config_id) = ? AND isactive = 1";
/** /**
* 对象级授权(防 IDOR):该 templateId 报表是否经某个<em>用户可见菜单</em>暴露给该用户。 * 对象级授权(防 IDOR):该 templateId 报表是否经某个<em>用户可见菜单</em>暴露给该用户。
* 关联 {@code view_sys_menu.view_templateid} ←→ {@code view_sys_usermenuid}(用户→可见菜单); * 关联 {@code view_sys_menu.view_templateid} ←→ {@code view_sys_usermenuid}(用户→可见菜单);
@@ -94,6 +99,25 @@ public class ReportTemplateRepository {
} }
} }
/**
* 报表抬头公司名:取自客户系统配置 {@code sys_application_config[com.dsasp.server.organize.COMPANY]}
* (即系统参数管理里维护的公司名,如「苏州第五建筑集团有限公司」)。最佳努力:找不到/异常返回 {@code null}
* (调用方回退 {@code eip4.report.company} 配置),绝不因取名失败影响渲染。
*/
public String loadCompanyName() {
try {
List<String> rows = jdbcTemplate.queryForList(COMPANY_SQL, String.class, COMPANY_CONFIG_KEY);
if (rows.isEmpty()) {
return null;
}
String v = rows.get(0);
return v == null || v.isBlank() ? null : v.trim();
} catch (RuntimeException e) {
log.debug("取系统公司名失败 key={} : {}", COMPANY_CONFIG_KEY, e.getMessage());
return null;
}
}
/** /**
* 当前用户能否访问该报表(经其可见菜单暴露)。userId/templateId 为空返回 {@code false}。 * 当前用户能否访问该报表(经其可见菜单暴露)。userId/templateId 为空返回 {@code false}。
* 仅做存在性判定,超管放行由调用方(控制器)按身份决定,本方法不含超管旁路。 * 仅做存在性判定,超管放行由调用方(控制器)按身份决定,本方法不含超管旁路。

View File

@@ -71,4 +71,33 @@ class JatoolsConfigUrlTest {
assertEquals("", JatoolsConfig.appendPgTimeouts("", 5000, 30)); assertEquals("", JatoolsConfig.appendPgTimeouts("", 5000, 30));
assertEquals(null, JatoolsConfig.appendPgTimeouts(null, 5000, 30)); assertEquals(null, JatoolsConfig.appendPgTimeouts(null, 5000, 30));
} }
// ---- maxResultBuffer:驱动层结果集缓冲上限,把「全量物化 OOM」变成「超限即抛」(残留 2 收口) ----
@Test
void appends_max_result_buffer_with_existing_query() {
String url = JatoolsConfig.appendPgResultBufferCap(
"jdbc:postgresql://h/db?currentSchema=eip3", "60p");
assertTrue(url.contains("currentSchema=eip3"), url);
assertTrue(url.contains("maxResultBuffer=60p"), url);
assertFalse(url.contains("??"), url);
}
@Test
void appends_max_result_buffer_with_question_mark_when_no_query() {
String url = JatoolsConfig.appendPgResultBufferCap("jdbc:postgresql://h/db", "256m");
assertEquals("jdbc:postgresql://h/db?maxResultBuffer=256m", url);
}
@Test
void max_result_buffer_blank_or_nonpg_unchanged_and_idempotent() {
assertEquals("jdbc:postgresql://h/db",
JatoolsConfig.appendPgResultBufferCap("jdbc:postgresql://h/db", ""));
assertEquals("jdbc:postgresql://h/db",
JatoolsConfig.appendPgResultBufferCap("jdbc:postgresql://h/db", null));
assertEquals("jdbc:oracle:thin:@h",
JatoolsConfig.appendPgResultBufferCap("jdbc:oracle:thin:@h", "60p"));
String once = JatoolsConfig.appendPgResultBufferCap("jdbc:postgresql://h/db", "60p");
assertEquals(once, JatoolsConfig.appendPgResultBufferCap(once, "60p")); // 幂等
}
} }

View File

@@ -79,7 +79,16 @@ class ReportParamGuardTest {
assertFalse(ReportParamGuard.isSafeValue("1=1")); // 等号 assertFalse(ReportParamGuard.isSafeValue("1=1")); // 等号
assertFalse(ReportParamGuard.isSafeValue("a b")); // 空格 assertFalse(ReportParamGuard.isSafeValue("a b")); // 空格
assertFalse(ReportParamGuard.isSafeValue("f(x)")); // 括号 assertFalse(ReportParamGuard.isSafeValue("f(x)")); // 括号
assertFalse(ReportParamGuard.isSafeValue("a,b")); // 逗号 }
@Test
void isSafeValue_allows_comma_lists_for_in_clause() {
// 真实模板存在 in (${WELFARECATEGORYID})/in (${SCHEMEITEM}) 多值 IN 列表,需允许逗号。
// 逗号本身无法构成注入:UNION/子查询/注释/堆叠仍需空格/括号/引号/分号(均被拒)。
assertTrue(ReportParamGuard.isSafeValue("1,2,3"));
assertTrue(ReportParamGuard.isSafeValue("a1b2,c3d4,e5f6"));
assertFalse(ReportParamGuard.isSafeValue("1, 2")); // 逗号+空格仍拒
assertFalse(ReportParamGuard.isSafeValue("1,(2)")); // 逗号+括号仍拒
} }
@Test @Test
@@ -192,4 +201,35 @@ class ReportParamGuardTest {
assertEquals(safe, ReportParamGuard.applyTrustedIdentity(safe, referenced, null)); assertEquals(safe, ReportParamGuard.applyTrustedIdentity(safe, referenced, null));
assertEquals(safe, ReportParamGuard.applyTrustedIdentity(safe, referenced, Map.of())); assertEquals(safe, ReportParamGuard.applyTrustedIdentity(safe, referenced, Map.of()));
} }
// ---- applyConfiguredCompany:模板声明 COMPANY 参数时注入配置公司名,覆盖占位默认("XXXXXX公司") ----
@Test
void applyConfiguredCompany_injects_when_template_declares_COMPANY() {
Map<String, String> params = new LinkedHashMap<>();
params.put("PROJECTID", "P-1");
String xml = "<Report><Variables><Item style=\"Parameter\" Name=\"COMPANY\">"
+ "<Name>COMPANY</Name><DefaultValue>XXXXXX公司</DefaultValue></Item></Variables></Report>";
Map<String, String> out = ReportParamGuard.applyConfiguredCompany(params, xml, "示例科技有限公司");
assertEquals("示例科技有限公司", out.get("COMPANY"), "声明 COMPANY 的模板应注入配置公司名");
assertEquals("P-1", out.get("PROJECTID"), "其他参数不动");
}
@Test
void applyConfiguredCompany_noop_when_no_COMPANY_param() {
Map<String, String> params = Map.of("PROJECTID", "P-1");
Map<String, String> out = ReportParamGuard.applyConfiguredCompany(params, "<Report><Variables/></Report>", "示例公司");
assertFalse(out.containsKey("COMPANY"), "未声明 COMPANY → 不注入");
assertEquals("P-1", out.get("PROJECTID"));
}
@Test
void applyConfiguredCompany_noop_when_company_blank_or_null() {
String xml = "<Item Name=\"COMPANY\"><Name>COMPANY</Name></Item>";
assertFalse(ReportParamGuard.applyConfiguredCompany(new LinkedHashMap<>(), xml, "").containsKey("COMPANY"));
assertFalse(ReportParamGuard.applyConfiguredCompany(new LinkedHashMap<>(), xml, null).containsKey("COMPANY"));
assertFalse(ReportParamGuard.applyConfiguredCompany(new LinkedHashMap<>(), xml, " ").containsKey("COMPANY"));
}
} }

View File

@@ -0,0 +1,48 @@
package com.eip4.platform.report;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertNull;
import java.util.List;
import org.junit.jupiter.api.Test;
import org.springframework.jdbc.core.JdbcTemplate;
/**
* 报表抬头公司名取自客户系统配置 {@code sys_application_config[com.dsasp.server.organize.COMPANY]},
* 而非静态 Spring 配置(用户指正:应用系统配置的值)。最佳努力,失败回退 null 由调用方兜底。
*
* <p>platform-report 测试不引入 Mockito,故用手写 {@link JdbcTemplate} 桩覆写 {@code queryForList}。
*/
class ReportTemplateRepositoryTest {
private static ReportTemplateRepository repo(List<String> rows, boolean throwErr) {
JdbcTemplate jdbc = new JdbcTemplate() {
@Override
@SuppressWarnings("unchecked")
public <T> List<T> queryForList(String sql, Class<T> elementType, Object... args) {
if (throwErr) {
throw new RuntimeException("db down");
}
return (List<T>) rows;
}
};
return new ReportTemplateRepository(jdbc);
}
@Test
void loadCompanyName_returns_trimmed_system_config_value() {
assertEquals("苏州第五建筑集团有限公司",
repo(List.of("苏州第五建筑集团有限公司 "), false).loadCompanyName());
}
@Test
void loadCompanyName_null_when_no_config_row() {
assertNull(repo(List.of(), false).loadCompanyName());
}
@Test
void loadCompanyName_null_on_query_error() {
assertNull(repo(List.of(), true).loadCompanyName());
}
}