EMS 设备管理

管理目标

设备管理不是简单维护一张设备表，而是把现场物理设备、慧知自研能源接入体系资源、业务归属、数据通道和控制能力建立稳定映射。系统必须回答五个问题：设备是谁、接在哪个边缘网关、由哪些资源组件构成、当前归属哪个电站、有哪些可信数据和可执行能力。

设备管理设备详情

这页给用户看的不是“设备清单”这么简单，而是每台设备的运营身份。用户能看到设备属于哪个公司、哪个电站、当前是否在线、有没有告警、关键指标是否正常，以及后续能不能参与监控、报表、收益和控制。

资源模型

EMS 将现场资源抽象为“控制器、设备组、主设备、辅助组件、能力”五个层次。同一台物理设备可能包含测量、控制、数据源和通信桥等多个组件，但对上层管理者仍表现为一个设备资源。

接入端点 hzem-prod
  └─ 边缘网关 edge10001
      ├─ Bridge modbus0
      ├─ Meter meter0
      ├─ ESS ess0
      ├─ Battery battery0
      └─ Controller ctrlEss0

业务设备：储能柜-01
  ├─ 主组件：ess0
  ├─ 辅助组件：battery0、meter0
  ├─ 通信依赖：modbus0
  └─ 控制能力：setActivePower、setMode

Bridge 属于共享通信资源，不能因为删除一个业务设备而直接删除仍被其他资源组件使用的 Bridge。资源组件 Relation 和 App Relation 用于记录依赖关系和资源来源。

设备类型

电表：有功功率、无功功率、电量、电压、电流和频率。
光伏：实时出力、日发电量、累计发电量和运行状态。
储能：SOC、充放电功率、可用电量、工作模式和告警。
PCS：交直流侧功率、电压、电流、运行状态和控制能力。
负荷与辅助设备：可按业务需要扩展负荷、环境和辅机模型。

标准指标建议

类型	核心实时指标	关键累计指标	常用控制能力
并网电表	有功/无功、三相电压电流、频率	上网/下网电量	通常只读
光伏逆变器	交流功率、直流功率、效率、状态	日/累计发电量	限功率、启停（按设备能力）
储能系统	SOC、SOH、功率、可用充放电功率	充/放电量、循环量	功率、模式、计划
PCS	交直流功率、电压、电流、温度	充/放电量、运行时长	功率、启停、模式
BMS/电池簇	SOC、SOH、单体极值、温度	循环次数、累计吞吐量	接触器/模式仅在明确授权时开放
负荷	实时功率、需量、功率因数	用电量、峰谷电量	负荷调节或开关（可选）

设备创建链路

选择目标控制器和设备模板。
系统根据模板生成标准中文表单。
提交前预览将创建或修改的资源、依赖和配置。
后端校验资源 ID、现场能力、共享组件和幂等键。
控制器离线时保存为待下发，上线后由系统触发一次安全下发。
下发完成后回读资源与能力，校验通过后设备进入活动状态。

编排任务状态机

DRAFT
  -> PRECHECK
  -> WAITING_EDGE（离线时）
  -> DISPATCHING
  -> VERIFYING
  -> ACTIVE

任一步骤 -> CONFLICT / FAILED / CANCELED
VERIFYING 超时 -> VERIFYING_TIMEOUT -> 人工核对或补偿回读

DRAFT 只保存用户输入；PRECHECK 完成参数、依赖和冲突检查；DISPATCHING 表示已调用接入中台；VERIFYING 表示等待回读边缘网关实际配置；只有配置、关系和能力均匹配时才能进入 ACTIVE。

预览结果

下发前预览应列出将创建、修改、复用和保持不变的资源，包括资源组件 ID、Factory ID、依赖 Bridge、关键配置摘要和风险提示。凭据字段只显示是否已配置，不回显明文。

冲突与失败

对已存在的资源 ID，系统进入冲突状态，不覆盖现场配置。超时请求不会立即自动重试，因为现场可能已经完成操作。管理员根据回读结果修改配置后重提，不会生成第二条重复设备。

常见冲突包括：资源组件 ID 已存在但 Factory 不同、Modbus Unit-ID 和地址重复、目标 Bridge 参数不一致、设备 SN 已绑定到其他有效电站、请求号重复但请求体不同。冲突响应要包含资源、字段、现值、期望值和建议动作。

停用而非删除

设备停用后保留主数据、配置、原始历史、告警和审计记录，但停止实时监控、告警计算、报表物化、收益计算和控制。重新启用后可按保留期创建历史补拉任务。

停用分为业务停用和现场停用。业务停用只影响 EMS 参与范围，不默认删除边缘网关资源组件；现场停用需要明确编排任务和审批。物理删除仅适用于从未产生正式数据且没有依赖关系的测试资源。

自研能源接入体系资源映射

设备资源与慧知自研能源接入体系的映射至少包含：serverEndpointId、edgeId、componentId、channelBindings。接入端点表示接入中台访问入口，不等于现场边缘网关；一个接入端点可以承载多个边缘网关，一个边缘网关可以暴露多个资源组件。映射变更必须记录前后值和生效时间，历史数据按采样时刻关联当时映射。

资源唯一性

建议使用 (endpointId, edgeId, componentId) 唯一定位资源组件，不能只用 componentId。设备 SN 在有效绑定区间内只能归属一个业务设备或电站；历史绑定关闭后可以重新绑定，但旧数据仍属于旧区间。

通道映射

慧知自研标准通道              平台标准指标
meter0/ActivePower       ->  grid.active_power_kw
ess0/Soc                 ->  ess.soc_pct
ess0/ActivePower         ->  ess.active_power_kw
pvInverter0/ActivePower  ->  pv.active_power_kw

映射配置包含方向系数、单位换算、数据类型、质量规则和生效时间。原始标准通道保留，标准指标供页面、告警和报表复用。

创建预检清单

租户、公司、电站和控制器属于当前数据范围。
边缘网关在线且资源镜像未超过能力快照 TTL（默认 5 分钟）。
资源组件 ID、协议参数、Unit-ID 和地址格式符合设备模板。
依赖 Bridge 未被其他任务占用，目标资源不存在冲突。
请求参数经过白名单校验，功率、SOC、时间和枚举值在设备能力范围内。

预检还应确认接入端点 API 与边缘网关 RPC 可用、Factory 存在、协议模板版本兼容、共享依赖引用计数、设备 SN 唯一、控制器调度顺序以及当前没有冲突的编排任务。

幂等与补偿

每次编排请求必须携带 requestNo。服务端以“租户 + requestNo”建立唯一约束，重复请求返回原任务而不是再次下发。下发后回读失败时进入 VERIFYING_TIMEOUT，由补偿任务查询边缘网关实际配置；禁止对可能已经执行的现场写命令进行无条件重试。

请求记录建议保存规范化参数哈希。相同请求号、相同哈希直接返回原结果；相同请求号、不同哈希返回幂等冲突。补偿只能推进任务状态或生成新的人工处理项，不能悄悄改变用户原始请求。

设备模板

模板拆成协议层、模型层、能力层：协议层描述 Modbus TCP、host、port、unitId；模型层定义 ActivePower、Soc、State 等标准通道；能力层定义充放电功率、启停、模式切换及参数范围。模板版本写入设备实例，通道删除不物理删除，避免历史曲线失去解释。

模板发布治理

模板具有 DRAFT/TESTING/PUBLISHED/DEPRECATED 状态。发布前至少通过配置 Schema 校验、模拟器联调、真实设备抽样和回滚验证。模板升级先生成差异预览，参数重命名、Factory 变化和通道删除属于破坏性变更，需要新主版本。

能力模型与控制约束

能力快照包含能力编码、参数 Schema、最小值、最大值、步长、枚举、单位、来源资源组件、采集时间和有效期。控制前必须使用最新有效快照，不能只依据设备类型猜测能力。

例如储能功率设定需要同时校验：

用户拥有控制按钮权限和目标电站数据范围。
边缘网关在线且能力快照未过期。
目标功率在设备充放电边界内并符合步长。
SOC、SOH、温度和故障状态允许执行。
当前不存在更高优先级控制器或互斥命令。
命令过期时间未到，requestNo 未重复。

生命周期操作

操作	业务结果	数据处理
启用	重新参与监控、告警和报表	从启用时间生效，可单独申请补拉
停用	停止业务计算和控制	历史与审计保留
换站	关闭旧绑定并创建新绑定	历史按有效区间归属
更换边缘网关	更新来源映射并验证通道	生成映射新版本，不覆盖旧血缘
更换设备	新建物理设备身份	不复用旧 SN 和累计量基线
退役	永久退出运营统计	保留归档和只读查询

接入验收

设备进入正式运营前应完成：通信稳定性、通道完整性、单位方向、累计量连续性、时钟偏差、异常码、断线恢复、控制边界、告警触发和历史补传测试。验收结果关联设备模板版本、固件版本和现场负责人。

资产数字孪生能力

设备管理模块的核心价值，是把分散在现场的电表、逆变器、PCS、BMS、储能柜、负荷支路和通信链路，整理成平台能统一管理的能源资产。平台不只记录设备名称，还记录它接在哪里、能采哪些数据、能执行哪些动作、历史属于哪个电站。这样每台设备都能被看见、被计量、被诊断，也能安全地参与调度。

能力层	高阶价值	技术表达
资产建模	统一多厂家、多协议、多形态设备	设备、资源组件、标准通道、能力快照分层建模
拓扑孪生	还原电站物理与能量关系	支持并网点、光伏、储能、负荷、通信链路的多维关系
能力画像	自动识别设备能读什么、能控什么	以能力快照驱动页面、告警、策略和控制入口
生命周期治理	设备从建设、投运、迁移到退役全程留痕	绑定区间、映射版本、审计事件和历史归属共同闭环
控制边界	将现场保护、参数范围和业务权限统一管控	控制前完成权限、在线、SOC、温度、功率、互斥命令校验

自研接入体系优势

慧知自研边缘智能网关与能源接入中台形成统一资源底座：边缘侧负责把现场设备接进来，云端负责把设备变成能管理、能计算、能分析的业务资产。相比单纯设备台账，平台把设备从“孤立硬件”升级为可参与经营决策的数字资产。

设备资源不依赖某个厂商的字段命名，而通过标准指标体系完成归一：并网功率、光伏出力、储能 SOC、充放电功率、累计电量、设备状态、告警码等指标被统一封装，后续新增厂家或型号时，上层监控、告警、报表和收益逻辑无需重写。

模块亮点

资产一张图：从公司、电站、边缘网关、设备、资源组件到标准通道形成完整资源链路，既能看业务归属，也能看现场连接关系。
能力驱动业务：设备详情、控制按钮、告警规则和报表指标都由能力模型驱动，避免前端写死设备类型。
强血缘追溯：设备换站、换表、换网关、换模板时保留生效区间，历史数据仍按当时真实归属解释。
低风险控制：所有控制命令经过能力、边界、互斥、过期和审计校验，确保平台只暴露被证明安全的动作。
规模化接入：模板化协议和标准指标降低多站点复制成本，使安装商可以批量交付、集中运维、统一验收。

典型应用场景

在工商业光储场景中，设备管理模块负责把并网电表、光伏逆变器、PCS 和储能系统编织成同一套能量关系，支撑自发自用率、上网电量、储能套利和需量控制的统一计算。在集团多站点场景中，它提供跨区域设备资产画像，帮助总部识别高故障率设备、低利用率资产和异常收益站点。在运维托管场景中，它让安装商以标准化模板快速复制交付能力，同时把每一次资源变更和控制动作沉淀为可审计证据。