BFF 编排与第三方服务接入
统一调用
前端 executeBffFlow 通过 App Gateway 的 orchestration_flow_execute 进入 BFF，业务请求由 apiId 与参数组成。后端统一执行入口为 POST /orchestration/flows/execute；前端不直接访问该内部服务地址。
现有合同
| 能力 | apiId 或系列 |
|---|---|
| 直播源 | API-CAMERA-LIVE-001 |
| 录播订单 | API-CAMERA-ORDER-001 |
| 录播计划 | API-CAMERA-RECORD-001/002/003 |
| 活动和球队媒体 | API-CAMERA-MEDIA-001/002/003 |
| 活动生命周期 | API-ACTIVITY-LIFECYCLE-001 |
| 认领、撤销与转载 | 当前对应 action 使用的已部署合同，改动前核对实际 apiId |
新能力实施顺序
- 先核对已有 Flow 与服务，确定输入、输出、身份及目标范围。
- 在服务端完成授权、幂等、状态机、外部调用和可恢复结果，不让客户端传私有凭据或可信用户身份。
- 在 API facade 封装业务参数，action 组织业务结果，页面只消费 DTO。
- 测试正常、拒绝、重复、超时后查询及部分成功恢复。
- 先部署向后兼容服务，再发布消费客户端，保留 traceId 用于排查。
设备商凭据由 BFF 持有，前端只使用业务所需的短时播放结果。已删除的 YS7 直连不得恢复；旧视频服务只作为迁移中的历史例外，不新增能力。