From f7d96489d02d0696d1b3a5774a8537431debf614 Mon Sep 17 00:00:00 2001 From: zhengwr Date: Thu, 2 Jul 2026 09:38:19 +0800 Subject: [PATCH] =?UTF-8?q?docs(plan):=20=E5=9B=9E=E5=86=99=20T1.1=20?= =?UTF-8?q?=E5=AE=9E=E8=AF=81=E2=80=94=E2=80=94=E5=8F=8C=E5=8C=85=E5=86=B2?= =?UTF-8?q?=E7=AA=81/=E5=B5=8C=E5=A5=97=E5=85=A8=E8=A7=92=E3=80=90?= =?UTF-8?q?=E3=80=91/formKey=E8=A3=B8UUID/moddle=E6=8B=92=E4=B8=AD?= =?UTF-8?q?=E6=96=87id?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .../2026-07-02-在线流程Modeler-实施计划.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/docs/plans/2026-07-02-在线流程Modeler-实施计划.md b/docs/plans/2026-07-02-在线流程Modeler-实施计划.md index f793095..186fde0 100644 --- a/docs/plans/2026-07-02-在线流程Modeler-实施计划.md +++ b/docs/plans/2026-07-02-在线流程Modeler-实施计划.md @@ -16,7 +16,7 @@ ## §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 可逆净化是硬需求)** / boundary·timer·subProcess·error 个位数 / signal·callActivity·serviceTask 零。 +扩展面实测:**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**。 @@ -54,7 +54,9 @@ ## 阶段 1:moddle 保真 + 只读载入存量(可独立合 main) -### Task 1.1 前端依赖 + moddle 描述符 + 保真单测 +### 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) @@ -159,13 +161,16 @@ 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'; -import flowableModdle from '../modeler/moddle/flowable.json'; +// (app 代码首次 import json:本 task 顺带在 tsconfig.app.json 开 "resolveJsonModule": true) const modeler = new Modeler({ container: canvasRef.current, propertiesPanel: { parent: panelRef.current }, additionalModules: [BpmnPropertiesPanelModule, BpmnPropertiesProviderModule], - moddleExtensions: { activiti: activitiModdle, flowable: flowableModdle }, + // ⚠️ 只载 activiti!T1.1 实证:activiti+flowable 双包同载会因 bpmn:UserTask 同名 extends + // 属性冲突(not allowed without redefines)静默丢弃 userTask。语料 1509/3 两命名空间不混用; + // 单载 activiti 时 flowable 文档经 moddle lax $attrs 零丢失往返。flowable.json 只做隔离单测。 + moddleExtensions: { activiti: activitiModdle }, }); ``` 布局参照 DesignerPage:顶栏(名称/保存草稿·发布·返回,本阶段按钮 disabled 占位)+ 左画布 + 右栏(上=EIP4 侧板占位,下=标准面板)。存量入口:设计中心按钮 → 新页内「打开存量流程」下拉(数据源复用 `GET /api/process-select/options`)。 @@ -219,7 +224,9 @@ commit:`feat(gateway): 流程草稿转发(超管门)+wftemplate picker 数据 **Step 1** 失败测试(真实形态往返): ```ts -const REAL = `\${candidateUsersHandler.getCandidateUsers(execution,'【"items":[{"type":"user","content":"u1,u2","isCandidate":true,"isSendMail":false,"isSendPhone":false}]】')}`; +// T1.1 psql 实证真实形态:外层对象与 items 内每个对象的花括号**全部**是全角【】, +// 方括号[]半角,XML 属性内引号转义为 ",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 });