Project Management Docs main jqkai/samples/feat-12-user-billing-reconciliation/rename-guardrail-PRD.md

Billing Result Naming Guardrail PRD

状态(2026-04-13)

  • 状态:Superseded
  • 建议目录:planning/backlog/active/feat-12-user-billing-reconciliation/rename-guardrail-PRD.md
  • 与主 PRD 的关系:本文件是同目录主 PRD.md 的补充术语提案,不是新的 backlog feature。
  • 不新开 backlog 编号的原因:
    • 它只处理原 feature 的局部命名边界
    • 它不会独立拥有新的生命周期
    • 它不改变主 feature 的产品范围
  • 处理结论:本文档保留为被否决提案记录,不作为实现真源。

背景

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

后续复核发现:

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

因此需要把这次命名判断作为补充 PRD 保留,而不是直接抹掉讨论过程。

问题定义

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

处理结论

  • 继续保留 billing_reconciliation_result 作为正式命名
  • billing result 只允许作为口语化描述,不作为结构化真源命名
  • 本提案状态标记为 Superseded

影响范围

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

验证与回归要求

  • 主 PRD 顶部应显式链接本补充 PRD
  • 文档中应明确写出本提案“不作为实现真源”
  • 后续若有人再次提出同类 rename,应先复核本记录