// 在线流程 Modeler(B3)——可编辑 BPMN 设计器页骨架。 // 本阶段(T1.5)只做:admin 门 + 三栏布局 + bpmn-js Modeler 挂载 + 存量流程只读载入。 // EIP4 定制侧板(办理人/会签/formKey…)是 T2.4,本页右上只放占位容器; // 「保存草稿」「发布」是 T2.5/T3.3,本页顶栏先放 disabled 占位按钮。 import { useEffect, useRef, useState } from 'react'; import { useNavigate, useSearchParams } from 'react-router-dom'; import Modeler from 'bpmn-js/lib/Modeler'; import { BpmnPropertiesPanelModule, BpmnPropertiesProviderModule } from 'bpmn-js-properties-panel'; import 'bpmn-js/dist/assets/diagram-js.css'; 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 { getProfile, isAdminProfile } from '../auth/token'; import { fetchProcDefSource, fetchProcDefSourceByKey, fetchProcessOptions, type ProcessOption, } from '../api/processModeler'; // bpmn-js/lib/Modeler 自带类型,但选项对象里的标准面板模块(本项目无类型)与 moddle JSON // 会与官方选项类型产生摩擦;照 ProcessDiagram 惯例把构造器收窄为本页用到的最小契约再实例化。 interface ModelerLike { importXML(xml: string): Promise; destroy(): void; get(service: string): unknown; on(event: string, cb: (e: unknown) => void): void; } const ModelerCtor = Modeler as unknown as new (options: Record) => ModelerLike; type LoadState = 'idle' | 'loading' | 'ready' | 'error'; export function ProcessModelerPage() { const profile = getProfile(); const isAdmin = isAdminProfile(profile); const navigate = useNavigate(); const [params, setParams] = useSearchParams(); // 打开存量流程两条路:?procDefId=(source=processDefinition,id 即 procDefId) // 或 ?procKey=(source=model/history,按流程 key 载入最新版)。 const procDefId = params.get('procDefId') ?? ''; const procKey = params.get('procKey') ?? ''; const hasTarget = !!procDefId || !!procKey; const canvasRef = useRef(null); const panelRef = useRef(null); const modelerRef = useRef(null); // 净化映射 原id→净化id:本阶段仅暂存,发布还原(T3.x)时用。 const idMapRef = useRef>({}); const [loadState, setLoadState] = useState('idle'); const [loadError, setLoadError] = useState(''); const [options, setOptions] = useState([]); const [optionsError, setOptionsError] = useState(''); // 未打开任何流程时拉存量流程选项(数据源复用旧 ProcessSelectDialog 端点)。 useEffect(() => { if (!isAdmin || hasTarget) return; let alive = true; fetchProcessOptions() .then((opts) => alive && setOptions(opts)) .catch(() => alive && setOptionsError('存量流程列表加载失败')); return () => { alive = false; }; }, [isAdmin, hasTarget]); // 有目标(procDefId 或 procKey)时挂载 Modeler 并载入净化后的存量 BPMN。 useEffect(() => { if (!isAdmin || !hasTarget) return; let alive = true; let modeler: ModelerLike | null = null; setLoadState('loading'); setLoadError(''); (async () => { try { // procDefId 优先(source=processDefinition);否则按 key(source=model/history)。 const src = procDefId ? await fetchProcDefSource(procDefId) : await fetchProcDefSourceByKey(procKey); if (!alive) return; if (!src.found || !src.bpmnXml) { setLoadError('未找到该流程的 BPMN 源(可能未部署或无布局信息)'); setLoadState('error'); return; } if (!canvasRef.current) { // 画布容器缺失(异常时序):明确报错,别停在 loading 无提示(T1.5 评审 M-2)。 setLoadError('画布未就绪,请重试'); setLoadState('error'); return; } modeler = new ModelerCtor({ container: canvasRef.current, propertiesPanel: { parent: panelRef.current }, // ⚠️ 只载标准 BpmnPropertiesProviderModule,严禁引 Camunda provider——它会把 // camunda 描述符注进 moddle,与 activiti 描述符在 bpmn:UserTask 上同名扩展冲突 // (not allowed without redefines) 静默丢弃 userTask(T1.1 评审 M-3 实证)。 additionalModules: [BpmnPropertiesPanelModule, BpmnPropertiesProviderModule], // ⚠️ moddleExtensions 只声明 activiti:语料 1509/3 两命名空间不混用,双载会因同名 // 扩展属性冲突静默丢弃 userTask;单载 activiti 时 flowable 文档经 moddle lax 往返零丢失。 moddleExtensions: { activiti: activitiModdle }, }); // ⚠️ 显式 attachTo:live 实证——只靠构造参数 propertiesPanel.parent,面板从不挂载 // (.bio-properties-panel 在 document 中为 0;构造时 ref 时序/传对象非 element 皆可致此)。 // attachTo 容器 DOM 是 bpmn-js-properties-panel 的规范补救。放在 importXML 前,alive 内。 if (panelRef.current) { try { (modeler.get('propertiesPanel') as { attachTo(el: HTMLElement): void }).attachTo(panelRef.current); } catch { /* 面板模块缺失 / stub 时忽略 */ } } idMapRef.current = src.idMap ?? {}; await modeler.importXML(src.bpmnXml); if (!alive) return; modelerRef.current = modeler; try { const canvas = modeler.get('canvas') as { zoom(mode: string, point?: string): void }; canvas.zoom('fit-viewport', 'auto'); } catch { /* stub / 无布局时忽略 */ } setLoadState('ready'); } catch { if (alive) { setLoadError('流程加载失败'); setLoadState('error'); } } })(); return () => { alive = false; if (modeler) { try { modeler.destroy(); } catch { /* 视图已卸载 */ } } modelerRef.current = null; }; }, [isAdmin, procDefId, procKey]); if (!isAdmin) { return
流程设计器仅管理员可用。
; } // 可载入 = 有可用打开参数:processDefinition 需 id(procDefId);其余(model/history)需 key。 const loadableOptions = options.filter((o) => o.source === 'processDefinition' ? !!o.id : !!o.key, ); // 选择器按 source 分派:processDefinition→?procDefId=;其余→?procKey=。 // 用索引取回选项对象(避免把 id/key 直接塞进