2.4 KiB
2.4 KiB
Status: done
换货绑定迁移修复
Parent
.scratch/customer-binding-architecture/PRD.md
What to build
在 CustomerBinding 模块上实现 Migrate(ctx, tx, oldAsset, newAsset) 方法,替换换货服务中现有的 switchCustomerBindingWithTx 和 ensureNewAssetBindingAvailableWithTx 逻辑,修复有虚拟号旧卡换无虚拟号新卡时被误拦截的 bug。
Migrate(ctx, tx, oldAsset, newAsset)
处理四种虚拟号组合,仅涉及 IoT 卡(设备必然有虚拟号,只有有→有一种情形):
| 旧卡 | 新卡 | 行为 |
|---|---|---|
| 有虚拟号,pcd 有绑定 | 有虚拟号 | 更新 pcd 记录的 virtual_no 为新卡虚拟号 |
| 有虚拟号,pcd 有绑定 | 无虚拟号 | 禁用旧 pcd 记录(status=0)+ 创建新 pci ICCID 绑定 |
| 有虚拟号,pcd 无绑定 | 无虚拟号 | 跳过,无需迁移 |
| 无虚拟号,pci 有绑定 | 任意 | 迁移 pci 记录到新卡 ICCID(或新卡虚拟号路径) |
| 任意 | 任意(无绑定) | 跳过 |
修复换货服务
switchCustomerBindingWithTx替换为调用CustomerBinding.Migrate(),移除函数内newKey == ""的误拦截逻辑ensureNewAssetBindingAvailableWithTx更新:当新卡无虚拟号时,不再拦截换货,因为Migrate()已能正确处理此情形(无绑定时跳过,有绑定时迁移到 pci)
根本 bug 说明
原 switchCustomerBindingWithTx 在执行阶段做了 if newKey == "" { return error } 的检查,但没有先确认旧资产是否实际存在绑定记录。旧卡有虚拟号但无任何客户绑定时,也会被误拦截报错"新资产无法承接客户绑定"。
Acceptance criteria
- 旧卡有虚拟号 + 有客户绑定,换货为有虚拟号新卡:pcd 记录的 virtual_no 正确更新为新卡虚拟号
- 旧卡有虚拟号 + 有客户绑定,换货为无虚拟号新卡:旧 pcd 记录 status 变为 0,pci 表出现新卡 ICCID 的绑定记录
- 旧卡有虚拟号 + 无客户绑定,换货为无虚拟号新卡:换货正常完成,不报错,不写入任何绑定记录
- 旧卡无虚拟号,换货为任意新卡:换货正常完成
- 有虚拟号换有虚拟号(原有场景):行为与修复前一致,无回归
- 换货完成后,客户通过新卡(无论有无虚拟号)能正常通过归属验证
Blocked by
.scratch/customer-binding-architecture/issues/02-no-virtual-no-card-cend-flow.md