范式退役:活动只剩一种、只跑 Loop;审批活动可管;活动库重做

用户定的两件,一并落地。

**一、活动不再分 flow 和 loop —— 彻底退役 flow**
  · `flow-engine` 模块整个删除(runner 379 行 + step-sequence 184 行 + 测试);
  · `paradigm` 从清单身份、`activity_package`/`task` 两张表、任务卡与活动库一并退场;
    `businessModel` 不再是判别联合 —— 只有案例模型(CMMN + 说明书 + DMN)一形;
  · task 的引擎分派从「按 paradigm 取两个之一」收成**唯一的引擎**;
  · `activities/` 四个 flow 活动(A1 受理 / A4 定价 / A6 议价 / A7 归档)各写了一份
    案例模型:阶段照原来的步分,触达世界的项一律 manualActivationRule,
    能算的交 DMN(A1 的三分类 P-03、A4 的 P-01/P-02)不交 Agent;
  · 六个占位槽位的骨架从「机器步落台账 + 一张验收单」改成案例骨架,包版本 0.8.0 → 0.9.0。

**代价写在明处,不假装没有**:`turn-runner` 每一拍都要 `agent.decide` ——
环境里没有模型 key,案例活动一步也走不动。三套端到端(统一报价 / 新建流程包 / 测试台
Trace)整套跳过,文件头写明恢复条件:①有可用模型 ②走法改写成按 Enabled 集推进。
**不许把断言改松让它变绿** —— 绿得不诚实比红着更坏。debt.md 已记。

**二、审批活动可管**(新能力)
  · `sys.approval_template`:审批点**可复用的那一半** —— 审批人看哪几项、按什么名字看、
    怎么催、说什么话。谁来审不在里面(与活动点同口径,运营时轮值);驳回回哪个节点
    也不在里面(那是每张图自己的事,留在节点上);
  · 三条路由 + 引用反查:还被审批点引着就不许删(409),删了那些节点会**静默**退回旧行为;
  · 运行时 `basisOf`:引了模板就按模板筛与改名,没引即旧行为(载荷全摊开)。
    模板改了只影响新发出的审批单 —— 在途单的依据在发出那一刻已定形。

**三、活动库重做**:一区两格 —— 「活动(装进来的)」与「审批活动(配出来的)」,
都用流程卡那套两段式卡片(头 + 四格数据板),幽灵卡当入口(装入活动 / 新建审批活动);
「标准/案例」那一维随范式一起撤,业务分类成了唯一的一维,以行内小签呈现。

迁移 0020:两张表 drop paradigm、建 approval_template。已在开发库跑过并重播种。
实测(丁子乔账号):建「定价审批」模板 → 流程包 A5 属性里选得到 → 引用反查计数正确。
四闸绿(api:check 随本提交)。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
This commit is contained in:
2026-07-29 23:53:51 +08:00
co-authored by Claude Opus 5
parent 18c3e3fd09
commit 1fd215cf40
88 changed files with 1319 additions and 2966 deletions
@@ -0,0 +1,81 @@
/**
* A4 成本定价的案例模型 —— **双表示同版本**:CMMN XML(机器面)与案例说明书(叙事面)。
*
* 2026-07-29 由步序声明(flow)改写而来。原六步各归其位:取价基准与逐条定价属「算价」,
* 偏离率与底价门禁属「自检」(两支 DMN:P-01 利润模型、P-02 底价门禁),
* 超限条目调人决策是**触达客户利益的一下**,必须人工激活;末尾一张验收单。
*/
export const CMMN_XML = `<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns="http://www.omg.org/spec/CMMN/20151109/MODEL">
<case id="pricing">
<caseFileModel>
<caseFileItem id="records" name="待定价条目"/>
<caseFileItem id="basis" name="取价基准"/>
<caseFileItem id="draft" name="报价草案"/>
<caseFileItem id="floors" name="底价表"/>
</caseFileModel>
<casePlanModel id="plan" name="成本定价" autoComplete="true">
<sentry id="s_records">
<onPart id="op_rc" caseFileItemRef="records"><standardEvent>create</standardEvent></onPart>
</sentry>
<sentry id="s_basis">
<onPart id="op_bs" caseFileItemRef="basis"><standardEvent>create</standardEvent></onPart>
</sentry>
<sentry id="s_priced">
<onPart id="op_pd" caseFileItemRef="draft"><standardEvent>update</standardEvent></onPart>
<ifPart id="if_pd"><condition>unpriced = 0</condition></ifPart>
</sentry>
<sentry id="s_breach">
<onPart id="op_br" caseFileItemRef="draft"><standardEvent>update</standardEvent></onPart>
<ifPart id="if_br"><condition>breaches &gt; 0</condition></ifPart>
</sentry>
<stage id="S1" name="算价" autoComplete="true">
<entryCriterion id="ec_s1" sentryRef="s_records"/>
<humanTask id="T_basis" name="人工取价基准">
<itemControl><manualActivationRule id="m_bs"/></itemControl>
</humanTask>
<decisionTask id="D_price" name="逐条定价" decisionRef="p01-margin">
<entryCriterion id="ec_price" sentryRef="s_basis"/>
</decisionTask>
</stage>
<milestone id="M_priced" name="全条已定价"/>
<stage id="S2" name="自检" autoComplete="true">
<entryCriterion id="ec_s2" sentryRef="s_priced"/>
<decisionTask id="D_floor" name="底价门禁" decisionRef="p02-floor"/>
<humanTask id="T_breach" name="人工裁超限条目(回调还是注明理由)">
<entryCriterion id="ec_breach" sentryRef="s_breach"/>
<itemControl><manualActivationRule id="m_br"/><repetitionRule id="r_br"/></itemControl>
</humanTask>
<planningTable id="pt_s2">
<humanTask id="T_refresh_floor" name="人工刷新底价"/>
</planningTable>
</stage>
<milestone id="M_gated" name="门禁已过"/>
<humanTask id="T_release" name="人工报价草案验收放行">
<itemControl><manualActivationRule id="m_rl"/></itemControl>
</humanTask>
<timerEventListener id="TL_half" name="时限过半">
<timerExpression>PT8H</timerExpression>
</timerEventListener>
</casePlanModel>
</case>
</definitions>`;
export const NARRATIVE = `§0 开案:拿到一批待定价条目即开案。成品是**一份全条目带偏离度的报价草案** ——
每条有拟报单价与毛利率,且都过了底价门禁。
S1 算价:先取价基准(历史成交价 / 供应商回价 / 替代料对标价,按可得性择优),
再按利润模型 P-01 逐条定价 —— 客户等级、数量档、料号类型、行情共同决定加价率。
基准取不到的条目不许拍脑袋定价,回头找寻源或标注「无基准」。
S2 自检:算出偏离度(基准价 ↔ 拟报价),按底价门禁 P-02 逐条判。
**偏离 ±20% 以内自动放过;超限的一律调人** —— 要么回调价格,要么写明为什么这样报。
底价超一周没更新的先刷底价再判(裁量项),拿旧底价判新行情等于没判。
§Z 结案:每条都有拟报单价与毛利率、超限条目已处置、BD 签字放行,自动结案。
草案交出去就是下游议价的起点 —— 它不是最终报价,但每一条都要经得起问「为什么是这个价」。`;
+5 -73
View File
@@ -7,6 +7,7 @@
*/
import type { ActivityManifest, DmnModel } from '@contracts';
import { PRICING_SKILLS } from './skills.ts';
import { CMMN_XML, NARRATIVE } from './case-model.ts';
import { activityIdSchema } from '@contracts';
import { PRICING_BASIS, PRICING_PRICED, PRICING_RELEASE } from './views/report.ts';
@@ -63,7 +64,6 @@ export const manifest: ActivityManifest = {
name: 'A4 · 成本定价',
packageVersion: '0.1.5',
category: '统一报价',
paradigm: 'flow',
sdkVersion: '0.1.0-m5',
checksum: 'dev-checksum-quote-pricing',
},
@@ -161,79 +161,11 @@ export const manifest: ActivityManifest = {
},
assets: {
/* 资产初始版:案例模型(2026-07-29 起活动只有这一种业务模型) */
businessModel: {
paradigm: 'flow',
steps: [
{
kind: 'tool',
name: 'S1_basis',
label: 'S1 取价基准',
// Type A 取历史价近期价;B/C 取供应商底价表(C 类参考替代对标表)
input: { pn: 'pn' },
// 取回来的是**基准价**;偏离率要等 S2 定出拟报价才算得出来(见 S2B)
output: { domain: DOMAIN, object: 'draft', key: { pn: 'pn' }, fields: { last_price: 'lastPrice' } },
tool: 'crm.history-price-read',
view: 'pricing-basis',
failure: { retry: { times: 2, backoff: 'PT1M' }, fallback: { kind: 'human', workOrder: 'execution' } },
},
{
kind: 'pure-tool',
name: 'S2_price',
label: 'S2 逐条定价(DMN · 利润模型 P-01)',
input: { customerGrade: 'customerGrade', materialType: 'materialType', volumeTier: 'volumeTier' },
output: {
domain: DOMAIN,
object: 'draft',
key: { pn: 'pn' },
fields: { margin: 'marginLow', quoted_price: 'quotedPrice' },
},
tool: 'quote-pricing.margin',
failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'pure-tool',
name: 'S2B_deviation',
label: 'S2B 算偏离率(基准价 ↔ 拟报价)',
input: { lastPrice: 'last_price', quotedPrice: 'quoted_price' },
output: { domain: DOMAIN, object: 'draft', key: { pn: 'pn' }, fields: { deviation: 'deviation' } },
tool: 'quote-pricing.basis',
failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'pure-tool',
name: 'S3_floor_gate',
label: 'S3 底价自检(DMN · 底价门禁 P-02)',
input: { deviation: 'deviation' },
output: { domain: DOMAIN, object: 'draft', key: { pn: 'pn' }, fields: { disposition: 'disposition' } },
tool: 'quote-pricing.floor-gate',
view: 'pricing-priced',
failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'human',
name: 'S4_decide_breach',
label: '超限条目:调人决策(回调还是注明理由)',
// 只有门禁不过才调人 —— 条件必谓词,零 LLM
when: 'breached > 0',
input: {},
workOrder: 'execution',
card: { title: '有条目低于底价 20% 以上,请裁决', fields: ['disposition', 'reason'] },
deadline: 'PT4H',
failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
},
{
kind: 'human',
name: 'S5_release',
label: 'S5 报价草案验收放行',
input: {},
workOrder: 'acceptance',
card: { title: '报价草案(全条目带偏离度)请验收', deliverable: 'quote-draft' },
deadline: 'P1D',
view: 'pricing-release',
failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
},
],
parallelGroups: [],
cmmnXml: CMMN_XML,
narrative: NARRATIVE,
dmn: P01_DMN,
},
skills: PRICING_SKILLS,
viewTemplates: [