diff --git a/e2e/process-modeler.spec.ts b/e2e/process-modeler.spec.ts new file mode 100644 index 0000000..98953ad --- /dev/null +++ b/e2e/process-modeler.spec.ts @@ -0,0 +1,264 @@ +/** + * 在线流程 Modeler(B3)· 浏览器全程点穿 live e2e(实施计划 Task 4.2)。 + * + * 三场景(真部署真起实例真验收,不 mock): + * A 改存量全链:登录 admin → /process-modeler?procKey=总包合同交底 → 画布渲染 → 点会签 userTask「编写交底」 + * → EIP4 侧板会签控件可见且「启用会签」勾选(保真读回)→ 保存草稿(URL 回填 ?modelId=)→ 发布 + * (PublishConfirm 断言含流程 key「总包合同交底」+ 版本 + 运行中实例数)→ 确认 → apiJson 起实例 + * → trace 断言有 current userTask(证部署的存量流程经 moddle 往返后小写元素仍被引擎识别、可派任)。 + * B 新建全链:新建流程 → 选「会签」模板 + 填名称/key → 进编辑器(画布非空)→ 选 task_cosign 填会签办理人 + * content=ADMIN(否则空集合运行期被跳过、不生成任务)→ 保存草稿 → 发布 → 确认 → apiJson 起实例 + * → trace 断言 current userTask「会签审批」(证 bpmn-js 新建的小写 BPMN 部署后真产任务)。 + * C 走查 + 权限:①中文节点名渲染正常 ②palette 元素齐 ③标准属性面板 + EIP4 侧板同屏 + * ④超管门:非超管访问 deploy/models 网关端点断言 403(见下方 alice 降级说明)。 + * + * 依赖:8093 网关/后端 + 8089 flowable-service + 5173 vite dev 均在线(见 playwright.process-modeler.config.ts)。 + * 自检:curl -s -o /dev/null -w '%{http_code}' localhost:8093/v3/api-docs(200)、curl localhost:5173(200)。 + * 跑法:npx playwright test -c playwright.process-modeler.config.ts + * + * 数据纪律:afterAll 删本次建的草稿(act_re_model,DELETE /api/workflow/models/{id})。发布产生的流程新版本 + * 无运行时下架端点(同 §F net-new),属 live 验收固有副作用——每跑一次「总包合同交底」版本 +1、B 新建一个净新 key。 + * + * ⚠️ 场景 C④ alice 降级:dev 库无 alice/123456 账号(登录返 success:false),无法用真实非超管 token 打 deploy。 + * 降级为等价断言:非超管凭据(无 token)打 deploy/models → 403(走的正是 ProcessModelerController.requireSuperAdmin + * 的 principal==null → 非 isSystemAdmin → 403 分支,与「合法非超管 token → 403」同一段代码),并用 admin token + * 打 models → 200 作对照,证超管门确在按身份区分放行/拒绝。alice 登录失败一并断言以记录账号缺席事实。 + */ +import { expect, test } from '@playwright/test'; +import http from 'node:http'; + +// apiJson 直连后端 8093(与 UI 经 5173 vite 代理的目标同一后端,故 UI 建的草稿 apiJson 可见)。 +const BACKEND_PORT = 8093; +const ZONGBAO_KEY = '总包合同交底'; +// 存量会签流程「总包合同交底」的会签 userTask id(净化源里 sid- 前缀为 ASCII 不被改写,即 bpmn-js data-element-id)。 +const COSIGN_TASK_ID = 'sid-2AB0790B-7C9B-4872-8753-BC3DB644568C'; + +// 本次运行建的草稿 id,afterAll 清理。 +const createdModelIds: string[] = []; + +function apiJson( + method: string, + path: string, + token?: string, + body?: unknown, +): Promise<{ status: number; json: any }> { + return new Promise((resolve, reject) => { + const data = body ? JSON.stringify(body) : undefined; + const req = http.request( + { + hostname: 'localhost', + port: BACKEND_PORT, + path, + method, + headers: { + 'Content-Type': 'application/json', + ...(token ? { Authorization: `Bearer ${token}` } : {}), + ...(data ? { 'Content-Length': Buffer.byteLength(data) } : {}), + }, + }, + (res) => { + let buf = ''; + res.on('data', (c) => (buf += c)); + res.on('end', () => { + try { + resolve({ status: res.statusCode ?? 0, json: buf ? JSON.parse(buf) : null }); + } catch { + resolve({ status: res.statusCode ?? 0, json: buf }); + } + }); + }, + ); + req.on('error', reject); + if (data) req.write(data); + req.end(); + }); +} + +async function adminToken(): Promise { + const r = await apiJson('POST', '/api/auth/login', undefined, { account: 'admin', password: '111111' }); + return r.json.token as string; +} + +// 真实 React 登录表单(复用 five-ring 惯例:第一个 textbox=账号、type=password=密码、按钮「登录」)。 +async function loginAdmin(page: import('@playwright/test').Page) { + await page.goto('/login'); + await page.getByRole('textbox').first().fill('admin'); + await page.locator('input[type="password"]').fill('111111'); + await page.getByRole('button', { name: '登录' }).click(); + await page.waitForURL((u) => !u.pathname.endsWith('/login'), { timeout: 15_000 }); +} + +// 点击画布上指定 BPMN 元素(bpmn-js 在 shape g 上挂 data-element-id)。 +async function selectBpmnElement(page: import('@playwright/test').Page, elementId: string) { + const el = page.locator(`[data-testid="process-modeler-canvas"] [data-element-id="${elementId}"]`); + await expect(el).toBeVisible({ timeout: 15_000 }); + await el.click(); +} + +// 记住 URL 里回填的 ?modelId=,供 afterAll 清理。 +function rememberModelId(page: import('@playwright/test').Page): string { + const id = new URL(page.url()).searchParams.get('modelId') ?? ''; + if (id && !createdModelIds.includes(id)) createdModelIds.push(id); + return id; +} + +// 起实例 + trace 断言:部署的流程 start 后必有 current userTask(证小写元素被引擎识别并派任)。 +async function assertTaskGenerated(key: string, businessKey: string, token: string): Promise { + const started = await apiJson('POST', '/api/process/start', token, { + processDefinitionKey: key, + businessKey, + }); + expect(started.status, 'start 应 200').toBe(200); + const iid = started.json?.id; + expect(iid, 'start 应返回流程实例 id').toBeTruthy(); + await expect + .poll( + async () => { + const t = await apiJson('GET', `/api/flow/process/${iid}/trace`, token); + const rows = Array.isArray(t.json) ? t.json : (t.json?.data ?? []); + return (rows as any[]).filter((r) => r && r.current && r.taskId).length; + }, + { timeout: 15_000, message: `${key} start 后应有 current userTask(证部署流程含真 userTask)` }, + ) + .toBeGreaterThan(0); +} + +test.afterAll(async () => { + try { + const tok = await adminToken(); + for (const id of createdModelIds) { + await apiJson('DELETE', `/api/workflow/models/${id}`, tok); + } + } catch { + /* 清理尽力而为 */ + } +}); + +// ──────────────────────────────────────────────────────────────────────────── +// 场景 A:改存量全链(打开→会签保真读回→存草稿→发布→起实例→任务生成) +// ──────────────────────────────────────────────────────────────────────────── +test('场景A 改存量全链:总包合同交底 打开→会签读回→存草稿→发布→起实例生成任务', async ({ page }) => { + test.setTimeout(150_000); + await loginAdmin(page); + + // 打开存量会签流程(中文 key 必须 encodeURIComponent 进 URL)。 + await page.goto(`/process-modeler?procKey=${encodeURIComponent(ZONGBAO_KEY)}`); + // 画布渲染完成:出现 bpmn 元素(.djs-element)。 + await expect(page.locator('[data-testid="process-modeler-canvas"] .djs-element').first()).toBeVisible({ + timeout: 30_000, + }); + + // 点会签 userTask「编写交底」→ EIP4 侧板会签控件可见 + 「启用会签」勾选(保真读回存量会签配置)。 + await selectBpmnElement(page, COSIGN_TASK_ID); + await expect(page.getByTestId('process-modeler-eip4-panel')).toBeVisible(); + await expect(page.getByTestId('eip4-cosign-toggle')).toBeChecked(); + + // 保存草稿 → URL 回填 ?modelId=(存量按 key 打开走 createDraft)。 + await page.getByTestId('process-modeler-save-draft').click(); + await page.waitForURL(/[?&]modelId=/, { timeout: 20_000 }); + const modelId = rememberModelId(page); + expect(modelId, '存草稿后 URL 应回填 modelId').toBeTruthy(); + + // 存草稿会以 modelId 重载画布——等发布按钮重新可用(modelerReady)再点发布。 + await expect(page.getByTestId('process-modeler-publish')).toBeEnabled({ timeout: 20_000 }); + await page.getByTestId('process-modeler-publish').click(); + + // 同人确认弹窗:断言影响摘要含流程 key「总包合同交底」+ 版本迁移 + 运行中实例数。 + await expect(page.getByTestId('process-modeler-publish-confirm')).toBeVisible({ timeout: 20_000 }); + await expect(page.getByTestId('publish-impact-key')).toContainText(ZONGBAO_KEY); + await expect(page.getByTestId('publish-impact-version')).toContainText(/首次发布|v\d+\s*→\s*v\d+/); + await expect(page.getByTestId('publish-impact-instances')).toHaveText(/\d/); + + // 确认发布 → 成功后弹窗关闭(onPublished→onClose)。 + await page.getByTestId('publish-confirm-btn').click(); + await expect(page.getByTestId('process-modeler-publish-confirm')).toBeHidden({ timeout: 30_000 }); + + // 起实例 + trace 断言:部署的新版本 start 后有 current userTask。 + const tok = await adminToken(); + await assertTaskGenerated(ZONGBAO_KEY, `E2E-A-${Date.now()}`, tok); +}); + +// ──────────────────────────────────────────────────────────────────────────── +// 场景 B:新建全链(会签模板→填办理人→存草稿→发布→起实例→任务生成) +// ──────────────────────────────────────────────────────────────────────────── +test('场景B 新建全链:会签模板新建→填办理人→存草稿→发布→起实例生成任务', async ({ page }) => { + test.setTimeout(150_000); + const newKey = `e2anew${Date.now()}`; // ASCII NCName → 直接作 process id,无需 idMap 还原 + await loginAdmin(page); + + await page.goto('/process-modeler'); + // 打开器「+ 新建流程」→ NewProcessDialog。 + await page.getByTestId('process-modeler-new').click(); + await page.getByTestId('new-process-name').fill('会签E2E演示'); + await page.getByTestId('new-process-key').fill(newKey); + await page.getByTestId('new-process-template').selectOption('cosign'); + await page.getByTestId('new-process-confirm').click(); + + // 进编辑器:画布非空(模板实例化)。 + await expect(page.locator('[data-testid="process-modeler-canvas"] .djs-element').first()).toBeVisible({ + timeout: 20_000, + }); + + // 选会签 userTask(模板 id=task_cosign)→ 会签已启用(保真)→ 填办理人 content=ADMIN + //(会签集合非空,运行期才真产任务;空 content 会被 MI 跳过导致流程直接结束、无任务)。 + await selectBpmnElement(page, 'task_cosign'); + await expect(page.getByTestId('eip4-cosign-toggle')).toBeChecked(); + await page.getByTestId('eip4-cosign-content-0').fill('ADMIN'); + + // 保存草稿 → URL 回填 modelId。 + await page.getByTestId('process-modeler-save-draft').click(); + await page.waitForURL(/[?&]modelId=/, { timeout: 20_000 }); + rememberModelId(page); + + // 发布。 + await expect(page.getByTestId('process-modeler-publish')).toBeEnabled({ timeout: 20_000 }); + await page.getByTestId('process-modeler-publish').click(); + await expect(page.getByTestId('process-modeler-publish-confirm')).toBeVisible({ timeout: 20_000 }); + await expect(page.getByTestId('publish-impact-key')).toContainText(newKey); + await page.getByTestId('publish-confirm-btn').click(); + await expect(page.getByTestId('process-modeler-publish-confirm')).toBeHidden({ timeout: 30_000 }); + + // 起实例 + trace 断言:新建部署的会签流程 start 后有 current userTask。 + const tok = await adminToken(); + await assertTaskGenerated(newKey, `E2E-B-${Date.now()}`, tok); +}); + +// ──────────────────────────────────────────────────────────────────────────── +// 场景 C:走查(中文节点/palette/双面板同屏)+ 权限(超管门 403) +// ──────────────────────────────────────────────────────────────────────────── +test('场景C 走查+权限:中文节点/palette/标准面板+EIP4侧板同屏 + 超管门403', async ({ page }) => { + test.setTimeout(120_000); + await loginAdmin(page); + await page.goto(`/process-modeler?procKey=${encodeURIComponent(ZONGBAO_KEY)}`); + const canvas = page.locator('[data-testid="process-modeler-canvas"]'); + await expect(canvas.locator('.djs-element').first()).toBeVisible({ timeout: 30_000 }); + + // ① 中文节点名渲染正常(存量会签流程节点「编写交底」「接收交底」)。 + await expect(canvas.getByText('编写交底')).toBeVisible(); + await expect(canvas.getByText('接收交底')).toBeVisible(); + + // ② palette 元素齐(bpmn-js Modeler 左侧工具箱有多个可拖建条目)。 + await expect(page.locator('[data-testid="process-modeler-root"] .djs-palette').first()).toBeVisible(); + expect(await page.locator('[data-testid="process-modeler-root"] .djs-palette .entry').count()).toBeGreaterThan(4); + + // ③ 标准属性面板 + EIP4 侧板同屏(选中会签 userTask 后 EIP4 侧板出真控件,与标准面板宿主并存)。 + await selectBpmnElement(page, COSIGN_TASK_ID); + await expect(page.getByTestId('process-modeler-eip4-panel')).toBeVisible(); + await expect(page.getByTestId('eip4-cosign-toggle')).toBeVisible(); + await expect(page.getByTestId('process-modeler-props')).toBeVisible(); + + // ④ 超管门 403:dev 库无 alice/123456 → 降级为「非超管凭据打 deploy/models → 403」等价断言。 + const alice = await apiJson('POST', '/api/auth/login', undefined, { account: 'alice', password: '123456' }); + expect(alice.json?.success, 'dev 库无 alice 账号(记录账号缺席)').toBeFalsy(); + + // 无 token(非超管)打 Modeler 网关端点 → requireSuperAdmin 拒 403(与合法非超管 token 同一拒绝分支)。 + const denyDeploy = await apiJson('POST', '/api/workflow/models/nonexistent/deploy'); + expect(denyDeploy.status, '非超管访问 deploy 端点应 403').toBe(403); + const denyModels = await apiJson('GET', '/api/workflow/models'); + expect(denyModels.status, '非超管访问 models 列表应 403').toBe(403); + + // 对照:admin(超管)打 models → 200,证超管门按身份区分放行,非一律拒。 + const tok = await adminToken(); + const allowModels = await apiJson('GET', '/api/workflow/models', tok); + expect(allowModels.status, 'admin 超管访问 models 应 200').toBe(200); +}); diff --git a/playwright.process-modeler.config.ts b/playwright.process-modeler.config.ts new file mode 100644 index 0000000..8bce749 --- /dev/null +++ b/playwright.process-modeler.config.ts @@ -0,0 +1,36 @@ +import { defineConfig, devices } from '@playwright/test'; + +// 在线流程 Modeler live e2e 专用配置(T4.2)。 +// +// 复用主会话已在跑的 vite dev(5173,vite.config 默认 proxy /api → http://localhost:8093), +// 后端指向当前 live 的 8093 网关 + 8089 flowable-service + 真库 eip4(含 T3.1/T3.2/T4.1 全部新代码)。 +// 与 fivering 配置(自起 vite 5174 → 8094)隔离:本配置 reuseExistingServer 复用 5173,不新起端口。 +// +// 依赖(跑前须在线,spec 头注释有 curl 自检): +// - 8093 网关/后端(curl -s -o /dev/null -w '%{http_code}' localhost:8093/v3/api-docs → 200) +// - 8089 flowable-service(经 8093 转发;start/trace 走它) +// - 5173 vite dev(curl localhost:5173 → 200;apiJson 直连 8093,与 UI 经 5173 代理同一后端) +// 跑法:npx playwright test -c playwright.process-modeler.config.ts +export default defineConfig({ + testDir: './e2e', + testMatch: /process-modeler\.spec\.ts/, + fullyParallel: false, + workers: 1, + timeout: 180_000, + reporter: [['list']], + use: { + baseURL: 'http://localhost:5173', + trace: 'off', + screenshot: 'only-on-failure', + }, + projects: [{ name: 'chromium', use: { ...devices['Desktop Chrome'] } }], + webServer: { + // reuseExistingServer:true → 5173 已在跑(主会话 npm run dev)则复用、不新起; + // 未跑时按 dev 同口径(VITE_BACKEND_TARGET=8093)拉起。 + command: + 'NODE_OPTIONS=--max-http-header-size=65536 VITE_BACKEND_TARGET=http://localhost:8093 npx vite --port 5173 --strictPort', + url: 'http://localhost:5173', + reuseExistingServer: true, + timeout: 120_000, + }, +}); diff --git a/src/modeler/NewProcessDialog.test.tsx b/src/modeler/NewProcessDialog.test.tsx new file mode 100644 index 0000000..1c77fc3 --- /dev/null +++ b/src/modeler/NewProcessDialog.test.tsx @@ -0,0 +1,94 @@ +import { describe, it, expect, vi } from 'vitest'; +import { render, screen, fireEvent } from '@testing-library/react'; +import { NewProcessDialog, type NewProcessResult } from './NewProcessDialog'; + +function renderDialog() { + const onConfirm = vi.fn<[NewProcessResult], void>(); + const onClose = vi.fn(); + render(); + return { onConfirm, onClose }; +} + +describe('NewProcessDialog', () => { + it('渲染名称/key/模板三字段', () => { + renderDialog(); + expect(screen.getByTestId('new-process-name')).toBeInTheDocument(); + expect(screen.getByTestId('new-process-key')).toBeInTheDocument(); + expect(screen.getByTestId('new-process-template')).toBeInTheDocument(); + // 模板下拉含四个模板 + expect(screen.getByText('空白流程')).toBeInTheDocument(); + expect(screen.getByText('单人审批')).toBeInTheDocument(); + expect(screen.getByText('两级审批')).toBeInTheDocument(); + expect(screen.getByText('会签')).toBeInTheDocument(); + }); + + it('name/key 任一为空 → 确认禁用且 onConfirm 不触发', () => { + const { onConfirm } = renderDialog(); + const confirm = screen.getByTestId('new-process-confirm'); + expect(confirm).toBeDisabled(); + // 只填 name,key 仍空 → 仍禁用 + fireEvent.change(screen.getByTestId('new-process-name'), { target: { value: '请假审批' } }); + expect(confirm).toBeDisabled(); + fireEvent.click(confirm); + expect(onConfirm).not.toHaveBeenCalled(); + }); + + it('key 仅空白也判无效', () => { + renderDialog(); + fireEvent.change(screen.getByTestId('new-process-name'), { target: { value: 'n' } }); + fireEvent.change(screen.getByTestId('new-process-key'), { target: { value: ' ' } }); + expect(screen.getByTestId('new-process-confirm')).toBeDisabled(); + }); + + it('填齐 + 选会签模板 → 确认,onConfirm 收到实例化 XML(含 multiInstance,占位符已替换)', () => { + const { onConfirm } = renderDialog(); + fireEvent.change(screen.getByTestId('new-process-name'), { target: { value: '合同会签' } }); + fireEvent.change(screen.getByTestId('new-process-key'), { target: { value: 'contractCosign' } }); + fireEvent.change(screen.getByTestId('new-process-template'), { target: { value: 'cosign' } }); + fireEvent.click(screen.getByTestId('new-process-confirm')); + expect(onConfirm).toHaveBeenCalledTimes(1); + const r = onConfirm.mock.calls[0][0]; + expect(r.name).toBe('合同会签'); + expect(r.key).toBe('contractCosign'); + // process id/key 已替换为用户输入(ASCII key),占位符无残留。 + expect(r.xml).toContain('id="contractCosign"'); + expect(r.xml).toContain('bpmnElement="contractCosign"'); + expect(r.xml).not.toContain('__PROCESS_ID__'); + expect(r.xml).not.toContain('__PROCESS_NAME__'); + // 选中的是会签模板。 + expect(r.xml).toContain('multiInstanceLoopCharacteristics'); + expect(r.idMap).toEqual({}); + }); + + it('默认模板为空白流程(不含 userTask)', () => { + const { onConfirm } = renderDialog(); + fireEvent.change(screen.getByTestId('new-process-name'), { target: { value: '空白' } }); + fireEvent.change(screen.getByTestId('new-process-key'), { target: { value: 'blankProc' } }); + fireEvent.click(screen.getByTestId('new-process-confirm')); + const r = onConfirm.mock.calls[0][0]; + expect(r.xml).not.toContain('userTask'); + expect(r.xml).toContain('id="blankProc"'); + }); + + it('中文 key → onConfirm.idMap 记录 {中文 key→净化 ASCII id},XML 内 process id 为 ASCII', () => { + const { onConfirm } = renderDialog(); + fireEvent.change(screen.getByTestId('new-process-name'), { target: { value: '总包合同交底' } }); + fireEvent.change(screen.getByTestId('new-process-key'), { target: { value: '总包合同交底' } }); + fireEvent.change(screen.getByTestId('new-process-template'), { target: { value: 'single-approval' } }); + fireEvent.click(screen.getByTestId('new-process-confirm')); + const r = onConfirm.mock.calls[0][0]; + expect(r.key).toBe('总包合同交底'); + expect(Object.keys(r.idMap)).toEqual(['总包合同交底']); + const asciiId = r.idMap['总包合同交底']; + expect(asciiId).toMatch(/^[A-Za-z_][A-Za-z0-9_.-]*$/); // ASCII NCName + expect(r.xml).toContain('id="' + asciiId + '"'); + expect(r.xml).not.toContain('id="总包合同交底"'); // moddle 拒中文 id + }); + + it('取消 → onClose,不 onConfirm', () => { + const { onConfirm, onClose } = renderDialog(); + fireEvent.click(screen.getByTestId('new-process-cancel')); + expect(onClose).toHaveBeenCalled(); + expect(onConfirm).not.toHaveBeenCalled(); + }); +}); diff --git a/src/modeler/NewProcessDialog.tsx b/src/modeler/NewProcessDialog.tsx new file mode 100644 index 0000000..f582567 --- /dev/null +++ b/src/modeler/NewProcessDialog.tsx @@ -0,0 +1,113 @@ +// 新建流程对话框(T4.1)。 +// +// 字段:名称(展示名)/ key(流程标识,允许中文——引擎 process key 既有中文事实)/ 模板下拉。 +// 确认时按选中模板 + 用户输入实例化 XML(buildNewProcessXml 替换占位符、按 key 定 ASCII process id +// 并算发布还原 idMap),把结果交父页进入编辑态(父页 importXML,尚未存草稿)。 +import { useState } from 'react'; +import { Dialog } from '../components/ui'; +import { PROCESS_TEMPLATES, getTemplate, buildNewProcessXml } from './templates'; + +/** 新建结果:交父页 importXML + 首存草稿用(name→草稿名/process name,key→草稿 key,idMap→metaInfo)。 */ +export interface NewProcessResult { + name: string; + key: string; + /** 实例化后的 BPMN(占位符已替换,可直接 importXML)。 */ + xml: string; + /** 发布还原映射(中文 key 时 {原 key→净化 id},ASCII key 时空)。 */ + idMap: Record; +} + +interface NewProcessDialogProps { + onConfirm: (r: NewProcessResult) => void; + onClose: () => void; +} + +export function NewProcessDialog({ onConfirm, onClose }: NewProcessDialogProps) { + const [name, setName] = useState(''); + const [key, setKey] = useState(''); + const [templateId, setTemplateId] = useState(PROCESS_TEMPLATES[0].id); + + const nameOk = name.trim().length > 0; + const keyOk = key.trim().length > 0; + const valid = nameOk && keyOk; + + function handleConfirm() { + if (!valid) return; + const tpl = getTemplate(templateId); + if (!tpl) return; + const built = buildNewProcessXml(tpl.xml, name, key); + onConfirm({ name: name.trim(), key: key.trim(), xml: built.xml, idMap: built.idMap }); + } + + const foot = ( + <> + + + + ); + + return ( + +
+ + setName(e.target.value)} + placeholder="如:请假审批" + style={inputStyle} + /> + + + setKey(e.target.value)} + placeholder="如:leaveApply 或 请假审批" + style={inputStyle} + /> + + + + + {!valid ? ( +
+ 请填写流程名称与 key。 +
+ ) : null} +
+
+ ); +} + +function Field({ label, hint, children }: { label: string; hint?: string; children: React.ReactNode }) { + return ( + + ); +} + +const inputStyle: React.CSSProperties = { width: '100%', padding: '6px 8px', boxSizing: 'border-box' }; diff --git a/src/modeler/templates/blank.bpmn.ts b/src/modeler/templates/blank.bpmn.ts new file mode 100644 index 0000000..6b06e1d --- /dev/null +++ b/src/modeler/templates/blank.bpmn.ts @@ -0,0 +1,35 @@ +// 新建流程模板——空白(1 startEvent + 1 endEvent,供纯手绘)。 +// +// ⚠️ CRITICAL(阶段 3 教训):元素名一律**全小写**(…); +// 缺 isExecutable="true" 会被 Flowable ProcessValidator 拒(看到 0 个可执行流程);缺完整 +// BPMNDiagram DI 则画布空白。故模板源字符串即含小写元素名 + isExecutable + 完整 DI。 +// +// 占位符(由 templates/index.ts 的 buildNewProcessXml 实例化替换): +// __PROCESS_ID__ —— 进 与 (决定 process key)。 +// 本身是合法 NCName(`_`+大写字母+`_`),故未替换的原模板也能过 moddle 校验。 +// __PROCESS_NAME__ —— 进 (展示名,name 属性对 NCName 无限制)。 +// +// 空白模板 start→end 直连即最小可部署流程,用户在流上插入节点或另起手绘。 + +export const BLANK_BPMN = ` + + + + + + + + + + + + + + + + + + + + +`; diff --git a/src/modeler/templates/cosign.bpmn.ts b/src/modeler/templates/cosign.bpmn.ts new file mode 100644 index 0000000..100768d --- /dev/null +++ b/src/modeler/templates/cosign.bpmn.ts @@ -0,0 +1,46 @@ +// 新建流程模板——会签(start → 多实例 userTask → end)。 +// +// userTask 挂 multiInstanceLoopCharacteristics(并行): +// - activiti:collection = multiInstance 表达式(multiInstanceUsersHandler.getUsers,全角【】+ +// items 一项 type:user;逐字对齐 candidateExpression codec 的 'multiInstance' 变体 build 输出)。 +// - activiti:elementVariable="assignee" + userTask activiti:assignee="${assignee}":每个实例把 +// 集合元素绑到 assignee 变量再据此派任(对照真实会签流「总包合同交底」结构)。 +// - completionCondition ${nrOfCompletedInstances/nrOfInstances==1}(全票通过,对齐侧板 all 预设)。 +// +// 约束同其余模板:全小写元素名 + isExecutable + 完整 DI + 占位符。 + +export const COSIGN_BPMN = ` + + + + + + \${nrOfCompletedInstances/nrOfInstances==1} + + + + + + + + + + + + + + + + + + + + + + + + + + + +`; diff --git a/src/modeler/templates/index.ts b/src/modeler/templates/index.ts new file mode 100644 index 0000000..fab37af --- /dev/null +++ b/src/modeler/templates/index.ts @@ -0,0 +1,95 @@ +// 新建流程模板库 + 实例化助手(T4.1 §0.5 P3)。 +// +// 四个模板以真实流程结构为骨架抽形;模板源用占位符 __PROCESS_ID__ / __PROCESS_NAME__, +// 由 {@link buildNewProcessXml} 按用户输入的 key/名称实例化替换。 +// +// 🔑 中文 key 与 moddle 的冲突:bpmn-moddle 拒非 ASCII 的 process id(NCName 校验),故进 +// Modeler 的 XML 里 必须是 ASCII。方案对齐存量改造链(后端 BpmnIdSanitizer + 发布 +// restore): +// - key 是合法 ASCII NCName → 直接用作 process id,idMap 空(发布即以该 key 部署,无需还原)。 +// - key 含中文等非法字符 → process id 用稳定 ASCII(与 BpmnIdSanitizer 同哈希方案), +// idMap={原中文 key → 净化 id};发布时后端按 metaInfo.eip4IdMap restore 回中文 key(process +// key = XML ,见 ProcessModelController.deploy)。 + +import { BLANK_BPMN } from './blank.bpmn'; +import { SINGLE_APPROVAL_BPMN } from './single-approval.bpmn'; +import { TWO_LEVEL_BPMN } from './two-level.bpmn'; +import { COSIGN_BPMN } from './cosign.bpmn'; + +export interface ProcessTemplate { + id: string; + label: string; + /** 未实例化的模板源(含 __PROCESS_ID__/__PROCESS_NAME__ 占位符)。 */ + xml: string; +} + +export const PROCESS_TEMPLATES: ProcessTemplate[] = [ + { id: 'blank', label: '空白流程', xml: BLANK_BPMN }, + { id: 'single-approval', label: '单人审批', xml: SINGLE_APPROVAL_BPMN }, + { id: 'two-level', label: '两级审批', xml: TWO_LEVEL_BPMN }, + { id: 'cosign', label: '会签', xml: COSIGN_BPMN }, +]; + +export function getTemplate(id: string): ProcessTemplate | undefined { + return PROCESS_TEMPLATES.find((t) => t.id === id); +} + +/** ASCII NCName 判定(逐字对齐后端 BpmnIdSanitizer.isValidNcName:首字符字母/下划线,余加数字/-/.)。 */ +export function isAsciiNcName(s: string): boolean { + return /^[A-Za-z_][A-Za-z0-9_.\-]*$/.test(s); +} + +/** Java String.hashCode(int 溢出语义),与后端 BpmnIdSanitizer 的净化 id 生成一致。 */ +function javaHashCode(s: string): number { + let h = 0; + for (let i = 0; i < s.length; i++) { + h = (Math.imul(31, h) + s.charCodeAt(i)) | 0; + } + return h; +} + +/** + * 中文等非法 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); +} + +/** 属性值 XML 转义(name 进 name="…",须转义 & < > " 与 ')。 */ +function xmlEscapeAttr(s: string): string { + return s + .replace(/&/g, '&') + .replace(//g, '>') + .replace(/"/g, '"') + .replace(/'/g, '''); +} + +export interface NewProcessXml { + /** 实例化后的 BPMN(占位符已替换,可直接 importXML)。 */ + xml: string; + /** 实际写入 的 ASCII id。 */ + processId: string; + /** 发布还原映射;ASCII key 时为空对象。 */ + idMap: Record; +} + +/** + * 用用户输入的名称/key 实例化模板:把 __PROCESS_ID__ 换成 ASCII 的 processId、__PROCESS_NAME__ 换成 + * 转义后的展示名。返回实例化 XML + 发布还原用的 idMap。key 前后空白已 trim。 + */ +export function buildNewProcessXml(templateXml: string, name: string, key: string): NewProcessXml { + const trimmedKey = key.trim(); + const processId = isAsciiNcName(trimmedKey) ? trimmedKey : sanitizedId(trimmedKey); + const idMap = processId === trimmedKey ? {} : { [trimmedKey]: processId }; + const xml = templateXml + .split('__PROCESS_ID__') + .join(processId) + .split('__PROCESS_NAME__') + .join(xmlEscapeAttr(name.trim())); + return { xml, processId, idMap }; +} diff --git a/src/modeler/templates/single-approval.bpmn.ts b/src/modeler/templates/single-approval.bpmn.ts new file mode 100644 index 0000000..f245010 --- /dev/null +++ b/src/modeler/templates/single-approval.bpmn.ts @@ -0,0 +1,41 @@ +// 新建流程模板——单人审批(start → 1 userTask → end)。 +// +// userTask 带 activiti:candidateUsers 示例表达式:外层对象用**全角【】**包裹(引擎运行期 +// CandidateUsersHandler 全局 【→{ 还原为 JSON),items 一项 type:user(content 留空供用户在 +// EIP4 侧板填人员 id)。逐字对齐 candidateExpression codec 的 build 输出: +// businessObject 值层:${candidateUsersHandler.getCandidateUsers(execution,'【"items":[…】]】')} +// XML 属性层:内层引号写作 "(属性以 " 分隔)。 +// +// 约束同 blank:全小写元素名 + isExecutable="true" + 完整 DI;占位符 __PROCESS_ID__/__PROCESS_NAME__。 + +export const SINGLE_APPROVAL_BPMN = ` + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +`; diff --git a/src/modeler/templates/templates.test.ts b/src/modeler/templates/templates.test.ts new file mode 100644 index 0000000..e078c1b --- /dev/null +++ b/src/modeler/templates/templates.test.ts @@ -0,0 +1,204 @@ +import { describe, it, expect } from 'vitest'; +import BpmnModdle from 'bpmn-moddle'; +import activiti from '../moddle/activiti.json'; +import { + PROCESS_TEMPLATES, + buildNewProcessXml, + isAsciiNcName, +} from './index'; +import { buildCandidateExpression, type UserPropertyItem } from '../candidateExpression'; + +// 模板可部署前提的三重门(对照 T4.1): +// ① bpmn-moddle fromXML 无警告(结构合法,activiti 扩展属性全被描述符识别)。 +// ② 真序列化(fromXML→toXML)后基础元素名**全小写**——防 PascalCase 回归(Flowable 大小写敏感, +// / 会被 ProcessValidator 判 0 个可执行流程、部署失败,见 moddle/serialization.test)。 +// ③ 保留 isExecutable="true"(缺则 ProcessValidator 拒)。 +// ④ 会签模板含 multiInstanceLoopCharacteristics。 +// 均用**实例化后**(buildNewProcessXml 替换占位符)的 XML,逐字复现新建流程真正 importXML/部署的源。 + +/** 元素名正则(可选 bpmn: 前缀 + 精确 token + 分隔符),大小写敏感(同 serialization.test)。 */ +const openTag = (name: string) => new RegExp('<(bpmn:)?' + name + '[\\s/>]'); + +// [小写名, PascalCase 名]——出现小写即断言对应 PascalCase 不出现。 +const BASE_TYPES: Array<[lower: string, pascal: string]> = [ + ['definitions', 'Definitions'], + ['process', 'Process'], + ['startEvent', 'StartEvent'], + ['endEvent', 'EndEvent'], + ['sequenceFlow', 'SequenceFlow'], + ['userTask', 'UserTask'], + ['multiInstanceLoopCharacteristics', 'MultiInstanceLoopCharacteristics'], +]; + +async function roundTrip(xml: string): Promise<{ out: string; warnings: unknown[] }> { + const moddle = new BpmnModdle({ activiti }); + const { rootElement, warnings } = await moddle.fromXML(xml); + const { xml: out } = await moddle.toXML(rootElement, { format: true }); + return { out, warnings: warnings ?? [] }; +} + +describe('新建流程模板库', () => { + it('登记齐 4 个模板(空白/单人/两级/会签)', () => { + expect(PROCESS_TEMPLATES.map((t) => t.id)).toEqual([ + 'blank', + 'single-approval', + 'two-level', + 'cosign', + ]); + }); + + for (const t of PROCESS_TEMPLATES) { + describe(`模板 ${t.id}`, () => { + // ASCII key → process id 直接用 key,不引 idMap;此实例化 XML 即真正被 importXML/部署的源。 + const { xml, processId, idMap } = buildNewProcessXml(t.xml, '测试流程', 'TestProc'); + + it('占位符已全部替换(无 __PROCESS_ID__/__PROCESS_NAME__ 残留)', () => { + expect(xml).not.toContain('__PROCESS_ID__'); + expect(xml).not.toContain('__PROCESS_NAME__'); + expect(processId).toBe('TestProc'); + expect(idMap).toEqual({}); + }); + + it('① bpmn-moddle fromXML 无警告(结构合法)', async () => { + const { warnings } = await roundTrip(xml); + expect(warnings).toEqual([]); + }); + + it('② 真序列化后基础元素名全小写(无 PascalCase,Flowable 可识别)', async () => { + const { out } = await roundTrip(xml); + for (const [lower, pascal] of BASE_TYPES) { + if (openTag(lower).test(out)) { + expect(out, `不应含 PascalCase <${pascal}>`).not.toMatch(openTag(pascal)); + } + } + // 每个模板至少含小写 process/startEvent/endEvent/sequenceFlow。 + for (const lower of ['process', 'startEvent', 'endEvent', 'sequenceFlow']) { + expect(out, `应含小写 <${lower}>`).toMatch(openTag(lower)); + } + }); + + it('③ 保留 isExecutable="true"(ProcessValidator 前提)', async () => { + const { out } = await roundTrip(xml); + expect(out).toMatch(/<(bpmn:)?process[\s][^>]*isExecutable="true"/); + }); + + it('含完整 BPMNDiagram DI(画布不空白)', () => { + expect(xml).toContain('BPMNDiagram'); + expect(xml).toContain('BPMNPlane'); + }); + }); + } + + it('④ 会签模板含 multiInstanceLoopCharacteristics + elementVariable + 完成条件', async () => { + const cosign = PROCESS_TEMPLATES.find((t) => t.id === 'cosign')!; + const { xml } = buildNewProcessXml(cosign.xml, '会签流程', 'CosignProc'); + const { out } = await roundTrip(xml); + expect(out).toMatch(openTag('multiInstanceLoopCharacteristics')); + expect(out).toContain('elementVariable="assignee"'); + expect(out).toMatch(/completionCondition/); + }); + + it('单人/两级/会签模板均含 userTask(空白模板不含)', async () => { + for (const id of ['single-approval', 'two-level', 'cosign']) { + const t = PROCESS_TEMPLATES.find((x) => x.id === id)!; + const { out } = await roundTrip(buildNewProcessXml(t.xml, 'n', 'K').xml); + expect(out, `${id} 应含 userTask`).toMatch(openTag('userTask')); + } + const blank = PROCESS_TEMPLATES.find((x) => x.id === 'blank')!; + const { out } = await roundTrip(buildNewProcessXml(blank.xml, 'n', 'K').xml); + expect(out).not.toMatch(openTag('userTask')); + }); +}); + +describe('buildNewProcessXml —— key/名称替换', () => { + const single = PROCESS_TEMPLATES.find((t) => t.id === 'single-approval')!; + + it('ASCII key 直接作 process id,idMap 空', () => { + const { xml, processId, idMap } = buildNewProcessXml(single.xml, '请假审批', 'LeaveApply'); + expect(processId).toBe('LeaveApply'); + expect(idMap).toEqual({}); + expect(xml).toContain('id="LeaveApply"'); + expect(xml).toContain('bpmnElement="LeaveApply"'); // DI plane 引用同步替换 + }); + + it('中文 key → process id 净化为 ASCII,idMap={原 key→净化 id},XML 内无中文 id', async () => { + const { xml, processId, idMap } = buildNewProcessXml(single.xml, '总包合同交底', '总包合同交底'); + expect(isAsciiNcName(processId)).toBe(true); + expect(idMap).toEqual({ 总包合同交底: processId }); + expect(xml).toContain('id="' + processId + '"'); + expect(xml).toContain('bpmnElement="' + processId + '"'); + // moddle 拒中文 id:中文 key 实例化后仍能 fromXML(证明 id 已净化为 ASCII)。 + const { warnings } = await roundTrip(xml); + expect(warnings).toEqual([]); + }); + + it('展示名进 process name(中文/特殊字符转义,round-trip 还原原文)', async () => { + const { xml } = buildNewProcessXml(single.xml, 'A&B <测试>', 'K'); + expect(xml).toContain('name="A&B <测试>"'); + const moddle = new BpmnModdle({ activiti }); + const { rootElement } = await moddle.fromXML(xml); + const proc = (rootElement as { rootElements: Array<{ $type: string; name?: string }> }).rootElements.find( + (e) => e.$type === 'bpmn:Process', + ); + expect(proc?.name).toBe('A&B <测试>'); + }); + + it('key 前后空白 trim 后再判定/替换', () => { + const { processId, idMap } = buildNewProcessXml(single.xml, 'n', ' LeaveApply '); + expect(processId).toBe('LeaveApply'); + 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')); + }); +}); diff --git a/src/modeler/templates/two-level.bpmn.ts b/src/modeler/templates/two-level.bpmn.ts new file mode 100644 index 0000000..4b634d5 --- /dev/null +++ b/src/modeler/templates/two-level.bpmn.ts @@ -0,0 +1,45 @@ +// 新建流程模板——两级审批(start → 一级 userTask → 二级 userTask → end)。 +// +// 两个 userTask 各带 activiti:candidateUsers(type:user,content 留空供侧板填人);结构、 +// 全角【】/" 转义、约束(全小写元素名 + isExecutable + 完整 DI + 占位符)同 single-approval。 + +export const TWO_LEVEL_BPMN = ` + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +`; diff --git a/src/pages/ProcessModelerPage.test.tsx b/src/pages/ProcessModelerPage.test.tsx index 598df8b..cdbfbdc 100644 --- a/src/pages/ProcessModelerPage.test.tsx +++ b/src/pages/ProcessModelerPage.test.tsx @@ -370,4 +370,79 @@ describe('ProcessModelerPage', () => { expect(screen.queryByTestId('publish-diff-empty')).not.toBeInTheDocument(); expect(screen.getByTestId('publish-diff-list')).toHaveTextContent('办理人变更'); }); + + // ── T4.1 新建流程(模板库 + NewProcessDialog;NewProcessDialog 不 mock,跑真实例化) ───── + it('“新建流程”按钮可用并打开新建对话框', async () => { + renderPage(); + const btn = await screen.findByTestId('process-modeler-new'); + expect(btn).not.toBeDisabled(); + fireEvent.click(btn); + expect(await screen.findByTestId('new-process-name')).toBeInTheDocument(); + expect(screen.getByTestId('new-process-template')).toBeInTheDocument(); + }); + + it('新建确认→挂 Modeler 并 importXML 模板实例化 XML(process id=用户 key,不取存量源)', async () => { + renderPage(); + fireEvent.click(await screen.findByTestId('process-modeler-new')); + fireEvent.change(await screen.findByTestId('new-process-name'), { target: { value: '请假审批' } }); + fireEvent.change(screen.getByTestId('new-process-key'), { target: { value: 'leaveApply' } }); + fireEvent.change(screen.getByTestId('new-process-template'), { target: { value: 'single-approval' } }); + fireEvent.click(screen.getByTestId('new-process-confirm')); + await waitFor(() => expect(importXMLMock).toHaveBeenCalled()); + const xml = importXMLMock.mock.calls[0][0] as string; + expect(xml).toContain('id="leaveApply"'); + expect(xml).toContain('userTask'); + expect(xml).not.toContain('__PROCESS_ID__'); + // 新建不走任何存量/草稿取源。 + expect(mSource).not.toHaveBeenCalled(); + expect(mSourceByKey).not.toHaveBeenCalled(); + expect(mGetModel).not.toHaveBeenCalled(); + // 打开器叠层消失(newDraft 激活)。 + expect(screen.queryByTestId('process-modeler-open-select')).not.toBeInTheDocument(); + }); + + it('新建会签模板→importXML 含 multiInstance', async () => { + renderPage(); + fireEvent.click(await screen.findByTestId('process-modeler-new')); + fireEvent.change(await screen.findByTestId('new-process-name'), { target: { value: '会签' } }); + fireEvent.change(screen.getByTestId('new-process-key'), { target: { value: 'cosignFlow' } }); + fireEvent.change(screen.getByTestId('new-process-template'), { target: { value: 'cosign' } }); + fireEvent.click(screen.getByTestId('new-process-confirm')); + await waitFor(() => expect(importXMLMock).toHaveBeenCalled()); + expect(importXMLMock.mock.calls[0][0] as string).toContain('multiInstanceLoopCharacteristics'); + }); + + it('新建后存草稿→createDraft 带展示名/key/空 eip4IdMap,回填 ?modelId= 重载', async () => { + renderPage(); + fireEvent.click(await screen.findByTestId('process-modeler-new')); + fireEvent.change(await screen.findByTestId('new-process-name'), { target: { value: '请假审批' } }); + fireEvent.change(screen.getByTestId('new-process-key'), { target: { value: 'leaveApply' } }); + fireEvent.click(screen.getByTestId('new-process-confirm')); + await waitFor(() => expect(importXMLMock).toHaveBeenCalled()); + await waitFor(() => expect(saveBtn()).not.toBeDisabled()); + fireEvent.click(saveBtn()); + await waitFor(() => expect(mCreateDraft).toHaveBeenCalled()); + const body = mCreateDraft.mock.calls[0][0]; + expect(body.name).toBe('请假审批'); // 展示名(非 key) + expect(body.key).toBe('leaveApply'); + expect(JSON.parse(body.metaInfo!).eip4IdMap).toEqual({}); // ASCII key 无还原映射 + expect(mFromProcDef).not.toHaveBeenCalled(); + // 首存回填 ?modelId=NEW-1 → 按 modelId 重载。 + await waitFor(() => expect(mGetModel).toHaveBeenCalledWith('NEW-1')); + }); + + it('新建中文 key→process id 净化为 ASCII,createDraft.metaInfo.eip4IdMap 记录还原映射', async () => { + renderPage(); + fireEvent.click(await screen.findByTestId('process-modeler-new')); + fireEvent.change(await screen.findByTestId('new-process-name'), { target: { value: '总包合同交底' } }); + fireEvent.change(screen.getByTestId('new-process-key'), { target: { value: '总包合同交底' } }); + fireEvent.click(screen.getByTestId('new-process-confirm')); + await waitFor(() => expect(importXMLMock).toHaveBeenCalled()); + expect(importXMLMock.mock.calls[0][0] as string).not.toContain('id="总包合同交底"'); + await waitFor(() => expect(saveBtn()).not.toBeDisabled()); + fireEvent.click(saveBtn()); + await waitFor(() => expect(mCreateDraft).toHaveBeenCalled()); + const meta = JSON.parse(mCreateDraft.mock.calls[0][0].metaInfo!); + expect(Object.keys(meta.eip4IdMap)).toEqual(['总包合同交底']); + }); }); diff --git a/src/pages/ProcessModelerPage.tsx b/src/pages/ProcessModelerPage.tsx index c37c003..26fc897 100644 --- a/src/pages/ProcessModelerPage.tsx +++ b/src/pages/ProcessModelerPage.tsx @@ -28,6 +28,7 @@ import { } from '../api/processModeler'; import { Eip4Panel, type PanelModeler } from '../modeler/Eip4Panel'; import { PublishConfirm } from '../modeler/PublishConfirm'; +import { NewProcessDialog, type NewProcessResult } from '../modeler/NewProcessDialog'; import { toast } from '../components/ui'; // bpmn-js/lib/Modeler 自带类型,但选项对象里的标准面板模块(本项目无类型)与 moddle JSON @@ -78,6 +79,8 @@ export function ProcessModelerPage() { const modelIdRef = useRef(''); // 当前载入流程的 key(存量 procDefKey / 草稿 key)——新建草稿的 name/key 源。 const loadedKeyRef = useRef(''); + // 新建流程的展示名(首存草稿的 name 用;存量/草稿路为空,createDraft 回退用 key)。 + const newNameRef = useRef(''); // 打开时的**原始**源 XML(发布影响摘要的 diff 基线:openSource vs 当前 saveXML)。 const openSourceRef = useRef(''); // 基线归属标识:openSourceRef 对应哪个打开目标。存量首存会 setParams(modelId) 触发载入 effect @@ -90,6 +93,10 @@ export function ProcessModelerPage() { const [saving, setSaving] = useState(false); // 发布弹窗:非 null 时展示 PublishConfirm,xml=点发布瞬间的 saveXML 结果。 const [publish, setPublish] = useState<{ xml: string } | null>(null); + // 新建流程:对话框开关 + pending 新建(非 null 时无 URL 目标也挂 Modeler 并 import 模板实例化 XML, + // 首存前不落草稿——走 T2.5 createDraft 首存路径)。 + const [showNewDialog, setShowNewDialog] = useState(false); + const [newDraft, setNewDraft] = useState(null); const [options, setOptions] = useState([]); const [optionsError, setOptionsError] = useState(''); // 打开器 tab:存量流程 / 草稿。 @@ -123,9 +130,10 @@ export function ProcessModelerPage() { }; }, [isAdmin, hasTarget, openTab, draftsReload]); - // 有目标时挂载 Modeler 并载入 BPMN(草稿→getModel / 存量→source)。 + // 有目标(或 pending 新建)时挂载 Modeler 并载入 BPMN(草稿→getModel / 存量→source / 新建→模板)。 useEffect(() => { - if (!isAdmin || !hasTarget) return; + if (!isAdmin) return; + if (!hasTarget && !newDraft) return; let alive = true; let modeler: ModelerLike | null = null; setLoadState('loading'); @@ -133,24 +141,33 @@ export function ProcessModelerPage() { (async () => { try { - // 三条路统一成 {found,bpmnXml,idMap,key}。 - let src: { found: boolean; bpmnXml?: string; idMap?: Record; key?: string }; - if (modelIdParam) { - const m = await getModel(modelIdParam); - src = { found: m.found, bpmnXml: m.bpmnXml, idMap: parseMetaIdMap(m.metaInfo), key: m.key }; - } else if (procDefId) { - const s = await fetchProcDefSource(procDefId); - src = { found: s.found, bpmnXml: s.bpmnXml, idMap: s.idMap, key: s.procDefKey }; + // 新建流程:无 URL 目标但有 pending newDraft → 直接用模板实例化 XML(无远端取源、无 found 守卫)。 + const isNew = !hasTarget && !!newDraft; + let bpmnXml: string; + // 非新建三条路统一成 {found,bpmnXml,idMap,key}。 + let src: { found: boolean; bpmnXml?: string; idMap?: Record; key?: string } | undefined; + if (isNew) { + bpmnXml = newDraft!.xml; } else { - const s = await fetchProcDefSourceByKey(procKey); - src = { found: s.found, bpmnXml: s.bpmnXml, idMap: s.idMap, key: s.procDefKey }; + if (modelIdParam) { + const m = await getModel(modelIdParam); + src = { found: m.found, bpmnXml: m.bpmnXml, idMap: parseMetaIdMap(m.metaInfo), key: m.key }; + } else if (procDefId) { + const s = await fetchProcDefSource(procDefId); + src = { found: s.found, bpmnXml: s.bpmnXml, idMap: s.idMap, key: s.procDefKey }; + } else { + const s = await fetchProcDefSourceByKey(procKey); + src = { found: s.found, bpmnXml: s.bpmnXml, idMap: s.idMap, key: s.procDefKey }; + } + if (!alive) return; + if (!src.found || !src.bpmnXml) { + setLoadError('未找到该流程的 BPMN 源(可能未部署或无布局信息)'); + setLoadState('error'); + return; + } + bpmnXml = src.bpmnXml; } if (!alive) return; - if (!src.found || !src.bpmnXml) { - setLoadError('未找到该流程的 BPMN 源(可能未部署或无布局信息)'); - setLoadState('error'); - return; - } if (!canvasRef.current) { // 画布容器缺失(异常时序):明确报错,别停在 loading 无提示(T1.5 评审 M-2)。 setLoadError('画布未就绪,请重试'); @@ -176,22 +193,33 @@ export function ProcessModelerPage() { /* 面板模块缺失 / stub 时忽略 */ } } - idMapRef.current = src.idMap ?? {}; - loadedKeyRef.current = src.key ?? ''; - // diff 基线:仅在**首次打开某目标**时捕获原始源;同目标重跑(含首存后 procKey→modelId - // 的 reload,归属已由 handleSaveDraft 预置成新 modelId)则保留,防 I1 基线被冲成「已存版」。 - const openTargetKey = modelIdParam - ? 'model:' + modelIdParam - : procDefId - ? 'pd:' + procDefId - : 'pk:' + procKey; - if (baselineTargetRef.current !== openTargetKey) { - openSourceRef.current = src.bpmnXml; // 此处 bpmnXml 已由上方 found 守卫保证非空 - baselineTargetRef.current = openTargetKey; + if (isNew) { + // 新建:idMap(中文 key 还原用)/key/名称进 ref,供首存 createDraft;无原始源→diff 基线空。 + idMapRef.current = newDraft!.idMap; + loadedKeyRef.current = newDraft!.key; + newNameRef.current = newDraft!.name; + modelIdRef.current = ''; + openSourceRef.current = ''; + baselineTargetRef.current = 'new:' + newDraft!.key; + } else { + idMapRef.current = src!.idMap ?? {}; + loadedKeyRef.current = src!.key ?? ''; + newNameRef.current = ''; + // diff 基线:仅在**首次打开某目标**时捕获原始源;同目标重跑(含首存后 procKey→modelId + // 的 reload,归属已由 handleSaveDraft 预置成新 modelId)则保留,防 I1 基线被冲成「已存版」。 + const openTargetKey = modelIdParam + ? 'model:' + modelIdParam + : procDefId + ? 'pd:' + procDefId + : 'pk:' + procKey; + if (baselineTargetRef.current !== openTargetKey) { + openSourceRef.current = bpmnXml; // 此处 bpmnXml 已由上方 found 守卫保证非空 + baselineTargetRef.current = openTargetKey; + } + // 草稿路:记住 modelId(后续保存走 PUT);存量路:清空(首次保存新建草稿)。 + modelIdRef.current = modelIdParam || ''; } - // 草稿路:记住 modelId(后续保存走 PUT);存量路:清空(首次保存新建草稿)。 - modelIdRef.current = modelIdParam || ''; - await modeler.importXML(src.bpmnXml); + await modeler.importXML(bpmnXml); if (!alive) return; modelerRef.current = modeler; setModelerReady(modeler); @@ -222,7 +250,7 @@ export function ProcessModelerPage() { modelerRef.current = null; setModelerReady(null); }; - }, [isAdmin, procDefId, procKey, modelIdParam]); + }, [isAdmin, procDefId, procKey, modelIdParam, newDraft]); // 保存草稿:saveXML → 有 modelId 走 PUT(不重发 metaInfo,保住 eip4IdMap); // 无 modelId:存量按 procDefId 走 from-procdef(后端写 metaInfo)再 PUT 覆盖为编辑源; @@ -246,17 +274,21 @@ export function ProcessModelerPage() { setParams({ modelId }, { replace: true }); } else { const key = loadedKeyRef.current || procKey || 'new_process'; + // 新建流程用展示名(newNameRef);存量按 key 无展示名,回退用 key。 + const name = newNameRef.current || key; // metaInfo 结构与 from-procdef 对齐(sourceProcDefId 便于 T3.x 影响摘要/审计, - // 虽 restore 只读 eip4IdMap)。 + // 虽 restore 只读 eip4IdMap;新建中文 key 的 idMap 使发布 restore 回中文 process key)。 const metaInfo = JSON.stringify({ eip4IdMap: idMapRef.current, sourceProcDefId: procDefId || '', originalKey: key, }); - modelId = await createDraft({ name: key, key, bpmnXml: xml, metaInfo }); + modelId = await createDraft({ name, key, bpmnXml: xml, metaInfo }); modelIdRef.current = modelId; // I1:同上,reload 保留原始源基线。 baselineTargetRef.current = 'model:' + modelId; + // 新建首存后清 pending newDraft:随后回填 ?modelId= 触发按 modelId 正常重载(幂等)。 + if (newDraft) setNewDraft(null); setParams({ modelId }, { replace: true }); } toast('已保存草稿', 'ok'); @@ -346,7 +378,9 @@ export function ProcessModelerPage() { {hasTarget ? `已打开:${modelIdParam ? '草稿 ' + modelIdParam : procDefId || procKey}` - : '在线编辑 BPMN 流程定义(可编辑存量 / 草稿)'} + : newDraft + ? `新建流程:${newDraft.name}(${newDraft.key})` + : '在线编辑 BPMN 流程定义(可编辑存量 / 草稿 / 新建)'} @@ -515,6 +554,17 @@ export function ProcessModelerPage() { + {/* 新建流程对话框(名称/key/模板 → 实例化模板进入编辑态,首存前不落草稿) */} + {showNewDialog ? ( + setShowNewDialog(false)} + onConfirm={(r) => { + setShowNewDialog(false); + setNewDraft(r); // 触发挂载 effect:importXML(模板实例化 XML) + 清空 diff 基线 + }} + /> + ) : null} + {/* 同人确认发布弹窗(影响摘要 + 节点级 diff + 422 校验清单) */} {publish && modelIdRef.current ? (