fujian_water_biz_doc/specs/008-rev004-legacy-finance-migration/quickstart.md

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

1. 评审入口

本轮目标是：

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

本轮验收重点检查：

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

2. 评审步骤

步骤一：映射方法校验

确认方案采用以下原则：

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

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

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

• implemented
• partial
• readonly
• missing

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

步骤三：最小保留集校验

确认迁移最少保留：

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

步骤四：批次顺序校验

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

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

步骤五：接口边界校验

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

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

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

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

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

4. 最小校验命令

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. 通过标准

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

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