光伏新能源管理平台接口功能说明书

1. 系统概述

2. 功能模块与接口说明

2.1 核心与工具模块

• 网络与配置：
  • 接口请求与响应的全局拦截处理。
  • 获取系统调试配置文件列表、下发调试配置。
• 文件服务：提供文件上传与下载功能。
• 日志服务：记录系统的增删改操作日志，并支持分页查询与日志还原。
• 消息中心：判断当前登录用户是否存在未读消息。

2.2 用户认证与权限管理

• 用户认证：
  • 用户登录、刷新访问令牌。
  • 获取当前登录用户的用户名、角色、令牌过期时间等信息。
  • 刷新用户在线心跳。
• 用户管理：
  • 用户注册、修改手机号（发送/验证验证码）、忘记密码、更新密码。
  • 获取/修改用户基本信息、头像。
  • 获取用户列表、新建账户、修改/删除账户、邀请子用户或租户。
• 角色与权限：
  • 功能管理：对系统路由、功能键进行增删改查，管理功能树和权限。
  • 角色管理：管理用户角色及权限。
  • 供应商角色管理：管理供应商专属的角色、用户及电站绑定关系。
• 租户与公司管理：
  • 租户管理：租户的增删改查、权限分配、功能管理。
  • 公司/供应商管理：公司及供应商信息的查询、新增、修改、删除。

2.3 电站综合管理

• 电站信息：
  • 获取用户或租户下所有电站的信息、列表、地区分布。
  • 新增、修改、删除电站信息，更新电站坐标。
  • 获取电站主页、合同详情、数据分析看板所需数据。
  • 判断电站激活状态，初始化电站默认收益计算公式。
• 电站收益：
  • 获取电站的收益数据列表。
  • 计算电站收益，并可依据不同时间维度更新收益数据。
• 收益定制分析：
  • 管理收益计算的自定义公式（增删改查）。
  • 更新电站的计算方式、显示间隔等配置。

2.4 设备全生命周期管理

• 设备管理：
  • 获取电站下的设备列表、数量、详细信息。
  • 新增、保存、修改、删除设备信息。
  • 获取设备采集数据、报警日志。
  • 检查并导出设备采集数据。
• 设备类型与模板：
  • 获取所有设备类型，并进行增删改管理。
  • 管理设备模板及其关联的变量、字典。
• 设备监控与配置：
  • 管理监控设备（增删改查）。
  • 获取租户监控数据、应用密钥。
• 扫码与调试：
  • 判定设备是否可添加，获取可扫码设备列表。
  • 测试采集、正式下发采集、重置设备、获取待定设备列表。
• 逆变器专项管理：
  • 获取逆变器结构图、基础数据、运行统计、日历图表。
  • 获取组串数据，进行逆变器对比。
• 智能设备：
  • 喷水/控制系统配置：管理设备、实验组、对比方案组、策略。
  • 监控与控制：获取阀门、水泵、气象数据状态，远程开关阀门/水泵，修改频率，顺序控制，开关低温保护。
  • 获取监控地址、最新抓拍画面。

2.5 数据监控、分析与预测

• 实时数据查看：
  • 查询设备属性配置及其采集数据。
• 大屏可视化：
  • 运维大屏：获取全国/省市电站数据、故障统计、效率分析、功率曲线、云图。
  • 三合一大屏：计算发电量、发电功率、收益趋势、辐照度趋势。
• 气象与预测：
  • 获取电站当地实时天气、历史天气详情，并可导出天气数据。
  • 获取彩云天气的发电量、辐照度、温度预测，并进行预测与实际值对比。
• 高级分析（思维导图/结构图）：
  • 逆变器结构管理：对逆变器、组串、关断器、网关的数据结构进行增删改查、树形结构维护。
  • 设备控制：一键关断/优化、开关优化器/关断器、开启追踪蜂鸣器。
  • 数据分析：获取关断器历史数据、数据对比、详情页、收藏对比。
• 策略监控：
  • 管理策略表，获取策略执行日志。
  • 查看策略监控信息，可关闭指定策略。

2.6 运营与工单管理

• 电价管理：
  • 管理地方电价、国网电价。
  • 自定义电价时段（尖峰平谷），支持按日、月批量增删改时段和导入数据。
• 告警配置：管理租户级别的报警规则配置。
• 工单管理：
  • 巡检配置：管理巡检计划和任务模板。
  • 工单流程：新增、获取、审核、统计各类型工单，获取工单详情与状态。
  • 自动工单：管理自动工单的创建、修改、删除、开启/关闭，查看执行记录。

2.7 系统与基础服务

• 字典与枚举：管理系统标签字典、枚举字典，支持树形结构管理。
• 自定义设置：管理用户自定义快捷键、租户UI主题与样式。
• 地理位置：通过经纬度与地理位置互查，获取行政区划数据。