A2-A7 全部补齐到验收线;顺手把几处「门拦住却不给路」的坑填了

活动:A2 选型 / A3 寻源 / A4 定价 / A6 议价 / A7 归档五件各补成真活动包 —— 契约宽进(input.required 空,归一在活动内)、台账必填声明(含行级 requiredWhen)、入场哨兵与 L1/L2 判据一律读基座数、两份件(在办可编辑 + 办结静态快照)、三案例常备、包内自测。e2e 各三案例 released、行动被拒 0、发口正确、提交闸每单真拦。基座(共享面,改一处影响所有活动,故每处都带回归): · 重发判断走在站上场之前 —— 人答完那步常已收掉,readyToWork 先抛「不能再往它上面挂活」, 于是「重发已答过的卡 = 无事发生」这条唯一活路在最需要时够不着,A1 基线当场熔断; · 决策卡补幂等兜底(与执行工单同一把尺):头两次无事发生,第三次起才算被拒; · 输出没成形先就地重问一次,原话进工作日志、不再摆上卡面; · 工具调用读数 tool_<名>_calls —— 「机检只读基座数」这条纪律第一次覆盖到工具; · 执行卡 steps/standard 补进出参 schema(从前能到卡面全靠厂商 JSON 模式宽松); · 件的就地更新改逐节点 morph,保存先把新值镜像进只读那份 —— 不闪、不等回声。 A1(基线,全程守住):措辞三档对齐(必填/建议/选填)、禁止拿历史价当客户目标价、卡骨架从步骤剧本搬进说明书(压成一拍连做时剧本没摊开,会发出没有指导书的裸卡)。契约两处**新增可选字段**(非破坏):FieldDeclaration.requiredWhen、工单 finalHtml; api-report 同批更新。docs/adr 与 docs/archive 的 13 份文件在工作树里不见了, 本次予以恢复而非提交删除。门禁:typecheck / lint / depcruise / test(1366)全绿。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-03 12:28:31 +08:00
parent 85466e815f
commit ade0fa5a94
90 changed files with 17969 additions and 2316 deletions
@@ -19,7 +19,7 @@
 * 抄一份的下场踩过 —— 生产改了、测没跟着改,测全绿而线上照旧。
 */
 import { describe, expect, it } from 'vitest';
-import { gateOf, rowChanged, writesOf } from '../routes/desk.ts';
+import { gateAddressesOf, gateOf, rowChanged, writesOf } from '../routes/desk.ts';
 import { missingReadings } from '../wiring/engines.ts';

 /** A1 受理记录的声明(裁到这一段用得着的几列):PN 与年用量必填 */
@@ -103,6 +103,100 @@ describe('提交闸:必填没填就交不了', () => {
  });
 });

+/*
+ * **行级必填 `requiredWhen`:必填钉在该轮到的那一行**(2026-08-02 用户:
+ * 「工作区的 HTML 必填项必须填写了才能提交啊,不填写能算任务完成了吗?」)。
+ *
+ * 逐颗按序派单(A2 的 sel_stage 队列)撞上表级 required 的死结:定案三格整列必填,
+ * 第一颗的卡会被第二颗(还没轮到、件上不可见)的空格拦死;整列不标,闸又没牙,
+ * 空手就能交卷(用户实测点名)。requiredWhen 只在行上指定列等于指定值时才算必填。
+ */
+describe('行级必填:requiredWhen 只数该轮到的那一行', () => {
+  const LIST = {
+    domain: 'quote_alternative',
+    object: 'list',
+    fields: [
+      { name: 'rfq_ref', type: 'text', primaryKey: true },
+      { name: 'pn', type: 'text', primaryKey: true },
+      { name: 'alt_pn', type: 'text', primaryKey: false, label: '替代料 PN', requiredWhen: { column: 'sel_stage', value: 'NOW' } },
+      { name: 'alt_grade', type: 'text', primaryKey: false, label: '替代等级', requiredWhen: { column: 'sel_stage', value: 'NOW' } },
+    ],
+  };
+  const read = (rows: Array<Record<string, unknown>>) =>
+    missingReadings({ 'mine:quote_alternative.list': rows }, [LIST]);
+
+  it('**排队(WAIT)的颗不拦当前的卡** —— 只有 NOW 行的空格算缺', () => {
+    const got = read([
+      { rfq_ref: 'R1', pn: 'A', sel_stage: 'NOW', alt_pn: '', alt_grade: '' },
+      { rfq_ref: 'R1', pn: 'B', sel_stage: 'WAIT', alt_pn: '', alt_grade: '' },
+    ]);
+    expect(got['quote_alternative_list_missing']).toBe(1);
+    expect(got['quote_alternative_list_missing_keys']).toBe('R1/A 缺替代料 PN、替代等级');
+  });
+
+  it('NOW 行定案齐了 → 缺 0,闸开;办结(DONE)的行不再数', () => {
+    const got = read([
+      { rfq_ref: 'R1', pn: 'A', sel_stage: 'DONE', alt_pn: 'X', alt_grade: 'P2P' },
+      { rfq_ref: 'R1', pn: 'B', sel_stage: 'NOW', alt_pn: 'Y', alt_grade: 'FUNC' },
+    ]);
+    expect(got['quote_alternative_list_missing']).toBe(0);
+  });
+
+  it('**未果撤行之后 NOW 行不存在 → 缺 0** —— 撤行也是一个答案', () => {
+    expect(read([{ rfq_ref: 'R1', pn: 'B', sel_stage: 'WAIT', alt_pn: '', alt_grade: '' }])['quote_alternative_list_missing']).toBe(0);
+  });
+
+  it('不带 requiredWhen 的 required 照旧整列必填 —— 老声明一个字不用改', () => {
+    const plain = {
+      domain: 'd',
+      object: 'o',
+      fields: [
+        { name: 'k', type: 'text', primaryKey: true },
+        { name: 'v', type: 'text', primaryKey: false, label: '值', required: true },
+      ],
+    };
+    expect(missingReadings({ 'mine:d.o': [{ k: '1', v: '' }] }, [plain])['d_o_missing']).toBe(1);
+  });
+});
+
+/*
+ * **执行卡零输入之后,闸看哪几张表**(2026-08-02 用户定:填写全去工作区)。
+ *
+ * 卡面不再绑 blocks,闸若只认卡上的表就整个失效 —— 缺着必填照样交得回来,
+ * 一路走到放行门才被 L1 拦住,那正是当初立这道闸要治的病。
+ * 回落断了页面上看不出来(按钮照常绿着),所以钉在这儿。
+ */
+describe('闸看哪几张表:卡上绑的优先,没绑回落到必交付物声明', () => {
+  const table = (ledger: string) => ({ t: 'table' as const, ledger, cols: [], rows: [], fields: [] });
+
+  it('卡上绑了表 → 看绑的那几张,交付物声明不掺和', () => {
+    expect(
+      gateAddressesOf([table('quote_intake.record')], [{ ledgers: ['a.b', 'c.d'] }]),
+    ).toEqual(['quote_intake.record']);
+  });
+
+  it('**卡上没绑表(零输入执行卡)→ 回落到必交付物的 ledgers 全表**', () => {
+    expect(
+      gateAddressesOf(undefined, [{ ledger: 'quote_intake.record', ledgers: ['quote_intake.record', 'quote_intake.verdict'] }]),
+    ).toEqual(['quote_intake.record', 'quote_intake.verdict']);
+  });
+
+  it('老清单只给 ledger 单张 → 退它那一张;两边都空才真的没有依据', () => {
+    expect(gateAddressesOf([], [{ ledger: 'quote_sourcing.quote_list' }])).toEqual(['quote_sourcing.quote_list']);
+    expect(gateAddressesOf([], [{}])).toEqual([]);
+    expect(gateAddressesOf(undefined, [])).toEqual([]);
+  });
+
+  it('非表块(文本段)不算绑表 —— 熔断卡带 basis 不带表,照样回落', () => {
+    expect(
+      gateAddressesOf(
+        [{ t: 'p', text: '拒绝理由' } as never],
+        [{ ledgers: ['quote_alternative.list', 'quote_alternative.verdict'] }],
+      ),
+    ).toEqual(['quote_alternative.list', 'quote_alternative.verdict']);
+  });
+});
+
 describe('只写真改了的那几行', () => {
  const row = { rfq_ref: 'R1', pn: 'NE555P', eau: 30000, brand: 'TI' };