vpp-ai-platform/docs/06-integration.md
2026-09-01 19:46:59 -04:00

64 lines
3.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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