junhong_cmp_fiber/.scratch/iot-risk-import-voucher-remark/issues/05-voucher-multi-migration.md

Status: done

Parent

.scratch/iot-risk-import-voucher-remark/PRD.md

What to build

一次 Migration 完成三个现有表的凭证字段类型变更，并同时新增代理预充值备注字段：

字段类型变更（varchar(500) → jsonb）：

• tb_order.payment_voucher_key
• tb_refund.refund_voucher_key
• tb_agent_recharge_record.payment_voucher_key

数据转换规则（在同一 Migration 的 USING 子句中完成）：

• 非空旧值 "some_key" → ["some_key"]
• 空字符串 "" → []
• NULL → []

新增字段：

• tb_agent_recharge_record.remark text（可为空，默认 null）

生产环境由运营手动执行，Migration 文件需包含完整的 UP 和 DOWN 语句。

Acceptance criteria

• Migration UP：三个凭证字段成功从 varchar 转为 jsonb，历史单值数据转换为单元素数组
• Migration UP：空字符串/NULL 转换为空数组 []
• Migration UP：tb_agent_recharge_record 新增 remark text 字段
• Migration DOWN：可回滚（jsonb → varchar，取数组第一个元素；remark 字段删除）
• 迁移后可用 PostgreSQL MCP 验证数据格式正确

Blocked by

None - can start immediately