lijiaoqiao/docs/v4_1_baseline_convergence_checklist_2026-03-18.md

规划设计 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 最终发布版并锁定变更窗口。