Files
one-pipe-system/openspec/changes/update-refund-voucher-multi-image/proposal.md
break 0c3065f970
All checks were successful
构建并部署前端到测试环境 / build-and-deploy (push) Successful in 7m52s
让凭证数组与套餐作废任务进入可联调状态
Constraint: 后端订单套餐作废接口使用 /api/admin/order-package-invalidate-tasks,上传
  purpose 只能使用 attachment。
  Rejected: 继续提交逗号拼接凭证字符串 | 新提交路径必须使用 string[],历史字符串只做读取归一化。
  Confidence: high
  Scope-risk: broad
  Directive: 新增订单套餐作废权限时需同时配置菜单 URL 与
  order_package_invalidate_task:create/detail 按钮权限。
  Tested: bun run build;development 真实后端联调上传、创建、列表、详情通过;复机接口未触发。
  Not-tested: 未逐一手工覆盖所有历史凭证数据、全部角色权限组合和所有文件扩展名预览
2026-06-23 09:50:12 +08:00

1.1 KiB

Change: Update Refund Voucher Multi Image Behavior

Why

退款管理需要更清晰地展示退款凭证,并支持一次退款记录关联多张凭证图片,便于财务核验。创建退款申请选择订单时也应只允许选择已支付订单,避免对未支付订单发起退款。

What Changes

  • 退款详情中直接展示退款凭证图片,点击图片后可放大预览。
  • 创建退款申请的订单号搜索/选择请求必须增加 payment_status: 2 条件。
  • 退款管理凭证上传支持多张图片,并按 ADR-0001 将所有上传后的文件 key 以 string[] 放入 refund_voucher_key 参数。

Impact

  • Affected specs: order-management
  • Affected code:
    • Refund detail voucher display and image preview behavior
    • Create refund request order selector query params
    • Refund management voucher upload component and submit payload
  • Breaking changes: Refund voucher payload field for this flow remains refund_voucher_key, but new submissions use string[]. Legacy single-key strings and comma-separated strings are read-only compatibility inputs for display normalization.