live 复验:画布/palette/选中/context pad 正常,但标准属性面板从不挂载
(document 中 .bio-properties-panel 为 0,容器 children=0)。
根因(本次修时 attachTo 测试逼出):属性面板宿主 <div data-testid=process-modeler-props>
**从未挂 ref={panelRef}** → 构造参数 propertiesPanel.parent 恒为 null,面板无处渲染。
- 补 ref={panelRef} 到 props 容器 div(真根因)。
- 构造后显式 (modeler.get('propertiesPanel')).attachTo(panelRef.current)——
bpmn-js-properties-panel 规范补救,放 importXML 前、alive 检查内、panelRef 存在时。
- 顺带修 T1.5 评审 M-2:canvasRef 为 null 分支改为 setError(原停 loading 无提示)。
测试:ProcessModelerPage.test.tsx +1(Modeler stub get('propertiesPanel')→{attachTo},
断言 attachTo 恰调一次且实参是 props 容器 DOM)。stub get 改按 service 分派
(propertiesPanel/canvas)。全量 vitest 22 文件 118 例绿;tsc -b 干净;npm run build 成功。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
293 lines
12 KiB
TypeScript
293 lines
12 KiB
TypeScript
// 在线流程 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<unknown>;
|
||
destroy(): void;
|
||
get(service: string): unknown;
|
||
on(event: string, cb: (e: unknown) => void): void;
|
||
}
|
||
const ModelerCtor = Modeler as unknown as new (options: Record<string, unknown>) => 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<HTMLDivElement>(null);
|
||
const panelRef = useRef<HTMLDivElement>(null);
|
||
const modelerRef = useRef<ModelerLike | null>(null);
|
||
// 净化映射 原id→净化id:本阶段仅暂存,发布还原(T3.x)时用。
|
||
const idMapRef = useRef<Record<string, string>>({});
|
||
|
||
const [loadState, setLoadState] = useState<LoadState>('idle');
|
||
const [loadError, setLoadError] = useState('');
|
||
const [options, setOptions] = useState<ProcessOption[]>([]);
|
||
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 <div style={{ padding: 24, color: 'var(--text-3)' }}>流程设计器仅管理员可用。</div>;
|
||
}
|
||
|
||
// 可载入 = 有可用打开参数:processDefinition 需 id(procDefId);其余(model/history)需 key。
|
||
const loadableOptions = options.filter((o) =>
|
||
o.source === 'processDefinition' ? !!o.id : !!o.key,
|
||
);
|
||
|
||
// 选择器按 source 分派:processDefinition→?procDefId=<id>;其余→?procKey=<key>。
|
||
// 用索引取回选项对象(避免把 id/key 直接塞进 <option value> 造成路由二义)。
|
||
function openSelected(indexValue: string) {
|
||
if (indexValue === '') return;
|
||
const opt = loadableOptions[Number(indexValue)];
|
||
if (!opt) return;
|
||
if (opt.source === 'processDefinition' && opt.id) {
|
||
setParams({ procDefId: opt.id });
|
||
} else if (opt.key) {
|
||
setParams({ procKey: opt.key });
|
||
}
|
||
}
|
||
|
||
return (
|
||
<div
|
||
data-testid="process-modeler-root"
|
||
style={{ display: 'flex', flexDirection: 'column', height: '100%', overflow: 'hidden' }}
|
||
>
|
||
{/* 顶栏 */}
|
||
<div
|
||
style={{
|
||
height: 48,
|
||
display: 'flex',
|
||
alignItems: 'center',
|
||
gap: 12,
|
||
padding: '0 16px',
|
||
borderBottom: '1px solid var(--line)',
|
||
flexShrink: 0,
|
||
}}
|
||
>
|
||
<span style={{ fontWeight: 600, fontSize: 15 }}>流程设计器</span>
|
||
<span className="muted" style={{ fontSize: 12, flex: 1 }}>
|
||
{hasTarget ? `已打开:${procDefId || procKey}` : '在线编辑 BPMN 流程定义(可编辑存量 / 新建)'}
|
||
</span>
|
||
<button className="btn btn-sm" data-testid="process-modeler-save-draft" disabled title="保存草稿(下阶段)">
|
||
保存草稿
|
||
</button>
|
||
<button className="btn btn-sm btn-primary" data-testid="process-modeler-publish" disabled title="发布(下阶段)">
|
||
发布
|
||
</button>
|
||
<button className="btn btn-sm" data-testid="process-modeler-back" onClick={() => navigate('/design-center')}>
|
||
返回
|
||
</button>
|
||
</div>
|
||
|
||
{/* 主体:左画布 + 右栏(上=EIP4 侧板占位 / 下=标准属性面板) */}
|
||
<div style={{ flex: 1, display: 'flex', minHeight: 0 }}>
|
||
<div style={{ flex: 1, position: 'relative', minWidth: 0, background: '#fff' }}>
|
||
<div ref={canvasRef} data-testid="process-modeler-canvas" style={{ width: '100%', height: '100%' }} />
|
||
|
||
{/* 未打开任何流程:叠加「打开存量流程」选择器 + 新建占位 */}
|
||
{!hasTarget ? (
|
||
<div
|
||
style={{
|
||
position: 'absolute',
|
||
inset: 0,
|
||
display: 'flex',
|
||
flexDirection: 'column',
|
||
alignItems: 'center',
|
||
justifyContent: 'center',
|
||
gap: 12,
|
||
background: 'var(--surface, #fff)',
|
||
}}
|
||
>
|
||
<div style={{ color: 'var(--text-3)', fontSize: 13 }}>选择一个存量流程开始编辑</div>
|
||
<select
|
||
data-testid="process-modeler-open-select"
|
||
defaultValue=""
|
||
onChange={(e) => openSelected(e.target.value)}
|
||
style={{ minWidth: 280, padding: '6px 8px' }}
|
||
>
|
||
<option value="">打开存量流程…</option>
|
||
{loadableOptions.map((o, i) => (
|
||
<option key={o.id ?? o.key ?? i} value={i}>
|
||
{o.label}
|
||
</option>
|
||
))}
|
||
</select>
|
||
{optionsError ? (
|
||
<div style={{ color: 'var(--err)', fontSize: 12 }}>{optionsError}</div>
|
||
) : null}
|
||
<button className="btn btn-sm" data-testid="process-modeler-new" disabled title="新建流程(下阶段)">
|
||
+ 新建流程
|
||
</button>
|
||
</div>
|
||
) : null}
|
||
|
||
{/* 载入中 / 载入失败 */}
|
||
{hasTarget && loadState === 'loading' ? (
|
||
<div style={overlayMsgStyle('var(--text-3)')} data-testid="process-modeler-loading">
|
||
加载流程中…
|
||
</div>
|
||
) : null}
|
||
{hasTarget && loadState === 'error' ? (
|
||
<div style={overlayMsgStyle('var(--warn, #d48806)')} data-testid="process-modeler-error">
|
||
{loadError}
|
||
</div>
|
||
) : null}
|
||
</div>
|
||
|
||
<div
|
||
style={{
|
||
width: 360,
|
||
flexShrink: 0,
|
||
borderLeft: '1px solid var(--line)',
|
||
display: 'flex',
|
||
flexDirection: 'column',
|
||
minHeight: 0,
|
||
}}
|
||
>
|
||
{/* EIP4 定制侧板占位(办理人/会签/formKey…由 T2.4 接入) */}
|
||
<div
|
||
data-testid="process-modeler-eip4-panel"
|
||
style={{ padding: 12, borderBottom: '1px solid var(--line)', color: 'var(--text-3)', fontSize: 12 }}
|
||
>
|
||
EIP4 定制控件(办理人 / 会签 / formKey)将在此叠加,下阶段接入。
|
||
</div>
|
||
{/* 标准属性面板宿主(bpmn-js-properties-panel attachTo 进此容器) */}
|
||
<div ref={panelRef} data-testid="process-modeler-props" style={{ flex: 1, overflow: 'auto', minHeight: 0 }} />
|
||
</div>
|
||
</div>
|
||
</div>
|
||
);
|
||
}
|
||
|
||
function overlayMsgStyle(color: string): React.CSSProperties {
|
||
return {
|
||
position: 'absolute',
|
||
top: 16,
|
||
left: 16,
|
||
padding: '8px 12px',
|
||
background: 'rgba(255,255,255,0.92)',
|
||
borderRadius: 4,
|
||
color,
|
||
fontSize: 13,
|
||
};
|
||
}
|