fujian_water_biz_doc/specs/005-rev002-billing-generation-gap/quickstart.md

Quickstart: REV-002 开账计费与账单生成缺口补齐

目标

本 quickstart 用于指导评审者和文档维护者快速完成 REV-002 开账计费与账单生成缺口补齐的检查，不涉及 backend 实施。

步骤 1：阅读规格与计划结论

1. 阅读 spec.md，确认本轮范围只覆盖 IF-REV-005、开账规则、结果表达、数据库承接口径与治理同步。
2. 阅读 research.md，确认以下决策已固定：
   • IF-REV-005 保持为正式账单生成接口
   • 开账生成闭环只覆盖“抄表校验后到账单生成”
   • 账单结果统一由 biz_charge + biz_charge_detail 承接
   • 异常采用“阻断生成 + 返回失败原因”的口径

步骤 2：执行文档改动时的目标落点

1. 在 docs/design/02_Detailed_Design/12_REV_Detailed.md 补齐：
   • 开账计费规则来源
   • 账单生成结果表达
   • 特殊开账与异常边界
   • 排除项与文档先行边界
2. 在 docs/design/03_Technical_Design/03_Interface_Design.md：
   • 补齐 IF-REV-005 的正式接口定义
   • 明确请求条件、输出结果和异常语义
3. 在 docs/design/03_Technical_Design/01_Database_Design.md：
   • 明确 biz_charge、biz_charge_detail 与价格规则对象的承接口径
4. 在治理台账中回写：
   • 15_SYS002_Requirement_Breakdown.md
   • 01_Project_Progress.md
   • 03_Task_Checklist.md

步骤 3：建议校验命令

make validate-file FILE=docs/design/02_Detailed_Design/12_REV_Detailed.md
make validate-file FILE=docs/design/03_Technical_Design/03_Interface_Design.md
make validate-file FILE=docs/design/03_Technical_Design/01_Database_Design.md
make validate-file FILE=docs/design/00_Management/15_SYS002_Requirement_Breakdown.md
make validate-file FILE=docs/design/00_Management/01_Project_Progress.md
make validate-file FILE=docs/design/00_Management/03_Task_Checklist.md
make check-links

步骤 4：验收检查点

• REV-002 的开账规则和结果表达不再停留在摘要级表述
• IF-REV-005 的请求输出和异常语义已明确
• 数据库主文档未把特殊开账误写为平行在线主表
• 治理台账明确保持“部分实现，账单生成闭环仍需继续校核”的真实结论
• 正式文档与台账同步更新