# 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 — 提供任务汇总与逐行明细查询
- `.scratch/tech-public-foundation/issues/12-foundation-release-gate-and-integration-contract.md` — 12 — 建立公共基础发布门禁和下游接入契约
- `.scratch/tech-global-audit/issues/19-one-time-audit-cutover-gate.md` — 19 — 执行一次性审计切换与停机发布门禁
- `.scratch/ur38-agent-main-wallet-credit/issues/10-credit-wallet-cutover-gate.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 配置核验。
- [ ] 回滚先关闭创建入口并处置待处理或处理中任务；已经形成的标准订单、钱包流水、套餐使用、批量任务和审计作为业务事实保留，不执行反向删除。
