# Quickstart: REV-004 旧账务迁移规划评审与最小校验

## 1. 评审入口

本轮目标是：

- 明确旧账务迁移映射如何形成
- 明确当前 backend 相对旧模型的功能缺失、弱映射点和历史只读对象
- 为后续迁移脚本设计、试迁和迁移验收提供统一规划入口

本轮验收重点检查：

- 映射方法是否稳定
- 功能缺失判定是否有证据
- 后续迁移批次和矩阵工件是否可直接执行

## 2. 评审步骤

### 步骤一：映射方法校验

确认方案采用以下原则：

- 以业务语义映射为主，而不是旧表逐表平移
- 采用在线主模型、兼容映射层、历史只读层三层承接
- 不把所有旧精细台账都当成必须重建的在线对象

### 步骤二：功能缺失判定校验

确认每个旧对象都按以下四类之一判定：

- `implemented`
- `partial`
- `readonly`
- `missing`

并确认每条判定都绑定 backend 或文档证据。

### 步骤三：最小保留集校验

确认迁移最少保留：

- 原单据标识
- 原账单标识
- 原流水标识
- 原发票标识
- 处理前后金额/水量
- 处理原因
- 申请/审批/生效时间
- 经办人与依据

### 步骤四：批次顺序校验

确认后续迁移按以下顺序推进：

1. 账户与营业账主明细
2. 收费结果与交易对象
3. 账务处理历史对象
4. 发票对象与账单关系

### 步骤五：接口边界校验

确认历史查询与迁移验收遵循以下边界：

- 接口只读
- 统一挂靠既有 `IF-REV-*` 接口族
- 同时支持汇总对账和明细追溯
- 返回新旧标识映射

## 3. 后续实施前必须补齐的工件

后续正式进入迁移脚本开发前，至少补齐：

1. 旧表到新对象映射矩阵
2. 旧字段到新字段映射矩阵
3. 旧状态到新状态映射矩阵
4. 新旧标识映射矩阵

## 4. 最小校验命令

```bash
make validate-file FILE=specs/008-rev004-legacy-finance-migration/spec.md
make validate-file FILE=specs/008-rev004-legacy-finance-migration/plan.md
make validate-file FILE=specs/008-rev004-legacy-finance-migration/research.md
make validate-file FILE=specs/008-rev004-legacy-finance-migration/data-model.md
make validate-file FILE=specs/008-rev004-legacy-finance-migration/quickstart.md
make check-links
```

## 5. 通过标准

满足以下条件即可进入下一阶段：

- 映射方法和三层承接模型已明确
- 功能缺失判定标准已明确
- 后续必做矩阵工件已明确
- 迁移分批顺序已明确
- 历史查询和迁移验收边界已明确