Files

T

浅念 25dcdf0a4d docs: 路线 V1.1——迁移优先快线为主（用户拍板最快见效），蓝图后移至迁移 MVP 后

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-10-21 15:04:51 +08:00

6.3 KiB

Raw Permalink Blame History

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）。定制后的计划序列：
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 域，以及"双入口切片"的正确性要求——通过路线定制吸收，不需要回退任何实现。

定制后的计划序列：

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 启动）

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

6.3 KiB Raw Permalink Blame History Unescape Escape