2.7 KiB
2.7 KiB
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: 接口待确认项完成前不进入大范围实现