junhong_cmp_fiber/.scratch/iot-risk-import-voucher-remark/issues/08-agent-recharge-voucher-remark.md

Status: done

Parent

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

What to build

同时完成代理预充值的凭证多图改造和备注字段接入：

凭证多图：

• CreateAgentRechargeRequest.payment_voucher_key：string → []string，validate 限制 max=5，每项 max=500（offline 支付时至少1个，微信支付时忽略）
• AgentRechargeResponse.payment_voucher_key：string → []string
• AgentRechargeRecord.PaymentVoucherKey Model 字段类型改为适配 jsonb 的类型

备注字段：

• CreateAgentRechargeRequest 新增 remark string（可选，建议不超过1000字符）
• AgentRechargeResponse 新增 remark string（列表和详情接口均返回）
• AgentRechargeRecord.Remark 在创建时写入，后续不可修改

AgentRecharge Service 中读写相关字段的逻辑同步更新。

Schema 变更（payment_voucher_key 类型 + remark 字段）已由 issues/05-voucher-multi-migration.md 完成。

Acceptance criteria

• 创建代理预充值接口接受 payment_voucher_key []string（offline 时至少1个）和可选 remark
• 代理预充值列表/详情接口返回 payment_voucher_key []string 和 remark
• 传入超过5个凭证 key 时返回参数校验错误
• 不新增 remark 修改接口，创建后备注字段只读
• 微信支付创建预充值时可不传凭证（与现有逻辑一致）

Blocked by

• issues/05-voucher-multi-migration.md