Implementation Plan: REV-007 营收统计查询设计

Branch: 004-rev007-revenue-statistics-design | Date: 2026-03-18 | Spec: /Volumes/Dpan/github/fujian_water_biz_doc/specs/004-rev007-revenue-statistics-design/spec.md Input: Feature specification from /specs/004-rev007-revenue-statistics-design/spec.md

Summary

本 feature 面向 REV-007 统计分析模块的正式文档补齐，重点收口三类内容：1）在 12_REV_Detailed.md 中明确统计主题、查询维度、核心指标与排除项；2）在 03_Interface_Design.md 中补齐 IF-REV-010 的查询边界、输入输出与权限导出约束；3）在 01_Database_Design.md 中明确统计数据承接口径、视图/汇总边界与“未见实现”的保守表述，并同步治理台账。

Technical Context

Primary Work Product: Markdown 正式设计文档、管理台账、Speckit 规格/计划工件 Source of Truth Documents:

docs/design/02_Detailed_Design/12_REV_Detailed.md
docs/design/03_Technical_Design/03_Interface_Design.md
docs/design/03_Technical_Design/01_Database_Design.md
docs/design/01_Overview/03_Summary_Design.md
docs/design/00_Management/04_Writing_Guide.md
AGENTS.md Reference Sources:
docs/design/00_Management/15_SYS002_Requirement_Breakdown.md
docs/guides/BACKEND_CURRENT_STATUS.md
docs/guides/BACKEND_TABLE_MAPPING.md
docs/design/04_Appendix/Archive/05_Data_Dictionary/营收数据字典.md
docs/design/04_Appendix/Archive/01_Requirements/ Validation Commands:
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 Target Scope: REV-007 统计分析相关章节、IF-REV-010 相关接口章节、数据库统计承接口径章节与治理台账 Project Type: 文档治理仓库 Constraints:
不新增平行正式稿
不臆造 backend 已实现的统计入口
Archive 仅作来源核对
使用相对路径与现有正式编号体系
不把预测分析、BI 专题或独立数仓实现写成本轮既成事实 Scale/Scope: 跨详细设计、接口设计、数据库设计与治理台账的中等规模文档收口

Constitution Check

GATE: Must pass before Phase 0 research. Re-check after Phase 1 design.

主文档归属已确认：本次改动将优先落在 12_REV_Detailed.md、03_Interface_Design.md、01_Database_Design.md 及治理台账，而不是新增平行正式稿。
范围基线已确认：REV-007 已存在于 SYS-002 营收业务模块中，当前仅补齐统计查询正式口径，不扩展到独立 BI/预测分析范围。
Archive 使用方式合规：Archive 仅作为统计主题和历史口径的参考来源，不直接替代主文档结论。
一致性影响已列出：受影响项包括统计主题名称、指标口径、IF-REV-010 边界、数据库统计承接口径、实现状态表述与治理台账。
校验与台账动作已规划：已明确单文件校验与 make check-links，并计划同步更新 01_Project_Progress.md 与 03_Task_Checklist.md。

Project Structure

Documentation (this feature)

specs/[###-feature]/
├── plan.md              # This file (/speckit.plan command output)
├── research.md          # Phase 0 output (/speckit.plan command)
├── data-model.md        # Optional: document entities/traceability objects
├── quickstart.md        # Optional: validation or review quickstart
├── contracts/           # Optional: interface or section-level artifacts
└── tasks.md             # Phase 2 output (/speckit.tasks command)

Repository Touchpoints

docs/design/
├── 00_Management/
├── 01_Overview/
├── 02_Detailed_Design/
├── 03_Technical_Design/
└── 04_Appendix/Archive/

README.md
AGENTS.md
.specify/templates/

Structure Decision: [Document the exact files to be updated and the reason each file is in scope] Structure Decision:

docs/design/02_Detailed_Design/12_REV_Detailed.md：补齐 REV-007 的业务范围、统计主题、维度、指标和排除项。
docs/design/03_Technical_Design/03_Interface_Design.md：补齐 IF-REV-010 的正式接口定义、查询主题、输入输出与权限导出边界。
docs/design/03_Technical_Design/01_Database_Design.md：补齐统计承接口径、视图/汇总边界、历史与现状保守口径。
docs/design/00_Management/15_SYS002_Requirement_Breakdown.md：同步 SYS002-REQ-012 的实现评估和后续建议。
docs/design/00_Management/01_Project_Progress.md：记录本轮 REV-007 设计收口进展。
docs/design/00_Management/03_Task_Checklist.md：同步 tracked-task 闭环记录。

Complexity Tracking

Fill ONLY if Constitution Check has violations that must be justified

Violation	Why Needed	Simpler Alternative Rejected Because
无	-	-

5.7 KiB Raw Blame History Unescape Escape