36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
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`
|