99 lines
5.7 KiB
Markdown
99 lines
5.7 KiB
Markdown
# 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 |
|
||
|-----------|------------|-------------------------------------|
|
||
| 无 | - | - |
|