Decision Record: Billing Result Naming Guardrail

本文档用于记录该 feature 内的局部命名决策。它不是新的 backlog feature，需求边界仍以同目录主 PRD.md 为准。

状态区

• 文档状态：Superseded
• 优先级：P2
• 建议目录：planning/backlog/active/feat-12-user-billing-reconciliation/decision-naming-guardrail.md
• 当前阶段：rejected naming proposal retained for history
• 最后更新日期：2026-04-13
• 与主 PRD 的关系：术语边界补充
• 是否仍作为有效决策真源：no

背景

在 feature 推进过程中，团队曾考虑把 billing_reconciliation_result 简化重命名为 billing_result，以缩短文档和页面文案。

后续复核发现：

• billing_result 语义过宽
• 容易与账单计算结果、结算结果混淆
• 现有迁移与摘要页已经围绕 reconciliation 术语建立稳定上下文

因此需要把这次命名判断作为决策记录保留，而不是直接抹掉讨论过程。

问题定义

• 需要记录为什么这次 rename 没有成立
• 需要让后续维护者知道不应再把这个局部议题拆成新的 backlog feature

处理结论

• 继续保留 billing_reconciliation_result 作为正式命名
• billing result 只允许作为口语化描述，不作为结构化真源命名
• 本文档状态标记为 Superseded，不再作为有效决策真源

影响范围

• 会影响术语说明、迁移注释和后台字段解释
• 不影响主 feature 的总体边界
• 不新增新编号，不新增新目录

验证与回归要求

• 主 PRD 应显式链接本决策记录
• 文档中应明确写出本提案“不作为有效决策真源”
• 后续若有人再次提出同类 rename，应先复核本记录