小谷充电宝项目概述和环境搭建

说明

• 本系列文章基于，作者学习和开发实践而来（非直接照搬照抄），与官方内容存在部分不同内容，但效果基本一致。

项目视频和地址

• 小谷充电宝
• PowerBankSystem

项目简介

• 共享充电宝是基于若依微服务版本框架开发的一个共享系统，项目包含平台管理端与微信小程序端，是一个前后端分离的项目。共享充电宝分为后台系统和前台微信小程序。其中覆盖了分布式文件系统、高速缓存、消息队列等多种业务场景和技术实现。
  • 后台系统功能:(用户登录、系统管理员列表、角色管理、权限规则管理、柜机管理、柜机分类、充电宝管理、…)
  • 前台微信小程序功能: (首页、附近门店、门店信息、登录功能、扫码、Mqtt通信、我的订单、微信支付…)

核心技术

后端技术内容

技术名称	描述
SpringBoot	简化新Spring应用的搭建及开发过程。
SpringCloud	基于Spring Boot的云原生应用开发工具，包含Spring Cloud Gateway、Alibaba Nacos、Sentinel、Task和Feign等技术。
SpringBoot + SpringCloud Alibaba	集成Nacos、Sentinel及Cloud OpenFeign的开发框架。
MyBatis-Plus	持久层框架，基于MyBatis构建。
Redis	内存缓存解决方案。
RabbitMQ	消息中间件，适用于大型分布式项目，支持分布式事务和最终一致性。
Quartz	分布式定时任务调度中心。
Drools	规则引擎，用于费用预估及取消等计算。
MongoDB	分布式文件存储数据库。
Knife4J	接口文档生成工具。
MinIO	私有化对象存储集群，类似于公有云OSS。
微信支付	支持微信支付功能的集成。
MySQL	关系型数据库。
Docker	容器化技术，适用于生产环境的Redis运维。
EMQX	分布式MQTT消息服务器。
SpringAI	面向人工智能工程的应用框架。
DeepSeek	开源AI工具库，专注于高效易用的AI模型训练与推理能力。

前端技术内容

技术名称	描述
Vue 3	Vue.js 的最新版本。
Element Plus	基于 Vue 3 的组件库，升级版 Element UI。
Vite	新型前端构建工具，提供快速构建体验。
Node.js	JavaScript 运行环境。
uni-app	前端应用框架，支持多平台开发。

技术架构图

业务流程图

准备环境

1. 创建linux系统环境，可以使用VM虚拟机或者在线购买云服务器，系统可以为ubutu、centos、debian
2. 安装1panel运维面板，参看安装1panel教程，1Panel在线安装。国内镜像源加速。
   

https://docker.1panel.live
https://proxy.1panel.live
https://dockerproxy.1panel.live
https://docker.anye.in

3. 依次在应用商店中安装以下应用，记得勾选允许端口外部访问，同时记得记录设置的用户和密码。
   
   
4. 安装rabbitmq延迟队列插件
   1. 首先下载rabbitmq_delayed_message_exchange-3.12.0.ez文件上传到RabbitMQ所在服务器，下载地址：https://www.rabbitmq.com/community-plugins.html
   2. 切换到插件所在目录，执行docker cp rabbitmq_delayed_message_exchange-3.12.0.ez share_rabbitmq:/plugins命令，将刚插件拷贝到容器内plugins目录下
   3. 执行docker exec -it share_rabbitmq /bin/bash命令进入到容器内部
   4. 执行cd plugins进入plugins目录,然后执行ls -l|grep delay 命令查看插件是否copy成功
   5. 在容器内plugins目录下，执行rabbitmq-plugins enable rabbitmq_delayed_message_exchange 命令启用插件
   6. exit命令退出RabbitMQ容器内部，然后执行 docker restart share_rabbitmq命令重启RabbitMQ容器

搭建项目环境

服务端

1. 解压项目模板下的share-parent.zip到工作空间，导入项目源码到idea。仓库地址：PowerBankSystem
   
2. 项目模块介绍

com.share     
├── share-gateway         // 网关模块 [8080]
├── share-auth            // 认证中心 [9200]
├── share-api             // 接口模块
│       └── share-api-system                        // 系统接口
├── share-common          // 通用模块
│       └── share-common-core                         // 核心模块
│       └── share-common-datascope                    // 权限范围
│       └── share-common-datasource                   // 多数据源
│       └── share-common-log                          // 日志记录
│       └── share-common-redis                        // 缓存服务
│       └── share-common-security                     // 安全模块
├── share-modules         // 业务模块
│       └── share-system                              // 系统模块 [9201]
│       └── share-gen                                 // 代码生成 [9202]
│       └── share-job                                 // 定时任务 [9203]
│       └── share-file                                // 文件服务 [9300]
├── share-ui              // 前端框架 [80]
├── share-visual          // 图形化管理模块
│       └── share-monitor                             // 监控中心 [9100]
├──pom.xml                // 公共依赖

3. 导入数据库表。仓库地址：PowerBankSystem
   
4. 导入nacos配置文件。启动nacos，访问nacos控制台：http://虚拟机IP:8848/nacos/。在nacos控制台：配置管理 -> 配置列表 导入配置文件。仓库地址：PowerBankSystem
   
   
5. 修改nacos配置：涉及数据源的地方都要修改，mysql、redis、minio等等，地址需要修改为自己虚拟机的地址。
6. 运行项目模块：修改各个模块nacos配置中心、注册中心地址、sentinel地址，启动没有先后顺序。
   • shareGatewayApplication （网关模块 必须）
   • shareAuthApplication （认证模块 必须）
   • shareSystemApplication （系统模块 必须）

后台前端部署

# node版本 v18.16.1
node -v

#安装yarn  
# Yarn是由Facebook、Google、Exponent 和 Tilde 联合推出发布的一款取代npm的包管理工具
#安装yarn出现问题，可以忽略校验
npm config set strict-ssl false
npm install -g yarn

# 进入项目目录
cd share-ui

# 安装依赖
yarn --registry=https://registry.npmmirror.com

# 启动服务
yarn dev

# 构建测试环境 yarn build:stage
# 构建生产环境 yarn build:prod

若依后端执行基本流程分析

• share-modules下的share-system模块处理系统管理相关请求，包括角色的CRUD

SysRoleController

import java.beans.PropertyEditorSupport;
import java.util.List;

public class BaseController {
    protected final Logger logger = LoggerFactory.getLogger(this.getClass());

    /**
     * 将前台传递过来的日期格式的字符串，自动转化为Date类型
     */
    @InitBinder
    public void initBinder(WebDataBinder binder) {
        // Date 类型转换
        binder.registerCustomEditor(Date.class, new PropertyEditorSupport() {
            @Override
            public void setAsText(String text) {
                setValue(DateUtils.parseDate(text));
            }
        });
    }

    /**
     * 设置请求分页数据
     */
    protected void startPage() {
        PageUtils.startPage();
    }

    /**
     * 清理分页的线程变量
     */
    protected void clearPage() {
        PageUtils.clearPage();
    }

    /**
     * 响应请求分页数据
     */
    @SuppressWarnings({"rawtypes", "unchecked"})
    protected TableDataInfo getDataTable(List<?> list) {
        TableDataInfo rspData = new TableDataInfo();
        rspData.setCode(HttpStatus.SUCCESS);
        rspData.setRows(list);
        rspData.setMsg("查询成功");
        rspData.setTotal(new PageInfo(list).getTotal());
        return rspData;
    }

    /**
     * 返回成功
     */
    public AjaxResult success() {
        return AjaxResult.success();
    }

    /**
     * 返回成功消息
     */
    public AjaxResult success(String message) {
        return AjaxResult.success(message);
    }

    /**
     * 返回成功消息
     */
    public AjaxResult success(Object data) {
        return AjaxResult.success(data);
    }

    /**
     * 返回失败消息
     */
    public AjaxResult error() {
        return AjaxResult.error();
    }

    /**
     * 返回失败消息
     */
    public AjaxResult error(String message) {
        return AjaxResult.error(message);
    }

    /**
     * 返回警告消息
     */
    public AjaxResult warn(String message) {
        return AjaxResult.warn(message);
    }

    /**
     * 响应返回结果
     *
     * @param rows 影响行数
     * @return 操作结果
     */
    protected AjaxResult toAjax(int rows) {
        return rows > 0 ? AjaxResult.success() : AjaxResult.error();
    }

    /**
     * 响应返回结果
     *
     * @param result 结果
     * @return 操作结果
     */
    protected AjaxResult toAjax(boolean result) {
        return result ? success() : error();
    }
}

PageUtils

public class PageUtils extends PageHelper
{
    /**
     * 设置请求分页数据
     */
    public static void startPage()
    {
        PageDomain pageDomain = TableSupport.buildPageRequest();
        Integer pageNum = pageDomain.getPageNum();
        Integer pageSize = pageDomain.getPageSize();
        String orderBy = SqlUtil.escapeOrderBySql(pageDomain.getOrderBy());
        Boolean reasonable = pageDomain.getReasonable();
        PageHelper.startPage(pageNum, pageSize, orderBy).setReasonable(reasonable);
    }

    /**
     * 清理分页的线程变量
     */
    public static void clearPage()
    {
        PageHelper.clearPage();
    }
}

AjaxResult

import java.util.HashMap;
import java.util.Objects;

public class AjaxResult extends HashMap<String, Object> {
    /**
     * 状态码
     */
    public static final String CODE_TAG = "code";
    /**
     * 返回内容
     */
    public static final String MSG_TAG = "msg";
    /**
     * 数据对象
     */
    public static final String DATA_TAG = "data";
    private static final long serialVersionUID = 1L;

    /**
     * 初始化一个新创建的 AjaxResult 对象，使其表示一个空消息。
     */
    public AjaxResult() {
    }

    /**
     * 初始化一个新创建的 AjaxResult 对象
     *
     * @param code 状态码
     * @param msg  返回内容
     */
    public AjaxResult(int code, String msg) {
        super.put(CODE_TAG, code);
        super.put(MSG_TAG, msg);
    }

    /**
     * 初始化一个新创建的 AjaxResult 对象
     *
     * @param code 状态码
     * @param msg  返回内容
     * @param data 数据对象
     */
    public AjaxResult(int code, String msg, Object data) {
        super.put(CODE_TAG, code);
        super.put(MSG_TAG, msg);
        if (StringUtils.isNotNull(data)) {
            super.put(DATA_TAG, data);
        }
    }

    /**
     * 返回成功消息
     *
     * @return 成功消息
     */
    public static AjaxResult success() {
        return AjaxResult.success("操作成功");
    }

    /**
     * 返回成功数据
     *
     * @return 成功消息
     */
    public static AjaxResult success(Object data) {
        return AjaxResult.success("操作成功", data);
    }

    /**
     * 返回成功消息
     *
     * @param msg 返回内容
     * @return 成功消息
     */
    public static AjaxResult success(String msg) {
        return AjaxResult.success(msg, null);
    }

    /**
     * 返回成功消息
     *
     * @param msg  返回内容
     * @param data 数据对象
     * @return 成功消息
     */
    public static AjaxResult success(String msg, Object data) {
        return new AjaxResult(HttpStatus.SUCCESS, msg, data);
    }

    /**
     * 返回警告消息
     *
     * @param msg 返回内容
     * @return 警告消息
     */
    public static AjaxResult warn(String msg) {
        return AjaxResult.warn(msg, null);
    }

    /**
     * 返回警告消息
     *
     * @param msg  返回内容
     * @param data 数据对象
     * @return 警告消息
     */
    public static AjaxResult warn(String msg, Object data) {
        return new AjaxResult(HttpStatus.WARN, msg, data);
    }

    /**
     * 返回错误消息
     *
     * @return 错误消息
     */
    public static AjaxResult error() {
        return AjaxResult.error("操作失败");
    }

    /**
     * 返回错误消息
     *
     * @param msg 返回内容
     * @return 错误消息
     */
    public static AjaxResult error(String msg) {
        return AjaxResult.error(msg, null);
    }

    /**
     * 返回错误消息
     *
     * @param msg  返回内容
     * @param data 数据对象
     * @return 错误消息
     */
    public static AjaxResult error(String msg, Object data) {
        return new AjaxResult(HttpStatus.ERROR, msg, data);
    }

    /**
     * 返回错误消息
     *
     * @param code 状态码
     * @param msg  返回内容
     * @return 错误消息
     */
    public static AjaxResult error(int code, String msg) {
        return new AjaxResult(code, msg, null);
    }

    /**
     * 是否为成功消息
     *
     * @return 结果
     */
    public boolean isSuccess() {
        return Objects.equals(HttpStatus.SUCCESS, this.get(CODE_TAG));
    }

    /**
     * 是否为警告消息
     *
     * @return 结果
     */
    public boolean isWarn() {
        return Objects.equals(HttpStatus.WARN, this.get(CODE_TAG));
    }

    /**
     * 是否为错误消息
     *
     * @return 结果
     */
    public boolean isError() {
        return Objects.equals(HttpStatus.ERROR, this.get(CODE_TAG));
    }

    /**
     * 方便链式调用
     *
     * @param key
     * @param value
     * @return
     */
    @Override
    public AjaxResult put(String key, Object value) {
        super.put(key, value);
        return this;
    }
}

SysRoleServiceImpl

@Service
public class SysRoleServiceImpl implements ISysRoleService{

    @Autowired
    private SysRoleMapper roleMapper;
    /**
     * 根据条件分页查询角色数据
     *
     * @param role 角色信息
     * @return 角色数据集合信息
     */
    @Override
    @DataScope(deptAlias = "d")
    public List<SysRole> selectRoleList(SysRole role)
    {
        return roleMapper.selectRoleList(role);
    }

}

SysRoleMapper

public interface SysRoleMapper
{
    /**
     * 根据条件分页查询角色数据
     * @param role 角色信息
     * @return 角色数据集合信息
     */
    public List<SysRole> selectRoleList(SysRole role);
}