# Checklist: REV-004 试迁校验清单 v1

**Purpose**: 用于指导 `REV-004` 旧账务数据试迁后的最小验收校验，确保数量、金额、关系、状态和追溯链条在试迁阶段就能被发现问题。  
**Created**: 2026-03-23  
**Feature**: [spec.md](/Volumes/Dpan/github/water-workspace/water-docs/specs/008-rev004-legacy-finance-migration/spec.md)

## 1. 使用方式

- 本清单面向“试迁批次”使用，不是最终割接验收清单。
- 每完成一个迁移批次，都应至少完成一次数量校验、金额校验、关系校验和抽样校验。
- 若某项校验失败，不应直接进入下一批次，而应先定位是：
  - 映射矩阵问题
  - 字段转换问题
  - 状态归并问题
  - 标识断链问题

## 2. 批次 1：账户与营业账主明细

### 2.1 数量校验

- [ ] `AT_CHARGES` 迁移记录数与 `biz_charge` 承接数一致，或差异已登记并有解释
- [ ] `AT_CHARGE_DETAILS` 迁移记录数与 `biz_charge_detail` 承接数一致，或差异已登记并有解释
- [ ] `CT_ACCOUNTS` 迁移记录数与账户承接对象一致，或差异已登记并有解释

### 2.2 金额校验

- [ ] 旧 `AT_CHARGES.ExtendedAmount` 汇总与新账单主对象应收金额汇总一致
- [ ] 旧 `AT_CHARGES.BillAmount` 汇总与新账单主对象开账金额汇总一致
- [ ] 旧 `AT_CHARGES.LateFee` 汇总与新账单主对象滞纳金汇总一致
- [ ] 旧 `CT_ACCOUNTS.Deposit` 汇总与新账户余额汇总一致，或差异已解释

### 2.3 关系校验

- [ ] 每条迁移后的账单主记录都能找到对应明细记录
- [ ] 每条旧账单都能通过映射表找到新账单主键
- [ ] 若存在 `ParentFeeId` / `ContrastFeeId`，迁移后仍能定位原账单与目标账单关系

### 2.4 抽样校验

- [ ] 随机抽 3 笔普通账单，核对客户号、账期、金额、状态一致
- [ ] 随机抽 2 笔带调整关系的账单，核对原账单与新账单映射关系一致
- [ ] 随机抽 2 个账户，核对余额和客户关系一致

## 3. 批次 2：收费结果与交易对象

### 3.1 数量校验

- [ ] `PM_PAY_COLLECTS`、`PM_PAY_SUBTOTALS`、`PM_PAY_DETAILS` 迁移或承接数量已核对
- [ ] 旧收费明细与新交易对象 / 收费承接对象数量差异已解释
- [ ] 实时收费日志如仅保留历史只读，其归档记录数已校对

### 3.2 金额校验

- [ ] 旧收费明细 `ActualMoney` 汇总与新交易金额汇总一致
- [ ] 旧收费明细 `SoldMoney` 汇总与新核销金额汇总一致，或差异已解释
- [ ] 旧收费汇总 `TotalMoney` 与新汇总结果一致
- [ ] 第三方交易流水涉及的金额抽样与新交易对象一致

### 3.3 关系校验

- [ ] 每笔收费明细都能追到原账单或新账单映射
- [ ] 每笔收费明细的重要流水号都能追到新交易对象
- [ ] 若存在红冲引用，原收费记录与后续记录链条未断裂

### 3.4 抽样校验

- [ ] 随机抽 3 笔柜台收费，核对原流水号、金额、收费时间、收费员
- [ ] 随机抽 2 笔第三方渠道收费，核对第三方流水号与新交易号映射
- [ ] 随机抽 1 笔红冲关联收费，核对原单与后续记录关系

## 4. 批次 3：账务处理历史对象

### 4.1 数量校验

- [ ] `PM_ACCOUNT_RECORD*`、`PM_AMOUNT_RECORD*`、`PM_PRICE_RECORD*`、`PM_PAYMENT_RECORD*`、`PM_KNOTTY_RECORD*` 已按对象分类统计
- [ ] 每类旧账务处理对象都已判定为在线承接、历史只读或映射保留之一
- [ ] 当前未在线承接的对象，历史只读记录数已归档核对

### 4.2 金额校验

- [ ] 预存退款金额汇总与新退款承接结果或映射结果一致
- [ ] 调整前后金额差额与新账单差异值一致，或差异已解释
- [ ] 坏账金额汇总与新坏账场景承接结果一致，或差异已解释
- [ ] 已销调整 / 价差调整的关键差额字段已核对

### 4.3 关系校验

- [ ] 每笔退款类记录都能追到原流水和目标流水
- [ ] 每笔调整类记录都能追到原账单和目标账单
- [ ] 每笔坏账记录都能追到原账单和处理结果
- [ ] `TaskId`、`StepId`、`FlowRemark` 等审批痕迹已进入历史只读或追溯字段

### 4.4 抽样校验

- [ ] 随机抽 2 笔预存退款，核对申请、原流水、目标流水、退款金额
- [ ] 随机抽 2 笔金额/水量调整，核对前后金额/水量和原账单、新账单关系
- [ ] 随机抽 1 笔已销调整或冲正，核对原收费记录与后续处理关系
- [ ] 随机抽 1 笔坏账申请，核对账单、金额、审批痕迹、结果状态

## 5. 批次 4：发票对象与账单关系

### 5.1 数量校验

- [ ] `IV_INVOICE_INFOS` 迁移数与新发票承接对象数量一致，或差异已解释
- [ ] `IV_INVOICE_DETAIL_INFOS` 若进入在线承接或历史只读，记录数已校对
- [ ] `IV_CHARGE_INVOICE_MAPPINGS` 关系数已校对

### 5.2 金额校验

- [ ] 发票总金额汇总与新发票对象金额汇总一致
- [ ] 发票与账单映射的金额汇总一致

### 5.3 关系校验

- [ ] 每张旧发票都能找到新发票主键或新业务单号
- [ ] 每张旧发票都能追到原账单或新账单关系
- [ ] 原发票代码 / 原发票号码在红冲或作废场景下未断链

### 5.4 抽样校验

- [ ] 随机抽 2 张正常发票，核对发票号、账单号、状态、电子票地址
- [ ] 随机抽 1 张作废或红冲相关发票，核对原票引用链是否完整
- [ ] 随机抽 1 张多账单映射发票，核对账单关系是否一致

## 6. 通用状态与标识校验

### 6.1 状态校验

- [ ] 收费状态已按状态矩阵归并，未出现无法解释的孤立状态
- [ ] 发票状态已按状态矩阵归并，未出现成功/失败/作废/红冲混乱
- [ ] 退款 / 冲正 / 坏账相关状态已按结果状态和 `legacyState` 双层承接

### 6.2 标识校验

- [ ] `FeeId` ↔ 新账单主键映射可查
- [ ] `AccLogId` ↔ 新流水映射可查
- [ ] 旧申请单号 ↔ 新调整单号映射可查
- [ ] 发票代码 / 号码 ↔ 新发票对象映射可查

## 7. 差异分类规则

若试迁中发现差异，优先按以下类型记录：

- [ ] A 类：对象映射错误
- [ ] B 类：字段转换错误
- [ ] C 类：状态归并错误
- [ ] D 类：标识断链
- [ ] E 类：历史只读遗漏
- [ ] F 类：真实功能缺失

## 8. 通过标准

一次试迁批次至少满足以下条件，才允许进入下一批次：

- [ ] 数量差异已全部解释
- [ ] 关键金额差异已全部解释
- [ ] 主关系链未断裂
- [ ] 抽样场景能完整追溯
- [ ] 状态和标识映射无重大断链
- [ ] 所有未解决问题已形成差异清单

## 9. 后续动作

本清单完成后，下一步应补：

1. 差异清单模板
2. 复迁规则
3. 批次回滚方案