# 100Charge基于若依的开源充电运营平台

**Repository Path**: ustcyc/100charge

## Basic Information

- **Project Name**: 100Charge基于若依的开源充电运营平台
- **Description**: 开源充电运营平台，充电桩管理系统，开源充电桩平台，充电桩管理平台，全面兼容多个主流充电桩品牌，服务于园区、车企、物流、桩企及政务等多种场景。
产品基于轻量级设计理念，易使用功能强大，满足中小规模企业的需求。架构设计采用高可扩展架构，可轻松支撑城市级规模充电网络的运营管理。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: develop1.0
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 439
- **Forks**: 213
- **Created**: 2024-08-26
- **Last Updated**: 2025-12-13

## Categories & Tags

**Categories**: erp

**Tags**: 充电管理系统, 中小充电场站主, 充电, 充电运营, 充电桩

## README

<p align="center"><img src='https://gitee.com/ustcyc/100charge/raw/master/images/LOGO.png'  height="100" width="231"></img></p>
<p align="center" style="margin: 30px 0 30px; font-weight: bold;font-size: larger;">100Charge基于若依的开源充电运营平台</h1>
<p align="center">基于SpringBoot和若依框架开发</p>

<p align="center">
    <a href='https://gitee.com/ustcyc/100charge/stargazers'><img src='https://gitee.com/ustcyc/100charge/badge/star.svg?theme=dark' alt='star'></img></a>
    <a href='https://gitee.com/ustcyc/100charge/members'><img src='https://gitee.com/ustcyc/100charge/badge/fork.svg?theme=dark' alt='fork'></img></a>
</p>

# 一 项目背景

    我们团队在新能源充电领域深耕多年，深刻理解中小型充电场站在运营中面临的核心需求与实际痛点。为此，团队决定将多年积累的行业经验与技术成果开源，通过共享力量，帮助广大充电站站长降本增效，轻松应对日常运营挑战。同时也为准备进入该领域的创业者，提供一套经过实际验证过的解决方案，助力业务快速落地与商业验证。

## 1.项目价值

    针对中小充电站场站主 “数字化门槛高、落地周期长、技术门槛高” 的痛点，开源系统提供两大关键支撑：

* **快速接入充电桩**：无需技术开发即可轻松接入主流品牌充电桩，还可以实现设备数据轻松上传云端，降低场站数字化改造难度以及实施成本；
* **业务直达用户**：支持微信小程序端，让充电业务快速触达终端用户，用户可通过小程序完成找桩、预约、充电、支付全流程，助力场站主快速搭建线上服务渠道，提升用户体验与运营效率。
  
  

## 2.功能介绍

    **100Charge**充电运营系统以 “快速落地、轻松上云、轻量运营”为核心目标。系统具有四大核心功能模块，具体如下：

* **充电桩管理**：实现对充电桩设备的集中化管控，支持设备状态实时监控、远程参数配置，确保设备稳定运行，轻松管理。

* **场站管理**：覆盖场站基础信息维护、运营状态可视化展示，帮助场站主高效管理线下场地资源，提升场地利用效率。

* **计费策略**：提供灵活可配置的计费规则设置功能，支持按峰谷时段等多维度自定义计费方案，满足不同场景下的定价需求。

* **订单管理**：自动记录充电订单详情（如充电时长、电量、费用等），支持订单查询、统计与导出，实现充电业务流水的清晰化管理
  
  ## 

## 2.小程序截图

<div>
<img height="600px" style="display: inline-block; margin: 5px;" src='https://gitee.com/ustcyc/100charge/raw/master/images/home.jpg' alt="首页">
<img  height="600px" style="display: inline-block; margin: 5px;" src='https://gitee.com/ustcyc/100charge/raw/master/images/search.jpg' alt="搜索">
<img  height="600px" style="display: inline-block; margin: 5px;" src='https://gitee.com/ustcyc/100charge/raw/master/images/charging-confirm.jpg' alt="充电确认">
<img  height="600px" style="display: inline-block; margin: 5px;" src='https://gitee.com/ustcyc/100charge/raw/master/images/charging.jpg' alt="充电中">
<img  height="600px" style="display: inline-block; margin: 5px;" src='https://gitee.com/ustcyc/100charge/raw/master/images/my.png' alt="我的">
<img  height="600px" style="display: inline-block; margin: 5px;" src='https://gitee.com/ustcyc/100charge/raw/master/images/orders.jpg' alt="订单列表">
<img  height="600px" style="display: inline-block; margin: 5px;" src='https://gitee.com/ustcyc/100charge/raw/master/images/station-detail.jpg' alt="详情">
</div>

## 3.运营系统截图

### 3.1 社区版

<center>
<div style="text-align: center">
<img  style="display: inline-block; margin: 5px;" width="45%" src="./images/8c335577-5ed4-4ccc-b9c6-727651448753.png" title="" alt="首页" data-align="center">
<img  style="display: inline-block; margin: 5px;"  width="45%" src="./images/充电实况.png" title="" alt="充电实况" data-align="center">
<img  style="display: inline-block; margin: 5px;" width="45%" src="./images/e73f6aff-96ad-4149-b71b-4e802e379760.png" title="" alt="充电订单" data-align="center">
<img  style="display: inline-block; margin: 5px;"  width="45%" src="./images/4bfde706-226e-44ea-82ef-7a822fdc61f7.png" title="" alt="订单详情" data-align="center">
</div>
</center>

### 3.2 标准版

# 二 版本对比

    我们提供两种版本，以满足不同阶段和规模的用户选择：

## 1.社区版

    如果您想快速推进业务落地，社区版是适合的选择，它包含的四项核心功能足以满足您的需求。社区版包含了稳定可靠的充电桩管理，计费策略，订单管理。助力您快速低成本开启充电场站运营。

## 2.标准版

    如果你要想要更精细化的运营与管理，标准版将是您的最佳选择。在**社区版**的基础上，额外提供了企业级的高阶运营功能，比如多维度的数据分析，营销工具等。并且提供官方技术保障与支持，满足复杂的商业场景。

## 3.功能对比

| 父模块  | 子模块     | 社区版 | 标准版 |
| ---- | ------- | --- | --- |
| 首页   | 首页      | √   | √   |
| 订单管理 | 订单管理    | √   | √   |
| 客户运营 | 个人用户    | √   | √   |
|      | 用户车辆    | √   | √   |
|      | 企业客户    | ×   | √   |
|      | 车队管理    | ×   | √   |
|      | 卡管理     | ×   | √   |
|      | 白名单管理   | ×   | √   |
| 场站运营 | 场站管理    | √   | √   |
|      | 充电桩管理   | √   | √   |
|      | 计费策略    | √   | √   |
| 财务管理 | 用户余额变动  | √   | √   |
|      | 企业余额变动  | ×   | √   |
|      | 结算单查询   | ×   | √   |
| 发票管理 | 发票管理    | ×   | √   |
| 营销活动 | 营销策略    | ×   | √   |
|      | 优惠券管理   | ×   | √   |
|      | 券使用记录   | ×   | √   |
|      | 文章管理   | ×   | √   |
|      | 轮播图管理   | ×   | √   |
| 运营商  | 运营商管理   | ×   | √   |
|      | 运营商分润管理 | ×   | √   |
| 运维管理 | 运维报表    | ×   | √   |
|      | 报文管理    | ×   | √   |
| 报表   | 账户充值明细  | ×   | √   |
|      | 电站失败率报表 | ×   | √   |
|      | 失败记录明细  | ×   | √   |
|      | 多维度分析   | ×   | √   |
|      | 运营报表    | ×   | √   |
|      | 电站数据报表  | ×   | √   |
|      | 订单扣费明细  | ×   | √   |
|      | 账户信息汇总  | ×   | √   |
|      | 电站运营状况  | ×   | √   |
|      | 终端利用率   | ×   | √   |
|      | 企业收退款报表 | ×   | √   |
|      | 尖峰平谷统计  | ×   | √   |
|      | 车辆峰谷统计  | ×   | √   |
| 系统监控 | 系统监控    | √   | √   |

# 三 演示系统

|     | 地址                                                                                          | 用户名与密码              |
| --- | ------------------------------------------------------------------------------------------- | ------------------- |
| 小程序 | <img  width="150px"   src="./images/wxp.jpg" title="" alt="wechat.jpg" data-align="center"> |                     |
| 社区版 | https://demo-admin.100charge.cn/                                                       | admin <br> admin123 |
| 标准版 | TODO                                                                                        | TODO                |

# 四 开发环境

## 1 项目结构

```
100charge/
├─ charging-api/                    # 后端（多模块 Maven 聚合工程，业务与支撑服务）
│  ├─ pom.xml                       # 父 POM：统一依赖 & 版本管理 (Spring Boot 2.6.x, Java 8 -> 计划升级 21)
│  ├─ start.bat / start.sh          # 启动脚本（打包 & 运行封装）
│  ├─ sql/                          # 数据库初始化脚本
│  │  ├─ BaseAdminAPI.sql
│  │  └─ postgresql/                # 分步骤建库脚本（step1/step2）
│  ├─ xingchuan-admin/              # Admin 接口层模块（可能聚合管理端业务入口，Controller/接口适配）
│  ├─ xingchuan-framework/          # 框架核心：基础配置、通用组件（安全、异常、日志、序列化等）
│  ├─ xingchuan-system/             # 系统业务模块：用户、角色、权限、配置、认证集成等
│  ├─ xingchuan-quartz/             # 定时任务调度模块（Quartz 封装，任务定义 & 执行管理）
│  ├─ xingchuan-generator/          # 代码生成模块（基于 Velocity/模板生成 CRUD、前端页面等）
│  ├─ xingchuan-common/             # 通用工具类：POJO、枚举、工具方法、常量、通用响应封装
│  └─ target/                       # 编译输出（各子模块也有各自 target）
│
├─ charging-web/                    # Vue3 + Vite 管理后台前端
│  ├─ package.json                  # 前端依赖 (Vue3, ElementPlus, Pinia, Axios, ECharts)
│  ├─ vite.config.js                # Vite 构建配置（按环境区分 dev/staging/prod）
│  ├─ src/
│  │  ├─ main.js                    # 入口文件（注册全局组件、路由、状态）
│  │  ├─ App.vue
│  │  ├─ permission.js              # 路由权限守卫（token/role 校验）
│  │  ├─ systemConfig.js            # 系统常量或运行时配置
│  │  ├─ api/                       # 后端接口封装（Axios 封装、模块化 API）
│  │  ├─ assets/                    # 静态资源（样式、图片、图标）
│  │  ├─ components/                # 通用业务组件（表格、上传、富文本、选择器等）
│  │  ├─ directive/                 # 全局指令（权限指令、焦点指令等）
│  │  ├─ layout/                    # 主布局（侧边栏、头部、标签页容器）
│  │  ├─ plugins/                   # 插件注册（图标、富文本、SVG 等）
│  │  ├─ router/                    # 路由定义（动态菜单/权限路由）
│  │  ├─ store/                     # Pinia 状态（用户、菜单、设置）
│  │  ├─ utils/                     # 工具方法（请求封装、缓存、加解密）
│  │  └─ views/                     # 业务页面（用户管理、订单管理、统计报表等）
│  └─ public/                       # 公共静态资源
│
├─ charging-mini/                   # 微信/小程序 & H5 端（基于 uni-app）
│  ├─ package.json                  # 依赖 (uview-ui, echarts, md5 等)
│  ├─ pages.json / manifest.json    # 页面与应用配置（路由/窗口/运行时）
│  ├─ main.js                       # 入口初始化（全局组件 & 请求封装挂载）
│  ├─ App.vue
│  ├─ uni.scss / common.scss        # 全局样式/主题
│  ├─ components/                   # 复用组件（站点卡片、地图、搜索、优惠券等）
│  │  ├─ home-map/
│  │  ├─ home-station-card/
│  │  ├─ tabbar/
│  ├─ config/
│  │  ├─ api.js                     # 后端接口地址集中管理
│  │  ├─ request.js                 # 请求封装（拦截器、token 注入）
│  │  └─ md5Utils.js                # 加密/签名工具
│  ├─ pages/
│  │  ├─ index/                     # 首页/个人中心/启动页
│  │  ├─ login/                     # 登录流程（手机号/验证码/微信授权）
│  │  ├─ scan/                      # 扫码充电入口
│  │  ├─ stations/                  # 站点列表 & 地图模式
│  │  └─ wode/                      # 我的订单/账户/优惠券等
│  ├─ utils/                        # mixin、通用方法
│  ├─ wxcomponents/                 # 微信官方组件（隐私弹窗等）
│  └─ static/                       # 图片/脚本资源

```

## 2. 依赖组件

```mermaid
flowchart TB
    WEB[Web 云平台<br/>Vue3 + Vite]
    MINI[微信小程序<br/>uni-app]

    WEB --> APP[充电桩管理系统<br/>Spring Boot 应用]
    MINI --> APP

    APP --> PG[(PostgreSQL 14+<br/>业务数据存储)]
    APP --> REDIS[(Redis 6.2+<br/>缓存/会话)]
    APP --> MQ[(RocketMQ 4.9.4<br/>消息队列)]
    APP --> WECHAT[微信支付 API<br/>外部服务]

    PG -.-> PGDATA[业务数据<br/>用户订单<br/>场站桩枪]
    REDIS -.-> RCACHE[会话缓存<br/>Token<br/>验证码]
    MQ -.-> MQMSG[消息队列<br/>充电指令<br/>订单通知]
    WECHAT -.-> PAY[支付退款<br/>余额充值]

    style WEB fill:#409EFF,stroke:#1976D2,stroke-width:3px,color:#fff
    style MINI fill:#07C160,stroke:#059748,stroke-width:3px,color:#fff
    style APP fill:#4CAF50,stroke:#2E7D32,stroke-width:3px,color:#fff
    style PG fill:#336791,stroke:#1a4d6d,stroke-width:2px,color:#fff
    style REDIS fill:#DC382D,stroke:#a72822,stroke-width:2px,color:#fff
    style MQ fill:#D77310,stroke:#a85a0a,stroke-width:2px,color:#fff
    style WECHAT fill:#07C160,stroke:#059748,stroke-width:2px,color:#fff

    style PGDATA fill:#E3F2FD,stroke:#1976D2,stroke-width:1px
    style RCACHE fill:#FFE0B2,stroke:#F57C00,stroke-width:1px
    style MQMSG fill:#FFF9C4,stroke:#F9A825,stroke-width:1px
    style PAY fill:#C8E6C9,stroke:#388E3C,stroke-width:1px
```

# 六 快速部署

项目提供简易部署命令，可供您快速部署，学习并使用。**请勿该部署方式应用于生产环境**，请按照以下顺序进行执行部署

## 1. 数据库

```bash
# 拉取镜像
docker pull docker.1ms.run/library/postgres:14-alpine
docker tag docker.1ms.run/library/postgres:14-alpine postgres:14-alpine

# 启动容器
docker run -d \
  --name charging-postgres \
  --restart always \
  -p 5432:5432 \
  -e POSTGRES_DB=charge \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=postgres \
  -e TZ=Asia/Shanghai \
  postgres:14-alpine


```

## 2. Redis

```bash
# 拉取镜像
docker pull docker.1ms.run/library/redis:6.2.21
docker tag docker.1ms.run/library/redis:6.2.21 redis:6.2.21

# 启动容器
docker run -d \
  --name charging-redis \
  --restart always \
  -p 6379:6379 \
  redis:6.2.21 \
  redis-server --appendonly yes
```

## 3. RocketMQ

```bash
# 拉取镜像
docker pull docker.1ms.run/xuchengen/rocketmq
docker tag docker.1ms.run/xuchengen/rocketmq xuchengen/rocketmq:latest

# 启动容器
docker run -itd \
 --name=rocketmq \
 --restart=always \
 -p 9876:9876 \
 -p 10909:10909 \
 -p 10911:10911 \
 -p 10912:10912 \
 -v /etc/localtime:/etc/localtime \
 -v /var/run/docker.sock:/var/run/docker.sock \

 xuchengen/rocketmq:latest
```

## 4. 数据库初始化

执行SQL脚本,请按照顺序依次执行。

- `charging-api/sql/postgresql/db1.sql` - 表结构以及初始化数据
- `charging-api/sql/postgresql/db2.sql` - 重置主键序列

## 5. API服务

拉取官方镜像

```shell
docker pull docker.1ms.run/100charge/charging-api:latest
docker tag docker.1ms.run/100charge/charging-api:latest 100charge/charging-api:latest
```

部署镜像

```shell
docker run -d \
  --name charging-api \
  -p 8080:8080 \
  -e TZ=Asia/Shanghai \
  -e JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC -XX:MaxGCPauseMillis=200" \
  -e DB_HOST=数据库所在IP \
  -e DB_PORT=数据库端口 \
  -e DB_NAME=数据库名称 \
  -e DB_USER=数据库账号 \
  -e DB_PASSWORD=数据库密码 \
  \
  -e REDIS_HOST=Redis所在IP \
  -e REDIS_PORT=Redis端口 \
  -e REDIS_DATABASE=0 \
  -e REDIS_PASSWORD= \
  \
  -e ROCKETMQ_NAME_SERVER=RocketMQ所在IP:端口 \
  \
  -e DRUID_USERNAME=admin \
  -e DRUID_PASSWORD=123456 \
  \
  -v /adminLogs:/app/adminLogs \
  -v /uploadPath:/app/uploadPath \
  -v /apiclient_key.pem:/app/certs/apiclient_key.pem:ro \
  --restart=always \
  100charge/charging-api:latest
```

## 6. Web运营平台

拉取官网镜像

```shell
docker pull docker.1ms.run/100charge/charging-web:latest
docker tag docker.1ms.run/100charge/charging-web:latest 100charge/charging-web:latest
```

部署镜像

```shell
docker run -d \
  --name charging-web \
  -p 80:80 \
  -e API_BASE_URL=/prod-api \
  -e BACKEND_URL=http://API服务IP:端口 \
  -e APP_TITLE=充电桩管理系统 \
  -e APP_ENV=production \
  -e APP_SYSTEM=行川 \
  --restart=always \
  100charge/charging-web:latest
```

访问Web运营平台IP和端口,使用测试账号：

```
账号：admin
密码：admin123
```

![1ae10411-3701-44b1-b58b-8d9c2d1782cf](./images/1ae10411-3701-44b1-b58b-8d9c2d1782cf.png)

# 七 版权须知

    本软件项目（包括但不限于源代码、文档、图片、配置等所有构成项目的材料）的原始版权和知识产权归 **[山东行川新能源科技有限公司]** 所有。我们保留对本项目名称、品牌、Logo、专利以及商业许可的所有权利。未经明确授权，任何个人或组织不得使用与本项目相关的名称、标识进行商业性宣传或推广。



# 八 贡献代码

## 1. 如何提交代码

    良好的团队协作的前提是，有一个清晰的代码规范，便于其他人理解。在您提交代码前，请您熟悉[《阿里巴巴Java开发手册》](https://developer.aliyun.com/ebook/386)的代码规范

## 2. 如何提交缺陷反馈

* 您已搜索过现有Issues，确保没有重复问题

* 您已确认这不是我本地环境导致的问题

* 您已提供足够的信息供开发人员复现问题

* 提交时，您已正确选择标签：bug

## 3. 如何提交需求

* 您已搜索过现有需求，确保没有重复需求

* 我已详细描述需求的背景，如我作为一个运营人员，我想要看到每日订单高峰时间段，并在该时间设置合适的价格。

* 我理解开源团队资源有限，会耐心等待评估

* 提交时，您已正确选择标签：feature

# 九 开源协议

    **100Charge**是基于 [AGPL](https://www.gnu.org/licenses/agpl-3.0.en.html) 和 [XCPL](./LICENSE) 双协议的开源软件。您在使用、修改、复制、分发本项目时，仔细阅读并理解以下该协议条款。

**如果您属于以下情况，请遵循[AGPL](https://www.gnu.org/licenses/agpl-3.0.en.html)协议**

* 您是**个人开发者、研究机构或教育机构**，希望技术学习、研究或非商业性地使用本项目。
* 您希望基于本项目进行**修改或扩展，并愿意将您的修改成果同样开源**给社区。

如果您是学生或者教师，用于技术学习或教学目的，可联系我们，我们将免费提供培训与指导（远程）



**如果您属于以下情况，需要获得[XCPL](./LICENSE)协议许可**

* 您基于本项目的修改版本**用于商业目的，但不希望公开您的项目代码**。

* 您在一个**内部使用的系统**中集成了本项目，只对组织内部使用，**不**打算将其对外提供服务。

* 您计划将本项目**打包成SaaS产品或云服务进行销售**。

* 您需要在**专有/闭源产品中集成、修改或链接**本项目的代码。

* 您需要自行部署系统并运营，对外部用户提供收费服务。

**如何获得[XCPL](./LICENSE)协议许可？**

    您需要通过官方渠道，包括不限于：微信、QQ群等与我们取得联系，这样确保您秉持开源精神同时，获得商业许可的自由，并能得到我们官方的技术支持



# 十 联系我们

**QQ群**，如果您只是技术学习与咨询等，请加入我们的**QQ群**：766266573，入群请填写：100+姓名

<img src="./images/qq.png" title="QQ群" style="display: inline-block; margin: 5px;width:200px" alt="QQ群" data-align="center">

**微信扫码**，如果您要想咨询我们的商业授权，以及培训等事宜，请优先加微信，请备注：100+姓名

<center>
<div style="text-align: center">
<img  style="display: inline-block; margin: 5px;" width="250px" src="./images/wechat1.jpg" title="" alt="wechat1.jpg" data-align="center">

</div>
</center>

更多信息，请访问我们的WiKi:[Wiki - Gitee.com](https://gitee.com/ustcyc/100charge/wikis)

想投资一个充电站？不知道什么时候回本？关注我们的公众号，试一试我们的投资分析计算器

<img  style="display: inline-block; margin: 5px;"  width="250px" src="./images/wechat_mp.png" title="" alt="wechat.jpg" data-align="center">