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

37 lines
1.9 KiB
Markdown

# Change: 新增业务列表提交人与审批摘要
## Why
退款、代理充值和换货列表当前无法直接显示提交人、企微审批进度及业务处理进度。运营人员需要进入详情或依赖额外沟通才能判断记录由谁发起、审批进行到哪一步以及后续业务是否完成。
## What Changes
- 在退款列表、代理充值列表和换货列表增加“提交人”“审批状态”“当前审批人摘要”“业务处理状态”四列。
- 三个列表接口项统一支持 `submitter_name``approval_source``approval_status``approval_status_name``current_approver_summary``processing_status``processing_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:
- 审批发起、撤回、审批操作或企微审批详情页。
- 前端根据业务状态或审批步骤推导审批结果和业务处理状态。