Files
one-pipe-system/openspec/changes/add-business-list-approval-summaries/proposal.md
luo d5fd8ac564
All checks were successful
构建并部署前端到测试环境 / build-and-deploy (push) Successful in 7m20s
feat: 退款充值换货列表提交人与审批摘要
2026-07-22 18:37:41 +08:00

1.9 KiB

Change: 新增业务列表提交人与审批摘要

Why

退款、代理充值和换货列表当前无法直接显示提交人、企微审批进度及业务处理进度。运营人员需要进入详情或依赖额外沟通才能判断记录由谁发起、审批进行到哪一步以及后续业务是否完成。

What Changes

  • 在退款列表、代理充值列表和换货列表增加“提交人”“审批状态”“当前审批人摘要”“业务处理状态”四列。
  • 三个列表接口项统一支持 submitter_nameapproval_sourceapproval_statusapproval_status_namecurrent_approver_summaryprocessing_statusprocessing_status_name
  • approval_source=none 时审批状态和当前审批人摘要显示 -
  • approval_source=legacy 时审批状态显示“历史审批”,作为只读历史信息,不新增审批操作按钮。
  • approval_source=wecom 时显示后端返回的企微审批状态及当前审批人摘要;超长审批人摘要使用省略显示并在悬浮时展示完整文本。
  • 业务处理状态直接展示后端 processing_status_name,与审批状态分列展示。
  • 列表仅使用列表响应中的审批摘要字段,翻页和刷新时不得为每行额外请求审批详情。

Impact

  • Affected specs:
    • order-management
    • agent-recharge
    • exchange-management
  • Affected code:
    • src/types/api/refund.ts
    • src/types/api/agentRecharge.ts
    • src/api/modules/exchange.ts
    • src/views/finance/refund/index.vue
    • src/views/finance/agent-recharge/index.vue
    • src/views/asset-management/exchange-management/index.vue
  • API contracts:
    • GET /api/admin/refunds
    • GET /api/admin/agent-recharges
    • GET /api/admin/exchanges
  • Out of scope:
    • 审批发起、撤回、审批操作或企微审批详情页。
    • 前端根据业务状态或审批步骤推导审批结果和业务处理状态。