JX-BPOS/apps/api/src/app/seed-mvp-flow.ts

/**
 * 「统一报价」流程包 —— 语义取自 `docs/MVP示例工作流.html` 的 FIG.1,几何**重排过**。
 *
 * 语义 15 节点:起点 · A1 · G1 · A2 · G2 · A3 · G2J · A4 · **A5 审批点** · G3 · A6 · G4 · A7 · 双终点。
 *
 * 与 FIG.1 的两处语义差异:
 *   · **多一颗 G2J**:G2 的两条互斥分支必须显式汇合 —— FIG.1 把它画成两条线各扎进 A4,
 *     语义上那是隐式合并,闭合校验不收(见下 joinNode 注释)。
 *   · **A5 是内置审批点**(审批不是任务,零开发、不入活动库),而 FIG.1 给它配了作业指导书。
 *
 * G3「审批结果」曾被我做掉过,理由是「审批点把它吸收了:通过走出边、驳回走 reject 声明」。
 * **那是错的** —— 审批点的两个去向本该由图决定(BPMN 的常规,也是用户要的)。
 * 现已补回,并且引擎跟着改成**先看图**:`onApprovalVerdict` 把裁决放进载荷,
 * 通过与驳回都先试出边,只有没画驳回边的包才退回 `reject` 声明。
 * 所以 G3 的两条出边都是**真的会走**的,不是摆设 —— 没有给条件喂常量。
 *
 * `reject` 声明仍保留:schema 必填,且它是通用机制(不是每个包都把驳回画成边)。
 * 它与 `e-g3-a4` 必须字字对齐,有测试守着。
 *
 * 几何是**重排**,不再逐点等于 SVG:两带换行(受理·选型·寻源 → 定价·审批·议价·成交),
 * 每带内 x 随推进次序单调递增,全图零连线交叉、零穿框。回跳仍用**卡点**表示(不画长线),
 * 卡点带 `to`,`mergeGraphIntoPackage` 会把「X → 卡点(to: Y)」还原成语义边,编辑器保存不丢回边。
 */
import { processPackageSchema, triggerConfigSchema } from '@contracts';
import type { ProcessPackage } from '@contracts';
import type { Container } from './container.ts';

/** 活动节点:岗位独任、失败即终止 —— 槽位期不谈容忍 */
const activityNode = (
  id: string,
  label: string,
  activityId: string,
  position: string,
  col: number,
  row: number,
  x: number,
  y: number,
) => ({
  id,
  kind: 'activity' as const,
  label,
  sub: position,
  activityId,
  owner: { position, strategy: 'sole' as const },
  failure: { kind: 'terminate' as const },
  layout: { row, col, x, y },
});

/** 判断网关:异或分叉,判据人读、条件在出边 */
const gatewayNode = (id: string, label: string, basis: string, col: number, row: number, x: number, y: number) => ({
  id,
  kind: 'gateway' as const,
  label,
  gateway: 'exclusive' as const,
  mode: 'fork' as const,
  basis,
  layout: { row, col, x, y },
});

/**
 * 异或汇合点 —— 两条互斥分支重新并回一条路。
 *
 * MVP 图上这里是两条线各自扎进 A4(隐式合并);语义上必须显式:
 * 不给汇合点,A4 就有两条同名映射的入边,闭合校验按「不做隐式合并」拦下(实测)。
 * 分叉必有汇合是 BPMN 的正解,本仓 v1 的 G2/G2J 即此先例。
 */
const joinNode = (id: string, label: string, col: number, row: number, x: number, y: number) => ({
  id,
  kind: 'gateway' as const,
  label,
  gateway: 'exclusive' as const,
  mode: 'join' as const,
  layout: { row, col, x, y },
});

/** 受理口的两枚去向旗与记录 —— A4 重新入场(回边 / 驳回)时照此装配 */
const REENTER_A4 = [
  { target: 'records', source: { from: 'output-port' as const, port: 'intake', path: 'records' } },
  { target: 'customerCode', source: { from: 'initiation' as const, path: 'customerCode' } },
];

export const MVP_PACKAGE: ProcessPackage = processPackageSchema.parse({
  id: 'unified-quote',
  name: '统一报价',
  version: 1,
  state: 'draft',
  callInterface: {
    input: {
      type: 'object',
      required: ['customerCode', 'rfqRef'],
      properties: {
        customerCode: { type: 'string' },
        rfqRef: { type: 'string' },
        subject: { type: 'string' },
        body: { type: 'string' },
        quotedAt: { type: 'string' },
      },
    },
    output: { type: 'object', properties: { landingRate: { type: 'number' } } },
  },
  /*
   * 版式:**两带换行**,不回形。`col` 用全局最长路径层级(0..13),每一带内 x 随 col 单调递增,
   * 所以「左→右、上→下」读出来就是推进次序 —— 图纸不再需要被当成次序的依据
   * (`advanceOrder` 早已改按边拓扑排,这里让两者一致只是为了不误导人)。
   *
   *   带 0(y 60..100) start → A1 → G1 → A2 → G2 → A3 → G2J     受理 · 选型 · 寻源
   *   换行车道 y=190   G2J 右探 40 再降下来,横扫回左,落 A4 北口
   *   带 1(y 310..350) A4 → A5 → G3 → A6 → G4 → end_won        定价 · 审批 · 议价 · 成交
   *   卡点车道 y=250..280  两枚回 A4 的牌子同朝向(向上 = 回退)
   *   带 2(y 410..450) A7 → end_arch                            未成交闭环
   *
   * 注:工厂的参数序是 **col 在 row 前**(activityNode(..., col, row, x, y))。
   */
  nodes: [
    { id: 'start', kind: 'start', label: '客户RFQ询价', layout: { row: 0, col: 0, x: 30, y: 70 } },
    activityNode('A1', '客户RFQ受理', 'rfq-intake', 'BD', 1, 0, 90, 60),
    gatewayNode('G1', '是否需要选型', '受理判定:该条是否要先选替代料(needAlternative)', 2, 0, 250, 60),
    activityNode('A2', '替代选型', 'alt-selection', 'FAE', 3, 0, 350, 60),
    gatewayNode('G2', '是否需要寻源', '受理判定:该条是否要向渠道询底价(needSourcing)', 4, 0, 510, 60),
    activityNode('A3', '寻源询价', 'sourcing-inquiry', 'PRM', 5, 0, 610, 60),
    joinNode('G2J', '寻源汇合', 6, 0, 770, 60),
    activityNode('A4', '成本定价', 'cost-pricing', 'BD', 7, 1, 60, 310),
    {
      id: 'A5',
      kind: 'approval',
      label: '定价审批',
      sub: 'PM',
      approver: { position: 'PM', strategy: 'sole' },
      /*
       * 驳回走向声明式,不由临场决定:退回 A4 重新定价。
       * 图上由 G3「审批结果」的 `verdict = "reject"` 出边**显式表达同一件事**,
       * 而引擎现在是**先看图**(见 `onApprovalVerdict`):有这条边就走边,没有才退回本声明。
       * 两处必须字字对齐 —— 有测试守着。本声明不能删:schema 必填,
       * 且它是通用机制(不是每个流程包都把驳回画成边)。
       */
      reject: { kind: 'reopen', nodeId: 'A4', mapping: REENTER_A4 },
      nudge: { steps: [{ after: 'PT20M', action: 'nudge' }], deadline: 'PT30M' },
      layout: { row: 1, col: 8, x: 240, y: 310 },
    },
    gatewayNode('G3', '审批结果', 'A5 裁决的去向:通过 / 不通过(verdict)—— 偏离底价 ≤±20% 才放行(底价门禁P-02)', 9, 1, 380, 310),
    activityNode('A6', '报价议价', 'quote-negotiation', 'BD', 10, 1, 460, 310),
    gatewayNode('G4', '议价结果', 'A6 办结的去向:成交 / 有异议 / 拒绝或超时(outcome)', 11, 1, 620, 310),
    activityNode('A7', '情报归档', 'intel-archive', 'BD', 12, 2, 590, 410),
    { id: 'end_won', kind: 'end', label: '转订单履约', layout: { row: 1, col: 12, x: 700, y: 320 } },
    { id: 'end_arch', kind: 'end', label: '归档闭环', layout: { row: 2, col: 13, x: 730, y: 420 } },
  ],
  edges: [
    {
      id: 'e-start-a1',
      from: 'start',
      to: 'A1',
      mapping: [
        { target: 'customerCode', source: { from: 'initiation', path: 'customerCode' } },
        { target: 'rfqRef', source: { from: 'initiation', path: 'rfqRef' } },
        // 主题与正文是归一步唯一的原始素材:只给单号,模型没有可拆解的东西
        { target: 'subject', source: { from: 'initiation', path: 'subject' } },
        { target: 'body', source: { from: 'initiation', path: 'body' } },
        { target: 'quotedAt', source: { from: 'initiation', path: 'quotedAt' } },
      ],
      reopen: false,
    },
    { id: 'e-a1-g1', from: 'A1', to: 'G1', mapping: [], label: '统一受理记录', reopen: false },
    {
      id: 'e-g1-a2',
      from: 'G1',
      to: 'A2',
      condition: 'needAlternative = true',
      label: '需要选型',
      mapping: [
        { target: 'material', source: { from: 'output-port', port: 'intake', path: 'pn' } },
        // 选型完了还要不要寻源,这枚旗得跟着走 —— G2 在本路径上读的是 A2 的载荷
        { target: 'needSourcing', source: { from: 'output-port', port: 'intake', path: 'needSourcing' } },
        /*
         * 询价单号也要带上:A2 办结时要把 `needSourcing` 回写「受理结论」那一行,
         * 而那一行的主键就是询价单号。不带,A2 就只能另起一行(或写出无主键的行,
         * 合并进正式版时被非空约束挡下)—— 去向便有了两个出处,G2 读哪个都不对。
         */
        { target: 'rfqRef', source: { from: 'initiation', path: 'rfqRef' } },
      ],
      reopen: false,
    },
    { id: 'e-g1-g2', from: 'G1', to: 'G2', condition: 'needAlternative = false', label: '不需要选型', mapping: [], reopen: false },
    { id: 'e-a2-g2', from: 'A2', to: 'G2', mapping: [], label: '替代对标表', reopen: false },
    {
      id: 'e-g2-a3',
      from: 'G2',
      to: 'A3',
      condition: 'needSourcing = true',
      label: '需要寻源',
      mapping: [{ target: 'pn', source: { from: 'output-port', port: 'intake', path: 'pn' } }],
      reopen: false,
    },
    {
      id: 'e-g2-j',
      from: 'G2',
      to: 'G2J',
      condition: 'needSourcing = false',
      label: '不需要寻源',
      mapping: [],
      reopen: false,
    },
    { id: 'e-a3-j', from: 'A3', to: 'G2J', mapping: [], label: '供应商底价表', reopen: false },
    {
      id: 'e-j-a4',
      from: 'G2J',
      to: 'A4',
      mapping: [
        ...REENTER_A4,
        // 底价只在寻源那条路上有;直通路径取不到即为空,A4 的 floors 非必填
        { target: 'floors', source: { from: 'output-port', port: 'compare', path: 'floors' } },
      ],
      reopen: false,
    },
    { id: 'e-a4-a5', from: 'A4', to: 'A5', mapping: [], label: '报价草案提审', reopen: false },
    /*
     * 审批点 → 网关:**审批的两个去向都由图决定**(BPMN 的常规)。
     * 判据 `verdict` 由引擎在裁决时放进载荷(`onApprovalVerdict`),不是这条边喂的常量 ——
     * 喂常量能让闸过、让流跑,但那样 G3 的条件恒真、驳回边永不可达,网关就成了摆设。
     */
    { id: 'e-a5-g3', from: 'A5', to: 'G3', mapping: [], reopen: false },
    {
      id: 'e-g3-a6',
      from: 'G3',
      to: 'A6',
      condition: 'verdict = "pass"',
      label: '通过',
      tone: 'ok',
      // 原 e-a5-a6 的装配原样搬来:draft 口是 A4 落的,一直在 record.ports 里
      mapping: [
        { target: 'rows', source: { from: 'output-port', port: 'draft', path: 'rows' } },
        { target: 'quote_no', source: { from: 'output-port', port: 'draft', path: 'quote_no' } },
        { target: 'customerCode', source: { from: 'initiation', path: 'customerCode' } },
      ],
      reopen: false,
    },
    {
      id: 'e-g3-a4',
      from: 'G3',
      to: 'A4',
      condition: 'verdict = "reject"',
      label: '不通过',
      tone: 'bad',
      mapping: REENTER_A4,
      /*
       * 回边:与 A5 的 `reject` 声明同一去向(回 A4 重开新实例),两处须一致。
       * `reopen` 必须为 true —— 标 false 则 A4 有两条**并发**入边(G2J 与 G3),
       * records / customerCode 同名双源,闭合校验按「汇合同名字段来源不明」拦下发布;
       * 拓扑序也会成环,流程链会读反。
       */
      reopen: true,
    },
    { id: 'e-a6-g4', from: 'A6', to: 'G4', mapping: [], label: '正式报价单', reopen: false },
    {
      id: 'e-g4-won',
      from: 'G4',
      to: 'end_won',
      condition: 'outcome = "won"',
      label: '成交',
      tone: 'ok',
      mapping: [],
      reopen: false,
    },
    {
      id: 'e-g4-a4',
      from: 'G4',
      to: 'A4',
      condition: 'outcome = "revise"',
      label: '有异议',
      tone: 'bad',
      mapping: REENTER_A4,
      // 回边:人裁决后重开新任务实例(同节点、新任务 ID、留痕关联)
      reopen: true,
    },
    {
      id: 'e-g4-a7',
      from: 'G4',
      to: 'A7',
      condition: 'outcome = "lost"',
      label: '拒绝/超时',
      tone: 'bad',
      mapping: [
        { target: 'outcome', source: { from: 'output-port', port: 'formal', path: 'outcome' } },
        { target: 'quote_no', source: { from: 'output-port', port: 'formal', path: 'quote_no' } },
        { target: 'customer_code', source: { from: 'output-port', port: 'formal', path: 'customer_code' } },
        { target: 'quotedAt', source: { from: 'initiation', path: 'quotedAt' } },
      ],
      reopen: false,
    },
    { id: 'e-a7-end', from: 'A7', to: 'end_arch', mapping: [], label: '归档闭环', reopen: false },
  ],
  variables: [],
  /*
   * 手绘几何存证 —— 呈现以它为真相(不走自动布局)。
   * 几何是重排后的两带换行(见 nodes 上方的版式说明),不再逐点等于 MVP 的 SVG;
   * 卡点是回跳的呈现(带 to,不画长线)。
   */
  diagram: {
    manual: true,
    rows: [],
    anchors: [],
    nodes: [
      { id: 'start', kind: 'start', label: '客户RFQ询价', x: 30, y: 70, lx: 44, ly: 104 },
      { id: 'A1', kind: 'activity', label: '客户RFQ受理', code: 'A1', owner: 'BD', x: 90, y: 60 },
      { id: 'G1', kind: 'gateway', label: '是否需要选型', mode: 'x', x: 250, y: 60, lx: 270, ly: 112 },
      { id: 'A2', kind: 'activity', label: '替代选型', code: 'A2', owner: 'FAE', flavor: 'case', x: 350, y: 60 },
      // 旁注左偏:正下方 x=530 有「不需要寻源」的竖段穿过
      { id: 'G2', kind: 'gateway', label: '是否需要寻源', mode: 'x', x: 510, y: 60, lx: 480, ly: 112 },
      { id: 'A3', kind: 'activity', label: '寻源询价', code: 'A3', owner: 'PRM', flavor: 'case', x: 610, y: 60 },
      { id: 'G2J', kind: 'gateway', label: '寻源汇合', mode: 'x', x: 770, y: 60, lx: 750, ly: 112 },
      { id: 'A4', kind: 'activity', label: '成本定价', code: 'A4', owner: 'BD', x: 60, y: 310 },
      { id: 'A5', kind: 'activity', label: '定价审批', code: 'A5', owner: 'PM', flavor: 'approval', x: 240, y: 310 },
      { id: 'G3', kind: 'gateway', label: '审批结果', mode: 'x', x: 380, y: 310, lx: 400, ly: 368 },
      { id: 'A6', kind: 'activity', label: '报价议价', code: 'A6', owner: 'BD', flavor: 'case', x: 460, y: 310 },
      // 旁注斜下:G4 四个口全占着线
      { id: 'G4', kind: 'gateway', label: '议价结果', mode: 'x', x: 620, y: 310, lx: 590, ly: 368 },
      { id: 'A7', kind: 'activity', label: '情报归档', code: 'A7', owner: 'BD', x: 590, y: 410 },
      { id: 'end_won', kind: 'end', label: '转订单履约', x: 700, y: 320, lx: 710, ly: 352 },
      { id: 'end_arch', kind: 'end-bad', label: '归档闭环', x: 730, y: 420, lx: 740, ly: 452 },
      // 两枚回 A4 的牌子同一条车道、同朝向(向上 = 回退):G3 上方与 G4 上方
      { id: 'c_reject', kind: 'callout', label: '退回调整', to: 'A4', x: 350, y: 250 },
      { id: 'c_revise', kind: 'callout', label: '返回调整', to: 'A4', x: 590, y: 250 },
    ],
    edges: [
      { from: 'start', to: 'A1', points: [{ x: 50, y: 80 }, { x: 90, y: 80 }] },
      { from: 'A1', to: 'G1', label: '统一受理记录', points: [{ x: 190, y: 80 }, { x: 250, y: 80 }] },
      { from: 'G1', to: 'A2', label: '需要选型', points: [{ x: 290, y: 80 }, { x: 350, y: 80 }] },
      // 不需要选型:从 G1 北口翻过 A2 头顶(y=20 车道)
      {
        from: 'G1',
        to: 'G2',
        label: '不需要选型',
        points: [{ x: 270, y: 60 }, { x: 270, y: 20 }, { x: 530, y: 20 }, { x: 530, y: 60 }],
      },
      { from: 'A2', to: 'G2', label: '替代对标表', points: [{ x: 450, y: 80 }, { x: 510, y: 80 }] },
      { from: 'G2', to: 'A3', label: '需要寻源', points: [{ x: 550, y: 80 }, { x: 610, y: 80 }] },
      // 不需要寻源:从 G2 南口穿过 A3 脚下(y=150 车道)扎进 G2J 南口
      {
        from: 'G2',
        to: 'G2J',
        label: '不需要寻源',
        points: [{ x: 530, y: 100 }, { x: 530, y: 150 }, { x: 790, y: 150 }, { x: 790, y: 100 }],
      },
      { from: 'A3', to: 'G2J', label: '供应商底价表', points: [{ x: 710, y: 80 }, { x: 770, y: 80 }] },
      // 换行那一笔:右探 40 → 降到 190 车道 → 横扫回左 → 落 A4 北口
      {
        from: 'G2J',
        to: 'A4',
        points: [
          { x: 810, y: 80 },
          { x: 850, y: 80 },
          { x: 850, y: 190 },
          { x: 110, y: 190 },
          { x: 110, y: 310 },
        ],
      },
      { from: 'A4', to: 'A5', label: '报价草案提审', points: [{ x: 160, y: 330 }, { x: 240, y: 330 }] },
      { from: 'A5', to: 'G3', points: [{ x: 340, y: 330 }, { x: 380, y: 330 }] },
      { from: 'G3', to: 'A6', label: '通过', tone: 'ok', points: [{ x: 420, y: 330 }, { x: 460, y: 330 }] },
      // 驳回:卡点(不画长线);语义边 e-g3-a4 在包里,存盘会被 mergeGraphIntoPackage 认回
      {
        from: 'G3',
        to: 'c_reject',
        label: '不通过',
        tone: 'bad',
        points: [{ x: 400, y: 310 }, { x: 400, y: 280 }],
        lx: 370,
        ly: 296,
      },
      { from: 'A6', to: 'G4', label: '正式报价单', points: [{ x: 560, y: 330 }, { x: 620, y: 330 }] },
      { from: 'G4', to: 'end_won', label: '成交', tone: 'ok', points: [{ x: 660, y: 330 }, { x: 700, y: 330 }] },
      {
        from: 'G4',
        to: 'c_revise',
        label: '有异议',
        tone: 'bad',
        points: [{ x: 640, y: 310 }, { x: 640, y: 280 }],
        lx: 610,
        ly: 296,
      },
      {
        from: 'G4',
        to: 'A7',
        label: '拒绝/超时',
        tone: 'bad',
        points: [{ x: 640, y: 350 }, { x: 640, y: 410 }],
        lx: 670,
        ly: 380,
      },
      { from: 'A7', to: 'end_arch', label: '归档闭环', points: [{ x: 690, y: 430 }, { x: 730, y: 430 }] },
    ],
  },
});

/** 事件触发器:投进公司询价邮箱且主题含询价/RFQ 的自动起单 */
const TRIGGER_EVENT = triggerConfigSchema.parse({
  id: 'trg-rfq',
  name: '客户RFQ询价',
  enabled: true,
  processPackageId: 'unified-quote',
  mapping: [
    { target: 'customerCode', source: { from: 'expression', sfeel: 'keys.customerCode' } },
    { target: 'rfqRef', source: { from: 'expression', sfeel: 'keys.rfqRef' } },
    { target: 'subject', source: { from: 'expression', sfeel: 'subject' } },
    { target: 'body', source: { from: 'expression', sfeel: 'body' } },
    // 单据日期取入站时刻:`intel.history_price` 的主键是 (pn, quoted_at),归档拿不到日期就写不进去
    { target: 'quotedAt', source: { from: 'expression', sfeel: 'occurredAt' } },
  ],
  // 按**通道**收口:同一封信投到「询价待确认邮箱」不命中,落人工确认那条路
  spec: {
    kind: 'event',
    rule: 'channelId = "ch-rfq-mail" and (contains(subject, "询价") or contains(subject, "RFQ"))',
    eventType: 'data',
  },
});

/** 登记触发器:人确认后起单,「登记人即来源」—— 表单由调用接口 schema 自动渲染 */
const TRIGGER_REGISTRATION = triggerConfigSchema.parse({
  id: 'trg-rfq-manual',
  name: '人工登记起单(统一报价)',
  enabled: true,
  processPackageId: 'unified-quote',
  mapping: [],
  spec: { kind: 'registration' },
});

export async function seedMvpFlow(container: Container): Promise<void> {
  const log = (line: string) => process.stdout.write(line + '\n');

  await container.process.savePackage(MVP_PACKAGE);
  const report = await container.process.validate(MVP_PACKAGE);
  if (!report.publishable) {
    log('   闭合校验未过,不得发布:' + report.violations.map((v) => v.message).join('; '));
  } else {
    await container.process.publish(MVP_PACKAGE.id, MVP_PACKAGE.version);
    log(`④ 流程包「统一报价」v${MVP_PACKAGE.version} 已发布 —— ${MVP_PACKAGE.nodes.length} 节点,边映射闭合校验通过`);
  }

  await container.trigger.upsert(TRIGGER_EVENT);
  await container.trigger.upsert(TRIGGER_REGISTRATION);
  log('   触发器已配置:客户RFQ询价(事件)· 人工登记起单(登记)');

  /* 邮件通道两条:自动起单的与人工确认的 —— 同一封 RFQ 两条路,起不起单由通道定 */
  const { positions } = await container.org.listStaff();
  const op = positions.find((p) => p.code === 'OP');
  const pm = positions.find((p) => p.code === 'PM');
  const extract = [
    { key: 'customerCode', regex: '\\bC\\d{3}\\b', source: 'both' as const },
    { key: 'rfqRef', regex: 'RFQ-[A-Z0-9]+', source: 'both' as const },
  ];

  await container.channel.upsert({
    id: 'ch-rfq-mail',
    name: '公司询价邮箱',
    kind: 'mail',
    address: 'rfq@we.com',
    enabled: true,
    extract: [...extract, { key: 'quoteNo', regex: 'Q\\d{6}', source: 'both' }],
    mapping: [],
    ...(op === undefined ? {} : { fallbackPosition: op.id }),
    addressWindowMs: 7 * 86_400_000,
  });

  await container.channel.upsert({
    id: 'ch-rfq-review',
    name: '询价待确认邮箱',
    kind: 'mail',
    address: 'rfq-review@we.com',
    enabled: true,
    extract,
    mapping: [],
    ...(pm === undefined ? {} : { fallbackPosition: pm.id }),
    addressWindowMs: 7 * 86_400_000,
  });
  log('   邮件通道已配置:公司询价邮箱(OP 兜底)· 询价待确认邮箱(PM 兜底)');
}