forked from ChaiHao/BPOS-MVP
从前一条只有一行标题,而人真想回看的东西全躺在留痕里没露过面 —— 凭什么算这一步办完了、那一笔落下哪几行、被拒到底拒在哪儿、发的是哪种卡送到哪儿。 现在每条可展开,细节由 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>
69 lines
2.8 KiB
TypeScript
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 }),
|
|
};
|
|
});
|
|
}
|