资料文件真产出来了;E04/I01 补到验收线,顺手填了几个「墙拦住却不给路」的坑

**资料文件全链**(用户:审核资料这一步要真产出 word/excel/md/html,前端能渲、点资料名能开)
接手时这一步一个文件都产不出来 —— S3 剧本白纸黑字写着「file_ref 本 MVP 阶段可留空」。
文件是台账那一行的投影,不另存一份:
· 声明 `file:{titleColumn,bodyColumn,formatColumn}`,它同时是授权面(没声明就点不开)
· 现造真字节 —— docx/xlsx 是自己打的 OOXML 包(zip-write:store+CRC32,零依赖)
· 读回来渲 —— 解的就是造出来那份字节,渲得出来才证明文件是真的
· 件上 `data-file-of` → 工作区二级界面(Word 纸面/Excel 网格/渲好的 md/沙箱 html)+ 下载原件
放行落地前把每一份冻进 `sys.task_asset_file`(迁移 0029):归档件点开的必须是签字那一刻
那一份,而资料落在主数据上、试跑单不落正式表 —— 不存这一份,收工后一个都点不开。
工作成果里「产出的资料」自成一摞。Markdown 富文本渲染顺带销账(仍零依赖)。

**Harness**
· 画面按「这一拍办完之后」在办的那一步挑 —— 从前拿拍首的局面决定拍尾的事:
  收掉 S4、发出 S5 的卡,而屏上还摆着 S4 的只读件,人无处可填(墙要配路第四次现形)
· 验收「重做」真能退回重做,且打回后台账没动就不许再提交(软硬两段,不锁死单子)
· 立监听的授权面是清单声明;发卡的授权面是调人预算,不是计划项
· 读工具同参重调有兜底;空转写身后还有行动就不废串;finish 的 doneWhen 按写完后的草稿算

**界面**
· 翻件与翻页各归各位(从前二选一,多卡多页时页翻不动);没得翻写「—」不写 0/0
· 工作成果详情能翻份;表宽超出能横滑(E04/I01 抄版式时把 overflow-x 抄丢了)
· 查看面灰底滚过一屏变白 —— 两条独立的路都治了(沙箱内不同色 / 弹性子项不长个)
· 测试台「取不到」不再当成「还活着」

**活动**
E04 关系覆盖、I01 品牌内容各自补到验收线:判据全读基座数、判据指向的东西摆上卡面、
样例满载且名字 ≤14 字;提交前要裁的判据搬进说明书(模型会压拍,压过之后只有说明书还在)。

验收:e2e i01 4/4、e04 3/3 全部 released,资料在办中渲得出、放行后存了档点得开;
门禁 typecheck/lint/depcruise/1628 测全绿。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EEJX8Z7CHejvwmDQyPQuBX
This commit is contained in:
xcs
2026-08-24 10:26:45 +08:00
co-authored by Claude Opus 5
parent 70e83d0b09
commit 0aa2fc11b0
92 changed files with 13984 additions and 370 deletions
+57
View File
@@ -157,6 +157,40 @@ export const taskDetailSchema = z.object({
)
.default([]),
workOrders: z.array(workOrderSchema),
/**
* **答过的决策卡,答完那一刻的报告快照**(2026-08-21)。
*
* `decide` 是唯一能循环的中间验收机制(`issueAcceptance` 一个任务只能发一次),
* 它答完不产生工单行 —— 工作成果那一屏要看见这些报告,得走这条**单独的**口:
* 混进 `workOrders` 会连累别处「`mode==='acceptance'` 恒是终局放行卡」的假设
* (如 `signed` 那处「字签下了正在落地」的判断)。呈现时前端把两份列表并显即可。
*/
decidedDeliverables: z.array(workOrderSchema).default([]),
/**
* **这一单产出的资料文件** —— 工作成果里与定稿报告并列的一摞(2026-08-23)。
*
* 它不是工单快照:工单是「叫了人办的一件事」,资料是**办出来的东西本身**
* (白皮书 / 对照表 / 落地页)。两者混进一摞会让「几份成果」这个数说不清。
* 在办期间来自台账现造,放行之后来自存档 —— 两处都按 `address + key` 认,
* 点开走的是同一条路(`openAssetFileRoute`)。
*/
assetFiles: z
.array(
z.object({
/** 台账地址 `域.对象` */
address: z.string(),
/** 主键(多列主键用 `列=值` 以 `,` 连)—— 与 `data-file` 里那一串同一形状 */
key: z.string(),
title: z.string(),
/** md | html | docx | xlsx */
format: z.string(),
name: z.string(),
/** 已存档的带上时刻;在办中的没有 */
at: z.string().optional(),
archived: z.boolean(),
}),
)
.default([]),
chat: z.array(chatMessageSchema),
view: z.array(viewBlockSchema),
/** 活动推送的视图 HTML —— 容器沙箱渲染,无脚本执行权(AM 07) */
@@ -286,6 +320,29 @@ export const saveTableRoute = {
output: z.object({ ok: z.boolean(), rows: z.number().int().min(0) }),
} as const satisfies RouteContract;
/**
* **点开一份资料文件** —— 件上的资料名指向哪一行,这里就把那一行现造成文件交出去。
*
* 为什么按「台账地址 + 主键」取,而不是给文件发一个 id:资料的正身是台账里那一行
* (标题、正文、要哪种格式都在上头),文件是它的投影。发 id 就等于另存一份,
* 同一份事实两处各存一份 —— 台账改了,那个 id 指的还是旧的。
*
* `raw=1` 交原字节(下载,真 .docx / .xlsx);不带就交 `FileDoc`,前端照它渲。
*/
export const openAssetFileRoute = {
method: 'GET',
path: '/api/desk/tasks/:taskId/file',
params: z.object({ taskId: taskIdSchema }),
query: z.object({
/** `域.对象` —— 必须是活动清单里声明过 `file` 段的那张表(授权面) */
address: z.string().min(3),
/** 主键值(多列主键用 `列=值` 以 `,` 连;单列主键直接给值) */
key: z.string().min(1),
raw: z.string().optional(),
}),
output: z.object({ file: fileDocSchema, fileName: z.string(), format: z.string() }),
} as const satisfies RouteContract;
/** 负责人的自由输入 —— 人事件的第二形态 */
export const sayRoute = {
method: 'POST',