Files
eip4-web/src/api/processModeler.ts
zhengwr e131b8dee9 feat(modeler): /process-modeler 页骨架(Modeler+标准属性面板+存量载入+设计中心入口)
阶段1 T1.5:admin 门 + 三栏布局(左画布/右上 EIP4 侧板占位/右下标准属性面板)
+ bpmn-js lib/Modeler 挂载(只载 activiti moddle、只引标准 BpmnPropertiesProvider,
严禁 Camunda provider)+ ?procDefId= 时 fetchProcDefSource→importXML(idMap 存 ref)
+ 无参时 process-select 存量流程选择器 + 设计中心「流程设计」入口。

api: processModeler.ts(fetchProcDefSource / fetchProcessOptions,裸 JSON 防御性默认)。
- procDefId 用 encodeURIComponent 进 path(真实库 id 形如「总包合同交底:3:<uuid>」中文+冒号)。
- found:false 先判后返,不解构 bpmnXml/idMap(后端此分支省略这些键)。
tsconfig.app.json 开 resolveJsonModule(首个 app 代码 import json)。
bpmn-js-properties-panel 补 ambient d.ts(包未发布类型)。

测试:ProcessModelerPage.test.tsx 5 例 + processModeler.test.ts 6 例(含中文+冒号
procDefId 断言 URL 已编码 / found:false 只返 found 键 / amis 信封解包);
DesignCenterPage.entrances 加 dc-process-modeler admin-only 断言。
全量 vitest 22 文件 112 例绿;tsc -b 干净;npm run build 成功(bpmn-js 进主 bundle)。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 10:37:36 +08:00

91 lines
3.3 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { http } from './http';
/**
* 流程 Modeler(在线 BPMN 设计器)后端契约。
*
* 阶段 1 只用到「按 procDefId 取净化源 XML」。裸 JSON 派,防御性默认 found:false,
* 与 diagram.ts 同风格。网关端点由 T1.6 上线,本层照 design 契约先写。
*/
/** GET /api/workflow/process-definitions/{id}/source 的返回体。 */
export interface ProcDefSource {
/** 是否命中流程定义(无则 found:false,不抛)。 */
found: boolean;
/** BpmnIdSanitizer 净化后的 BPMN 2.0 XML(中文 id 已替换为 ASCII,供 moddle/Modeler 载入)。 */
bpmnXml?: string;
/** 净化映射 原id→净化id(发布时逆向还原用,本 task 仅存 ref,后续 task 用)。 */
idMap?: Record<string, string>;
/** 流程定义 key(存量多为中文,如「总包合同交底」)。 */
procDefKey?: string;
/** 流程定义版本号。 */
version?: number;
}
/**
* 按 procDefId 取净化后的存量流程源 XML(含可逆 idMap)。
*
* ⚠️ procDefId 必须编码进 path:真实库 1445 个流程的 id 形如「总包合同交底:3:<uuid>」
* (中文 + 冒号),不 encodeURIComponent 会破坏 path segment。
* found:false 时后端省略 bpmnXml/idMap 键——先判 found 再解构,不在 false 分支碰这些键。
*/
export async function fetchProcDefSource(procDefId: string): Promise<ProcDefSource> {
const { data } = await http.get<ProcDefSource>(
`/api/workflow/process-definitions/${encodeURIComponent(procDefId)}/source`,
);
if (!data?.found) {
return { found: false };
}
return {
found: true,
bpmnXml: data.bpmnXml ?? undefined,
idMap: data.idMap ?? undefined,
procDefKey: data.procDefKey ?? undefined,
version: data.version ?? undefined,
};
}
/**
* 存量流程选择器的一条选项。复用旧 ProcessSelectDialog 的数据源
* `/api/process-select/options`(amis 信封 {status,data:{options}})。
*
* - {@link id} 为 procDefId(source=processDefinition/model 时有值;history 来源为空,不可载入)。
* - {@link value}/{@link label} 均为流程名称(沿用旧口径 value==label==流程名)。
*/
export interface ProcessOption {
label: string;
value: string;
id?: string;
key?: string;
}
interface ProcessSelectEnvelope {
data?: { options?: unknown[] };
options?: unknown[];
}
interface RawOption {
label?: unknown;
value?: unknown;
id?: unknown;
key?: unknown;
}
/** GET /api/process-select/options —— 取存量流程选项(解 amis 信封,防御性返回数组)。 */
export async function fetchProcessOptions(q?: string): Promise<ProcessOption[]> {
const { data } = await http.get<ProcessSelectEnvelope>('/api/process-select/options', {
params: q ? { q } : undefined,
});
const raw = data?.data?.options ?? data?.options ?? [];
if (!Array.isArray(raw)) return [];
return raw.map((o) => {
const opt = (o ?? {}) as RawOption;
const label = opt.label != null ? String(opt.label) : opt.value != null ? String(opt.value) : '';
return {
label,
value: opt.value != null ? String(opt.value) : label,
id: opt.id != null && String(opt.id) !== '' ? String(opt.id) : undefined,
key: opt.key != null && String(opt.key) !== '' ? String(opt.key) : undefined,
};
});
}