/** * 流程包 → 画布图模型:**连线即映射**的可视一侧。 * * 画布件(`flow-layout` / `flow-node-paint` / `FlowDiagram`)是框架无关的纯几何与画笔, * 它认的是 `FlowGraph`;我们的权威模型是 `ProcessPackage`。这里做且只做一次形状转换, * **不产生任何新语义** —— 节点仍是编排层五要素,审批点仍是系统内置人裁节点(共用方框几何而已)。 */ import type { ProcessPackage } from '@contracts'; import type { FlowEdge, FlowGraph, FlowNode } from './flow-layout.ts'; /** 节点实例落位:running / waiting / terminal 决定描边高亮,不改几何 */ export type InstanceMark = { readonly nodeId: string; readonly running: boolean; readonly waiting: boolean; readonly activated: boolean; readonly terminal?: string | undefined; }; /** 每行最多几个方框 —— 蛇形折行的行宽;取原型 business 预设的观感 */ const ROW_WIDTH = 4; export function packageToGraph(pkg: ProcessPackage, marks: readonly InstanceMark[] = []): FlowGraph { const markOf = new Map(marks.map((m) => [m.nodeId, m])); /* * 手绘图存证优先:编辑器保存过,**手绘几何即呈现真相**。 * 运行标注仍要每次现算(它是运行态,不入存证),合到存证节点的 note 上。 */ const stored = readStoredDiagram(pkg.diagram); if (stored !== undefined) { /* * **语义里有、存证里没有的节点要补画出来** —— 不补,画布就看不见它: * 异常看板指着一个图上不存在的节点,点了也定位不到(实测:API 直存的包 * 语义层加了新节点、diagram 还是旧的,picker 里根本没有那个节点)。 * 编辑器保存时两层同步,不会走到这;这是给「语义先行」的数据兜底。 * 补的节点没有几何,按 60px 一档排在图纸下缘 —— 位置丑没关系,看得见才能修。 */ const drawn = new Set(stored.nodes.map((n) => n.id)); const missing = pkg.nodes.filter((n) => !drawn.has(n.id)); const bottom = stored.nodes.reduce((max, n) => Math.max(max, (n.y ?? 0)), 0) + 90; const extras: FlowNode[] = missing.map((n, i) => ({ id: n.id, kind: n.kind === 'start' ? ('start' as const) : n.kind === 'end' ? ('end' as const) : ('activity' as const), label: n.label, ...(n.kind === 'approval' ? { flavor: 'approval' as const } : {}), ...(n.kind === 'activity' ? { code: n.id, act: n.activityId } : {}), x: 30 + (i % 6) * 160, y: bottom + Math.floor(i / 6) * 60, })); const semanticById = new Map(pkg.nodes.map((n) => [n.id as string, n])); const withState = (list: readonly FlowNode[]) => list.map((n) => { const state = stateOf(markOf.get(n.id)); const sem = semanticById.get(n.id); // 链接的实现(装载面)以语义为准回填 —— 存证里的 act 只是画布工作痕迹 const linked = sem?.kind === 'activity' ? { act: sem.activityId as string } : {}; const base = { ...n, ...linked }; return state === undefined ? base : { ...base, note: state }; }); /* * 边属性(编号/条件/映射)从语义边回填到画布边:属性卡编辑的是画布工作副本, * 保存时 graph-to-pkg 又以它为准 —— 回填缺席的话,打开即保存会把契约冲掉。 * 顺序流全是真边(卡点画法已废),按 from→to 直接认亲;code 即边号 E1、E2… */ const semEdge = new Map(pkg.edges.map((e) => [`${e.from}→${e.to}`, e])); const edges = stored.edges.map((e) => { const sem = semEdge.get(`${e.from}→${e.to}`); if (sem === undefined) return e; return { ...e, code: sem.id as string, ...(sem.condition === undefined ? {} : { condition: sem.condition }), mapping: sem.mapping as unknown[], }; }); return { ...stored, edges, nodes: [...withState(stored.nodes), ...withState(extras)] }; } const nodes: FlowNode[] = pkg.nodes.map((n) => { const state = stateOf(markOf.get(n.id)); if (n.kind === 'start') return { id: n.id, kind: 'start', label: n.label }; if (n.kind === 'end') return { id: n.id, kind: 'end', label: n.label }; const base: FlowNode = { id: n.id, kind: 'activity', label: n.label, code: n.id, ...(n.sub === undefined ? {} : { sub: n.sub }), ...(state === undefined ? {} : { note: state }), }; if (n.kind === 'approval') { // approval **不是一种活动**:它挂在 kind:"activity" 下仅因共用同一套方框几何 return { ...base, flavor: 'approval' }; } return { ...base, // 契约不带负责人岗位 —— 角标不再标岗位,链接的实现(装载面)以 act 携带 act: n.activityId, ...(n.in === undefined ? {} : { in: [...n.in] }), ...(n.out === undefined ? {} : { out: [...n.out] }), }; }); /** 蛇形折行:偶数行 L→R、奇数行 R→L —— 行的划分交给拓扑序 */ const order = topologicalOrder(pkg); const rows: string[][] = []; for (let i = 0; i < order.length; i += ROW_WIDTH) rows.push(order.slice(i, i + ROW_WIDTH)); const edges: FlowEdge[] = pkg.edges.map((e) => ({ from: e.from, to: e.to, code: e.id as string, // 回边按声明走「回 A4 重开新实例」,视觉上标红以区分正向流转 ...(e.tone !== undefined ? { tone: e.tone } : e.reopen ? { tone: 'bad' as const } : {}), ...(e.label === undefined ? (e.condition === undefined ? {} : { label: e.condition }) : { label: e.label }), })); return { nodes, rows, anchors: [], edges }; } /** * 手绘图存证的在场校验:`diagram` 由本仓 `graph-to-pkg` 序列化而来,结构即 FlowGraph; * 这里只验骨架在不在(nodes/edges 数组、非空),不逐字段复检 —— 写入侧是唯一生产者。 */ function readStoredDiagram(d: Record | undefined): FlowGraph | undefined { if (d === undefined) return undefined; const nodes = d['nodes']; const edges = d['edges']; if (!Array.isArray(nodes) || nodes.length === 0 || !Array.isArray(edges)) return undefined; return { nodes, edges, rows: Array.isArray(d['rows']) ? d['rows'] : [], anchors: Array.isArray(d['anchors']) ? d['anchors'] : [], manual: d['manual'] === true, } as FlowGraph; } /** 运行标注:节点实例态 → 画布角注文字;未激活不标 */ function stateOf(mark: InstanceMark | undefined): string | undefined { if (mark === undefined || !mark.activated) return undefined; if (mark.terminal !== undefined) return mark.terminal === 'released' ? '已放行' : '已终止'; return mark.running ? '运行中' : mark.waiting ? '等待中' : '已激活'; } /** 拓扑序:回边不参与定序(否则成环),同层按声明顺序稳定排列 */ function topologicalOrder(pkg: ProcessPackage): string[] { const ids = pkg.nodes.map((n) => n.id as string); const forward = pkg.edges.filter((e) => !e.reopen); const indegree = new Map(ids.map((id) => [id, 0])); for (const e of forward) indegree.set(e.to, (indegree.get(e.to) ?? 0) + 1); const ready = ids.filter((id) => indegree.get(id) === 0); const out: string[] = []; const seen = new Set(); while (ready.length > 0) { const id = ready.shift()!; if (seen.has(id)) continue; seen.add(id); out.push(id); for (const e of forward.filter((x) => x.from === id)) { const left = (indegree.get(e.to) ?? 0) - 1; indegree.set(e.to, left); if (left === 0) ready.push(e.to); } } // 环(理论上闭合校验已挡住)或孤点:兜底补齐,画布不因数据异常而空白 for (const id of ids) if (!seen.has(id)) out.push(id); return out; }