📚 文档中心

完整的技术文档、需求说明和架构设计

📋 需求文档

版本: v1.0 | 更新时间: 2026-03-21 | 状态: ✓ 完成

详细的业务需求分析、功能列表和用户场景描述。

📖 查看完整文档
✓ 业务需求

详细的充电桩管理业务流程和功能需求

✓ 用户场景

管理员、运营、运维多角色的使用场景

✓ 功能清单

完整的功能模块清单和优先级划分

✓ 非功能需求

性能、安全、可靠性等非功能要求

🏗️ 技术方案

版本: v1.1 (最新) | 更新时间: 2026-03-21 | 状态: ✓ 完成

详细的技术架构设计、技术选型和实现方案。

📘 v1.1 (最新) 📗 历史版本
✓ 系统架构

Spring Cloud 微服务架构设计

✓ 模块设计

10+ 微服务模块的详细设计

✓ 数据库设计

30+ 表的完整ER模型和DDL语句

✓ API设计

前后端接口规范和数据结构定义

版本历史

v1.1 明确7项待确认事项，完整的技术方案和风险评估 2026-03-21
v1.0.2 核心数据表增加SQL建表语句 2026-03-21
v1.0.1 优化可视化展示和组织结构 2026-03-21
v1.0 初始版本，基础技术方案 2026-03-21

📊 工作总结

日期: 2026-03-22 | 进度: 95% 完成

详细的项目开发进展、完成情况和技术成果总结。

📈 查看详细总结
20+ 模块

已完成全部核心功能模块

50+ API

完整的后端接口实现

2 端应用

管理后台 + 小程序完整UI

95% 进度

即将进入测试和部署阶段

🏛️ 系统架构

完整的系统架构设计和技术栈说明。

整体架构

采用 Spring Cloud 微服务架构，包含以下主要组件：

  • API 网关 (Gateway): 请求路由、认证、限流
  • 微服务模块: 业务逻辑分离、独立部署
  • 服务注册中心 (Nacos): 服务自动发现和配置管理
  • 缓存层 (Redis): 分布式缓存和会话管理
  • 消息队列 (RocketMQ): 异步处理和事件驱动
  • 数据持久化 (MySQL): 核心数据存储

服务模块

模块名 功能描述 端口
API 网关 请求入口、路由转发、认证 8080
管理服务 登录认证、用户管理、权限控制 8081
业务服务 设备管理、订单、计费、结算 8082
小程序服务 用户、站点、充电、订单 8083
定时任务 定时任务、报表生成、数据清理 8084
代理模块 代理商管理、分账结算 8085

技术栈

后端

Spring Boot 2.7
Spring Cloud 2022
JPA + Mybatis

前端

Vue 3 + Vite
Element Plus
ECharts

移动

微信小程序
Vant Weapp
原生开发

基础设施

Docker Compose
MySQL 8.0
Redis 6.0+

📦 完成的模块

已完成的所有核心功能模块清单。

✅ 登录认证模块

账号密码登录、短信验证码登录、JWT Token管理、网关认证过滤器

✅ 设备管理模块

区域、站点、充电桩、充电枪四级结构管理

✅ 订单模块

充电下单、停止、状态查询、实时数据更新

✅ 运营大盘模块

统计数据、营收趋势、排行、告警、设备状态

✅ 结算分账模块

分账配置、结算单、对账核销、完整分账流程

✅ 运维工单模块

工单管理、运维人员、巡检记录、工作流

✅ 系统管理模块

操作日志、消息通知、RBAC角色、权限管理

✅ 小程序后端

用户、站点、充电、订单、钱包完整功能

✅ 定时任务服务

设备检查、订单结算、数据清理、报表生成

✅ 代理模块

代理商管理、结算、钱包、两级代理结构

✅ 小程序前端

完整页面架构、API封装、工具系统

✅ 管理后台前端

Vue 3 + Element Plus、完整业务页面、ECharts可视化

🗄️ 数据库设计

系统包含多个数据库，共 30+ 核心数据表。

数据库列表

数据库名 描述 表数量
energy_main 核心业务数据库 15+
energy_operation 运营统计和工单数据 8+
energy_settlement 结算和分账数据 4+
energy_system 系统管理和操作日志 5+
mini_db 小程序业务数据 7+
energy_agent 代理商相关数据 4+

所有数据库表都已生成完整的 SQL 建表语句，详见技术方案文档。

🚀 部署指南

本地开发环境和线上部署的详细指南。

本地开发环境

1. 启动基础设施

cd /Users/xiege/WorkBuddy/charging/source
docker-compose up -d

启动 Nacos、MySQL、Redis、RocketMQ 等基础服务

2. 启动微服务

# 编译项目
mvn clean install

# 启动各微服务
mvn -pl energy-gateway spring-boot:run
mvn -pl energy-admin spring-boot:run
mvn -pl energy-service spring-boot:run

3. 启动 Portal 门户

cd /Users/xiege/WorkBuddy/charging/portal
python3 -m http.server 8000

访问: http://localhost:8000

云端部署

📌 腾讯云部署

项目已准备好腾讯云部署。计划使用：

  • 腾讯云 CVM 服务器
  • 云数据库 MySQL
  • 云 Redis
  • 容器服务 TKE （可选）
💡 提示

详细的部署文档和配置示例会在测试完成后补充。 目标上线时间：2026年3月31日