diff --git a/docs/项目进度与路线-总览-2026-06-21.md b/docs/项目进度与路线-总览-2026-06-21.md index 8320e5a..b7b0691 100644 --- a/docs/项目进度与路线-总览-2026-06-21.md +++ b/docs/项目进度与路线-总览-2026-06-21.md @@ -57,7 +57,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁 |---|---|---|---| | **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 止损评审 | -| **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 同根) | | **A4** | 附件系统 | 🟠 | 双态组件已上线;缺图片预览、老附件物理文件迁移(下载 403)、DOCUMENT 全生命周期 | | **A5** | 消息 & 邮件 | 🟠 | 短消息发送 + 消息详情已移植;webmail(IMAP/SMTP)独立子系统未起步;已读联动未接 | @@ -76,7 +76,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 + 只建新不改表** | | **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 进行中 | -| **B3** | 流程建模器 BPMN Modeler | 🔴 | 未起步(即 A2 缺的流程定义 Modeler) | +| **B3** | 流程建模器 BPMN Modeler | 🔴 | 未起步(即 A2 现在唯一缺的「流程定义在线编辑」)。注:BPMN 只读**查看**已做(A2 流程图,bpmn-js NavigatedViewer);Modeler=可编辑+部署,需 S1 拍板自研 vs 嵌入 flowable-modeler | | **B4** | 生产级 UI/UE 组件体系 | 🟡 | L1 主题(amis-theme.css §10-15 密度/按钮/弹窗/字号)+ L2 行选中 `checkOnItemClick` + 设计中心 DesignCenterPage 已上线;剩选择框统一 / 主子表宿主 / 树编辑 Drawer / 审批待办 未完整(`组件设计体系-design-2026-06-15` 落地状态需对齐本矩阵) | | **B5** | 移动端 / 响应式 | 🔴 | 未起步 | | **B6** | 报表设计器(自助报表) | 🔴 | 未起步(与 A3 同根待立项) | @@ -97,7 +97,7 @@ EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁 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)。* -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 完整可用。* ### P2(立项 / 排期) diff --git a/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessDiagramController.java b/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessDiagramController.java index 0ac2459..1022e99 100644 --- a/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessDiagramController.java +++ b/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessDiagramController.java @@ -95,13 +95,79 @@ public class ProcessDiagramController { .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 mutableActive = new java.util.ArrayList<>(active); + List mutableFinished = new java.util.ArrayList<>(finished); + String safeXml = sanitizeBpmnIds(bpmnXml, mutableActive, mutableFinished); + resp.put("found", true); - resp.put("bpmnXml", bpmnXml); - resp.put("activeActivityIds", active); - resp.put("finishedActivityIds", finished); + resp.put("bpmnXml", safeXml); + resp.put("activeActivityIds", mutableActive); + resp.put("finishedActivityIds", mutableFinished); return ResponseEntity.ok(resp); } + /** id/引用类属性(需为合法 NCName;name/value 等展示属性不在内,避免改坏中文节点名)。 */ + private static final java.util.regex.Pattern ID_ATTR = java.util.regex.Pattern.compile( + "\\b(id|bpmnElement|sourceRef|targetRef|attachedToRef|processRef|default)\\s*=\\s*\"([^\"]+)\""); + + /** + * 把 BPMN 里非法(非 ASCII NCName)的 id 及其全部引用一致重写为安全 ASCII id(稳定哈希), + * 使 bpmn-js 能解析渲染。只重写 id/引用类属性,name 等展示属性不动。同步重映射 active/finished 节点 id。 + */ + static String sanitizeBpmnIds(String xml, List active, List finished) { + if (xml == null || xml.isEmpty()) { + return xml; + } + // 1. 收集所有非法 id 值 → 安全 id 映射 + java.util.Map map = new java.util.LinkedHashMap<>(); + java.util.regex.Matcher scan = ID_ATTR.matcher(xml); + while (scan.find()) { + String val = scan.group(2); + if (!isValidNcName(val) && !map.containsKey(val)) { + map.put(val, "n" + Integer.toHexString(val.hashCode() & 0x7fffffff)); + } + } + if (map.isEmpty()) { + return xml; + } + // 2. 仅重写 id/引用类属性(appendReplacement 精确,不误伤 name=) + java.util.regex.Matcher rw = ID_ATTR.matcher(xml); + StringBuilder sb = new StringBuilder(); + while (rw.find()) { + String attr = rw.group(1); + String val = rw.group(2); + String repl = map.getOrDefault(val, val); + rw.appendReplacement(sb, java.util.regex.Matcher.quoteReplacement(attr + "=\"" + repl + "\"")); + } + rw.appendTail(sb); + // 3. 同步重映射返回的当前/历史节点 id + active.replaceAll(id -> map.getOrDefault(id, id)); + finished.replaceAll(id -> map.getOrDefault(id, id)); + 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; + } + /** 读流程定义 BPMN XML(getProcessModel 返回部署的 BPMN 资源流)。读失败返回 null(前端降级)。 */ private String readProcessModel(String procDefId) { try (InputStream is = repositoryService.getProcessModel(procDefId)) { diff --git a/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessDiagramControllerTest.java b/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessDiagramControllerTest.java index 8b21fcb..6a58b21 100644 --- a/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessDiagramControllerTest.java +++ b/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessDiagramControllerTest.java @@ -117,4 +117,37 @@ class ProcessDiagramControllerTest { .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 = "" + + "" + + "" + + "" + + "" + + "" + + "" + + ""; + List active = new java.util.ArrayList<>(List.of("sid-A")); + List 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("