Files
junhong_cmp_fiber/migrations/000222_add_exchange_migration_status.up.sql
break 93e072e1e2
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 11m42s
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),
  旧资产带标签时迁移最后一步失败,待另立变更修复
2026-09-14 18:32:26 +08:00

29 lines
2.1 KiB
SQL
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
-- 换货业务数据迁移状态与最近一次失败原因。
-- 既有 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字符';