# 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](/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](/Volumes/Dpan/github/fujian_water_biz_doc/docs/design/02_Detailed_Design/12_REV_Detailed.md) 中明确统计主题、查询维度、核心指标与排除项；2）在 [03_Interface_Design.md](/Volumes/Dpan/github/fujian_water_biz_doc/docs/design/03_Technical_Design/03_Interface_Design.md) 中补齐 `IF-REV-010` 的查询边界、输入输出与权限导出约束；3）在 [01_Database_Design.md](/Volumes/Dpan/github/fujian_water_biz_doc/docs/design/03_Technical_Design/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.*

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

## Project Structure

### Documentation (this feature)

```text
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

```text
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 |
|-----------|------------|-------------------------------------|
| 无 | - | - |