Skip to content

一致性阶梯(Consistency Ladder) ​

「标品」不是一句形容词,而是一个可举证的数: 接一个新企业,改了几行业务代码。


五级阶梯 ​

级范围契约一份实现覆盖的三种企业配置
L1算价 / 报价pricing-quote13% / 19% / 8.25% 税率,half-up / half-even 舍入
L2订单 → 库存预留 → 履约order-fulfillment预留时机、审批阈值、部分履约、取消释放
L3期间 → 分录 → 结算accounting-period关账严格度、结算舍入、平台费率上限
L4多组织 / 多币种 / 审批链multi-org-approval组织维度、币种精度、单级 / 两级审批
L5退货 / 拆单 / 部分履约order-exceptions退货窗口、拆单策略、反向分录

每一级的差异全部在配置对象里。实现只有一份。


每级怎么证明「零代码」 ​

三条判据,缺一条就只是「代码写得比较灵活」:

  1. 新增变体只加配置对象,不改实现
  2. 守卫测试:读实现源码,断言不含 variant-[abc] / tenant 分支
  3. 同一批用例跑过所有变体,规则失败数为 0

真库验证 ​

纯函数只能证明「配置能表达差异」;要证明「配置能驱动真实系统」,必须落到真实状态。

级真库 e2e 验证的内容
L1ComputationService 幂等缓存、配置版本变更后重算
L2订单落库、库存预留、幂等键、余额不足拒绝
L3关账后写分录被 state 门禁拒绝、借贷平衡
L4审批记录落 state、版本递增、跨组织不可见
L5退货后库存返还、反向分录、期间试算平衡

一致性报告 ​

一条命令汇总五级:

bash
npm run conformance
level  verified  skill                      implementation       variants  cases  rules  pass
L1     real-db   pricing-quote.json         pricing-quote.ts            3      3      8 100.0%
L2     real-db   order-fulfillment.json     order-flow.ts               3      4      7 100.0%
L3     real-db   accounting-period.json     period-close.ts             3      4      7 100.0%
L4     real-db   multi-org-approval.json    approval-flow.ts            3      5      7 100.0%
L5     real-db   order-exceptions.json      order-exceptions.ts         3      4      7 100.0%

totals: 15 variants / 20 cases / 36 rules / failures 0 / pass 100.0%

报告已挂进 npm run review:有失败规则时退出码为 1,提交前即阻断。


边界 ​

这一层刻意不做完整的 ERP:

不做原因
多准则并行、税务申报、合并报表会变成财务软件,与定位冲突
多币种换算 / 重估 / 汇兑损益只做记账与显示精度;出现真实跨境单再议
换货、跨组织调拨、全量逆向物流L5 只覆盖退货 / 拆单 / 部分履约
与 SAP / Oracle 比功能数量只比「业务闭环是否可验证」

这份报告能证明什么 ​

同一套代码、五份实现、十五套企业配置,在真实 MongoDB 上跑完 36 条规则,零失败。

这份报告不能证明什么 ​

  • 不能证明真实客户接入成本为 0:变体是自造的,没有脏数据与历史流程
  • 不能说明规则足够严格:36 条以不变量为主,尚未覆盖业务口径的细微差异
  • 不能替代第一个真实客户的校准

Released under the MIT License.