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