tangweijie 3eccab2cf9 docs: 文档治理统一 — AGENTS.md 生命周期规则 + 模块归档 + DDL 修正

1. AGENTS.md 更新
   - water-docs: 新增 specs/ 与 docs/design/ 生命周期规则章节
   - water-backend: 更新协作引用（建设期/建成后、evidence 模块化）

2. specs/ 重复合并
   - 006-reminder-event-design 合并入 003-rev006-reminder-event-design
   - 001-rev004-accounting 删除冗余 data-model.md + contracts/
   - 002-rev005-invoice-flow 删除冗余 data-model.md + contracts/

3. evidence 按模块归档
   - 35 个 REV-004 文件归入 evidence/rev004-accounting/
   - 7 个通用 bugfix 文件归入 evidence/bugfix/ 和 bugfix/frontend/
   - 新建 rev005-invoice/、rev006-reminder/、rev007-statistics/ 目录

4. guides/ 清理
   - 14 个 REV004_*.md 移入 evidence/rev004-accounting/

5. 遗留文件处理
   - docs/research/ 归档到 Archive/06_Migration_Plans/
   - backend-check detached worktrees 清理

6. 交叉引用修复
   - 006-reminder-event-design → 003-rev006-reminder-event-design
   - docs/guides/REV004_ → docs/evidence/rev004-accounting/REV004_

7. DB 设计文档修正（01_Database_Design.md）
   - biz_invoice 明确为开票配置表，非发票记录表
   - 新增 biz_invoice_record 为发票申请/结果主表
   - 新增 biz_charge_invoice_rel 账单-发票关联说明
   - REV-005 承接口径表名全部修正

8. 发票审计证据
   - 新增 evidence/rev005-invoice/2026-06-16-invoice-document-audit.md

2026-06-16 11:47:16 +08:00

3.7 KiB

Raw Blame History

Quickstart: REV-004 账务处理一期计划评审与最小校验

1. 评审入口

本轮目标是：

完成 REV-004 一期文档范围收敛
形成后续实施计划的边界、任务拆解与验收入口
不直接进入 backend 代码修改

本轮验收仅检查：

文档一致性
计划可拆解性
台账可回写性

2. 评审步骤

步骤一：范围校验

确认一期只覆盖以下场景：

水量调整
金额调整
退款
冲正
坏账申请

同时确认以下内容未被带入：

新增独立账务台账表族
泛化 BPM 平台扩展
非 IF-REV-007 的跨模块接口扩围
backend 代码实施内容

步骤二：单一真源校验

对照以下正式口径：

spec.md
12_REV_Detailed.md
03_Interface_Design.md
01_Database_Design.md
.specify/memory/constitution.md

确认 plan 中没有用执行手册或 Archive 直接替代正式结论。

步骤三：追溯关系校验

确认以下关系在计划中可直接对应：

场景 → IF-REV-007
场景 → biz_charge / biz_charge_detail
退款/冲正 → bk_transaction*
留痕 → biz_operat_log*

步骤四：审批边界校验

确认审批相关内容仅保留：

approvalRequired
PENDING_APPROVAL
审批边界说明

不展开：

完整 BPM 流程
流程节点
流转规则
审批回写实现细节

步骤五：台账动作校验

确认执行闭环已说明：

01_Project_Progress.md 只在形成新的治理里程碑或正式交付节点时更新
03_Task_Checklist.md 只在 tracked task 完成或闭环条件被重新定义时更新
台账更新动作位于正式文档修订与最小校验之后，而不是默认并行执行

步骤六：独立验收入口校验

确认审阅者仅通过以下文件即可完成 US3 验收：

docs/evidence/rev004-accounting/REV004_ACCOUNTING_EXECUTION_PLAYBOOK.md
docs/design/00_Management/01_Project_Progress.md
docs/design/00_Management/03_Task_Checklist.md

并确认无需查看 backend 代码、运行态脚本或 Archive 历史附件，即可判断后续任务可继续拆解推进。

步骤七：正式文档修订闭环校验

若后续进入正式主文档修订，统一按以下顺序执行：

先更新执行手册中的执行顺序、验收入口、最小校验动作与台账触发条件。
再同步 quickstart.md、plan.md 等支撑产物，保持闭环表述一致。
每修改 1 份目标文档，执行对应 make validate-file FILE=<目标文件>。
涉及跨文档引用变更时执行 make check-links。
仅当里程碑成立或 tracked task 完成条件发生实质变化时，再回写两份治理台账。

3. 最小校验命令

make validate-file FILE=docs/evidence/rev004-accounting/REV004_ACCOUNTING_EXECUTION_PLAYBOOK.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

说明：

本轮校验聚焦执行手册与治理台账闭环，不再以 spec.md / plan.md 作为唯一校验对象。
make check-links 用于确认执行手册与两份治理台账之间的相对链接和引用关系正常。
若后续进入新的正式主文档修订批次，应补充对应目标文件的 make validate-file FILE=<目标文件>。

4. 通过标准

满足以下条件即可进入下一批 tasks 执行：

后续任务拆解顺序已明确：执行手册 → 支撑产物 → 台账同步
独立验收入口已明确，审阅者仅需查看执行手册与两份治理台账
最小校验动作已明确并可直接执行
项目进度与任务清单的更新触发条件已写清楚
后续工作可继续按文档修订、校验、台账同步三类动作拆解推进

3.7 KiB Raw Blame History