# 04 — 固化前端接口交互契约并完成发布验收

**What to build:** 交付可由前端页面直接消费的 CSV 批量分配接口交互契约：上传、两个独立命令提交、任务轮询和结果展示所需字段、状态与错误语义完整一致；通过真实环境异步链路验证平台和代理场景，确保发布与回滚安全。此任务不开发前端页面。

**Blocked by:** 02 — 完成 CSV 批量分配代理接口闭环；03 — 完成 CSV 批量分配套餐系列接口闭环。

**Status:** ready-for-agent

**架构通道：** 主通道为接口契约与发布验证，辅助通道为 Query。完整边界是前端可完成上传、提交、轮询和结果展示的交互闭环；明确不包含设备管理页、弹框、模板静态资源或其他前端页面实现。

- [ ] 两个命令保持独立请求字段和语义，上传后仅提交 `file_key`，不使用 multipart，也不提供可同时修改代理与系列的通用操作。
- [ ] 响应完整提供前端展示任务号、命令、目标摘要、状态及中文名称、进度、总数、成功/幂等/失败数、失败明细和时间；终态可据此停止轮询。
- [ ] 接口文档和集成测试覆盖 CSV 上传、平台与代理权限、部分成功、文件级失败、入队失败和安全错误语义，保证前端无需依赖隐含规则。
- [ ] 在真实 PostgreSQL、Redis、Asynq 和对象存储可用的环境中验证端到端链路；确认 Worker 未部署不开放入口，回滚不删除既有任务、分配记录或审计事实。