diff --git a/src/modeler/templates/index.ts b/src/modeler/templates/index.ts index f790927..fab37af 100644 --- a/src/modeler/templates/index.ts +++ b/src/modeler/templates/index.ts @@ -48,7 +48,13 @@ function javaHashCode(s: string): number { return h; } -/** 中文等非法 key → 稳定 ASCII id:`n` + hex(hashCode & 0x7fffffff)(对齐 BpmnIdSanitizer.sanitize)。 */ +/** + * 中文等非法 key → 稳定 ASCII id:`n` + hex(hashCode & 0x7fffffff)(对齐 BpmnIdSanitizer.sanitize)。 + * + * M-1 前提:新建模板里**只有 process key 一个**可能非 ASCII 的 id,节点 id(start_1/task_* 等)全 ASCII, + * 故文档内不会出现两个非法 id → 净化 id 碰撞不可达,无需后端的 -2/-3 去重。若将来允许中文节点 id, + * 须对齐 BpmnIdSanitizer 的碰撞序号方案(否则两 id 哈希相同会串引用、restore 还原错)。 + */ function sanitizedId(key: string): string { return 'n' + (javaHashCode(key) & 0x7fffffff).toString(16); } diff --git a/src/modeler/templates/templates.test.ts b/src/modeler/templates/templates.test.ts index 2c45f7e..e078c1b 100644 --- a/src/modeler/templates/templates.test.ts +++ b/src/modeler/templates/templates.test.ts @@ -6,6 +6,7 @@ import { buildNewProcessXml, isAsciiNcName, } from './index'; +import { buildCandidateExpression, type UserPropertyItem } from '../candidateExpression'; // 模板可部署前提的三重门(对照 T4.1): // ① bpmn-moddle fromXML 无警告(结构合法,activiti 扩展属性全被描述符识别)。 @@ -148,3 +149,56 @@ describe('buildNewProcessXml —— key/名称替换', () => { expect(idMap).toEqual({}); }); }); + +// I-1(守命根回归):模板里的 activiti:candidateUsers / collection 是**硬编码字符串**,其与 +// candidateExpression codec build 输出的逐字对齐此前只是实测、无测试守护。这里从各模板 fromXML 解出 +// 属性值(moddle 已把 " 解码为真引号、全角【】保留——即 codec 处理的 businessObject 值层), +// 断言 === buildCandidateExpression(标准 item, 变体)。模板 JSON 键序/转义漂移或 codec 改契约都会被 +// 单测立即抓到,而非等 live 部署才暴露(部署后表达式解析即断)。 +describe('模板办理人表达式与 codec 逐字对齐(守命根)', () => { + // 模板示例项:一项 type:user、content 空、候选、三通知关(与 templates/*.bpmn.ts 硬编码一致)。 + const STD_ITEM: UserPropertyItem = { + type: 'user', + content: '', + isCandidate: true, + isSendMail: false, + isSendPhone: false, + isSendMessage: false, + }; + + interface ModdleEl { + $type: string; + get(name: string): unknown; + } + + async function userTasksOf(templateXml: string): Promise { + const moddle = new BpmnModdle({ activiti }); + // ASCII key → process id 直接用 key,实例化 XML 即真正 importXML/部署的源。 + const { rootElement } = await moddle.fromXML(buildNewProcessXml(templateXml, 'n', 'K').xml); + const proc = (rootElement as unknown as { rootElements: ModdleEl[] }).rootElements.find( + (e) => e.$type === 'bpmn:Process', + ); + const flow = (proc?.get('flowElements') ?? []) as ModdleEl[]; + return flow.filter((e) => e.$type === 'bpmn:UserTask'); + } + + it('单人审批:userTask candidateUsers === buildCandidateExpression([std],candidate)', async () => { + const [ut] = await userTasksOf(PROCESS_TEMPLATES.find((t) => t.id === 'single-approval')!.xml); + expect(ut.get('activiti:candidateUsers')).toBe(buildCandidateExpression([STD_ITEM], 'candidate')); + }); + + it('两级审批:两 userTask candidateUsers 均 === buildCandidateExpression([std],candidate)', async () => { + const uts = await userTasksOf(PROCESS_TEMPLATES.find((t) => t.id === 'two-level')!.xml); + expect(uts).toHaveLength(2); + const expected = buildCandidateExpression([STD_ITEM], 'candidate'); + for (const ut of uts) { + expect(ut.get('activiti:candidateUsers')).toBe(expected); + } + }); + + it('会签:multiInstance collection === buildCandidateExpression([std],multiInstance)', async () => { + const [ut] = await userTasksOf(PROCESS_TEMPLATES.find((t) => t.id === 'cosign')!.xml); + const loop = ut.get('loopCharacteristics') as ModdleEl; + expect(loop.get('activiti:collection')).toBe(buildCandidateExpression([STD_ITEM], 'multiInstance')); + }); +});