cms-website/SiteForge_V4基线重评估与路线定制_V1.0.md

# SiteForge V4 基线重评估与路线定制 V1.0

> 日期：2026-10-21
> 输入：`SiteForge_网站工厂完整项目计划方案_V4.0.md`（新最高基线）× 当前进度（Plan 1/2 已收官、Plan 3 已批准待执行）
> 决策：用户已确认 **路线 A**（先执行 Plan 3，再做蓝图阶段）+ **新站样板先用通用定义**（corporate-basic）
>
> **⚠️ V1.1 修订（2026-10-21，用户拍板"最快看到效果"主线）**：实施顺序以 `SiteForge_迁移优先快速见效实施计划_V1.0.md` 为准——**真实 WordPress 站静态迁移预览优先**，蓝图/新建站退至迁移 MVP 之后（该计划 §13）。定制后的计划序列：
> ```text
> Plan 3（执行中）= 快线第 2/4 步：导入管道（最小导入 + 全量导入 + URL Registry）
> Plan 4（改写）  = 快线第 3 步：content:publish + Render Snapshot + pilot-minimal 主题（六类页面）+ Astro 构建 + 本地 Preview + 最小门禁 → 浏览器可见
> Plan 5（改写）  = 快线第 4 步收尾：SEO 三方差异 + 完整门禁 → M1 完整迁移预览
> Plan 6（改写）  = 快线第 5 步：最小后台（内容/导入/构建/预览闭环）→ M2
> Plan 7（改写）  = 快线第 6 步：Release/发布锁/部署适配器/回滚 → M3
> Plan 8（改写）  = 快线第 7 步：迁移站正式验收 → 迁移 MVP（第 10 周口径）
> Plan 9+          = 工厂扩展（快线 §13 顺序：迁移产品化 → 蓝图新建站 → 第二主题/页面板块 → 复制建站 → 平台增强）
> ```
> 原 V4 阶段 2（蓝图）内容完整保留但后移至 Plan 10 附近；V4 的模型/门禁/发布设计仍是各计划的技术依据。

---

## 1. 结论

V4 把产品从"迁移平台"升级为"网站工厂"（四条路径）。**已完成的三轮计划没有工作被作废**：Plan 1 ≈ V4 阶段 1，Plan 2+3 ≈ V4 阶段 3（迁移路径主体）。V4 的实质增量是蓝图/页面板块/新建站/CSV/JSON 域，以及"双入口切片"的正确性要求——通过路线定制吸收，不需要回退任何实现。

定制后的计划序列：

```text
Plan 3（执行中）   = V4 阶段 3 收尾：导入管道落库
Plan 4（新写）     = V4 阶段 2：站点蓝图 + 全新建站最小链路（含页面/板块/菜单模型 + CSV/JSON 导入）
Plan 5（新写）     = V4 阶段 4：双入口主题与静态构建（两路径汇合同一构建器）
Plan 6（新写）     = V4 阶段 5：Art Design Pro 管理后台核心闭环
Plan 7（新写）     = V4 阶段 6：SEO 门禁 + Release + 部署适配器 + 回滚
Plan 8（新写）     = V4 阶段 7：三类样板验收（迁移原样/老内容新主题/蓝图新站）
```

## 2. 现状 → V4 映射（资产保全判定）

| 资产 | V4 对应 | 处置 |
|---|---|---|
| 21 表 schema（sites/snapshots/entries/revisions/taxonomies/media/routes/build/audit） | §10 领域模型 | **直接保留**；V4 §10.3-10.7 的核心身份/双指针/快照语义与现有实现一致 |
| 四冻结契约（UniversalRow + 三 Manifest） | §11 适配器协议、§15.2 Render Snapshot | 保留；Render Snapshot 文件清单在 Plan 5 按 V4 §15.2 扩展（加 blueprint/pages/blocks/menus/seo） |
| WXR 适配器 + PHP 解析 + 清洗 + 报告 | §11.3 WordPress 首版范围 | 保留（V4 要求的 post/page/product/分类/attachment/Yoast/permalink 全覆盖） |
| source:register + 媒体侧车 + sf CLI | §19.2 首版 CLI 子集 | 保留 |
| globalSetup 测试基建 / ADR×16 / 门禁纪律 | §22 测试策略 | 保留扩展 |
| Plan 3（已批准） | §25 阶段 3 全部交付物 | **照原样执行** |

## 3. 差距账本（按落地计划分组）

### Plan 4（蓝图阶段）需要新增
- **数据库**：`site_blueprints` / `site_blueprint_versions` / `blueprint_installations` / `site_blueprint_bindings`；`content_types`（安装化内容类型）；`page_template_definitions` / `page_instances` / `page_revisions` / `block_definitions` / `block_instances` / `block_instance_revisions`；`menus` / `menu_items`
- **能力**：Blueprint Manifest 契约 + 校验 + 安装/回滚（后台 Job 化）；`corporate-basic` 蓝图实体；`site:create` / `blueprint:list/install` CLI；CSV/JSON 导入 + 映射预览 + 幂等；`content:add`（手工）；新站 URL/SEO 默认规则（route_registry 的第二写入方）
- **Gate（=V4 M2）**：新站入口零 WordPress 假设；同一蓝图装两站数据隔离；安装失败完整回滚

### Plan 5（构建阶段）需要新增
- `site_environments` / `theme_bindings` / `deployment_targets` 表；Theme Manifest 扩展（蓝图兼容/预设）；两套主题（pilot-minimal 迁移向 + corporate-modern 新站向）；Block Renderer + Schema 版本迁移；冻结构建输入扩展（V4 §15.1 七元组）；自包含 Preview Server
- **Gate（=V4 M4）**：两路径同一构建器；同输入双构建 Hash 一致；双样板可 HTTP 预览

### Plan 6/7/8 需要（后台/发布/验收）
- mapping_profiles / import_items / import_conflicts（冲突队列 + 人工覆盖保护——V4 §11.5；Plan 3 的报告级冲突可升级为表级）
- media_variants / legacy_asset_routes；route_collisions / redirect_rules / seo_revisions / source_page_snapshots / sitemap_entries
- Art Design Pro 后台（V4 §18 信息架构）；Release/发布锁/部署适配器/回滚；Form API（按试点需要）
- 复制建站（V4 路径 4，P1）

## 4. 对既有基线文档的裁决（随 V4 §1.1 生效）

- V4.0 = 产品/架构/实施/验收**最高基线**
- V2 切片设计 = 数据/路由/构建/门禁细节参考（冲突处以 V4 为准）
- V3.0 / 实施计划 V1.0 = 历史参考
- Plan 1-3 文档 = 实施记录，继续有效

## 5. 时间线重估（诚实口径）

V4 自估：4-5 人团队 24-28 周；单开发者+AI **36-48 周**。当前进度约折抵 V4 阶段 1 全部 + 阶段 3 的 2/3（约 8-10 周等价工作量）。剩余（Plan 3 收尾 + Plan 4-8）按 V4 口径约 **28-40 周**。里程碑驱动的节奏不变：每计划终审通过才进下一个。

## 6. 待用户后续输入（不阻塞 Plan 3/4 启动）

1. 全新站样板的真实业务定制（现为通用 corporate-basic，品牌/字段/设计后补）
2. 首个正式部署目标（Nginx/SSH vs OSS/CDN）——Plan 7 前确定
3. 后台是否公网开放（决定 MFA 强制度）——Plan 6 前确定
4. Task 0.2 cms 数据备份（阶段 6/L3 前必须补——责任链持续携带）