110 lines
6.6 KiB
Markdown
110 lines
6.6 KiB
Markdown
# Implementation Plan: REV-006 催缴事件与通知协同设计
|
||
|
||
**Branch**: `003-rev006-reminder-event-design` | **Date**: 2026-03-18 | **Spec**: [/Volumes/Dpan/github/fujian_water_biz_doc/specs/003-rev006-reminder-event-design/spec.md](/Volumes/Dpan/github/fujian_water_biz_doc/specs/003-rev006-reminder-event-design/spec.md)
|
||
**Input**: Feature specification from `/specs/003-rev006-reminder-event-design/spec.md`
|
||
|
||
**Note**: This template is filled in by the `/speckit.plan` command. See `.specify/templates/plan-template.md` for the execution workflow.
|
||
|
||
## Summary
|
||
|
||
本 feature 用于补齐 `REV-006` 在正式文档体系中的设计闭环，重点收口催缴对象生成、催缴任务触发、`SYS-010` 消息协同结果回写、停复水联动边界以及历史查询最小保留集。实施方式以修订既有主文档和治理台账为主，不进入 backend 代码实现；同时将现有接口冲突纠正为 `REV-006` 使用新的独立正式接口编号，发票查询继续保留 `IF-REV-009`。
|
||
|
||
## Technical Context
|
||
|
||
<!--
|
||
ACTION REQUIRED: Replace this section with the real project context.
|
||
For this repository, prefer documenting document-system context rather than
|
||
inventing software implementation context.
|
||
-->
|
||
|
||
**Primary Work Product**: Markdown 设计文档、接口/数据库专题文档、管理台账文档
|
||
**Source of Truth Documents**:
|
||
- `/Volumes/Dpan/github/fujian_water_biz_doc/docs/design/02_Detailed_Design/12_REV_Detailed.md`
|
||
- `/Volumes/Dpan/github/fujian_water_biz_doc/docs/design/03_Technical_Design/03_Interface_Design.md`
|
||
- `/Volumes/Dpan/github/fujian_water_biz_doc/docs/design/03_Technical_Design/01_Database_Design.md`
|
||
- `/Volumes/Dpan/github/fujian_water_biz_doc/docs/design/00_Management/04_Writing_Guide.md`
|
||
- `/Volumes/Dpan/github/fujian_water_biz_doc/AGENTS.md`
|
||
**Reference Sources**:
|
||
- `/Volumes/Dpan/github/fujian_water_biz_doc/docs/design/00_Management/15_SYS002_Requirement_Breakdown.md`
|
||
- `/Volumes/Dpan/github/fujian_water_biz_doc/docs/guides/BACKEND_CURRENT_STATUS.md`
|
||
- `/Volumes/Dpan/github/fujian_water_biz_doc/docs/guides/BACKEND_TABLE_MAPPING.md`
|
||
- `/Volumes/Dpan/github/fujian_water_biz_doc/docs/design/04_Appendix/Archive/05_Data_Dictionary/营收数据字典.md`
|
||
- `/Volumes/Dpan/github/fujian_water_biz_doc/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**:
|
||
- `12_REV_Detailed.md` 中 `REV-006` 正文、流程、规则、落地边界
|
||
- `03_Interface_Design.md` 中 `REV-006` 与 `SYS-010` 的接口编号、接口定义、时序、映射表、异常码、幂等策略
|
||
- `01_Database_Design.md` 中催缴/停复水/预存短信历史只读口径与在线主模型承接边界
|
||
- `15_SYS002_Requirement_Breakdown.md` 中实现评估和 Story/Task 建议
|
||
- `01_Project_Progress.md`、`03_Task_Checklist.md` 的治理回写
|
||
**Project Type**: 文档治理仓库
|
||
**Constraints**:
|
||
- 不新增平行正式主稿，所有正式内容回写既有主文档
|
||
- 不臆造 backend 已实现事实，只能写“已实现 / 部分实现 / 文档先行 / 历史只读”
|
||
- 仓库内引用保持相对路径
|
||
- 停复水只定义联动边界，不展开内部处置流程
|
||
- `REV-006` 必须使用独立正式接口编号，不再复用 `IF-REV-009`
|
||
- 催缴结果状态固定为 `PENDING`、`SUCCESS`、`FAIL`、`MANUAL_VERIFIED`
|
||
**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-006` 已存在于 `03_Summary_Design.md`、`12_REV_Detailed.md` 和 `15_SYS002_Requirement_Breakdown.md`，本轮仅补齐既有范围内的设计与接口口径，不引入超范围新模块。
|
||
- [x] **Archive 使用方式合规**：Archive 仅用于核对旧“催缴记录/停水记录/预存短信”来源与历史只读口径，不直接作为正式结论输出。
|
||
- [x] **一致性影响已列出**：受影响项包括 `REV-006` 接口编号、结果状态术语、催缴/停复水边界、历史只读查询口径、时序图与映射表。
|
||
- [x] **校验与台账动作已规划**：已规划单文件校验、链接校验，并要求同步更新 `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**:
|
||
- 更新 `docs/design/02_Detailed_Design/12_REV_Detailed.md`：补齐 `REV-006` 详细设计正文与落地边界。
|
||
- 更新 `docs/design/03_Technical_Design/03_Interface_Design.md`：修正接口编号冲突，补齐 `REV-006` 正式接口、协同时序、异常码和幂等策略。
|
||
- 更新 `docs/design/03_Technical_Design/01_Database_Design.md`：明确在线承接与历史只读查询口径，不把旧菜单机械映射为新表。
|
||
- 更新 `docs/design/00_Management/15_SYS002_Requirement_Breakdown.md`：同步实现评估、TAPD/Speckit 建议和后续任务入口。
|
||
- 更新 `docs/design/00_Management/01_Project_Progress.md` 与 `docs/design/00_Management/03_Task_Checklist.md`：完成治理闭环。
|
||
|
||
## Complexity Tracking
|
||
|
||
> **Fill ONLY if Constitution Check has violations that must be justified**
|
||
|
||
| Violation | Why Needed | Simpler Alternative Rejected Because |
|
||
|-----------|------------|-------------------------------------|
|
||
| 无 | - | - |
|