tangweijie
20afae2255
Document the existing REV-002 backend billing-generation path and preserve a conservative partial-implementation judgment so the design stays aligned with current code evidence. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
52 lines
2.3 KiB
Markdown
52 lines
2.3 KiB
Markdown
# 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` 的请求输出和异常语义已明确
|
||
- 数据库主文档未把特殊开账误写为平行在线主表
|
||
- 治理台账明确保持“部分实现，账单生成闭环仍需继续校核”的真实结论
|
||
- 正式文档与台账同步更新
|