# 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:建议校验命令 ```bash 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` 的请求输出和异常语义已明确 - 数据库主文档未把特殊开账误写为平行在线主表 - 治理台账明确保持“部分实现,账单生成闭环仍需继续校核”的真实结论 - 正式文档与台账同步更新