test(modeler): 模板办理人表达式与codec逐字对齐回归断言(守命根)

I-1:模板里的 activiti:candidateUsers/collection 是硬编码字符串,与 candidateExpression
codec build 输出的逐字对齐此前只是实测、无测试守护。新增断言:从各模板 fromXML 解出属性值
(moddle 已解码 "→真引号、保留全角【】,即 codec 处理的 businessObject 值层),
断言 === buildCandidateExpression(标准 item, 变体)(单人/两级 candidate、会签 multiInstance)。
模板 JSON 键序/转义漂移或 codec 改契约会被单测立即抓到,而非等 live 部署解析即断。

M-1:sanitizedId 加注释说明前端无碰撞去重的前提(新建模板仅 process key 一个非 ASCII id、
节点 id 全 ASCII → 碰撞不可达;未来引入中文节点 id 须对齐后端 -2/-3 去重)。

全量 vitest 273 绿、tsc -b exit 0。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-02 16:00:28 +08:00
parent 2477f67afe
commit 54b0200ac0
2 changed files with 61 additions and 1 deletions

View File

@@ -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);
}

View File

@@ -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 已把 &quot; 解码为真引号、全角【】保留——即 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<ModdleEl[]> {
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'));
});
});