阶段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>
91 lines
3.3 KiB
TypeScript
91 lines
3.3 KiB
TypeScript
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,
|
||
};
|
||
});
|
||
}
|