From e5139d980a0865093da6d3a56a3fdd157deccdbd Mon Sep 17 00:00:00 2001 From: weichen Date: Sun, 13 Sep 2026 11:12:03 +0000 Subject: [PATCH] docs(ops): note upload freeform registration before send Record client_key create path and no-orphan send contract on the document-revision-runtime short-term task. Co-authored-by: Cursor --- .doc/ops/short-term/2026-09-13-document-revision-runtime.md | 1 + 1 file changed, 1 insertion(+) diff --git a/.doc/ops/short-term/2026-09-13-document-revision-runtime.md b/.doc/ops/short-term/2026-09-13-document-revision-runtime.md index a6ccaaf0..c982477c 100644 --- a/.doc/ops/short-term/2026-09-13-document-revision-runtime.md +++ b/.doc/ops/short-term/2026-09-13-document-revision-runtime.md @@ -77,6 +77,7 @@ cd web && npm test && npm run build - J：**前端历史映射**：`pending_author_confirmation` 显式映射为气泡状态（不再默认 completed）；刷新窗口显示「待编制人确认」标签 - K：**决策幂等收口**：`CommitAgentVersion` 已 committed 且 expected hashes 一致时返回当前 state（可继续投影/MarkProposalApplied）；已 committed 禁止 reject。`MarkProposalApplied` 先写 DB 再改内存；已 applied 幂等（包内 Propose+Decide 验证）。decision 失败 hint 指向同决策重试；**不**暴露内存补种 helper（避免内存/DB 分叉） - L：**Playwright 骨架**：`web` 增加 `@playwright/test` + `playwright.config.ts` + `e2e/document-revision-runtime.spec.ts`（`RUN_UI_ACCEPTANCE=1` 才跑；无 mock/route/API/DB fixture） +- M：**上传注册事实源**：发送前 `await registerUploadAttachments` → `POST /api/v1/freeform-documents`（`client_key` 幂等）；失败 UI 显式错误且不发消息、不生成本地 `doc-upload` orphan；成功使用 `doc-free-*` 写入 deliverable/fileStore 并挂 toolbar ### 用户 UI 实战验收