vpp-ai-platform/docs/06-integration.md

64 lines
3.6 KiB
Markdown
Raw Normal View History

2026-09-01 19:46:59 -04:00
# 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. 接口清单的落实节奏(对应实施计划)
- 一期(省内能力落地):气象/市场信息只读接入 + 计量数据接入 + 申报文件导出(人工上传通道)——不依赖外部单位排期即可闭环演示;
- 二期(资源接入与推广):交易平台程序化申报、调度接口、边缘控制链路——需与外部单位联调,是二期进度的主要风险项,尽早启动接口协议对接。