一、项目概述
无忧共享电池柜管理系统是一款面向共享电池租赁场景的综合性管理平台，旨在实现电池全生命周期管理、智能租赁业务处理和数据可视化展示。系统采用前后端分离架构，具备良好的扩展性和维护性。
二、技术架构
2.1 技术栈
| 分类 | 技术 | 版本 |
|---|---|---|
| 前端框架 | Vue.js | 3.x |
| UI组件库 | Element Plus | 2.x |
| 图表库 | ECharts | 5.x |
| 路由管理 | Vue Router | 4.x |
| 后端框架 | Spring Boot | 2.x |
| 数据库 | MySQL | 8.x |
| ORM框架 | MyBatis | 3.x |
| 构建工具 | Vite | 6.x |
2.2 架构设计
系统采用经典的MVC架构模式：
表现层：Vue.js + Element Plus 构建用户界面
控制层：Spring Boot Controller 处理HTTP请求
业务层：Spring Boot Service 实现业务逻辑
数据层：MyBatis + MySQL 进行数据持久化
2.3 核心特性
前后端分离，降低耦合度
RESTful API 设计，便于集成
响应式布局，支持多设备访问
模块化开发，易于维护和扩展
三、功能模块
3.1 用户管理
管理员管理：支持管理员账号的增删改查
普通用户管理：用户注册、登录、信息管理
角色权限控制：区分管理员和普通用户权限
3.2 电池柜管理
电池柜信息管理：添加、编辑、删除电池柜
电池仓管理：管理电池柜中的各个仓位
状态监控：实时显示电池柜和仓位状态
3.3 电池管理
电池信息管理：电池的添加、编辑、删除
电池状态跟踪：空闲/在用状态管理
电池入仓出仓：支持电池的入库和出库操作
3.4 租赁管理
租赁订单管理：创建、查询租赁订单
租赁费用计算：自动计算租赁费用
租赁记录查询：用户可查看个人租赁历史
3.5 数据统计大屏
数据概览：展示关键业务指标
图表展示：电池柜使用率、电池状态分布
实时更新：数据实时刷新展示
3.6 公告管理
公告发布：管理员发布系统公告
公告浏览：所有用户可查看公告
四、部署说明
4.1 环境要求
操作系统：Linux / Windows / macOS
Java版本：JDK 1.8+
数据库：MySQL 8.x
Node.js：18.x+
4.2 后端部署
导入数据库
CREATE DATABASE IF NOT EXISTS gxdc_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE gxdc_db; SOURCE /path/to/your/database.sql;配置数据库连接
编辑 main/src/main/resources/application.properties：
spring.datasource.url=jdbc:mysql://localhost:3306/gxdc_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai spring.datasource.username=your_username spring.datasource.password=your_password启动后端服务
cd main mvn spring-boot:run后端服务默认运行在 http://localhost:8080
4.3 前端部署
安装依赖
cd vue npm install启动开发服务器
npm run dev前端服务默认运行在 http://localhost:5173
生产构建
npm run build构建产物位于 dist 目录，可部署至Nginx等静态资源服务器。
五、使用说明
5.1 登录系统
选择角色（管理员/用户）
输入用户名和密码
点击登录按钮
默认账号：
管理员：admin / 123456
用户：123/ 123
5.2 电池柜管理
登录系统后，点击左侧菜单"电池柜管理"
可查看所有电池柜列表
点击电池柜卡片可查看详细信息
支持搜索功能，可按电池柜编号查询
5.3 电池入仓
在电池柜页面找到空闲仓位
点击"入仓"按钮
在弹出的对话框中选择空闲电池
点击确定完成入仓操作
