-- 换货业务数据迁移状态与最近一次失败原因。
-- 既有 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字符';