BPOS-TMP-REPO/activities/quote-sourcing/src/manifest.ts

/**
 * 活动包清单 —— 统一报价 A3 · 渠道寻源(**案例活动 · loop**)。
 *
 * 业务素材:docs/MVP示例工作流.html §1.5。按 README《归一化对照表》映射:
 *   案例图 → CMMN XML;案例说明书 → 同版本叙事面;
 *   `!必做` → entryCriterion 常项;`看情况` → discretionary(planningTable);
 *   `#可反复` → repetitionRule;`▶需拍板` → manualActivation + 放行;
 *   `⏱时限/回价到期` → 时间监听(**时限必配**)。
 */
import type { ActivityManifest, DmnModel } from '@contracts';
import { SOURCING_SKILLS } from './skills.ts';
import { SOURCING_CASE } from './views/report.ts';
import { activityIdSchema } from '@contracts';
import { CMMN_XML, NARRATIVE, SOURCING_STEPS } from './case-model.ts';

const DOMAIN = 'quote_sourcing';
const ACTIVITY_ID = activityIdSchema.parse('quote-sourcing');

/** 采用策略 —— 「能算的不问 LLM」:场景 × 历史情形 → 直采 / 重询 */
export const STRATEGY_DMN: DmnModel = {
  drd: [{ decision: 'sourcing-strategy', requires: [], inputs: ['scenario', 'priceDrift', 'quoteCount'] }],
  tables: [
    {
      id: 'sourcing-strategy',
      label: '采用策略判定',
      hitPolicy: 'FIRST',
      inputs: [
        { name: 'scenario', expression: 'scenario' },
        { name: 'priceDrift', expression: 'priceDrift' },
        { name: 'quoteCount', expression: 'quoteCount' },
      ],
      outputs: [{ name: 'strategy' }, { name: 'needNewQuote' }],
      rules: [
        { id: 'st-spot', when: ['"现货","样品"', '-', '-'], then: ['一律重询', true] },
        { id: 'st-early-direct', when: ['"BOM早期"', '<= 0.10', '-'], then: ['直采', false] },
        { id: 'st-early-avg', when: ['"BOM早期"', '[0.10..0.20]', '-'], then: ['取均价', false] },
        { id: 'st-late-direct', when: ['"BOM后期"', '-', '>= 3'], then: ['历史最低直采', false] },
        { id: 'st-default', when: ['-', '-', '-'], then: ['重询', true] },
      ],
    },
  ],
};

export const manifest: ActivityManifest = {
  identity: {
    activityId: ACTIVITY_ID,
    name: 'A3 · 渠道寻源',
    packageVersion: '2.0.0',
    category: '统一报价',
    sdkVersion: '0.1.0-m5',
    checksum: 'dev-checksum-quote-sourcing',
  },

  contract: {
    activityId: ACTIVITY_ID,
    version: '0.1.0',
    input: {
      data: {
        type: 'object',
        required: ['rfqRef', 'pn', 'scenario'],
        properties: {
          rfqRef: { type: 'string', title: '询价单号(单标识,贯穿全流程)' },
          pn: { type: 'string' },
          scenario: { type: 'string' },
          quantity: { type: 'integer' },
          targetPrice: { type: 'number' },
        },
      },
      messageAllowed: true,
      messageHint: '急料、客户特殊要求写这里',
    },
    output: {
      mandatory: [
        {
          name: 'compare',
          payload: { type: 'object', required: ['rows'], properties: { rows: { type: 'array' } } },
          description: '寻源比价表(多渠道横比定底)',
        },
      ],
      selective: [],
    },
    /*
     * 必交付物**必须给 `ledger` 地址**(2026-07-31 修)。
     * 不给的话预检退回 `scope[key]` 去找 —— key 是 `benchmark-table` 这样的短横线别名,
     * 任务视图里永远没有这个键,于是「必交付物缺一不得提交放行」永远拒,
     * 活办完了也放不了行,连拒五拍熔断(实测 A2 死于此)。
     */
    requiredDeliverables: [
      { key: 'compare-table', label: '寻源比价表', ledger: `${DOMAIN}.compare_table` },
    ],
    /*
     * 机检谓词读的是 `verdict` 那张**汇总表**的列(照 A1 的口径)。
     * 上一版的名字(unquoted / channelsPicked)**台账里根本没有** —— S-FEEL 拿未绑定的名字
     * 比大小求值为假,判据永远达不了标,submit 门永远拒,连拒五拍熔断。
     * 判据的名字必须落在台账上,否则「机检」是一句空话(2026-07-31 销账)。
     */
    acceptanceCriteria: [
      { key: 'each-has-quote', label: '每料有有效报价或明确无货', level: 'L2', predicate: 'unquoted_total = 0' },
      { key: 'channels-enough', label: 'BOM后期每料 2~3 家渠道', level: 'L2', predicate: 'supplier_total >= 2' },
      { key: 'cross-check', label: '价格验证按场景规则做过', level: 'L3' },
      { key: 'prm-release', label: '采购放行', level: 'L5' },
    ],
    revisableAtRelease: [],
    prohibitions: [
      { key: 'no-stockless-trader', statement: '现货场景不得选无库存转单商' },
      { key: 'no-unverified', statement: '不实回价或远低行情的,必须换渠道补询,不得直接采用' },
    ],
    authorization: {
      discretion: [{ key: 'channel-band', statement: '按场景放宽或收紧渠道尺度;贸易商尽量不用' }],
      preauthorizedActions: [{ tool: 'mail.send', operation: 'inquiry', limit: '询价模板' }],
      humanCallBudget: 8,
    },
    resources: {
      tools: [{ name: 'mail.send' }, { name: 'crm.history-price-read' }],
      skills: SOURCING_SKILLS.map((s) => s.id),
      models: ['deepseek-v4-flash'],
      roles: ['PRM'],
      budget: { steps: 120, tokens: 300_000, activeMinutes: 480, humanCalls: 8 },
    },
  },

  declarations: {
    models: ['deepseek-v4-flash'],
    tools: [{ name: 'mail.send' }, { name: 'crm.history-price-read' }],
    ledger: [
      {
        domain: DOMAIN,
        object: 'supplier_quote',
        kind: 'record',
        caseKey: 'rfq_ref',
        label: '供应商回价单',
        fields: [
          { name: 'rfq_ref', type: 'text', primaryKey: true, masked: false, label: '询价单号' },
          { name: 'pn', type: 'text', primaryKey: true, masked: false },
          { name: 'supplier', type: 'text', primaryKey: true, masked: false, label: '供应商' },
          { name: 'price', type: 'number', primaryKey: false, masked: false, label: '回价' },
          { name: 'moq', type: 'integer', primaryKey: false, masked: false, label: 'MOQ' },
          { name: 'lead_time', type: 'text', primaryKey: false, masked: false, label: '交期' },
          { name: 'valid_until', type: 'date', primaryKey: false, masked: false, label: '有效期' },
          { name: 'grade', type: 'text', primaryKey: false, masked: false, label: '渠道等级' },
        ],
      },
      {
        domain: DOMAIN,
        object: 'compare_table',
        kind: 'record',
        caseKey: 'rfq_ref',
        label: '寻源比价表',
        fields: [
          { name: 'rfq_ref', type: 'text', primaryKey: true, masked: false, label: '询价单号' },
          { name: 'pn', type: 'text', primaryKey: true, masked: false },
          { name: 'supplier', type: 'text', primaryKey: false, masked: false },
          { name: 'price', type: 'number', primaryKey: false, masked: false },
          { name: 'conclusion', type: 'text', primaryKey: false, masked: false, label: '结论' },
        ],
      },
      {
        /*
         * 寻源结论 —— 一单一行的**汇总表**,验收机检谓词的入参就在这儿。
         * 汇总列与逐行列**故意不同名**:任务视图把草稿行摊平到顶层是「后写的赢」,
         * 拿逐行列求值只会验到最后写的那一行,那不叫机检、叫抽样(A1 的教训)。
         */
        domain: DOMAIN,
        object: 'verdict',
        kind: 'record',
        caseKey: 'rfq_ref',
        label: '寻源结论',
        fields: [
          { name: 'rfq_ref', type: 'text', primaryKey: true, masked: false, label: '询价单号' },
          { name: 'pn', type: 'text', primaryKey: false, masked: false, label: '型号' },
          { name: 'supplier_total', type: 'integer', primaryKey: false, masked: false, label: '已询渠道数' },
          { name: 'quoted_total', type: 'integer', primaryKey: false, masked: false, label: '已回价条数' },
          { name: 'unquoted_total', type: 'integer', primaryKey: false, masked: false, label: '未回价条数' },
          { name: 'compare_total', type: 'integer', primaryKey: false, masked: false, label: '比价条数' },
          { name: 'recommend_supplier', type: 'text', primaryKey: false, masked: false, label: '推荐供应商' },
          { name: 'summary', type: 'text', primaryKey: false, masked: false, label: '寻源结论' },
        ],
      },
    ],
    listeners: [
      {
        // 回价到期:临过期提醒复核确认,过期触发重询 —— 时限必配
        origin: 'static',
        eventType: 'data',
        keyFilter: { kind: 'supplier-quote' },
        semantic: 'observe',
        deadline: 'P4D',
        escalation: ['nudge', 'escalate'],
      },
      {
        origin: 'static',
        eventType: 'time',
        keyFilter: { kind: 'quote-expiry' },
        semantic: 'observe',
        deadline: 'P7D',
        escalation: ['nudge', 'reroute'],
      },
    ],
    // 按场景时限:BOM早期/现货 1~4 日、样品 1~3 日、BOM后期 3~9 日 —— 取最宽做停滞阈值
    harness: {
      memoryWindow: 30,
      stallAfter: 'P2D',
      nudge: [{ after: 'P1D', action: 'nudge' }],
      retry: { times: 2, backoff: 'PT5M' },
    },
  },

  assets: {
    businessModel: {
      cmmnXml: CMMN_XML,
      // 双表示同版本:XML 是机器面,说明书是叙事面 —— 不允许分叉
      narrative: NARRATIVE,
      dmn: STRATEGY_DMN,
      /* 步骤剧本 —— 与 A1 同一套:doneWhen 真了引擎自己收步,不问模型 */
      steps: SOURCING_STEPS,
    },
    skills: SOURCING_SKILLS,
    viewTemplates: [{ name: 'case-overview', html: SOURCING_CASE }],
    cardSchemas: {},
    distillHooks: [
      { on: 'milestone', milestone: 'M_quotes', prompt: '归纳各渠道的回价节奏与配合度。' },
      { on: 'terminal', prompt: '归纳本单寻源:哪些渠道靠谱、哪些场景的价格验证规则该收紧。' },
    ],
  },

  samples: [
    { name: 'BOM后期询价', input: { pn: 'LM358DR', scenario: 'BOM后期', quantity: 5000 }, expect: { ports: ['compare'] } },
  ],

  entry: { file: 'index.js', checksum: 'dev-entry-quote-sourcing' },
};