EMS_Platform

企业能耗管理平台 (EMS)

本项目基于 Golang 后端 + Vue 3 前端 + Docker 容器化部署架构构建，支持企业级电力监控与数据分析。

项目结构

.
├── backend/            # Golang 后端 (Gin + GORM)
├── frontend/           # Vue 3 前端 (Vite + TypeScript)
├── configs/            # 配置文件 (Nginx 等)
├── data/               # 数据持久化目录 (自动生成)
├── docker-compose.yml  # 生产环境容器编排
├── docker-compose.wsl.yml # WSL 开发环境容器编排
└── README.md           # 说明文档

快速开始

1. 环境准备

确保已安装 Docker & Docker Compose。

2. 开发环境启动 (WSL / 本地调试)

适用于开发人员，端口全开放，方便数据库工具直连调试。

# 启动开发环境服务栈
docker-compose -f docker-compose.wsl.yml up -d --build

访问地址:

• Web 界面: http://localhost (Nginx)
• 后端 API: http://localhost:8080 (直连后端，方便调试)
• PostgreSQL: localhost:5433 (用户: ems_user / 密码: ems_pass)
• TDengine: localhost:6030
• Redis: localhost:6379
• EMQX (MQTT): localhost:1883 (TCP), Dashboard: localhost:18083 (admin/public)

3. 生产环境部署 (Production)

适用于正式服务器部署，安全性更高，数据库端口仅限内网访问。

# 启动生产环境服务栈
docker-compose up -d --build

访问地址:

• Web 界面: http://YOUR_SERVER_IP
• API 接口: 统一通过 Nginx 转发，例如 /api/v1/...
• 数据库: 默认仅监听 127.0.0.1，不对外网暴露端口。

4. 本地源码运行 (非 Docker)

如果您想在本地单独运行前后端代码进行调试：

后端 (Golang)

cd backend
go mod tidy
# 确保本地已启动必要的数据库 (Postgres, TDengine, Redis)，或修改配置指向 Docker 服务
go run main.go

前端 (Vue 3)

cd frontend
npm install
npm run dev
# 开发服务器启动在 http://localhost:5173

技术栈详情

• 核心服务: Golang (Gin), Vue 3 (TypeScript, Element Plus)
• 数据存储:
  • PostgreSQL: 存储用户、设备、告警规则等元数据
  • TDengine: 高性能时序数据库，存储电力、传感器历史数据
• 中间件:
  • Redis: 缓存与即时状态
  • EMQX: MQTT 消息代理，处理物联网设备接入
  • Nginx: 反向代理与静态资源服务