# SiteForge 项目实施计划 > 版本：V1.0 > 编制日期：2026-10-20 > 方案基线：`SiteForge_完整项目计划方案_V3.0.md` > 计划周期：目标20周，预留4周风险缓冲 > 适用团队：约5人核心团队，设计师阶段性参与 --- ## 1. 实施目标 在20周目标周期内，完成一套可投入生产使用的多站点迁移与静态发布平台，并通过两个真实网站验证： 1. 一个资料完整的 WordPress 网站。 2. 一个非 WordPress、HTML/PHP、自研 CMS 或其他不同来源的网站。 最终必须跑通： ```text 多来源盘点 → 全量导入 → 标准化与字段映射 → URL/SEO基线 → 独立主题与组件化实现 → 差量同步 → 静态构建 → 自动验收 → 发布确认 → 原子部署 → 生产验证 → 回滚演练 ``` 项目实施遵循以下原则： - 优先完成真实站点纵向闭环，不先堆积后台页面。 - V1 只设置 `super_admin` 一个系统角色。 - 管理后台使用 Art Design Pro（Vue 3 + TypeScript + Element Plus）。 - 第一版只做全量构建，不提前开发复杂增量构建。 - 先完成 WordPress 与通用网页适配，不同时扩展多个 CMS。 - URL、SEO、内容和回滚能力优先于高级视觉编辑。 - 每个 Sprint 必须交付可演示、可测试的结果。 --- ## 2. 计划假设 ### 2.1 团队配置 | 代号 | 角色 | 建议投入 | 主要责任 | |---|---|---:|---| | PM | 项目/产品负责人 | 50%–100% | 范围、决策、试点协调、验收 | | BE | 后端/架构工程师 | 100% | API、数据库、任务、构建、发布、安全 | | FE | 前端/主题工程师 | 100% | Art Design Pro、编辑器、主题、组件化 | | DE | 迁移/数据工程师 | 100% | 扫描、WordPress、映射、URL/SEO基线 | | QA | 测试/运维工程师 | 80%–100% | 自动测试、部署、监控、备份、回滚 | | UI | UI/UX设计师 | 阶段性 | 两站设计、组件规范、响应式验收 | 项目角色仅用于实施分工，不对应系统权限；系统内仍由超级管理员完成所有操作。 ### 2.2 必要输入 项目第1周必须能够获得： - 两个试点站及其负责人。 - WordPress SQL、WXR、uploads 和插件/主题清单。 - Sitemap、旧服务器规则和可用访问权限。 - 生产域名、DNS、CDN、证书和部署环境信息。 - 重要页面、产品、文章和动态功能清单。 - 至少一部分访问日志或 GSC/GA4 落地页数据。 - 品牌资料及第一批页面设计方向。 如果关键数据无法取得，项目可以继续完成平台功能，但试点完整迁移和最终上线日期需要重新评估。 ### 2.3 周期说明 - 目标实施周期：20周。 - 风险缓冲：第21–24周，按需启用。 - Sprint长度：2周。 - 共10个正式Sprint。 - 复杂 Elementor、WooCommerce、多语言、特殊URL规则可能消耗缓冲时间。 --- ## 3. 总体里程碑 | 里程碑 | 时间 | 结果 | 发布门槛 | |---|---:|---|---| | M0 范围冻结 | 第2周 | 试点、技术和V1范围确定 | 样本数据可访问，风险已分级 | | M1 平台底座 | 第4周 | 超管、站点、任务和基础设施可用 | CI通过，核心环境可启动 | | M2 数据闭环 | 第8周 | WordPress可重复导入并建立URL/SEO基线 | 幂等、快照、差量测试通过 | | M3 静态预览 | 第12周 | 首站可从后台生成独立主题预览 | 内容、路由、SEO进入静态产物 | | M4 发布闭环 | 第16周 | 构建、验收、部署和回滚可用 | 生产等价环境演练通过 | | M5 双站验证 | 第18周 | 第二来源和第二主题闭环 | 公共组件复用验证通过 | | M6 试点上线 | 第20周 | 首站上线、第二站可交付 | 最终差量、门禁、回滚均通过 | --- ## 4. 工作流划分 ### 4.1 平台与后台工作流 - Art Design Pro 工程底座。 - 超管登录、MFA、会话和恢复。 - 站点、环境、域名和配置。 - 任务进度、日志和系统设置。 - 内容、页面板块、URL、SEO、构建和发布界面。 ### 4.2 数据迁移工作流 - 网站探测和扫描。 - URL多来源合并。 - WordPress REST/WXR/SQL/uploads。 - 原始快照和差量同步。 - 字段映射、冲突和异常处理。 ### 4.3 主题与组件工作流 - Theme Manifest、Template和Block Schema。 - 公共数据契约、基础组件和Headless逻辑。 - 第一套WordPress试点主题。 - 第二套视觉差异明显的主题。 - 静态预览和视觉回归。 ### 4.4 构建与发布工作流 - 构建输入快照。 - 隔离、可复现的Astro构建。 - 路由编译和部署能力预检。 - 自动验收、Release、发布锁和回滚。 - Nginx/SSH或对象存储/CDN部署。 ### 4.5 质量与运维工作流 - 单元、契约、集成和E2E。 - URL/SEO/内容/媒体/视觉门禁。 - 监控、告警、任务死信。 - 备份、恢复和故障Runbook。 - 切站彩排和稳定期监测。 --- ## 5. Sprint 0：试点盘点与范围冻结（第1–2周） ### 5.1 Sprint目标 确认项目能做什么、首版不做什么，并用真实数据验证关键技术路径。 ### 5.2 工作任务 #### 产品与业务 - 确定两个试点网站。 - 确定生产部署方式。 - 收集产品、新闻、页面和动态功能清单。 - 建立V1/V1.1/暂缓范围矩阵。 - 确定超级管理员和试点验收负责人。 #### 迁移盘点 - 收集SQL、WXR、uploads、Sitemap和服务器规则。 - 识别WordPress插件、ACF/CPT、页面构建器和SEO插件。 - 从数据库、Sitemap、日志、GSC/GA4合并首批URL。 - 抽取至少20个代表性页面。 - 识别中文URL、查询参数、`.html`、`.php`、分页和媒体路径。 - 输出动态功能处置表。 #### 技术预研 - 验证Art Design Pro工程结构。 - 验证NestJS、PostgreSQL、Redis/BullMQ和对象存储。 - 验证Astro动态路由和目标服务器URL行为。 - 验证构建隔离方案。 - 确定ORM、存储和部署适配器ADR。 #### 设计 - 明确两个试点的品牌方向。 - 列出首页、产品、文章、列表和普通页面类型。 - 建立第一版设计令牌和组件清单。 ### 5.3 交付物 - 《两个试点站评估报告》 - 《V1范围矩阵》 - 《URL/SEO初始基线》 - 《动态功能处置表》 - 《字段映射样本》 - 《技术ADR清单》 - 《风险登记表》 - 20个真实页面PoC结果 ### 5.4 验收门槛 M0 - 两个试点及数据可用范围明确。 - WordPress数据至少能读取SQL/WXR中的一种。 - 目标部署环境能够执行URL行为验证。 - V1范围和不做事项书面冻结。 - P0风险都有负责人和处置方案。 --- ## 6. Sprint 1：工程底座与超级管理员（第3–4周） ### 6.1 Sprint目标 建立可持续开发的工程、环境和安全基础。 ### 6.2 工作任务 #### 工程 - 建立pnpm Monorepo和统一TypeScript配置。 - 建立admin、api、worker、builder应用。 - 配置代码检查、类型检查、单元测试和CI。 - 建立开发、测试和预览环境配置。 - 锁定Node、依赖和容器镜像版本。 #### 管理后台 - 初始化Art Design Pro。 - 删除多角色、按钮权限和成员管理功能。 - 建立固定菜单和基础页面框架。 - 完成登录、MFA、恢复码和会话管理页面。 - 完成统一API错误和任务状态展示。 #### 后端与基础设施 - 建立NestJS模块骨架。 - 建立PostgreSQL迁移机制。 - 建立Redis/BullMQ。 - 建立S3兼容对象存储。 - 建立结构化日志、请求ID和审计日志。 - 建立密钥引用模型。 #### 数据模型 - admin_user、admin_session。 - site、domain、environment、site_setting。 - job、job_lease、audit_log。 - source_connection基础表。 ### 6.3 交付物 - 可启动的本地开发环境。 - 可登录的管理后台。 - 可创建站点和环境。 - 可提交示例异步任务并查看日志。 - CI流水线和数据库迁移。 ### 6.4 验收门槛 M1 - 全新环境可按文档一键启动。 - 超管登录和MFA通过。 - 同一任务重复请求不会重复创建。 - 日志可关联用户、请求和任务。 - CI在合并前执行类型和基础测试。 --- ## 7. Sprint 2：扫描、快照与URL注册表（第5–6周） ### 7.1 Sprint目标 建立从旧站发现URL、保存证据、分类和形成基线的完整链路。 ### 7.2 工作任务 #### 扫描引擎 - 实现域名和协议白名单。 - 实现DNS/IP/跳转后的SSRF检查。 - 实现Sitemap和Sitemap Index解析。 - 实现HTTP抓取、HTML解析和链接发现。 - 接入Playwright处理JS页面和截图。 - 支持速率、并发、深度、超时和文件大小限制。 - 实现断点、重试、取消和任务心跳。 #### 快照 - 保存状态码、跳转、响应头、HTML和checksum。 - 保存必要的渲染DOM和截图。 - 建立source_snapshot和source_record。 - 对原始数据写入对象存储。 #### URL注册表 - 建立原始路径和规范化辅助键。 - 处理大小写、尾斜杠、Unicode和查询参数。 - 实现URL来源合并和冲突展示。 - 实现路由种类与验证状态。 #### 后台 - 扫描创建与进度页面。 - URL清单、来源、状态和失败原因页面。 - 页面类型初步分类和手工修正。 ### 7.3 交付物 - 通用网页扫描器。 - URL注册表V1。 - URL来源合并报告。 - 扫描任务后台界面。 - 安全抓取配置和测试夹具。 ### 7.4 验收条件 - 对测试站重复扫描不会产生重复URL。 - 中断后可从检查点继续。 - 内网和非法重定向请求被拒绝。 - 中文、大小写、尾斜杠和查询参数测试通过。 - 至少20个真实页面保存完整快照。 --- ## 8. Sprint 3：WordPress导入与差量同步（第7–8周） ### 8.1 Sprint目标 完成WordPress核心数据导入、标准化和可重复差量同步。 ### 8.2 工作任务 #### WordPress适配器 - REST API探测和导入。 - WXR解析。 - SQL表前缀识别。 - posts、postmeta、terms和relationships导入。 - 页面、文章、公开CPT、分类和标签。 - 菜单、媒体、特色图片和uploads。 - Yoast/Rank Math常用字段。 - Gutenberg基础块。 - ACF未知字段保留。 #### 标准化 - content_entry和content_revision。 - taxonomy和term。 - media_asset和media_usage。 - source_key、checksum和映射状态。 - 源字段、标准字段和人工覆盖规则。 #### 差量同步 - 新增、更新、删除、未变化和冲突检测。 - 使用modified时间和checksum。 - 人工修改字段保护。 - 导入批次报告。 #### 后台 - 导入任务页面。 - 字段映射和未识别字段页面。 - 冲突比较和人工选择。 - 页面、文章、产品的基础查看。 ### 8.3 交付物 - WordPress适配器V1。 - 统一内容模型V1。 - 字段映射工作台基础版。 - 差量同步和冲突报告。 - 首站内容数量对比报告。 ### 8.4 验收门槛 M2 - 同一数据导入两次不产生重复内容。 - 修改源内容后只产生预期更新。 - 人工覆盖字段不会被静默覆盖。 - 产品/文章/页面/分类/媒体数量有来源对照。 - URL和SEO能够关联到标准内容。 --- ## 9. Sprint 4：内容后台、媒体、URL与SEO（第9–10周） ### 9.1 Sprint目标 让超级管理员能够维护核心内容，并形成可用于构建的URL/SEO/媒体快照。 ### 9.2 工作任务 #### 内容后台 - 产品、新闻、普通页面编辑。 - 分类、品牌和菜单管理。 - 草稿、ready_to_publish、published和archived状态。 - 内容修订、差异和恢复。 - ETag/版本号乐观锁。 #### 媒体 - 上传、选择、预览和基础信息编辑。 - SHA-256去重辅助。 - 图片尺寸、MIME和安全验证。 - 旧路径、衍生资源和使用关系。 - PDF、SVG、字体等非图片资源。 #### URL/SEO - route_registry编辑和冲突检查。 - redirect、gone、asset和dynamic规则。 - SEO三套数据对比。 - Title、Description、Canonical、Robots、OG和JSON-LD。 - Sitemap与内部链接基础检查。 #### 内容引用 - content_reference表。 - 板块、媒体、内容和路由引用。 - 删除前影响报告。 - 悬空引用检测。 ### 9.3 交付物 - 内容中心V1。 - 媒体中心V1。 - URL和SEO中心V1。 - 内容引用和删除影响分析。 - 可冻结的内容/路由/SEO快照。 ### 9.4 验收条件 - 管理员能新增一条产品和新闻并保存修订。 - 多标签页冲突不会覆盖新版本。 - 删除已引用内容会被阻止并显示影响页面。 - URL冲突和重定向循环能够被发现。 - SEO差异可以按P0–P3分类。 --- ## 10. Sprint 5：主题、板块和第一套主题（第11–12周） ### 10.1 Sprint目标 建立可复用主题体系，并将首个WordPress站生成完整静态预览。 ### 10.2 工作任务 #### 主题契约 - theme manifest。 - template definition。 - block schema和UI schema。 - slotKey、position、variant和schemaVersion。 - 主题与公共运行时兼容规则。 #### 公共组件包 - content-contracts。 - block-contracts。 - theme-runtime。 - ui-primitives。 - content-resolvers。 - media-components。 - seo-components。 #### 首批板块 - Hero。 - Rich Text。 - Image Text。 - Gallery。 - Feature List。 - Product Grid。 - Article List。 - Specification Table。 - Download List。 - FAQ。 - CTA。 - Statistics。 #### 后台板块编辑 - 根据schema生成表单。 - 新增、复制、排序、隐藏和删除。 - 媒体、产品、文章和路由选择。 - 模板允许范围和数量限制。 - 预览构建入口。 #### 第一套主题 - Base Layout、Header和Footer。 - 首页。 - 产品列表和详情。 - 文章列表和详情。 - 普通页面和404。 - 桌面与移动端。 ### 10.3 交付物 - Theme SDK V1。 - 组件公共包V1。 - 页面板块编辑器V1。 - 第一套试点主题。 - 首站完整静态预览。 ### 10.4 验收门槛 M3 - 首站核心页面从数据库生成静态HTML。 - 核心内容在禁用JavaScript时仍可读取。 - 不支持板块会阻止生产构建。 - 页面URL来自route_registry而非主题slug。 - 主题不直接访问数据库。 - PC/移动端典型页面通过初次视觉验收。 --- ## 11. Sprint 6：可复现构建、路由编译与预览（第13–14周） ### 11.1 Sprint目标 将静态预览升级为可追溯、可隔离和可重复执行的构建系统。 ### 11.2 工作任务 #### 构建快照 - 锁定内容、路由、SEO、媒体和站点配置。 - 记录Git commit、依赖哈希、运行时和镜像digest。 - 固定locale、timezone和构建时间。 #### 构建沙箱 - 只读输入和代码。 - 临时写目录。 - CPU、内存、磁盘和超时限制。 - 网络白名单。 - 不挂载主数据库与控制面密钥。 #### 构建并发 - Job幂等键。 - 站点/环境构建租约。 - 心跳和失联回收。 - 旧构建禁止自动发布。 - 取消安全点。 #### 路由编译 - 统一route-manifest。 - Nginx规则生成。 - 目标部署能力声明。 - `.php`、查询参数、尾斜杠和状态码预检。 #### 预览 - 不可变预览release。 - 访问控制和noindex。 - 真实HTTP路径检查。 ### 11.3 交付物 - builder V1。 - build-input、manifest和checksums。 - 构建隔离环境。 - Nginx路由编译器。 - 预览Release和HTTP测试。 ### 11.4 验收条件 - 相同输入在固定环境中输出一致哈希。 - 构建期间修改内容不影响当前任务。 - 两个并发构建不会互相覆盖。 - 目标服务器真实返回预期状态码和Location。 - 预览站无法被搜索引擎正常索引。 --- ## 12. Sprint 7：自动验收、发布与回滚（第15–16周） ### 12.1 Sprint目标 完成从静态预览到安全生产发布的完整链路。 ### 12.2 工作任务 #### 自动验收 - URL覆盖、状态和跳转。 - SEO差异。 - 内容摘要和核心字段。 - 媒体与内部链接。 - 主题契约和板块schema。 - 桌面/移动截图。 - 性能和可访问性基线。 - 敏感文件和安全头。 #### Release - 不可变release目录。 - 发布状态机。 - active_release_id。 - environment_publish_lock。 - 比较并交换切换。 - 发布前版本过期检查。 #### 部署 - Nginx/SSH部署适配器。 - 如试点需要，实现S3/OSS + CDN适配器。 - 文件数量和哈希校验。 - 临时入口冒烟。 - CDN刷新状态。 #### 回滚 - 静态文件、路由、Header和配置同步回滚。 - 回滚后二次冒烟。 - partially_deployed补偿流程。 ### 12.3 交付物 - 验收引擎和报告。 - Release/Deployment模型。 - 生产发布确认页面。 - 部署适配器。 - 回滚Runbook。 ### 12.4 验收门槛 M4 - P0问题能够阻止发布。 - 较旧构建不能覆盖较新生产版本。 - 发布中断后状态可识别和恢复。 - 在生产等价环境中完成发布和回滚演练。 - 路由规则与静态文件始终属于同一release。 --- ## 13. Sprint 8：第二主题、第二来源和动态能力（第17–18周） ### 13.1 Sprint目标 证明平台不是单站、单主题和WordPress专用工具。 ### 13.2 工作任务 #### 第二来源 - 为第二试点配置通用网页或专属轻量适配器。 - 使用CSS选择器、JSON-LD或API提取结构化数据。 - 建立字段映射和Legacy HTML兜底。 - 输出来源能力与未知范围报告。 #### 第二主题 - 采用不同布局、导航、产品卡片和视觉语言。 - 复用相同数据契约、SEO、媒体和Headless逻辑。 - 只将真正通用的逻辑提取到公共包。 - 建立两个主题的截图回归。 #### 动态能力 - 实现试点需要的Form API。 - 来源校验、验证码、限流和幂等。 - 邮件/CRM转发、重试和死信。 - 隐私同意、脱敏和保留策略。 ### 13.3 交付物 - 第二来源适配方案。 - 第二套独立主题。 - 公共组件复用报告。 - Form API或试点必需动态服务。 - 双站静态预览。 ### 13.4 验收门槛 M5 - 两个站点数据、域名、主题和release互不影响。 - 两套主题视觉明显不同。 - 公共契约升级不会破坏两套主题测试。 - 第二来源未支持内容进入明确异常清单。 - 表单能够处理成功、失败、重试和重复提交。 --- ## 14. Sprint 9：上线准备、切换与稳定期（第19–20周） ### 14.1 Sprint目标 完成首站正式切换，并使第二站达到可交付状态。 ### 14.2 工作任务 #### 运维完善 - 生产监控、关键URL探测和告警。 - 队列、Worker、存储和数据库监控。 - PostgreSQL和对象存储备份。 - 密钥和配置恢复材料。 - 完整恢复演练。 #### 上线彩排 - 模拟内容冻结。 - 最终差量导入。 - URL/SEO最终重扫。 - 构建、验收和发布。 - DNS/CDN切换。 - 回滚演练。 #### 正式上线 - 执行T-7天至T时刻Runbook。 - 超级管理员确认发布。 - 关键URL、SEO、表单和日志检查。 - 保留旧站环境。 - 建立问题响应和回滚窗口。 #### 项目收尾 - 完成操作、开发和运维文档。 - 完成试点迁移报告。 - 整理V1.1待办。 - 复盘估算后续每站成本。 ### 14.3 交付物 - 生产监控和告警。 - 备份恢复报告。 - 上线与回滚Runbook。 - 首站生产发布。 - 第二站可交付release。 - 项目验收报告。 ### 14.4 验收门槛 M6 - 最终差量同步完成，无未解释内容丢失。 - URL和SEO P0为0，P1已处理或记录例外。 - 关键页面、媒体和动态功能通过。 - 首站可安全回滚到上一个release。 - 生产站不依赖SiteForge实时在线。 - 旧站保留期、监测负责人和后续计划明确。 --- ## 15. 第21–24周风险缓冲 缓冲期不是默认增加功能，只处理以下事项： - Elementor/WPBakery复杂页面结构化。 - WooCommerce变体和特殊字段。 - 多语言历史URL。 - 大量异常媒体或编码路径。 - CDN/对象存储路由能力限制。 - 试点业务验收返工。 - 正式上线后的高优先级问题。 缓冲期不得用于临时加入低代码、更多CMS、复杂权限或非试点功能，除非项目范围正式变更。 --- ## 16. Epic与任务分解 | Epic | 名称 | 主要Sprint | 负责人 | 完成定义 | |---|---|---:|---|---| | E01 | 工程与环境 | 1 | BE/QA | 开发、测试、CI可重复启动 | | E02 | 超管认证 | 1 | BE/FE | MFA、恢复、会话、审计通过 | | E03 | 站点与环境 | 1–2 | BE/FE | 两站隔离，环境配置可管理 | | E04 | 任务平台 | 1–9 | BE/QA | 租约、重试、死信、监控完整 | | E05 | 扫描与URL | 2 | DE/BE | 多来源URL与快照可审计 | | E06 | WordPress适配 | 3 | DE | REST/WXR/SQL/uploads闭环 | | E07 | 内容与映射 | 3–4 | BE/FE/DE | 内容修订、映射、冲突可用 | | E08 | 媒体 | 3–4 | BE/FE | 原件、旧路径、引用可管理 | | E09 | URL/SEO | 2–7 | DE/BE | 差异、冲突、门禁完整 | | E10 | 主题与板块 | 5 | FE/UI | 第一主题与板块编辑可用 | | E11 | 公共组件 | 5–8 | FE | 两主题复用并通过回归 | | E12 | 构建 | 6 | BE/FE | 快照、隔离、可复现 | | E13 | 验收 | 6–7 | QA/DE | 报告和P0门禁可用 | | E14 | 发布与回滚 | 7 | BE/QA | 原子切换和回滚演练通过 | | E15 | 第二来源/主题 | 8 | DE/FE/UI | 双站双主题闭环 | | E16 | 动态服务 | 8 | BE/QA | 试点动态功能验收通过 | | E17 | 运维与备份 | 1–9 | QA/BE | 监控、告警、恢复演练通过 | | E18 | 切站与稳定期 | 9 | 全员 | 首站上线和试点验收 | --- ## 17. 关键依赖与关键路径 ### 17.1 关键路径 ```text 试点数据到位 → 数据模型与快照 → WordPress导入 → URL/SEO注册表 → 主题/板块 → 静态构建 → 自动验收 → 发布/回滚 → 最终差量 → 生产切换 ``` 任何关键路径任务延迟会直接影响上线日期。 ### 17.2 可并行任务 - 设计师可在扫描期间完成首站设计系统。 - FE可在后端模型稳定后使用fixture开发页面板块。 - QA可从Sprint 1开始建设测试夹具和CI。 - 第二主题可在首套主题SDK稳定后并行开发。 - 运维可在构建功能开发时并行准备部署环境。 ### 17.3 决策截止时间 | 决策 | 最晚时间 | 未决影响 | |---|---:|---| | 两个试点站 | 第1周 | 无法建立真实模型 | | ORM与对象存储 | 第2周 | 数据层和环境延迟 | | 生产部署目标 | 第2周 | 路由编译和发布延迟 | | 第一主题设计方向 | 第4周 | Sprint 5无法开始 | | 动态功能方案 | 第6周 | Form API范围不确定 | | 第二试点来源 | 第8周 | Sprint 8延迟 | | DNS/CDN切站权限 | 第14周 | 上线彩排无法完成 | --- ## 18. 测试实施计划 ### 18.1 每个Sprint持续执行 - 代码检查和类型检查。 - 单元测试。 - 数据库迁移测试。 - API集成测试。 - 安全静态检查。 ### 18.2 从Sprint 2开始 - URL编码和路径fixture。 - 爬虫限流、断点和SSRF测试。 - 快照和幂等测试。 ### 18.3 从Sprint 3开始 - WordPress适配器契约测试。 - 导入计数、差量和冲突测试。 - SEO字段交叉验证。 ### 18.4 从Sprint 5开始 - 主题manifest和block schema契约测试。 - 页面静态HTML测试。 - 桌面与移动截图。 - 可访问性基础测试。 ### 18.5 从Sprint 6开始 - 构建可复现测试。 - 真实HTTP路由测试。 - 目标部署能力测试。 - 敏感文件和依赖扫描。 ### 18.6 从Sprint 7开始 - 发布并发和失败注入。 - CDN刷新失败。 - Worker失联和任务恢复。 - 部分部署补偿。 - 完整回滚。 --- ## 19. Definition of Ready 任务进入Sprint前必须满足： - 业务目标和范围明确。 - 输入数据或fixture可用。 - API/Schema依赖已确定。 - 验收条件可以测试。 - 不存在未解决的P0设计问题。 - 负责人和评审人明确。 不满足Ready条件的任务不能为了填满Sprint而强行开始。 --- ## 20. Definition of Done 功能完成必须同时满足： - 代码实现完成并通过Review。 - 类型检查、单元和相关集成测试通过。 - 数据库迁移可执行且有回退说明。 - 错误、日志和任务状态可观察。 - 安全和站点隔离检查通过。 - 管理后台包含加载、空、失败和重试状态。 - 用户文档或开发文档已更新。 - 使用真实试点数据演示通过。 - 不产生新的P0/P1未登记问题。 仅完成页面外观或接口代码不算Done。 --- ## 21. 变更控制 ### 21.1 变更分类 - P0：不处理会导致数据丢失、安全风险、无法发布或无法回滚。 - P1：V1承诺范围或试点关键需求。 - P2：可进入V1.1的增强。 - P3：长期优化建议。 ### 21.2 变更规则 Sprint开始后新增需求必须回答： 1. 是否阻塞两个试点闭环。 2. 是否可以进入V1.1。 3. 增加多少开发和测试成本。 4. 替换掉当前Sprint的哪项工作。 5. 是否改变上线日期。 不允许只增加需求而不调整范围或工期。 ### 21.3 明确禁止临时加入 - 通用低代码。 - 复杂多角色权限。 - 第三个CMS深度适配。 - 复杂电商交易。 - Kubernetes和多区域架构。 - 未经试点证明需要的真正增量构建。 --- ## 22. 项目沟通与跟踪 ### 22.1 会议节奏 - 每日：15分钟开发同步。 - 每周：风险、范围和关键数据检查。 - Sprint中期：技术和设计走查。 - Sprint结束：真实环境演示、验收和下Sprint计划。 - 里程碑：Go/No-Go评审。 ### 22.2 每周报告 固定报告： - 本周完成。 - 下周目标。 - 里程碑状态。 - P0/P1问题。 - 外部依赖和待决策。 - 实际投入与计划偏差。 - 试点数据覆盖率。 - 测试和缺陷趋势。 ### 22.3 看板状态 ```text Backlog → Ready → In Progress → Review → QA → Accepted → Released ``` 阻塞任务必须标记阻塞原因、负责人和下一检查时间。 --- ## 23. 风险登记与触发条件 | 风险 | 触发条件 | 责任人 | 处理 | |---|---|---|---| | 试点数据迟到 | 第1周末仍无SQL/WXR | PM | 调整试点或延期M0 | | URL总量异常 | 日志URL显著高于Sitemap | DE | 扩展基线和扫描预算 | | 页面构建器复杂 | 代表页面无法结构化 | FE/DE | Legacy兜底并单独排期 | | 主题设计迟到 | 第4周无核心页面设计 | PM/UI | 使用线框先完成数据闭环 | | 构建性能差 | 全量构建超目标窗口 | BE | 分析瓶颈，暂不直接上复杂增量 | | 部署不兼容 | 关键URL无法由目标平台实现 | BE/QA | Edge规则或更换目标 | | SEO差异过大 | P0/P1持续无法收敛 | DE/PM | 暂停上线并逐类修复 | | 范围膨胀 | 新功能影响关键路径 | PM | 执行变更控制 | | 生产故障 | 关键URL或表单失败 | QA/BE | 按Runbook回滚 | --- ## 24. 质量指标 | 指标 | 目标 | |---|---| | 已确认URL处置率 | 100%或有明确例外 | | SEO P0 | 发布前为0 | | SEO P1 | 发布前修复或有记录例外 | | 核心内部死链 | 0 | | 关键媒体缺失 | 0 | | 生产发布可回滚 | 100% | | 构建版本可追溯 | 100% | | 未知板块静默丢失 | 0 | | 任务副作用重复执行 | 0个已知问题 | | 备份恢复演练 | 上线前通过 | | 关键URL上线冒烟 | 全部通过 | 性能指标不使用所有站点统一分数，由两个试点分别设定基线和目标。 --- ## 25. 上线执行清单 ### T-7天 - 完成一次全流程彩排。 - 验证回滚。 - 冻结非必要平台变更。 - 确认生产凭据和权限。 ### T-3天 - 缩短DNS TTL。 - 完成旧站完整备份。 - 确认最新URL、SEO和动态功能报告。 - 通知内容更新冻结时间。 ### T-1天 - 执行倒数第二次差量同步。 - 修复剩余P0/P1。 - 确认最终release候选。 ### T-2小时 - 冻结旧站写入。 - 执行最终差量同步。 - 重扫URL和SEO。 ### T-90分钟 - 锁定内容、路由、SEO和主题快照。 - 执行最终构建和自动验收。 ### T-30分钟 - 超级管理员确认发布。 - 临时入口执行关键URL和表单冒烟。 - 确认回滚release。 ### T时刻 - 原子切换。 - 刷新必要缓存。 - 验证首页、核心产品、文章、Sitemap、Robots和表单。 ### T+2小时 - 高频监控4xx/5xx、跳转、SEO头和表单。 - 达到回滚条件时立即回滚。 ### T+1至7天 - 监控抓取、索引、自然流量和错误日志。 - 处理非阻塞问题。 - 保留旧站环境。 --- ## 26. 最终项目验收 ### 26.1 平台验收 - 超管安全登录和全部后台功能可用。 - 两站数据和环境隔离。 - 扫描、导入、差量和冲突可执行。 - 内容、媒体、URL、SEO和板块可维护。 - 构建可追溯、可隔离、可重复。 - 发布有锁、有门禁、有回滚。 - 监控、告警、备份和恢复通过。 ### 26.2 试点验收 - 一个WordPress站完整迁移并上线。 - 第二来源完成可交付静态release。 - 两套主题视觉明显不同。 - 相同公共组件和数据契约得到复用。 - 所有未支持内容有明确异常记录。 - 切站和回滚Runbook经过实际验证。 ### 26.3 文档验收 - 架构和ADR。 - 数据库与API。 - 适配器SDK。 - 主题/板块/组件规范。 - URL/SEO验收规范。 - 部署、监控、备份和恢复手册。 - 上线和回滚Runbook。 - 两站迁移报告。 --- ## 27. 立即开始的第一周任务 ### PM - 确定两个试点。 - 发出资料收集清单。 - 建立范围、风险和决策台账。 - 确定每个试点的业务确认人。 ### BE - 评估当前基础设施和部署目标。 - 创建Monorepo技术PoC。 - 验证PostgreSQL、Redis、对象存储和构建容器。 ### FE - 验证Art Design Pro版本和工程结构。 - 清点需要保留与删除的底座功能。 - 建立管理后台页面地图。 ### DE - 获取WordPress样本。 - 导出数据库内容数量和URL样本。 - 合并Sitemap、数据库和日志URL。 - 识别SEO插件与页面构建器。 ### QA - 建立测试环境清单。 - 建立URL、SEO和WordPress fixture计划。 - 定义缺陷等级和验收报告格式。 ### UI - 收集两个站点品牌资料。 - 输出第一版页面类型和组件清单。 第一周结束时必须能够回答：两个站点是什么、数据能否取得、URL有多复杂、动态功能有哪些、部署到哪里、首版明确不做什么。 --- ## 28. 结论 本实施计划把V3架构方案拆成10个双周Sprint。真正的关键路径不是后台页面数量，而是： ```text 真实数据 → 可重复导入 → URL/SEO可信基线 → 独立主题静态生成 → 目标环境真实验收 → 最终差量同步 → 安全发布与回滚 ``` 按此顺序推进，可以在第12周形成首站完整静态预览，在第16周完成发布闭环，在第18周完成双站验证，并以第20周作为首站上线目标。第21–24周只作为复杂旧站数据和上线问题的风险缓冲，不作为扩展功能窗口。