tangweijie a26f65a3d8 docs: 收口 REV-004 一期正式文档与交付闭环

统一 REV-004 一期范围、接口口径、数据库承接口径与追溯关系，
并补齐执行手册、quickstart、tasks 及治理台账，完成可执行交付闭环。

2026-03-13 15:02:29 +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/guides/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/guides/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