人手改的那一手真正落得下去;界面不撒谎那几处补齐

手改是**兜 AI 的错**的那一手 —— 这一轮把它从「摆在那儿但落不了地」做成真的: 件上就地改 · 保存**按地址收**,不看当下那张卡:载荷从前借道工单的 `blocks[i]` 取列名, 于是熔断卡(没有 blocks)在屏上时,人补的那一格一个字都送不出去 —— 而他要补的恰恰是把这一单卡住的那个必填格。授权面改由活动清单的台账声明把关。 · **能增删行**:错不止「这一格填错了」,还有「这一行不该在」与「漏了一行」。删挂记号不当场抹掉(看得见、可后悔),且**删要说出来**(`drops`)—— 「没回传就是删了」会把一次不完整的回传变成一次删表。 · **必填没填按不下提交**:与放行门 L1 同一个数同一套算法;闸上摆出差在哪一行哪一格。 · 只写真改了的那几行 —— 改一格却留「修订 4 行」的痕,那句话是假的。判据与门 · 裁量判据带谓词时**谓词说了算**:「选填缺口已补齐」基座数得出来, 人填好的目标价它照样判「客户未提供」的毛病由此消掉。 · 验收卡判据**读时现算** —— 人在成果件上补一格,判据跟着变。 · 放行门认「**办完了没有**」不认「有人写过」:从前写个 `false` 就把门推开, 于是一单没打标就进了放行门。三个数全由基座现数。 · 拒回把「活没干完」说成「数或行对不上」的毛病:判据点名的表一行都没写时直说那一步没办。 **指向两扇打不开的门,比不指还糟。** 界面不撒谎 · 日志只有三色:负责人绿 · 智能体蓝 · 系统灰(归侧五种是度量的分法,不是给人看的)。 · 验收收口答两件事:落了什么(按**交付物**点名,一份成果的几张表并成一行)、往哪儿去(转出哪一口、带过去哪些字段);一个口都没发就直说到此为止。 · 签完到收尾之间那一段有自己的话「字已签下,正在落地」—— 中间态本来就该说出来,只是要说对。 · 消息不再被内部事件刷屏:只有从通道进来的件才谈得上「无人认领」。 · 建客户公司与联系人**一次确认落两行**;联系人编码自增不问人;卡面摆表的人读名。 A1 三案例端到端全 released:全 A 类直通 12 拍 / 客户点名跳一条 10 拍 / 新客户缺必填 14 拍。五道门禁全绿(971 passed)。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01JsTDjoHovERXyy6Wmw1ALp
2026-08-02 13:41:44 +08:00
parent 94f1c7a4ef
commit 259192f736
228 changed files with 27850 additions and 2847 deletions
@@ -0,0 +1,50 @@
+/**
+ * 阶段进度 —— **给人看的刻度**,纯函数、零 IO(编码规范 §5.3)。
+ *
+ * 计划项是给引擎的粒度(A1 六项);阶段是给人的粒度(三段 + 收口)。
+ * 两层分开,是因为它们回答的是两个问题:
+ *   · 计划项:这一件事干完没有 —— 引擎要能判,所以拆得细;
+ *   · 阶段:这一单到哪儿了 —— 人要能扫一眼看懂,所以合得粗。
+ * 拿计划项当进度条,人看到的是「6 格里过了 3 格」,而那 6 格他一个也说不出是什么。
+ */
+import type { CasePhase } from '@contracts';
+import type { ItemRuntime } from './lifecycle.ts';
+
+export type PhaseProgress = {
+  /** 第几阶段,1 起;全部阶段过完但还没收口 = 最后一格(结束态) */
+  readonly index: number;
+  /** 总格数 = 声明的阶段数 **+ 1**(结束态) */
+  readonly total: number;
+  /** 这一格叫什么 */
+  readonly name: string;
+};
+
+/** 结束态的名字 —— 每个活动都以放行收口(铁律③),不由活动自己起名 */
+export const CLOSING_PHASE = '放行收口';
+
+/**
+ * 算这一单在第几阶段。
+ *
+ * 判据是「这一阶段的计划项**全部收完**」——
+ *   · 收完(Completed / Terminated,后者是被跳过的裁量项)算过；
+ *   · 没收完就停在这一阶段,哪怕其中一项已经在办。
+ * 从前往后找第一个没过的阶段:那就是当下这一格。全过了 = 进结束态。
+ *
+ * `terminal` 为真(这一单已收口)时直接给最后一格 —— 终态就是终态,
+ * 不必再去数计划项:放行完成之后 T_release 才收,中间那一瞬会显示成「还差一格」。
+ */
+export function phaseProgress(
+  phases: readonly CasePhase[] | undefined,
+  items: readonly ItemRuntime[],
+  terminal: boolean,
+): PhaseProgress | undefined {
+  if (phases === undefined || phases.length === 0) return undefined;
+  const total = phases.length + 1;
+  if (terminal) return { index: total, total, name: CLOSING_PHASE };
+
+  const settled = new Set(items.filter((i) => i.state === 'Completed' || i.state === 'Terminated').map((i) => i.id));
+  for (const [at, phase] of phases.entries()) {
+    if (!phase.items.every((id) => settled.has(id))) return { index: at + 1, total, name: phase.name };
+  }
+  return { index: total, total, name: CLOSING_PHASE };
+}