选中 userTask 时在标准属性面板上方叠加 React 侧板(§0.5 P5),全部写操作经
modeling.updateProperties(element,{...}),undo/redo 天然生效:
- 办理人:activiti:candidateUsers 经 codec parse→items 表格→build 写回,
🔴 codec 外层业务 meta(taskSuccessService 等)存 ref、写回原样带回(硬要求用例覆盖)
- 会签:loopCharacteristics 开关(moddle.create MultiInstanceLoopCharacteristics,
activiti:collection multiInstance 变体+elementVariable=assignee+completionCondition
全票/过半/指定数 N 三预设);关→undefined
- formKey:GET /api/workflow/wftemplates 下拉写 activiti:formKey(裸 UUID),「无」清除
- 扩展属性:长尾 $attrs(activiti:/flowable:)增删改
- 任务监听器:activiti:taskListener event+class/delegateExpression 互斥;已有 field
子元素显示徽标并原样保留(moddle 元素引用不动)
新增 useSelectedElement hook(订阅 selection.changed,单选返 element/多选空选 null/卸载解绑)。
ProcessModelerPage 右栏上方挂 Eip4Panel(modeler 入 state 驱动订阅)。
📌 红线回归:ProcessModelerPage 断言 moddleExtensions 键恰 ['activiti']、
additionalModules 长度 2(防双包冲突静默丢 userTask)。
测试:Eip4Panel 20 + useSelectedElement 5 + ProcessModelerPage 10(+1 红线);
全量 vitest 164 绿 / tsc -b 干净 / npm run build 成功。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
162 lines
7.6 KiB
TypeScript
162 lines
7.6 KiB
TypeScript
import { describe, it, expect, vi, beforeEach } from 'vitest';
|
||
import { render, screen, waitFor, fireEvent, act } from '@testing-library/react';
|
||
import { MemoryRouter } from 'react-router-dom';
|
||
import { SYNTHETIC_BPMN } from '../modeler/moddle/fixtures/synthetic-full-surface.bpmn';
|
||
|
||
// bpmn-js Modeler:jsdom 跑不动真渲染,stub 成类(可断言 importXML/destroy 调用)。
|
||
const { importXMLMock, destroyMock, getMock, onMock, attachToMock, ModelerCtor } = vi.hoisted(() => {
|
||
const importXMLMock = vi.fn();
|
||
const destroyMock = vi.fn();
|
||
const attachToMock = vi.fn();
|
||
const getMock = vi.fn((service: string) => {
|
||
if (service === 'propertiesPanel') return { attachTo: attachToMock };
|
||
if (service === 'canvas') return { zoom: vi.fn() };
|
||
return {};
|
||
});
|
||
const onMock = vi.fn();
|
||
const ModelerCtor = vi.fn().mockImplementation(() => ({
|
||
importXML: importXMLMock,
|
||
destroy: destroyMock,
|
||
get: getMock,
|
||
on: onMock,
|
||
}));
|
||
return { importXMLMock, destroyMock, getMock, onMock, attachToMock, ModelerCtor };
|
||
});
|
||
vi.mock('bpmn-js/lib/Modeler', () => ({ default: ModelerCtor }));
|
||
// 标准属性面板模块只作为 additionalModules 配置项传入被 mock 的 Modeler,永不真正执行。
|
||
vi.mock('bpmn-js-properties-panel', () => ({
|
||
BpmnPropertiesPanelModule: {},
|
||
BpmnPropertiesProviderModule: {},
|
||
}));
|
||
vi.mock('../api/processModeler', () => ({
|
||
fetchProcDefSource: vi.fn(),
|
||
fetchProcDefSourceByKey: vi.fn(),
|
||
fetchProcessOptions: vi.fn(),
|
||
// Eip4Panel(右栏叠板)挂载时拉 formKey 数据源——mock 成空列表避免真请求。
|
||
fetchWfTemplates: vi.fn(() => Promise.resolve([])),
|
||
}));
|
||
vi.mock('../auth/token', async (importOriginal) => ({
|
||
...(await importOriginal<typeof import('../auth/token')>()),
|
||
getProfile: vi.fn(),
|
||
}));
|
||
|
||
import { ProcessModelerPage } from './ProcessModelerPage';
|
||
import { fetchProcDefSource, fetchProcDefSourceByKey, fetchProcessOptions } from '../api/processModeler';
|
||
import { getProfile } from '../auth/token';
|
||
|
||
const mSource = vi.mocked(fetchProcDefSource);
|
||
const mSourceByKey = vi.mocked(fetchProcDefSourceByKey);
|
||
const mOptions = vi.mocked(fetchProcessOptions);
|
||
const mProfile = vi.mocked(getProfile);
|
||
|
||
function renderPage(initialPath = '/process-modeler') {
|
||
return render(
|
||
<MemoryRouter initialEntries={[initialPath]}>
|
||
<ProcessModelerPage />
|
||
</MemoryRouter>,
|
||
);
|
||
}
|
||
|
||
beforeEach(() => {
|
||
importXMLMock.mockReset().mockResolvedValue(undefined);
|
||
destroyMock.mockReset();
|
||
attachToMock.mockReset();
|
||
getMock.mockClear();
|
||
onMock.mockReset();
|
||
ModelerCtor.mockClear();
|
||
mSource.mockReset().mockResolvedValue({ found: true, bpmnXml: SYNTHETIC_BPMN, idMap: { '总包合同交底': 'Proc_zbht' } });
|
||
mSourceByKey.mockReset().mockResolvedValue({ found: true, bpmnXml: SYNTHETIC_BPMN, idMap: { '总包合同交底': 'Proc_zbht' } });
|
||
mOptions.mockReset().mockResolvedValue([]);
|
||
mProfile.mockReset().mockReturnValue({ userId: 'ADMIN', account: 'admin', name: '管理员', roles: [] });
|
||
});
|
||
|
||
describe('ProcessModelerPage', () => {
|
||
it('admin 渲染画布容器与标准属性面板容器', async () => {
|
||
renderPage();
|
||
expect(screen.getByTestId('process-modeler-canvas')).toBeInTheDocument();
|
||
expect(screen.getByTestId('process-modeler-props')).toBeInTheDocument();
|
||
// flush Eip4Panel 挂载期 fetchWfTemplates 的 setState(避免 act 告警)
|
||
await act(async () => {
|
||
await Promise.resolve();
|
||
});
|
||
});
|
||
|
||
it('非 admin 降级为「仅管理员可用」文案,不渲染画布', () => {
|
||
mProfile.mockReturnValue({ userId: 'U9', account: 'zhang', name: '张三', roles: [] });
|
||
renderPage();
|
||
expect(screen.getByText(/仅管理员可用/)).toBeInTheDocument();
|
||
expect(screen.queryByTestId('process-modeler-canvas')).not.toBeInTheDocument();
|
||
});
|
||
|
||
it('?procDefId= 时载入存量流程并把返回的 bpmnXml 交给 Modeler.importXML', async () => {
|
||
renderPage('/process-modeler?procDefId=PD-1');
|
||
await waitFor(() => expect(mSource).toHaveBeenCalledWith('PD-1'));
|
||
await waitFor(() => expect(importXMLMock).toHaveBeenCalledWith(SYNTHETIC_BPMN));
|
||
expect(ModelerCtor).toHaveBeenCalledTimes(1);
|
||
});
|
||
|
||
it('构造后显式 attachTo 属性面板容器一次(修 live 面板从不挂载)', async () => {
|
||
renderPage('/process-modeler?procDefId=PD-1');
|
||
await waitFor(() => expect(attachToMock).toHaveBeenCalledTimes(1));
|
||
expect(attachToMock).toHaveBeenCalledWith(screen.getByTestId('process-modeler-props'));
|
||
});
|
||
|
||
it('接口 found:false 时显示未找到文案且不 importXML', async () => {
|
||
mSource.mockResolvedValue({ found: false });
|
||
renderPage('/process-modeler?procDefId=PD-x');
|
||
await waitFor(() => expect(screen.getByText(/未找到|无 BPMN|加载失败/)).toBeInTheDocument());
|
||
expect(importXMLMock).not.toHaveBeenCalled();
|
||
});
|
||
|
||
it('无参时展示「打开存量流程」选择器(数据源 process-select)', async () => {
|
||
mOptions.mockResolvedValue([{ label: '总包合同交底', value: '总包合同交底', source: 'model', id: 'MDL-1', key: 'zbht' }]);
|
||
renderPage();
|
||
await waitFor(() => expect(mOptions).toHaveBeenCalled());
|
||
expect(screen.getByTestId('process-modeler-open-select')).toBeInTheDocument();
|
||
expect(await screen.findByText('总包合同交底')).toBeInTheDocument();
|
||
});
|
||
|
||
it('?procKey= 时走 by-key 载入并 importXML(source=model 语义缺口修复)', async () => {
|
||
renderPage('/process-modeler?procKey=' + encodeURIComponent('总包合同交底'));
|
||
await waitFor(() => expect(mSourceByKey).toHaveBeenCalledWith('总包合同交底'));
|
||
await waitFor(() => expect(importXMLMock).toHaveBeenCalledWith(SYNTHETIC_BPMN));
|
||
expect(mSource).not.toHaveBeenCalled(); // 未走 by-id 路径
|
||
});
|
||
|
||
it('选中 source=model 选项 → 派到 by-key(procKey),不走 by-id', async () => {
|
||
mOptions.mockResolvedValue([{ label: '模型流程', value: '模型流程', source: 'model', id: 'MDL-9', key: 'MKEY' }]);
|
||
renderPage();
|
||
const select = await screen.findByTestId('process-modeler-open-select');
|
||
await screen.findByText('模型流程');
|
||
fireEvent.change(select, { target: { value: '0' } });
|
||
await waitFor(() => expect(mSourceByKey).toHaveBeenCalledWith('MKEY'));
|
||
expect(mSource).not.toHaveBeenCalled();
|
||
});
|
||
|
||
it('选中 source=processDefinition 选项 → 派到 by-id(procDefId)', async () => {
|
||
mOptions.mockResolvedValue([
|
||
{ label: '部署流程', value: '部署流程', source: 'processDefinition', id: '部署流程:3:uuid', key: 'k' },
|
||
]);
|
||
renderPage();
|
||
const select = await screen.findByTestId('process-modeler-open-select');
|
||
await screen.findByText('部署流程');
|
||
fireEvent.change(select, { target: { value: '0' } });
|
||
await waitFor(() => expect(mSource).toHaveBeenCalledWith('部署流程:3:uuid'));
|
||
expect(mSourceByKey).not.toHaveBeenCalled();
|
||
});
|
||
|
||
// 🔴 红线回归(T1.5 评审遗留 + T2.4 顺带收口):双包冲突会静默丢弃 userTask,
|
||
// 故构造参数必须锁死——moddleExtensions 键恰为 ['activiti'],additionalModules 长度恰 2。
|
||
// 防「顺手」加 Camunda provider / 双载 flowable 描述符导致静默回归。
|
||
it('红线:Modeler 构造参数 moddleExtensions 键恰 [activiti] 且 additionalModules 长度 2', async () => {
|
||
renderPage('/process-modeler?procDefId=PD-1');
|
||
await waitFor(() => expect(ModelerCtor).toHaveBeenCalledTimes(1));
|
||
const opts = ModelerCtor.mock.calls[0][0] as {
|
||
moddleExtensions: Record<string, unknown>;
|
||
additionalModules: unknown[];
|
||
};
|
||
expect(Object.keys(opts.moddleExtensions)).toEqual(['activiti']);
|
||
expect(opts.additionalModules).toHaveLength(2);
|
||
});
|
||
});
|