媒体网关 实施计划
负责自研媒体供应协议、提交/查询/取消、供应状态和结果返回
归档内容,只读,不代表现行方案。现行文档见文档总览。
目标与范围
负责自研媒体供应协议、提交/查询/取消、供应状态和结果返回。Core 持有客户任务、费用和恢复协调;网关不成为第二个客户账务中心。
需求输入与确认
按媒体 API核对实际已用供应商及计量方式,记录同步/异步、任务 ID、结果保存期、取消能力、回调与查询可靠性。已有代码分别核验,不因重构计划重写成熟适配。
设计与原型
设计受理失败、已受理、结果未知、执行中、终态和结果失效的供应状态映射。明确哪些情况可安全重试、哪些必须先查询;Core Worker 负责客户侧持久核对,供应网关提供证据。
API 与文档交付
形成内部提交/查询/可选取消协议、任务 ID 映射、计量单位、错误/回调签名和结果访问说明。不同供应能力如不支持取消或缺终态用量,应显式声明,不伪造一致能力。
实施步骤与交付物
| 步骤 | 实施内容 | 交付物与退出条件 |
|---|---|---|
| MG-01 能力盘点 | 核验现有代码、供应协议和真实能力 | 提交/查询/取消/结果/计量矩阵 |
| MG-02 状态与规范 | 明确供应状态映射、请求幂等与未知核对 | 契约、请求/回调样例及错误分类 |
| MG-03 适配与保护 | 补内部鉴权、任务归属关联、限流和结果处理 | 隔离测试通过;敏感供应数据不泄漏 |
| MG-04 Core Worker 联调 | 提交关联、轮询/回调、取消意图和恢复 | 丢失响应后可查询,重复回调不重复结算 |
| MG-05 产品与运行 | 接一个真实创作流程,测试结果失效与容量 | 结果和费用可核对,故障排查与升级说明齐全 |
依赖与接入顺序
能力盘点独立推进;Core Worker 与 Contracts 确认任务协议后做真实联调。产品通过共享服务消费,不直接操作供应任务表。具体采用的调用入口按实际协议确认。
验收标准
- 提交结果未知先核对,不能自动再次产生付费任务。
- 查询退避、重复回调、取消不支持与结果失效均可解释。
- 任务、结果与计量有关联,供应商切换不破坏客户归属和结算。
待定项与后续范围
首批媒体类型/供应能力、取消收费规则、结果存储与保留期、并发和回调保障待核验。
本文定义计划,不累积执行日志。实际版本、完成状态和验证证据见项目进度;任务状态登记到本机工作台,并关联本文步骤。