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

3.6 KiB
Raw Blame History

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. 接口清单的落实节奏(对应实施计划)

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