fujian_water_biz_doc/specs/003-rev006-reminder-event-design/quickstart.md

Quickstart: REV-006 催缴事件与通知协同设计

目标

本 quickstart 用于指导评审者和文档维护者快速完成 REV-006 设计补齐的检查，不涉及 backend 实施。

步骤 1：阅读规格与研究结论

1. 阅读 spec.md，确认三项澄清已固定：
   • 停复水仅定义联动边界
   • REV-006 使用独立接口编号 IF-REV-013
   • 结果状态固定为四态
2. 阅读 research.md，确认所有关键设计决策已有依据和备选方案说明。

步骤 2：执行文档改动时的目标落点

1. 在 docs/design/02_Detailed_Design/12_REV_Detailed.md 补齐 REV-006：
   • 任务生成规则
   • 结果回写规则
   • 停复水联动边界
   • 历史查询最小保留集
2. 在 docs/design/03_Technical_Design/03_Interface_Design.md：
   • 新增或替换 IF-REV-013
   • 保留 IF-EXT-008
   • 删除 REV-006 对 IF-REV-009 的错误引用
3. 在 docs/design/03_Technical_Design/01_Database_Design.md：
   • 明确在线主模型和历史只读查询口径
4. 在治理台账中回写：
   • 01_Project_Progress.md
   • 03_Task_Checklist.md

步骤 3：建议校验命令

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

步骤 4：验收检查点

• REV-006 不再复用 IF-REV-009
• 正式文档中统一使用四态结果集
• 停复水只写联动边界，不扩写内部流程
• 历史“催缴记录 / 停水记录 / 预存短信”不被误写成新在线主表
• 台账和正式文档同步更新

步骤 5：本轮实现摘要

• 已完成 12_REV_Detailed.md、03_Interface_Design.md、01_Database_Design.md、15_SYS002_Requirement_Breakdown.md、01_Project_Progress.md、03_Task_Checklist.md 的正式文档回写。
• REV-006 的正式业务接口编号已固定为 IF-REV-013，IF-REV-009 继续保留给 REV-005 发票结果查询。
• 催缴结果已统一为 PENDING、SUCCESS、FAIL、MANUAL_VERIFIED 四态；数据库与历史查询口径同步收口。
• 已执行并通过全部单文件校验与 make check-links。