文档
v1(2026-09 及以前)实施计划供应网关

媒体网关 实施计划

负责自研媒体供应协议、提交/查询/取消、供应状态和结果返回

归档内容,只读,不代表现行方案。现行文档见文档总览。

目标与范围

负责自研媒体供应协议、提交/查询/取消、供应状态和结果返回。Core 持有客户任务、费用和恢复协调;网关不成为第二个客户账务中心。

需求输入与确认

按媒体 API核对实际已用供应商及计量方式,记录同步/异步、任务 ID、结果保存期、取消能力、回调与查询可靠性。已有代码分别核验,不因重构计划重写成熟适配。

设计与原型

设计受理失败、已受理、结果未知、执行中、终态和结果失效的供应状态映射。明确哪些情况可安全重试、哪些必须先查询;Core Worker 负责客户侧持久核对,供应网关提供证据。

API 与文档交付

形成内部提交/查询/可选取消协议、任务 ID 映射、计量单位、错误/回调签名和结果访问说明。不同供应能力如不支持取消或缺终态用量,应显式声明,不伪造一致能力。

实施步骤与交付物

步骤实施内容交付物与退出条件
MG-01 能力盘点核验现有代码、供应协议和真实能力提交/查询/取消/结果/计量矩阵
MG-02 状态与规范明确供应状态映射、请求幂等与未知核对契约、请求/回调样例及错误分类
MG-03 适配与保护补内部鉴权、任务归属关联、限流和结果处理隔离测试通过;敏感供应数据不泄漏
MG-04 Core Worker 联调提交关联、轮询/回调、取消意图和恢复丢失响应后可查询,重复回调不重复结算
MG-05 产品与运行接一个真实创作流程,测试结果失效与容量结果和费用可核对,故障排查与升级说明齐全

依赖与接入顺序

能力盘点独立推进;Core Worker 与 Contracts 确认任务协议后做真实联调。产品通过共享服务消费,不直接操作供应任务表。具体采用的调用入口按实际协议确认。

验收标准

  • 提交结果未知先核对,不能自动再次产生付费任务。
  • 查询退避、重复回调、取消不支持与结果失效均可解释。
  • 任务、结果与计量有关联,供应商切换不破坏客户归属和结算。

待定项与后续范围

首批媒体类型/供应能力、取消收费规则、结果存储与保留期、并发和回调保障待核验。

本文定义计划,不累积执行日志。实际版本、完成状态和验证证据见项目进度;任务状态登记到本机工作台,并关联本文步骤。

On this page