fujian_water_biz_doc/specs/004-rev007-revenue-statistics-design/quickstart.md

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：建议校验命令

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。