docs(plan): Plan 3 收官——移交清单第 9 项终审既定事实

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-10-21 21:27:58 +08:00
parent fc36239b35
commit 066ba289bb
@@ -158,3 +158,4 @@ tests/integration/import-*.test.ts
6. **导入产物消费接口**:published 修订集合(entry_locales.published_revision_id → content_revisions.data)、routes(route_registry 全表)、**media_assets ready 集合**(status='ready'——quarantined/unsupported 排除语义:其路由行是旧 URL 空间台账,构建/产物侧不复制文件);`storage/incoming/` 副本路径保留(WXR 副本 + 媒体副本 2625 文件/164.53 MiB + 侧车,含 storage/snapshots content-addressed 双份共约 345MB——见 `docs/evidence/phase3-import.md` §6)供构建期媒体复制。
7. **续传携带**:Task 0.2 cms 数据备份(用户暂缓——**阶段 6 L3 验收前必须补做**,Plan 2 清单第 6 项责任链延续);836 条 attachment 301 的 nginx conf 输出(V2 §14 route compile)——Plan 4 或 Plan 5 定,数据已齐(route_registry redirect 行含 location)。
8. **度量基线**(Plan 4 构建耗时对照):导入首跑 51.8s / 二导 20.3s(逐事件串行分派的交互式往返口径——提速方向批量锚点解析,见 phase3-import.md §5);内存峰值 304.3 MiB(进程集上界口径);登记 media_bundle 19.0s(2625 文件哈希+副本)。
9. **终审补记的既定事实**(Plan 4 前置认知):① 真实站 `/products/` 被 basic_page "products" 内容页占据(exact 冲突——CLI 列表参数跳过,证据 §4)——主题的产品列表页路由实为内容页;② 19 条 `?p=` 条目无路由不进构建(既定口径);③ content_terms is_primary = first-import-wins 永不翻转(ADR-017 决策六)——主题渲染"主分类"前需确认源站主分类是否跨快照稳定;④ 五列锚点解析查询在三家写入器各有一份拷贝(同形非同码)——Plan 4 再加消费方时提取共享 helper;⑤ JSON/HTML 双文件顺序写存在极窄状态窗口(HTML 先失败时磁盘 JSON 带旧终态)——Plan 4 随手改 HTML 先写或接受。