From 80dcc8378fdcdcf538bdd16a1bcb70ed9d524576 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=B5=85=E5=BF=B5?= Date: Tue, 20 Oct 2026 16:40:10 +0800 Subject: [PATCH] =?UTF-8?q?docs(spec):=20=E9=87=87=E7=BA=B3=E5=A4=8D?= =?UTF-8?q?=E5=AE=A1=E5=85=AD=E6=9D=A1=E5=BB=BA=E8=AE=AE=E2=80=94=E2=80=94?= =?UTF-8?q?G5=E6=8E=AA=E8=BE=9E=E3=80=81=E9=99=84=E4=BB=B6=E9=A1=B5?= =?UTF-8?q?=E9=BB=98=E8=AE=A4=E8=A7=84=E5=88=99=E3=80=81NULLS=20NOT=20DIST?= =?UTF-8?q?INCT=E3=80=81verify.ts=E5=88=86=E5=B7=A5=E3=80=81incoming?= =?UTF-8?q?=E7=9B=AE=E5=BD=95=E3=80=81=E5=91=A8=E6=9C=9F=E5=AF=B9=E9=BD=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Code --- .../2026-10-20-siteforge-vertical-slice-design-v2.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/superpowers/specs/2026-10-20-siteforge-vertical-slice-design-v2.md b/docs/superpowers/specs/2026-10-20-siteforge-vertical-slice-design-v2.md index f45d98e..bdae9f9 100644 --- a/docs/superpowers/specs/2026-10-20-siteforge-vertical-slice-design-v2.md +++ b/docs/superpowers/specs/2026-10-20-siteforge-vertical-slice-design-v2.md @@ -59,7 +59,7 @@ SiteForge 是多站点静态迁移、内容维护、静态构建和发布平台 | G2 | 幂等与不可变修订 | 第二次导入同一 Source Snapshot 产生 0 条新修订；内容变化产生新修订，不 UPDATE 历史修订 | | G3 | 导入不发布 | 首次导入只更新 current revision；只有显式 publish 才更新 published revision | | G4 | URL 注册表 | WXR + 本地 Sitemap 构成的“当前已知 URL 基线”全部有明确处置；未处理 🔴=0 | -| G5 | 路径和媒体保真 | 可保真的内容、分类、分页和媒体按旧路径输出；不能保真的路径使用明确 Redirect/Gone/Unresolved 状态 | +| G5 | 路径和媒体保真 | 可保真的内容、分类、分页和媒体按旧路径输出；不能保真的路径使用明确 Redirect/Gone；登记为 unresolved 的路径必须在门禁前清零 | | G6 | 可复现静态构建 | 构建只读取冻结快照；相同输入连续构建的业务文件 Hash 一致；禁止 Seed 和在线数据库读取 | | G7 | 最小主题契约 | pilot-minimal 使用正式 Theme Manifest、Render Snapshot 和公共基础组件，不复制旧 cms 的整页硬编码架构 | | G8 | 自动门禁 | 全量检查路由、SEO、死链、媒体、Sitemap、重定向图、路径冲突和远程依赖 | @@ -133,7 +133,7 @@ WXR 可推导 URL | ADR-001 | ORM | Drizzle + PostgreSQL 16 | 所有 Schema 通过迁移文件管理；关键约束落数据库 | | ADR-002 | 服务形态 | NestJS 模块化单体 + Standalone App Context + CLI | 本切片不监听公网端口；服务层未来由 HTTP Controller 复用 | | ADR-003 | Job 执行 | 进程内 Runner + 数据库 Job 状态 | 不要求 BullMQ，但不能只存内存；进程中断后可识别 stale Job | -| ADR-004 | 原始输入 | Source Connection 与 Source Snapshot 分离 | 每个 WXR/Sitemap/媒体包形成不可变 Snapshot 和 Hash | +| ADR-004 | 原始输入 | Source Connection 与 Source Snapshot 分离 | 每个 WXR/Sitemap/已解包媒体目录形成不可变 Snapshot 和 Hash | | ADR-005 | WXR 解析 | 流式 SAX 解析 | 禁止整文件正则解析；限制字节、节点、深度、字段长度和处理时间 | | ADR-006 | 内容身份 | Source Record 稳定键 | WordPress ID 是来源身份；Permalink 只是 URL 证据，不作为稳定主键 | | ADR-007 | URL 模型 | Exact Route Key 与 Collision Key 分离 | 实际路由不大小写折叠、不去尾斜杠；碰撞键只用于风险检查 | @@ -193,6 +193,7 @@ cms-one/ docker-compose.yml # 本切片仅 PostgreSQL database/ storage/ # 全部 Git Ignore + incoming/ # 待登记的临时暂存输入（source:register 登记后复制进 snapshots/，可清理） snapshots/ media/ quarantine/ @@ -516,6 +517,7 @@ UNIQUE(site_id, host, exact_route_key, query_key) 规则： +- `UNIQUE(site_id, host, exact_route_key, query_key)` 中 `query_key` 为 NULL 的纯路径路由，需以 PostgreSQL `NULLS NOT DISTINCT`（或哨兵值）实现数据库级唯一——写入 Schema 约束，避免迁移编写时才发现。 - `source_path_raw` 永远保存来源原文。 - `route_path` 是经过安全校验的实际公开路径。 - `exact_route_key` 用于请求匹配，保留大小写和尾斜杠语义。 @@ -612,7 +614,7 @@ CLI 必须接受或生成明确 Actor，不使用模糊的固定 `system/importe | 产品分类/文章分类 | 根据 Taxonomy/Term 生成列表和分页 | html | | Tag/Product Tag | 默认 301 到对应主列表（本切片不生成 Tag 页；生成能力留待 SP3 后按需评估） | redirect | | 日期/作者归档 | 默认 301 到新闻主列表，逐条登记 | redirect | -| Attachment 页面 | 按 Sitemap/WXR 状态决定 HTML、Redirect 或 Gone | html/redirect/gone | +| Attachment 页面 | 确定性默认规则：出现在老站 Sitemap → html；仅 WXR 证据 → 301 到对应媒体文件（或父列表页）；确认已删除 → 410。偏离默认的条目在报告中逐条列出 | html/redirect/gone | | 上传媒体路径 | 按旧 `wp-content/uploads/...` 输出 | asset | | 无法保真的内容路径 | 人工映射；不得默认跳首页 | redirect/unresolved | | 已确认永久删除 | 410 | gone | @@ -1068,6 +1070,8 @@ pnpm sf preview --build --host 127.0.0.1 --port 4173 ### 13.1 URL 与响应 +门禁 CLI 分工：`gate.ts` 对 Artifacts 做静态检查（清单/文件/Hash/路径安全）；`verify.ts` 启动 Preview 后对 Route Manifest **全部路由**做真实 HTTP 验证（本节规则与 §14.5）。 + - 当前已知 URL 基线 `unresolved=0`。 - 自动请求 Route Manifest 中全部路由，不以 20 条抽样代替全量检查。 - HTML、Asset、Redirect、Gone 状态符合 Manifest。 @@ -1386,7 +1390,7 @@ pnpm sf preview --build --host 127.0.0.1 --port 4173 - §16 全部满足。 -预计总周期：约 4–6 周。真实数据异常、未知插件字段和媒体命名问题可能增加时间。 +预计总周期：约 5–8 周（各阶段区间合计 24–42 个工作日）。真实数据异常、未知插件字段和媒体命名问题可能增加时间。 ---