28 lines
2.7 KiB
Markdown
28 lines
2.7 KiB
Markdown
# Change: 对接七月迭代后台实现与接口契约
|
|
|
|
## Why
|
|
|
|
最新的七月迭代实现说明明确了后端已完成的接口、字段语义、前端调用顺序和联调边界。当前后台页面仍需要按这些最新契约完成筛选、展示、权限、审批、批量任务、导出和代理资金能力的统一对接，避免继续使用旧字段或前端自行推导业务规则。
|
|
|
|
## What Changes
|
|
|
|
- 按 `00-七月迭代实现与接口对接说明.md` 更新后台管理端的接口调用和页面展示契约。
|
|
- 按 `产品迭代7月份/000-代理钱包扫码充值接口对接说明.md` 和 `所需接口文档/000-代理钱包扫码充值接口对接.md` 补齐代理钱包在线扫码充值、线下代充和充值导出权限的前端契约。
|
|
- 以 `docs/所需接口文档/01-店铺.md` 至 `21-设备批量分配.md` 为接口参数、响应字段、枚举、权限和错误语义的具体来源。
|
|
- 对资产、店铺、订单、换货、套餐、资金、系列授权、审批、通知、批量任务、导出和 Gateway 相关页面补齐前端适配要求。
|
|
- 统一使用后端返回的实名策略、支付方式、预计到期、审批状态、金额计算结果和任务状态，不在前端重复推导。
|
|
- 代理在线充值只提交金额、动态可用支付方式和幂等 `request_id`，用后端返回的原始 `qr_content` 渲染二维码，并按充值状态轮询到帐结果。
|
|
- 按 `recharge_source` 区分代理在线自充与平台线下代充；线下单展示凭证和审批状态，在线单隐藏线下字段和人工审批操作。
|
|
- 补齐代理充值列表导出入口、导出任务详情和下载的权限编码。
|
|
- 补齐 CSV 上传模板、异步任务恢复、权限按钮、错误处理和并发冲突处理要求。
|
|
- 明确预签名上传先取 `file_key`、再调用批量业务接口的两阶段流程，并固定批量订购、设备分配和导出任务的终态处理规则。
|
|
- **不实施 H5/C 端页面改动**，但在规格和联调清单中标注其依赖的接口及外部工作项。
|
|
- **不实施后端接口、数据库、Worker、企微回调、Gateway 和对象存储改造**；本变更只描述后台前端联调所需的适配边界。
|
|
|
|
## Impact
|
|
|
|
- Affected specs: `july-iteration-frontend-integration`
|
|
- Affected code: 后台资产、店铺、订单、换货、套餐、代理充值与资金、系列授权、审批配置、通知、批量任务和导出页面；重点涉及 `src/views/finance/agent-recharge`、`src/api/modules/agentRecharge.ts` 和 `src/types/api/agentRecharge.ts`
|
|
- External follow-up: H5/C 端认证限制、实名流程、支付按钮、C 端订单续费、C 端通知和 C 端资产展示
|
|
- Approval gate: 接口待确认项完成前不进入大范围实现
|