本项目是一个基于 Spring Boot 3.1.5 + Java 17 的xx数据后台服务,围绕"电力采集数据归档"与"电费财务报表推送"两大业务展开:系统每 5 分钟从 InfluxDB 时序库拉取各测点的电力采集数据(电压、电流、功率、电能等),按设备聚合成电力数据日志落库到达梦数据库;同时通过定时任务解析财务部门产出的《xx电费财务报表(财务版)》Excel,提取用电大类、公司、责任部门、电量电费等明细,组装为标准 JSON 并携带 token 推送至外部互动物流服务平台,实现电费数据(日报/月报)的自动上报,并提供网页上传、手动补推、测点清单导出等辅助功能。
1. 电力采集数据五分钟归档(AsyncFiveMinuteTask)
每 5 分钟异步执行一次,按"整 5 分钟区间"从 InfluxDB(smart_edge 库)查询各通讯机/节点/测点的最新采集值;
内置中文名称→字段缩写映射(如 正向有功总电能→EPZ、A相电压→VA、分时费率尖峰平谷电能等 20 余项);
按设备聚合为一条 PowerDataLog 记录(数值保留三位小数,时间统一转为北京时间),批量写入达梦数据库。
2. 电费财务报表定时解析与推送(ExcelToJson + HttpClientService)
每天 04:00 读取 /home/reports/{前一日}财务报表.xls(日报),每月 21 号 05:00 处理上月月报;
使用 Apache POI 解析"港区电费财务报表(财务版)"工作表,识别一级用电大类((一)(二)(三)…)、公司编码/名称、责任部门、用电区域、线路设备,以及当日电量、电费、不含税电费,并区分明细行与小计/合计/共计行;
组装为结构化 JSON 后,先调用平台 validate 接口以加密账号换取 token,再将数据推送至 ElectricityBillDataReceive 电费账单接收接口(billType 按日期格式自动区分"日/月")。
3. 手动上传与测试补推(ExportController + HtmlController)
POST /export/publish:配合 pushFile.html 页面手动上传报表文件,自动从文件名识别日报/月报类型并推送;
GET /export/publish/test:测试推送,不传参数按定时任务规则读昨天报表,?date= 指定日期,?file= 指定本地文件路径补推;
GET /export/publish/getToken:单独验证 token 获取链路;
GET /export/nodePoints:导出通讯机/节点/测点清单 CSV(带 UTF-8 BOM,Excel 可直接打开)。