tangweijie
3eccab2cf9
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
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/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 历史附件，即可判断后续任务可继续拆解推进。
|
|
|
|
### 步骤七：正式文档修订闭环校验
|
|
若后续进入正式主文档修订，统一按以下顺序执行：
|
|
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/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 执行：
|
|
- 后续任务拆解顺序已明确：执行手册 → 支撑产物 → 台账同步
|
|
- 独立验收入口已明确，审阅者仅需查看执行手册与两份治理台账
|
|
- 最小校验动作已明确并可直接执行
|
|
- 项目进度与任务清单的更新触发条件已写清楚
|
|
- 后续工作可继续按文档修订、校验、台账同步三类动作拆解推进
|