feat(换货): AUG26-005 换货业务数据迁移状态与失败恢复
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 11m42s

- 新增成对迁移 000222:tb_exchange_order 增加非空 migration_status 与
  migration_failure_reason,按既有 migrate_data/migration_completed 回填历史,
  并加四值 CHECK 约束,不新增索引
- 模型与常量定义四种迁移状态及中文名称,保留既有布尔字段兼容语义
- 物流换货创建恒 not_migrated,发货按请求落 pending/not_migrated,
  完成成功写 migrated/not_migrated 并清空失败原因、同步兼容字段
- 直接换货创建即完成,任一步失败整体回滚,不持久化换货单、不产生 failed
- 迁移失败回滚全部业务修改后,在独立短事务内条件更新 failed 与安全失败原因
  并写失败审计,RowsAffected 为 0 时跳过状态写入但仍写审计
- failed 物流单重试仅限超级管理员或平台用户,授权以锁内 FOR UPDATE 判定为准,
  重试从钱包余额起整表重跑;非 failed 单沿用既有完成门禁
- 列表与详情返回迁移状态与中文名称,仅 failed 返回失败原因;既有三字段保持兼容
- 换货导出在「状态」列后新增中文「迁移状态」列,不导出失败原因
- 同步 order-refund-exchange 主 spec 与验证证据,归档本 Change
- 登记 KNOWN-ISSUE-001:既有标签复制 OnConflict 未声明部分索引谓词(42P10),
  旧资产带标签时迁移最后一步失败,待另立变更修复
This commit is contained in:
2026-09-14 18:32:26 +08:00
parent c7f9e005af
commit 93e072e1e2
20 changed files with 597 additions and 125 deletions

View File

@@ -711,7 +711,8 @@
"capability": "order-refund-exchange",
"requirements": [
"identity-access::数据范围拒绝",
"order-refund-exchange::订单、退款与换货状态门禁"
"order-refund-exchange::订单、退款与换货状态门禁",
"order-refund-exchange::换货业务数据迁移状态与失败恢复"
],
"classification": "behavior"
},
@@ -721,7 +722,8 @@
"capability": "order-refund-exchange",
"requirements": [
"identity-access::数据范围拒绝",
"order-refund-exchange::订单、退款与换货状态门禁"
"order-refund-exchange::订单、退款与换货状态门禁",
"order-refund-exchange::换货业务数据迁移状态与失败恢复"
],
"classification": "behavior"
},
@@ -2077,7 +2079,8 @@
"capability": "order-refund-exchange",
"requirements": [
"identity-access::数据范围拒绝",
"order-refund-exchange::订单、退款与换货状态门禁"
"order-refund-exchange::订单、退款与换货状态门禁",
"order-refund-exchange::换货业务数据迁移状态与失败恢复"
],
"classification": "behavior"
},
@@ -2097,7 +2100,9 @@
"capability": "order-refund-exchange",
"requirements": [
"identity-access::数据范围拒绝",
"order-refund-exchange::订单、退款与换货状态门禁"
"order-refund-exchange::订单、退款与换货状态门禁",
"order-refund-exchange::换货业务数据迁移状态与失败恢复",
"order-refund-exchange::换货业务数据迁移范围"
],
"classification": "behavior"
},
@@ -2117,7 +2122,8 @@
"capability": "order-refund-exchange",
"requirements": [
"identity-access::数据范围拒绝",
"order-refund-exchange::订单、退款与换货状态门禁"
"order-refund-exchange::订单、退款与换货状态门禁",
"order-refund-exchange::换货业务数据迁移状态与失败恢复"
],
"classification": "behavior"
},
@@ -2136,7 +2142,8 @@
"capability": "export-task",
"requirements": [
"export-task::导出任务终态",
"identity-access::数据范围拒绝"
"identity-access::数据范围拒绝",
"order-refund-exchange::换货导出业务数据迁移状态"
],
"classification": "behavior"
},

View File

@@ -3566,5 +3566,101 @@
],
"exit_status": 0
}
},
{
"capability": "order-refund-exchange",
"requirement": "换货业务数据迁移状态与失败恢复",
"spec": "openspec/specs/order-refund-exchange/spec.md",
"entries": [
"/api/admin/exchanges",
"/api/admin/exchanges/{id}",
"/api/admin/exchanges/{id}/ship",
"/api/admin/exchanges/{id}/complete"
],
"handler_consumer_job": [
"internal/routes/exchange.go",
"internal/handler/admin/exchange.go"
],
"application_service_query": [
"internal/service/exchange/service.go",
"internal/service/exchange/migration_failure.go",
"internal/query/exchange/list.go"
],
"domain_state_amount": [
"internal/model/exchange_order.go",
"pkg/constants/constants.go"
],
"store_migration_config": [
"migrations/000222_add_exchange_migration_status.up.sql",
"migrations/000222_add_exchange_migration_status.down.sql",
"internal/store/postgres/exchange_order_store.go"
],
"verification": {
"command": "grep -n '仅超级管理员或平台用户可重试迁移失败的换货单' internal/service/exchange/service.go",
"literal_output": [
"254:\t\terr = errors.New(errors.CodeForbidden, \"仅超级管理员或平台用户可重试迁移失败的换货单\")",
"271:\t\t\treturn errors.New(errors.CodeForbidden, \"仅超级管理员或平台用户可重试迁移失败的换货单\")"
],
"exit_status": 0
}
},
{
"capability": "order-refund-exchange",
"requirement": "换货业务数据迁移范围",
"spec": "openspec/specs/order-refund-exchange/spec.md",
"entries": [
"/api/admin/exchanges/{id}/complete"
],
"handler_consumer_job": [
"internal/routes/exchange.go",
"internal/handler/admin/exchange.go"
],
"application_service_query": [
"internal/service/exchange/service.go",
"internal/service/exchange/migration.go",
"internal/service/customer_binding/service.go"
],
"domain_state_amount": [
"internal/model/exchange_order.go",
"internal/model/personal_customer_phone.go"
],
"store_migration_config": [
"migrations/000222_add_exchange_migration_status.up.sql"
],
"verification": {
"command": "grep -n 'errors.Wrap(errors.CodeExchangeMigrationFailed' internal/service/exchange/migration.go",
"literal_output": [
"23:\t\treturn nil, errors.Wrap(errors.CodeExchangeMigrationFailed, err, \"执行钱包迁移失败\")",
"27:\t\treturn nil, errors.Wrap(errors.CodeExchangeMigrationFailed, err, \"迁移套餐使用记录失败\")",
"30:\t\treturn nil, errors.Wrap(errors.CodeExchangeMigrationFailed, err, \"复制累计充值字段失败\")",
"33:\t\treturn nil, errors.Wrap(errors.CodeExchangeMigrationFailed, err, \"复制资产标签失败\")"
],
"exit_status": 0
}
},
{
"capability": "order-refund-exchange",
"requirement": "换货导出业务数据迁移状态",
"spec": "openspec/specs/order-refund-exchange/spec.md",
"entries": [
"/api/admin/export-tasks"
],
"handler_consumer_job": [
"internal/exporter/exchange_scene.go"
],
"application_service_query": [
"internal/service/export_task/service.go"
],
"domain_state_amount": [
"pkg/constants/constants.go"
],
"store_migration_config": [],
"verification": {
"command": "grep -n '\"迁移状态\"' internal/exporter/exchange_scene.go",
"literal_output": [
"41:\t\t\"收货人姓名\", \"收货人电话\", \"收货地址\", \"快递公司\", \"快递单号\", \"状态\", \"迁移状态\", \"创建人\", \"创建时间\","
],
"exit_status": 0
}
}
]