feat(换货): AUG26-005 换货业务数据迁移状态与失败恢复

- 新增成对迁移 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），
  旧资产带标签时迁移最后一步失败，待另立变更修复

migrations/000222_add_exchange_migration_status.up.sql

@@ -0,0 +1,28 @@
+-- 换货业务数据迁移状态与最近一次失败原因。
+-- 既有 migrate_data、migration_completed 两个布尔字段无法区分未迁移、待迁移、已迁移与迁移失败，
+-- 也无法承载失败原因，后台列表与详情只能靠布尔组合推断。本迁移为 tb_exchange_order 增加可查询状态。
+-- 实施顺序：先带默认值加列（历史行取默认值）→ 按既有字段回填历史映射 → 加四值 CHECK 约束。
+-- 历史记录不推断失败原因，失败原因一律置空（not_migrated 以外的状态由应用写入时才有值）。
+-- 不新增索引：本期没有按迁移状态筛选或后台批处理查询，列表分页已直接投影换货单字段。
+
+ALTER TABLE tb_exchange_order
+    ADD COLUMN IF NOT EXISTS migration_status VARCHAR(20) NOT NULL DEFAULT 'not_migrated',
+    ADD COLUMN IF NOT EXISTS migration_failure_reason VARCHAR(500) NOT NULL DEFAULT '';
+
+-- 历史映射：未选择迁移 → not_migrated；已选择且迁移成功 → migrated；已选择但未成功完成 → pending。
+-- 只更新 migrate_data 为真的行（false 行已由列默认值落到 not_migrated），避免全表重写与多余 updated_at 变更。
+-- 注意：本回填只依据 migrate_data、migration_completed 推导，重新执行 up（含先 down 再 up）会把 failed 退化为 pending；
+-- 应用回滚需先回滚到仍兼容新增列的版本，仅在确认没有依赖迁移状态的数据或功能后才执行 down。
+UPDATE tb_exchange_order
+SET migration_status = CASE
+        WHEN migration_completed IS TRUE THEN 'migrated'
+        ELSE 'pending'
+    END
+WHERE migrate_data IS TRUE;
+
+ALTER TABLE tb_exchange_order
+    ADD CONSTRAINT chk_exchange_order_migration_status
+    CHECK (migration_status IN ('not_migrated', 'pending', 'migrated', 'failed'));
+
+COMMENT ON COLUMN tb_exchange_order.migration_status IS '业务数据迁移状态 not_migrated-不迁移 pending-待迁移 migrated-已迁移 failed-迁移失败';
+COMMENT ON COLUMN tb_exchange_order.migration_failure_reason IS '最近一次业务数据迁移失败的安全化原因，仅迁移状态为 failed 时非空，最长500字符';