# 06 · 外部系统集成边界

## 1. 集成总则

- 所有外部系统经**防腐层（Anti-Corruption Layer）适配器**接入：外部报文格式在适配器内
  转换为平台内部业务对象，外部系统的字段语义、编码习惯不渗入核心域模型；
- 每个适配器双向留痕（原始报文 + 转换后对象），满足对账与审计；
- 外部接口的可用性假设**从悲观设计**：超时、重试（幂等）、降级路径全部显式定义。

## 2. 三大业务接口

### 2.1 交易平台接口

| 交互 | 方向 | 内容 | 备注 |
|---|---|---|---|
| 申报提交 | 出 | 日前/日内申报文件（Proposal RELEASED 后由适配器投递） | 截止时间硬约束，见降级策略 |
| 撤单/改单 | 出 | 截止前修正 | |
| 出清结果 | 入 | 中标计划、出清价格 → 写持仓账本、触发计划分解 | |
| 市场信息 | 入 | 披露的供需/价格信息 → 时序库，喂电价预测 | |

**降级策略**：申报窗口临近截止（可配，如 T-30min）而 Proposal 仍未批准 → 强制告警升级；
接口故障 → 回退人工申报通道（平台导出标准申报文件，人工上传），该路径纳入演练。

### 2.2 调度 / 负荷管理系统接口

| 交互 | 方向 | 内容 |
|---|---|---|
| 调节指令/需求 | 入 | 调度下达的调节需求 → 转为事件触发（负荷控制 Agent 生成响应计划） |
| 调节能力申报 | 出 | 可调容量申报（来自资源画像核定值） |
| 基线与考核数据 | 入 | 响应基线、考核结果 → 复盘与用户履约评价 |

### 2.3 计量结算系统接口

| 交互 | 方向 | 内容 |
|---|---|---|
| 计量数据 | 入 | 用户/资源电量数据 → 时序库 + 持仓账本「实际值」列 |
| 结算结果 | 入 | 结算单 → 收益复盘、内部收益分摊 |

计量数据到达是**复盘流程的触发事件**（D+1 周期触发的数据前提）。

## 3. 数据类接入

气象服务（预报 + 实况）、外部行情等只读数据源：统一经数据接入管道（05 篇 §3.1），
带来源标记与质量门禁，不设专用适配器逻辑。

## 4. 内部既有系统的关系

平台不是推倒重建，与既有 3060 平台/业务模块的关系：

| 既有能力 | 关系 |
|---|---|
| 共性能力层（客户/档案/设备/站点中心） | **复用**，作为主数据源；平台经服务接口读写 |
| 平台底座（用户权限、消息、工作流） | 用户权限体系**对接复用**（审批人身份来自既有权限系统）；Agent Runtime 的工作流引擎为新建（需求不同：持久化 AI 任务编排 vs 传统 OA 流程） |
| 既有交易/虚拟电厂业务模块 | 保留为业务操作界面，逐步嵌入 AI 卡片；申报等关键动作的**通道收敛**到可信执行链（避免绕过安全链的旁路） |
| 客户侧资源聚合（数据网关、本地 CPS） | **复用并升级**为控制平面的边缘层（04 篇），新增包络/断连策略能力 |

**通道收敛**是集成阶段的关键治理动作：上线后人工申报也应走平台（人工直接创建 Proposal，
跳过 Agent 生成环节但不跳过校核与留痕），否则账本与审计出现盲区。

## 5. 接口清单的落实节奏（对应实施计划）

- 一期（省内能力落地）：气象/市场信息只读接入 + 计量数据接入 + 申报文件导出（人工上传通道）——不依赖外部单位排期即可闭环演示；
- 二期（资源接入与推广）：交易平台程序化申报、调度接口、边缘控制链路——需与外部单位联调，是二期进度的主要风险项，尽早启动接口协议对接。