huang
f339fb1987
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m8s
- client_order: 新增 getOrCreateWallet 兜底，钱包不存在时自动创建 - device_import: 设备导入事务内同步创建设备钱包 - iot_card_import: IoT卡批量导入后批量创建卡钱包 - queue/handler: 传递 AssetWalletStore 给两个导入 handler - migration 000098: 为存量IoT卡和设备补建资产钱包
2.8 KiB
2.8 KiB
ADDED Requirements
Requirement: 退款后套餐失效
退款审批通过后，系统 SHALL 查找该订单关联资产（iot_card_id 或 device_id）的全部套餐使用记录（status IN (0,1,2) 待生效/生效中/已用完），批量更新为 status=4（已失效）。
Scenario: 失效单卡套餐
- WHEN 退款订单为单卡购买，关联 iot_card_id
- THEN 系统 SHALL 将该卡所有
status IN (0,1,2)的套餐使用记录更新为status=4
Scenario: 失效设备套餐
- WHEN 退款订单为设备购买，关联 device_id
- THEN 系统 SHALL 将该设备所有
status IN (0,1,2)的套餐使用记录更新为status=4
Requirement: 退款后停机
套餐失效后，系统 SHALL 对资产执行停机操作。
Scenario: 单卡停机
- WHEN 退款订单为单卡购买
- THEN 系统 SHALL 调用
StopResumeService.ManualStopCard(iccid)停机
Scenario: 设备停机（停所有绑定卡）
- WHEN 退款订单为设备购买
- THEN 系统 SHALL 调用
DeviceService.StopDevice(deviceID)，内部遍历所有绑定卡逐一停机
Requirement: 退款后资产世代重置
停机后，系统 SHALL 对资产执行世代重置（参照换货模块 exchange/service.go 的重置逻辑），使资产回到可重新销售状态，一次性佣金可重新触发。
Scenario: 单卡世代重置
- WHEN 退款订单为单卡购买
- THEN 系统 SHALL 更新 IoT 卡：
generation+1、asset_status=1（在库）、accumulated_recharge=0、first_commission_paid=false、清零系列充值和触发标记，清理个人客户绑定（tb_personal_customer_device），删除旧资产钱包并创建新空钱包
Scenario: 设备世代重置
- WHEN 退款订单为设备购买
- THEN 系统 SHALL 更新设备：
generation+1、asset_status=1（在库）、accumulated_recharge=0、first_commission_paid=false、清零系列充值和触发标记，清理个人客户绑定，删除旧资产钱包并创建新空钱包
Requirement: 退款后订单状态更新
资产处理完成后，系统 SHALL 将订单 payment_status 更新为 4（已退款）。
Scenario: 订单标记已退款
- WHEN 资产处理全部成功
- THEN 订单
payment_statusSHALL 变为 4（已退款），退款单asset_reset标记为true
Requirement: 资产处理失败容错
资产处理 SHALL 在独立 Goroutine 中执行，失败不影响审批结果。
Scenario: 资产处理失败
- WHEN 套餐失效/停机/世代重置过程中发生错误
- THEN 审批结果 SHALL NOT 受影响（已通过），
asset_reset保持false，记录 Error 日志（含 refund_id 和 error） - AND 管理员可通过
asset_reset=false筛选需手动处理的退款单