2.8 KiB
2.8 KiB
11 — 完成真实链路验收、文档与发布门禁
What to build: 发布负责人可以通过自动化测试、OpenAPI、静态 CSV 模板和中文联调契约，验证从后台认证、真实 S3 直传、任务创建、可靠投递、Worker 执行到任务查询的完整链路。发布和回滚步骤明确保护已经产生的订单、钱包流水、套餐使用、任务和审计事实。
Blocked by:
.scratch/ur36-bulk-package-purchase/issues/03-real-dependency-integration-harness.md— 03 — 建立批量任务真实依赖的集成测试 Harness.scratch/ur36-bulk-package-purchase/issues/10-bulk-purchase-task-queries.md— 10 — 提供任务汇总与逐行明细查询
Status: ready-for-agent
架构通道: 主通道为 Infrastructure，辅助通道为 Application 与 Query 验收。
完整业务边界: 本票收口 UR#36 的真实依赖验收、接口文档、静态模板、中文功能总结、发布与回滚门禁。本仓库不实现前端页面；只提供前端交互所需的 API、OpenAPI、静态 CSV 模板和联调验收契约，不扩展为全仓测试治理。
- 完整示例穿过真实后台认证、预签名 URL、真实 S3 PUT 与 Head、创建 API、可靠任务投递、公开 Worker Handler、PostgreSQL 事实和查询 API。
- 自动化覆盖文件级零订单失败、行业务部分成功、全部行业务失败、多代理线下与钱包、信用与余额不足、严格行序、幂等 HTTP、双 Worker 和崩溃恢复。
- 审计验证任务创建、任务终态、成功订单和钱包事实可串联，且响应、日志、审计和测试输出不包含密钥、Token、预签名 URL 或底层错误。
- 提供只有
资产标识一列的 UTF-8 静态 CSV 模板，并明确支持的标识、1000 行、10MB、不接受 Excel及长数字保护提示。 - OpenAPI 完整包含上传用途、创建任务、任务详情和明细查询契约；两个文档生成入口一致，生成校验无漂移。
- 前端交互联调契约覆盖单套餐、钱包或线下支付、1 至 5 个凭证、四阶段页面、重复点击复用
request_id、刷新恢复、解析中空进度、部分成功计数、失败默认筛选和精确搜索。 - 中文功能总结和 README 说明领域边界、接口、失败闭环、真实依赖测试、部署顺序、监控、停用入口及回滚限制。
- 发布门禁包含目标及相关包测试、全量 Go 测试、并发或竞态专项、静态检查、OpenAPI 生成、迁移升降级验证，以及 PostgreSQL、Redis/Asynq 和真实 S3 配置核验。
- 回滚先关闭创建入口并处置待处理或处理中任务；已经形成的标准订单、钱包流水、套餐使用、批量任务和审计作为业务事实保留，不执行反向删除。