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

手改是**兜 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,65 @@
+/**
+ * 日志行的呈现口径 —— **主语进内容**(2026-07-31 用户定)。
+ *
+ * 日志一行读起来该是「谁 · 做了什么 · 什么内容」:
+ *
+ *   16:25  [触发事件]  系统:一封邮件触发了这条流程,系统指定你负责「A1 · 询价受理」。
+ *   16:26  [阶段结论]  任务助手:这封邮件来自青岛海洋电子,是新客户…
+ *   16:30  [员工确认]  柴浩:写入 customer.profile
+ *
+ * 四字动作与归侧由 `memory` 的域函数算出(纯函数,可重算);
+ * **只有人名算不出来** —— 域里零 IO,不认识人。所以域交出 `actorId`,
+ * 在这一层换成名字:换不到就退回「员工」,不编名字(界面不撒谎)。
+ *
+ * 放在 routes 而不是 memory 模块里:这是**呈现**口径,不是事实口径。
+ * 事实库里存的是 id,谁改了名、谁离职了,回看旧单都该按当时的 id 找当下的名字。
+ */
+import type { LogLine } from '@modules/memory';
+import { staffIdSchema } from '@contracts';
+import type { OrgService } from '@modules/org';
+
+export type DisplayLogLine = {
+  readonly id: string;
+  readonly at: string;
+  readonly side: LogLine['side'];
+  readonly sideLabel: string;
+  /** 谁干的 —— 日志只认三档:负责人(绿)· 智能体(蓝)· 系统(灰) */
+  readonly who: LogLine['who'];
+  readonly action: string;
+  readonly title: string;
+  readonly summary?: string;
+};
+
+/**
+ * 把 `actorId` 换成名字并拼进内容。
+ *
+ * 一次任务里出现的人极少(通常 0–2 个),所以按**出现过的 id** 逐个查,
+ * 不整表捞:整表捞在任务详情这条热路径上是白花的一次全表查询。
+ */
+export async function displayLog(lines: readonly LogLine[], org: OrgService): Promise<DisplayLogLine[]> {
+  const ids = [...new Set(lines.flatMap((l) => (l.actorId === undefined ? [] : [l.actorId])))];
+  const names = new Map<string, string>();
+  await Promise.all(
+    ids.map(async (id) => {
+      const parsed = staffIdSchema.safeParse(id);
+      if (!parsed.success) return;
+      const staff = await org.getStaff(parsed.data).catch(() => undefined);
+      if (staff !== undefined) names.set(id, staff.name);
+    }),
+  );
+
+  return lines.map((l) => {
+    // 人做的那些:换得到名字就用名字,换不到就写「员工」—— 不编,也不留空
+    const actor = l.actor !== '' ? l.actor : (l.actorId === undefined ? '员工' : (names.get(l.actorId) ?? '员工'));
+    return {
+      id: l.id,
+      at: l.at,
+      side: l.side,
+      sideLabel: l.sideLabel,
+      who: l.who,
+      action: l.action,
+      title: `${actor}:${l.title}`,
+      ...(l.summary === undefined ? {} : { summary: l.summary }),
+    };
+  });
+}