tangweijie/fujian_water_biz_doc
1
0
Fork 0
Code Issues Pull Requests 12 Actions Packages Projects Releases 1 Wiki Activity
fujian_water_biz_doc/specs/003-rev006-reminder-event-design/plan.md

6.6 KiB
Raw Blame History

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

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.

  • 主文档归属已确认：改动落点限定为 12_REV_Detailed.md、03_Interface_Design.md、01_Database_Design.md 与治理台账，不新增平行正式稿。
  • 范围基线已确认：REV-006 已存在于 03_Summary_Design.md、12_REV_Detailed.md 和 15_SYS002_Requirement_Breakdown.md，本轮仅补齐既有范围内的设计与接口口径，不引入超范围新模块。
  • Archive 使用方式合规：Archive 仅用于核对旧“催缴记录/停水记录/预存短信”来源与历史只读口径，不直接作为正式结论输出。
  • 一致性影响已列出：受影响项包括 REV-006 接口编号、结果状态术语、催缴/停复水边界、历史只读查询口径、时序图与映射表。
  • 校验与台账动作已规划：已规划单文件校验、链接校验，并要求同步更新 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:

  • 更新 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
无 - -