98 lines
2.5 KiB
Markdown
98 lines
2.5 KiB
Markdown
# 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. 通过标准
|
|
|
|
满足以下条件即可进入下一阶段：
|
|
|
|
- 映射方法和三层承接模型已明确
|
|
- 功能缺失判定标准已明确
|
|
- 后续必做矩阵工件已明确
|
|
- 迁移分批顺序已明确
|
|
- 历史查询和迁移验收边界已明确
|