Handoff: db-patch-hardening
本文档用于承接 feat-12-user-billing-reconciliation 的数据库迁移收尾工作。它不是新的需求文档,需求边界仍以同目录主 PRD.md 为准,实施安排仍以同目录 execution-plan.md 为准。
状态区
- 文档状态:
Active - 优先级:
P2 - 建议目录:
planning/backlog/active/feat-12-user-billing-reconciliation/handoff-db-patch-hardening.md - 当前阶段:
follow-up for migration-note closure - 最后更新日期:
2026-04-13
当前基线
- 对账结果主表和摘要读取路径已经进入正式主线
- 后台摘要页已基于当前结构展示最近一次结果
- backlog 主 PRD 已把本 feature 标记为
Implemented - 当前仍缺一轮针对迁移说明和字段注释的收尾校准
本轮要处理的范围
- 复核历史 patch 中的对账结果字段注释
- 确认迁移说明与当前结构化字段命名一致
- 明确哪些历史兼容说明仍需保留
明确不做
- 不改写主 PRD 边界
- 不扩展新的账单来源
- 不顺带重构后台摘要页
交付结果
- 迁移说明与现行字段命名口径一致
- 验收清单中与迁移相关的结果项可以回填
- 后续维护者能从文档判断哪些兼容说明仍然有效
验证建议
- 手工核对历史 patch 与当前字段名是否一致
- 核对迁移说明是否仍使用被否决的旧术语
- 回填验收清单后,再决定是否可以迁入
accepted/