# 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`。