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>
This commit is contained in:
90
src/api/processModeler.ts
Normal file
90
src/api/processModeler.ts
Normal file
@@ -0,0 +1,90 @@
|
||||
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,
|
||||
};
|
||||
});
|
||||
}
|
||||
Reference in New Issue
Block a user