90 lines
6.0 KiB
Markdown
90 lines
6.0 KiB
Markdown
|
# 规划设计 v4.1 基线收敛清单（执行版）
|
|||
|
|
|
|||
|
|
- 版本：v4.1-checklist
|
|||
|
|
- 日期：2026-03-18
|
|||
|
|
- 目的：在实施前消除口径冲突、依赖倒挂、技术栈错位与验收歧义，形成单一可执行基线（SSOT）。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1. 收敛原则（必须满足）
|
|||
|
|
|
|||
|
|
1. 单一事实源：阶段日期、目标值、验收口径只能在一份主基线文档定义，其他文档只引用。
|
|||
|
|
2. 先定义再执行：任何 Go/No-Go 指标必须先统一 SQL 口径、端点集合与平台分类来源。
|
|||
|
|
3. 依赖可执行：任务依赖必须满足“前置任务截止 <= 后置任务截止”。
|
|||
|
|
4. 栈一致性：架构、测试、SQL 示例与主技术栈（Go + PostgreSQL）一致。
|
|||
|
|
5. 验收可追溯：每个里程碑都有证据产物路径、责任人、阻断规则。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 2. P0 收敛项（必须在开工前完成）
|
|||
|
|
|
|||
|
|
| ID | 收敛项 | 当前问题 | 目标状态（v4.1） | 责任角色 | 完成定义 |
|
|||
|
|
|---|---|---|---|---|---|
|
|||
|
|
| BL-001 | 版本与命名统一 | 文件名 v3，正文出现 v4.0/v3.0 混用 | 主文档命名、头部版本、尾部版本一致（统一 v4.1） | PMO + ARCH | 任意文档内仅出现一个有效版本号 |
|
|||
|
|
| BL-002 | 阶段时间线统一 | S0 在不同文档出现 4周/12周/15周；S1/S2相互重叠 | 发布“阶段时间线裁决表”，所有文档仅引用该表 | PMO | 阶段开始/结束日期在所有文档一致 |
|
|||
|
|
| BL-003 | S2 目标值统一 | 同时存在 60%、50-60%、30-40%、40%终态 | 锁定 S2 验收目标：全供应商 >=60%，国内=100%（弹性仅做过程预警，不进入最终验收） | ARCH + 产品 | 所有验收章节口径一致 |
|
|||
|
|
| BL-004 | 主路径端点集合统一 | `/responses` 与 `/v1/responses` 表述混用 | 固化 canonical 主路径端点集合并在 SQL/看板/执行文档复用 | ARCH + FIN | `main_path_endpoint_set` 在相关文档一致 |
|
|||
|
|
| BL-005 | 国内平台分类来源统一 | `cn_platforms` 示例硬编码风险 | 改为配置表/配置中心注入，SQL 不再硬编码示例值 | PLAT + FIN | 验收 SQL 无固定数组常量 |
|
|||
|
|
| BL-006 | WBS 阶段边界修正 | S0 文档中包含 S1 验收；任务重复（A0.2 与 C0.1） | 任务按阶段归属，重复任务合并，里程碑不跨阶段串名 | PMO + QA | WBS 中无重复任务、阶段名与验收名一致 |
|
|||
|
|
| BL-007 | 依赖拓扑重排 | 多个任务截止日早于其依赖项 | 发布“依赖重排版任务表”，所有依赖满足时间顺序 | PMO | 依赖零倒挂 |
|
|||
|
|
| BL-008 | 安全 SQL 方言统一 | PostgreSQL 架构中出现 MySQL 方言样例 | 安全文档 SQL/触发器改为 PostgreSQL 可执行语法 | SEC + DBA | SQL 可在 PostgreSQL 演练通过 |
|
|||
|
|
| BL-009 | 责任人实名化 | 关键任务仍为角色占位 | 所有 P0/P1 任务实名 owner+backup+on-call | PMO | 无占位符角色 |
|
|||
|
|
| BL-010 | 验收门禁唯一化 | 同一指标出现多阈值版本 | 建立“唯一验收门禁表”，其余文档只引用 ID | ARCH + QA | 验收阈值单一来源 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 3. P1 收敛项（建议在两周内完成）
|
|||
|
|
|
|||
|
|
| ID | 收敛项 | 当前问题 | 目标状态（v4.1） | 责任角色 |
|
|||
|
|
|---|---|---|---|---|
|
|||
|
|
| BL-011 | 测试栈与实现栈对齐 | Go 主线，测试方案以 Python 工程骨架为主 | 单测/集成/契约主路径以 Go 工具链为主，Python 仅保留工具脚本 | QA + 后端 |
|
|||
|
|
| BL-012 | 运维复杂度分层 | S0/S1 引入过多基础设施组件 | 定义“最小可运营栈”与“触发式扩容栈”分界 | ARCH + SRE |
|
|||
|
|
| BL-013 | 文档引用规范 | 部分文档引用旧版本基线 | 全部引用最新主基线文档与唯一验收表 | PMO |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 4. 文件级修订清单（按优先级）
|
|||
|
|
|
|||
|
|
| 优先级 | 文件 | 必改项 |
|
|||
|
|
|---|---|---|
|
|||
|
|
| P0 | `llm_gateway_subapi_evolution_plan_v4_1_2026-03-18.md` | 统一版本号；统一阶段日期；统一 S2 验收目标；清理弹性目标与最终目标冲突 |
|
|||
|
|
| P0 | `s0_wbs_detailed_v1_2026-03-18.md` | 校正 S0 边界；移除或重命名 S1 验收项；合并重复任务；修复里程碑命名 |
|
|||
|
|
| P0 | `subapi_integration_risk_controls_execution_tasks_v1_2026-03-17.md` | 修复所有依赖倒挂；P0/P1 任务实名化 |
|
|||
|
|
| P0 | `router_core_takeover_execution_plan_v3_2026-03-17.md` | 与指标 SQL 的主路径端点定义逐字一致 |
|
|||
|
|
| P0 | `router_core_takeover_metrics_sql_dashboard_v1_2026-03-17.md` | `cn_platforms` 改配置源；主路径集合与执行文档一致 |
|
|||
|
|
| P0 | `security_solution_v1_2026-03-18.md` | SQL 方言改为 PostgreSQL；触发器/审计示例可执行化 |
|
|||
|
|
| P1 | `technical_architecture_design_v1_2026-03-18.md` | 定义 S0/S1 最小栈，组件引入条件化 |
|
|||
|
|
| P1 | `test_plan_design_v1_2026-03-18.md` | Go 主测试链路替换 Python 工程骨架示例 |
|
|||
|
|
| P1 | `architecture_solution_v1_2026-03-18.md` | 将“30-40%终态”改为“过程缓冲，不改变最终验收目标” |
|
|||
|
|
| P1 | `s2_takeover_buffer_strategy_v1_2026-03-18.md` | 保留预警与止损，不覆盖 S2 最终验收口径 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 5. 裁决项（需要一次会议拍板）
|
|||
|
|
|
|||
|
|
1. S0 周期最终裁决：4周 / 12周 / 15周（三选一）。
|
|||
|
|
2. S1 与 S0 是否并行：并行 / 串行（二选一）。
|
|||
|
|
3. S2 目标是否允许“验收降档”：不允许（推荐）/ 允许一次。
|
|||
|
|
4. 主技术栈是否冻结为 Go + PostgreSQL：是（推荐）/ 否。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 6. 验收清单（v4.1 收敛完成判据）
|
|||
|
|
|
|||
|
|
1. 文档一致性检查通过：版本、日期、阶段、目标值零冲突。
|
|||
|
|
2. 依赖拓扑检查通过：关键任务零倒挂。
|
|||
|
|
3. 指标口径检查通过：主路径端点、国内平台分类来源、SQL 公式一致。
|
|||
|
|
4. 栈一致性检查通过：架构、测试、SQL 示例与主栈一致。
|
|||
|
|
5. 责任闭环检查通过：P0/P1 任务均有 owner+backup+on-call。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 7. 建议执行顺序（48小时）
|
|||
|
|
|
|||
|
|
1. 0-4小时：完成裁决项并冻结 SSOT。
|
|||
|
|
2. 4-12小时：修订主基线 + WBS + 任务单 + 指标口径。
|
|||
|
|
3. 12-24小时：修订安全 SQL、测试栈、架构最小栈。
|
|||
|
|
4. 24-36小时：进行一次全量交叉核对（口径/依赖/验收）。
|
|||
|
|
5. 36-48小时：输出 `v4.1` 最终发布版并锁定变更窗口。
|
|||
|
|
|