摘要

在工业数字化、绿色工厂建设与 “双碳” 目标推进的大背景下，能碳管理系统已成为园区、制造企业实现能耗精细化管控、碳排放核算的核心载体。本文将结合开源项目 zhitan-ems（智碳能源管理系统），从技术架构、核心模块、功能设计、部署运维、二次开发等维度展开全面拆解，分享一套可直接落地的企业级能碳解决方案。文章全程聚焦技术实践、源码解读与场景落地，适合后端开发、物联网运维、能源信息化从业者参考学习。

一、项目背景与适用场景

随着《工业企业和园区数字化能碳管理中心建设指南》落地，传统人工统计能耗、线下填报碳数据的模式，已经无法满足绿色工厂申报、省市能耗上报、碳盘查、碳追溯等合规要求。企业亟需一套集数据采集、实时监测、能效分析、碳管理、新能源运维于一体的综合平台。

zhitan-ems 是一款基于 SpringBoot + 若依框架搭建的开源能源碳管理系统，专门面向政府、工业园区、大中型工业企业设计，完整覆盖水、电、气、热、光伏、储能、充电桩等全品类能源数据管理，同时兼容全国能耗上报标准，是开源领域中功能完整、架构成熟的能碳类项目，非常适合技术人员学习、企业私有化部署以及定制化二次开发。

二、整体技术栈与架构设计

2.1 全栈技术选型

该项目采用前后端分离架构，兼顾性能、稳定性与扩展性，技术栈贴合当下工业级开发主流方案，具体划分如下：

1. 后端技术核心框架沿用国内广受欢迎的 SpringBoot + 若依 (Ruoyi)，降低权限管理、代码生成、基础运维的开发成本；数据层采用 PostgreSQL 作为业务主库，同时搭配 InfluxDB 2.7+ 时序数据库存储海量能耗测点数据，完美适配物联网高频采集场景；缓存使用 Redis 提升接口响应速度；消息中间件基于 MQTT 协议对接现场网关、仪表设备，保障设备数据稳定上报；任务调度依赖 Quartz 实现定时数据统计、报表生成、数据清洗；安全层面整合 Spring Security 实现权限管控，接口文档集成 Swagger 便于前后端联调。

2. 前端技术前端基于 Vue 3 + Element Plus 开发，使用 Vite 作为构建工具，搭配 Vuex、Vue Router 实现状态管理与路由控制；可视化部分依托 ECharts 完成能耗大屏、趋势图、占比图、能流平衡图等图表开发，同时支持深色 / 浅色双主题切换，适配不同运维场景的使用习惯。

2.2 整体架构分层

整套系统分为三大核心组件，各司其职，解耦性极强，也是工业物联网平台的经典架构：

1. MQTT 数据采集网关：对接水表、电表、气表、光伏逆变器、储能设备等终端硬件，通过多协议采集原始数据，实时推送至时序数据库，项目单独提供网关仓库，支持软硬网关双模式部署。
2. 数据清洗服务：通过定时任务将 InfluxDB 中的时序数据进行聚合、转换、降噪，同步至 PostgreSQL 关系型数据库，支撑后续报表、统计、分析类业务查询。
3. 能碳平台后台 + Web 前端：也就是本开源仓库的核心内容，提供业务管理、数据展示、规则配置、告警管理、碳核算等全功能后台服务与可视化页面，对外提供标准 API 接口，支持第三方系统集成。

从部署架构来看，平台支持集群化部署，集成 Nacos 注册中心、Gateway 网关、Sentinel 限流熔断组件，可满足集团多分厂、大型园区的分布式使用需求。

2.3 项目目录结构解读

打开源码仓库，项目模块化划分清晰，新手也能快速定位对应功能模块，核心目录说明如下：

• bin：存放项目启停、打包、清理等批处理脚本，简化运维操作；
• zhitan-admin：项目主应用入口，包含 SpringBoot 启动类、全局配置、MyBatis 映射文件，是后端核心运行模块；
• zhitan-common：公共工具包，封装自定义注解、全局异常、通用工具类、枚举、XSS 防护组件，全项目通用；
• zhitan-framework：框架增强层，包含 MQTT 消息处理、切面编程、拦截器、短信推送、数据源管理等底层能力；
• zhitan-generator：代码生成模块，依托若依能力快速生成 CRUD 代码，提升开发效率；
• zhitan-quartz：定时任务专属模块，承载数据统计、数据补录、报表定时生成等任务；
• zhitan-system：系统基础管理模块，包含组织架构、用户角色、权限、字典等基础功能；
• zhitan-vue：前端完整源码，包含接口请求、路由、页面组件、静态资源、图表逻辑等。

模块化的设计让功能迭代、问题排查、二次开发都变得十分便捷，这也是该项目在工业场景中落地的重要优势。

三、核心功能模块拆解（结合源码与业务逻辑）

结合源码与实际业务，我将系统划分为 9 大核心业务模块，逐一讲解功能逻辑、技术实现亮点与落地价值，同时区分社区版与商业增强版的能力边界，方便大家按需使用。

3.1 数据采集与接入模块（物联网核心）

这是整个平台的数据源头，也是工业物联网项目的重难点。系统支持多协议接入各类计量仪表、新能源设备，搭配采集指标库统一管理测点信息，同时增加数据质量监控能力，自动识别断采、异常数据。针对无法自动采集的老旧设备，平台内置手动数据录入功能，兼顾新旧设备兼容。

技术亮点：基于 MQTT 协议实现设备与平台的长连接，配合边缘计算能力减轻云端压力；时序数据库 InfluxDB 专门优化海量高频测点数据存储，千万级测点数据查询依旧流畅。

3.2 运行监测与智能告警模块

1. 实时监测：提供综合看板、电力组态图、工艺流程图、网关状态、仪表状态等多维度实时视图，精准展示厂区、车间、单台设备的瞬时能耗、电压、电流、功率因数等数据，运维人员可 7×24 小时掌握现场工况。
2. 智能告警：支持为水、电、气、热等能源品类配置上下限阈值，一旦数据异常自动触发告警，告警渠道覆盖系统站内通知、短信、邮件，同时生成告警工单与告警记录，支持告警溯源、统计分析，告警及时率可达 98% 以上，提前规避设备故障与能耗浪费问题。

3.3 能效分析与对标模块（节能降碳核心）

该模块是企业挖掘节能潜力的关键，也是绿色工厂评审的重要依据，功能维度十分丰富：

• 多维能耗分析：按时间（日 / 周 / 月 / 年）、空间（厂区 / 车间 / 工序 / 设备）、能源品种做多维度统计，同时实现同环比分析，直观展示能耗波动规律；
• 尖峰平谷分析：针对电价分时计费规则，统计峰、谷、平、深谷时段的用电量与用电成本，为企业错峰用电、降低电费提供数据支撑；
• 重点设备 & 工序分析：聚焦空压机、水泵等高耗能设备，以及核心生产工序，做能耗排名、负荷分析，定位高能耗节点；
• 建筑能耗分析：精细到楼栋、楼层、支路，适配园区、商业建筑的节能管理需求；
• 能流平衡图：以可视化图表展示能源供给、消耗全流程，快速排查 “跑冒滴漏” 等管理漏洞。

社区版已覆盖以上基础分析能力，商业增强版额外提供产品单耗分析、能效对标功能，可对接企业 ERP 系统，结合产量计算单位产品能耗，并对标行业、国家先进能效指标，量化节能空间。

3.4 碳管理模块（双碳目标核心）

完全依据国家标准开发碳核算能力，助力企业完成碳盘查、碳汇报、省市能耗碳数据上报：系统根据能耗数据自动折算碳指标，实时展示碳排放总量、碳排放趋势；商业版进一步拓展碳预算、碳资产、供应链碳管理、碳核查等全生命周期能力，覆盖企业碳跟踪、碳盘查、碳交易全流程，完美支撑企业碳合规与低碳转型。

3.5 成本核算与 KPI 考核模块

1. 能源成本核算：结合能耗数据、电价 / 气价等成本数据，自动计算整体用能成本、单品能耗成本，输出多维度成本报表；
2. KPI 管理：支持企业按部门、车间下发能耗、成本类 KPI 指标，将节能目标落地到具体班组与人员，实现能源管理数字化考核。

3.6 新能源专项运营模块

针对当下光伏、储能、充电桩普及的趋势，平台内置三大专项管理子系统：

1. 光伏发电管理：实时监测光伏出力、发电效率、逆变器状态，结合LSTM 自回归 + 气象驱动双模型做发电量智能预测，同时生成发电报表、PR 值分析；
2. 储能运营管理：管控储能场站充放电状态、运行效率，配置储能调度策略，实现源网荷储协同优化；
3. 充电桩运营管理：监控充电桩实时状态、充电订单、充电量统计，完成设备运维与运营数据统计。

三大模块实现 “光伏 + 储能 + 充电桩” 一体化管理，适配新能源园区、分布式光伏电站场景。

3.7 报表与数据填报模块

平台内置强大的报表中心，支持自定义报表、峰谷用电报表、功率因数报表等行业常用报表；同时兼容全国官方能耗上报平台标准，提供标准化数据填报功能，一键导出上报格式数据，大幅减少人工填报工作量。商业版集成积木报表设计器，用户可拖拽式自定义报表样式，灵活性更高。

3.8 设备全生命周期管理

记录能耗设备从进厂、运行、维修到保养的全生命周期数据，结合实时采集数据统计设备开机时长、能耗数据，计算设备综合效率（OEE），辅助企业做好设备运维与资产管理。

3.9 系统管理与运维监控

包含用户、角色、权限、字典、设备档案等基础配置，同时提供系统日志、网关监控、服务状态监控等运维能力，保障平台长期稳定运行。商业版支持单点登录（SSO），便于与企业现有 OA、MES 等系统集成。

四、技术亮点与项目核心优势

结合源码研读与实测使用，总结该开源项目区别于其他同类项目的核心优势，也是其适合学习与落地的原因：

1. 架构成熟，工业级可用基于若依二次开发，规避了重复搭建权限、代码生成、安全框架的工作量；时序数据库 + 关系数据库的组合，完美解决物联网高频数据存储难题，架构经过实际项目验证，可直接用于生产环境。

2. 功能完整，贴合行业规范全面对标《工业企业和园区数字化能碳管理中心建设指南》，满足绿色工厂申报、能耗上报、碳核算等合规需求，功能覆盖能耗、碳、新能源、设备、成本全场景，无需大量二次开发即可满足中小企业基础需求。

3. 部署简单，容器化支持项目完整提供 Docker 镜像与部署脚本，支持一键部署 PostgreSQL、Redis、InfluxDB、MQTT 全套环境，降低部署门槛，个人学习、测试、私有化部署都十分便捷。

4. 扩展性强，二次开发友好模块化代码结构、完善的注释、标准化接口，加上若依自带的代码生成器，开发者可快速新增自定义功能、对接第三方系统；同时开放 API 服务，支持与 MES、ERP、园区平台等系统集成。

5. 双版本划分，适配不同需求分为社区版与商业增强版：社区版开源免费，覆盖绝大多数基础能碳管理功能，满足个人学习、小微企业、小型园区使用；商业版补充单耗分析、碳资产、源网荷储协同、自定义报表等企业级能力，适配大型集团、低碳园区复杂场景。

五、完整部署流程（Docker 容器化实战）

该项目主推 Docker 容器化部署，步骤清晰，下面整理通用部署流程，供大家本地测试、服务器部署使用：

5.1 前置环境准备

一台具备 Docker 环境的服务器 / 虚拟机，开放 80、5432、6379、8086、8080 等对应端口，网络可访问外网拉取镜像。

5.2 分步部署中间件

1. 部署 PostgreSQL（业务主库）拉取镜像并启动容器，初始化数据库账号、库名，之后导入项目内 zhitan-api/sql/public-v3.sql 脚本完成数据库表结构与基础数据初始化。
2. 部署 Redis（缓存）启动 Redis 容器并开启持久化，用于缓存会话、热点数据。
3. 部署 InfluxDB（时序数据库）启动容器后进入后台，创建组织（Org）、存储桶（Bucket），并复制生成的 Token，后续配置文件需要用到。
4. MQTT 服务测试环境可直接使用官方免费公共 MQTT 服务，生产环境建议自行部署 EMQ X 等私有 MQTT 服务。

5.3 部署后端 API 与前端 Web

1. 编辑项目根目录 .env.file 环境变量配置文件，依次填入数据库、Redis、InfluxDB、MQTT 的连接地址、账号、密码、Token 等信息；
2. 拉取后端 API 镜像并启动容器，映射 8080 端口；
3. 拉取前端 Web 镜像，修改后端接口地址后启动容器，映射 80 端口；
4. 访问服务器 IP 地址，使用默认账号 admin、密码 123456 即可登录系统。

5.4 补充说明

部署完成后，可访问 http://服务器IP:8080/swagger-ui/index.html 查看全部后端接口文档，方便接口调试与二次开发对接。

六、源码学习与二次开发建议

针对不同学习目标的开发者，给出差异化的学习路线，最大化发挥该开源项目的价值：

6.1 入门开发者（Java 后端 / 物联网方向）

1. 先吃透项目架构：理清 MQTT 采集 → InfluxDB 存储 → 数据清洗 → 业务库统计 → 前端展示 的全数据流，这是物联网平台的核心逻辑；
2. 研读公共模块：重点查看 zhitan-common 中的工具类、全局异常处理、权限注解，学习工业项目的编码规范；
3. 实操基础功能：基于代码生成器新增一张业务表，完成简单的 CRUD 开发，熟悉若依框架的使用逻辑。

6.2 进阶开发者（物联网平台开发）

1. 深挖 MQTT 数据接收逻辑：查看 zhitan-framework 下 MQTT 相关代码，学习设备上下线、消息订阅、数据解析的实现；
2. 研究时序数据库应用：分析项目中 InfluxDB 的数据写入、聚合查询逻辑，掌握时序数据库在能耗场景的最佳实践；
3. 拆解定时任务：查看 Quartz 定时任务模块，学习海量数据定时统计、数据补全、报表生成的实现方案。

6.3 企业二次开发（私有化定制）

1. 功能定制：基于现有模块扩展定制化报表、专属告警规则、区域权限隔离等功能；
2. 硬件对接：根据现场仪表协议，新增采集解析逻辑，对接非标物联网设备；
3. 系统集成：基于开放 API，实现与企业 ERP、MES、园区管理平台的数据互通；
4. 界面定制：修改 Vue 前端源码，调整页面布局、菜单、主题，适配企业品牌风格。

七、开源协议与社区交流说明

zhitan-ems 采用 AGPL + ZTPL 双开源协议，使用时需遵守对应规则：

1. AGPL 协议：个人开发者、高校、研究机构可免费用于学习、研究、非商业场景；若修改源码并对外使用，需同步开源修改后的代码。
2. ZTPL 商业协议：若将项目修改后用于商业售卖、SaaS 服务、企业内部闭源部署、对外收费服务等场景，需要联系官方获取商业授权。

项目配套完善的社区支持，可通过仓库内置 Wiki 查阅详细开发文档、用户手册；也可加入官方 QQ 技术交流群，和同行交流问题、分享落地经验。

八、总结

zhitan-ems 作为一款开源能碳能源管理系统，架构扎实、功能贴合行业刚需、部署简单、二次开发友好，既是 Java 后端、物联网开发者学习工业级项目的优质案例，也是中小制造企业、园区快速搭建能碳管理平台的低成本解决方案。

在双碳与工业数字化的大趋势下，能碳管理、物联网数据采集、能耗分析等相关技术会持续成为行业热点。建议感兴趣的开发者拉取源码本地部署运行，结合本文的架构与模块拆解，一步步吃透技术细节；有企业落地需求的团队，也可基于社区版快速验证业务，再根据实际场景选择定制开发或商业版本。

这套开源方案打通了 “硬件采集 - 数据存储 - 业务分析 - 可视化展示 - 合规上报” 的全链路，无论是技术学习还是商业落地，都具备很高的参考价值。