break
93e072e1e2
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）， 旧资产带标签时迁移最后一步失败，待另立变更修复
1.8 KiB
1.8 KiB
Why
现有换货单只以“是否要求迁移”和“是否完成迁移”两个布尔值表达迁移结果；迁移失败会回滚，后台无法在列表和详情中区分未迁移、待迁移、已迁移及迁移失败，也无法获知失败原因或在修复后重试。
本轮 AUG26-005 已收口迁移范围和失败处理，需让换货运营能准确判断业务数据迁移结果并追溯异常。
What Changes
- 将换货业务数据迁移结果统一为不迁移、待迁移、已迁移、迁移失败四个可观察状态，并保留最近一次失败原因。
- 在换货完成的迁移失败场景中保留换货单可完成状态及失败事实；超级管理员或平台用户修复条件后可再次确认完成，并重新原子执行完整迁移。
- 在换货列表和详情返回迁移状态及失败原因（仅迁移失败时），替代前端对现有布尔字段的推断；换货导出仅新增迁移状态列（中文名称），不导出失败原因。
- 将迁移范围明确限定为资产钱包余额、有效套餐使用记录、累计充值字段和资产标签；资产归属、个人客户—资产绑定及手机号—资产关联不属于该迁移范围。
Capabilities
New Capabilities
- 无。
Modified Capabilities
order-refund-exchange: 明确换货业务数据迁移的状态、失败恢复、范围和列表、详情及导出可见性。
Impact
- 影响
internal/model/exchange_order.go、换货完成写用例、换货列表 Query、换货 DTO、换货导出场景及既有换货审计。 - 需要新增成对数据库迁移，以保存迁移状态和最近失败原因；不修改既有迁移。
- 既有换货列表与详情接口将新增/明确迁移状态字段，前端应改按状态展示；换货导出新增一列迁移状态（中文名称），不导出失败原因。