Execution Plan: feat-12-user-billing-reconciliation

本文档是该 feature 的实施真源，需求边界以同目录 PRD.md 为准。

状态区

• 文档状态：Implemented
• 优先级：P1
• 建议目录：planning/backlog/active/feat-12-user-billing-reconciliation/execution-plan.md
• 当前阶段：main implementation landed; migration notes and acceptance closure remain
• 最后更新日期：2026-04-13

实施摘要

本条 feature 的主要运行路径已经进入主线，本轮实施重点不再是补建核心功能，而是把结构化结果、后台摘要、迁移说明和 backlog 文档收口到统一口径。

当前基线

• 对账结果主表和摘要读取路径已经进入正式主线
• 后台摘要页已基于当前结构展示最近一次结果
• 差异类型字段和结果写入逻辑已具备稳定主路径
• 当前仍缺少一轮迁移说明、索引与验收文案的最终追平

实施范围

• 复核对账结果相关术语与迁移说明
• 追平后台摘要展示口径与正式文档
• 回填验收清单与 backlog 索引

不在本轮范围内：

• 新增账单来源
• 自动修复差异
• 大规模重构摘要页

分阶段推进

阶段 1

• 复核迁移说明、字段注释与后台文案是否使用统一命名
• 完成标志是局部命名歧义已被收口
• 主要风险是历史 patch 仍残留旧术语

阶段 2

• 回填验收清单和 backlog 索引
• 完成标志是条目可以明确判断是否进入 Accepted
• 主要风险是实现现实与文档假设仍有偏差

依赖与风险

• 依赖既有摘要查询路径与对账结果表结构稳定
• 风险是历史迁移说明未完全反映当前字段命名
• 若发现摘要展示语义与主表字段不一致，应优先修正文档口径并复核是否需要补充决策记录

回退或降级策略

• 若本轮未能完成全部文档追平，feature 继续保留在 Implemented
• 不提前迁入 accepted/，避免形成“目录已完成、口径未完成”的假象

同步要求

• 更新 acceptance-checklist.md
• 在 backlog 根索引和 active/README.md 中补充当前口径
• 完成术语复核后，再决定是否进入 Accepted