This repository has been archived on 2026-09-13. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
BPOS-TMP-REPO/apps/api/src/app/routes/log-lines.ts
T
ChaiHaoandClaude Opus 5 70e83d0b09 工作日志:一行摆首句,展开就把话说完
从前一条只有一行标题,而人真想回看的东西全躺在留痕里没露过面 ——
凭什么算这一步办完了、那一笔落下哪几行、被拒到底拒在哪儿、发的是哪种卡送到哪儿。
现在每条可展开,细节由 detailOf 摘成**一句句人话**(不摆 execution 这类内部名);
摘不出就是空数组,前端据此不给展开钮 —— 点开是空抽屉比不给还糟。

不摆二级条目(用户定):细节不是「键:值」两栏 —— 那是把留痕的字段名搬到人面前,
人还得自己在脑子里连成句子。每句自带主语与语境,单拎出来也读得通。

连带修一处文档与实现不符:「一轮一句」的口径说埋头办事那几拍的交代「留进工作日志」,
而实现把 internal 整类滤掉了,那几句哪儿都看不到。现在带交代的放行,
章写「交代进展」、记在 AI 名下;排障用的内部痕照旧不摆。
两种交代统一「首句上行、全文进抽屉」,一句话说完的不重复摆;截了才加省略号。

契约:任务详情的日志行新增可选 detail(字符串数组),api-report 同批更新。
门禁:typecheck / lint / depcruise / test(1378)全绿;浏览器实测折叠行高 34-36px 齐平、
展开无键值两栏残留。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-03 13:10:46 +08:00

69 lines
2.8 KiB
TypeScript

/**
* 日志行的呈现口径 —— **主语进内容**(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;
/** 展开才看的细节:一段一句人话(摘不出就是空数组 —— 前端据此不给展开钮) */
readonly detail: readonly 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,
detail: l.detail,
title: `${actor}:${l.title}`,
...(l.summary === undefined ? {} : { summary: l.summary }),
};
});
}