59 lines
2.8 KiB
Markdown
59 lines
2.8 KiB
Markdown
# Quickstart: REV-007 营收统计查询设计
|
||
|
||
## 目标
|
||
|
||
本 quickstart 用于指导评审者和文档维护者快速完成 `REV-007` 统计查询设计补齐的检查，不涉及 backend 实施。
|
||
|
||
## 步骤 1：阅读规格与计划结论
|
||
|
||
1. 阅读 `spec.md`，确认本轮范围只覆盖 `REV-007` 的正式设计收口，不扩展到预测分析或独立 BI 专题。
|
||
2. 阅读 `research.md`，确认以下决策已固定：
|
||
- `REV-007` 保持使用 `IF-REV-010`
|
||
- 统计范围收敛为经营查询
|
||
- 统计口径按“主题 + 维度 + 指标”组织
|
||
- 数据承接口径以在线主数据聚合和视图/汇总口径为主
|
||
|
||
## 步骤 2：执行文档改动时的目标落点
|
||
|
||
1. 在 `docs/design/02_Detailed_Design/12_REV_Detailed.md` 补齐：
|
||
- 统计主题清单
|
||
- 维度与指标口径
|
||
- 导出与权限边界
|
||
- 排除项与文档先行边界
|
||
2. 在 `docs/design/03_Technical_Design/03_Interface_Design.md`：
|
||
- 补齐 `IF-REV-010` 的正式接口定义
|
||
- 明确查询条件、输出主题、权限和导出边界
|
||
3. 在 `docs/design/03_Technical_Design/01_Database_Design.md`：
|
||
- 明确统计数据来源、视图/汇总口径和保守承接口径
|
||
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-007` 的统计主题、维度和指标口径不再停留在摘要级表述
|
||
- `IF-REV-010` 的输入输出、权限与导出边界已明确
|
||
- 数据库主文档未把统计承接口径误写为已存在独立统计表族
|
||
- 治理台账明确保持“设计收口推进中，代码入口未见明确实现”的真实结论
|
||
- 正式文档与台账同步更新
|
||
|
||
## 步骤 5：本轮实现摘要
|
||
|
||
- 已完成 `12_REV_Detailed.md`、`03_Interface_Design.md`、`01_Database_Design.md`、`15_SYS002_Requirement_Breakdown.md`、`01_Project_Progress.md`、`03_Task_Checklist.md` 的正式文档回写。
|
||
- `REV-007` 已在正式文档中明确按“主题 + 维度 + 指标”组织统计查询，`IF-REV-010` 的输入输出、权限和导出边界已补齐。
|
||
- 数据库主文档已明确统计承接口径以在线主数据聚合、视图或汇总口径为主，不臆造独立统计表或离线数仓能力。
|
||
- 已执行并通过全部单文件校验与 `make check-links`。
|