# 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 历史附件,即可判断后续任务可继续拆解推进。 ### 步骤七:正式文档修订闭环校验 若后续进入正式主文档修订,统一按以下顺序执行: 1. 先更新执行手册中的执行顺序、验收入口、最小校验动作与台账触发条件。 2. 再同步 `quickstart.md`、`plan.md` 等支撑产物,保持闭环表述一致。 3. 每修改 1 份目标文档,执行对应 `make validate-file FILE=<目标文件>`。 4. 涉及跨文档引用变更时执行 `make check-links`。 5. 仅当里程碑成立或 tracked task 完成条件发生实质变化时,再回写两份治理台账。 ## 3. 最小校验命令 ```bash 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 执行: - 后续任务拆解顺序已明确:执行手册 → 支撑产物 → 台账同步 - 独立验收入口已明确,审阅者仅需查看执行手册与两份治理台账 - 最小校验动作已明确并可直接执行 - 项目进度与任务清单的更新触发条件已写清楚 - 后续工作可继续按文档修订、校验、台账同步三类动作拆解推进