# master-boot

**Repository Path**: MF007/master-boot

## Basic Information

- **Project Name**: master-boot
- **Description**: 既做copy，也做增强。MasterBoot是一套借鉴RuoYi、mall等项目开发的SpringBoot多模块前后端脚手架项目，包含系统基础设置账号权限模块、日志模块、监控模块、代码生成等模块，方便搭建自有或外包项目。后续将会陆续集成多种工具，方便大家使用。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/panday94
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 8
- **Created**: 2025-06-27
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Master Boot

<p>
    <a href="#联系我们"><img src="https://img.shields.io/badge/%E5%85%AC%E4%BC%97%E5%8F%B7-%E5%A4%A7%E5%B8%88%E5%AD%A6Java-blue" alt="公众号"></a>
</p>

![](https://img.shields.io/badge/SpringBoot-2.3.7-brightgreen.svg)

# 项目简介

以SpringBoot为项目框架搭建的多模块版本，上手即用，包含系统基础设置账号权限模块、日志模块、监控模块、代码生成模块，方便搭建自有项目或者外包项目，可以快速生成前后端代码信息，配合[master-admin](https://gitee.com/panday94/master-admin)项目使用方便高效。

MasterBoot是一套全部开源的多模块开发平台，去除繁琐配置及多余代码，代码简洁，遵循restful风格，友好的代码注释，毫无保留给个人及企业免费使用。代码模块自动生成Controller、Service、Mapper、DO、DTO、VO、Command及vue等文件，开发无需考虑再去创建各种类，只需要注重业务实现即可。
欢迎添加我们进行沟通。集成多种第三方插件及功能，方便新手开箱即用。不止copy，也做增强。

* 前端采用Vue、Element UI。
* 后端采用Spring Boot、Spring Security + JWT、Mybatis-Plus、Lombok、 Mysql & Redis。
* 完善的权限控制，权限认证使用Jwt，支持多终端认证系统。
* 支持加载动态权限菜单，多方式轻松权限控制。
* 高效率开发，使用代码生成器可以一键生成前后端代码。
* 前后端快速版本，请移步[master-fast](https://gitee.com/yoli9/master-fast)
* 微服务版本，请移步[mast-cloud](https://gitee.com/yoli9/master-cloud)
* 特别鸣谢[RuoYi](https://gitee.com/y_project/RuoYi)
* 特别鸣谢[CIM](https://gitee.com/farsunset/cim)

## 框架特点

1. 使用@RepeatSubmit(interval = 1000)注解对接口进行重复提交限制，interval默认值为5s内，可以自定义时间范围。
2. 使用@RateLimiter注解对接口进行限流。
3. 使用@DataScope(deptAlias = "t1", userAlias = "t2")进行数据过滤。
4. 使用@PreAuthorize("hasAuthority('system:config:remove')")注解可以对接口进行权限校验。
5. 使用@Log(value = "刷新系统配置缓存", type = SysLogTypeConstant.CONFIG, businessType = BusinessTypeEnum.CLEAN)
   注解进行系统日志存储。
6. 使用@DS("master")切换数据源，优先方法高于类
7. 引入阿里巴巴easy-excel框架，轻松编写导出、导入接口。
8. 使用Lombok简化java代码，省略getter、setter方法。（@Accessors(chain = true)支持链式操作）
9. 完善的自动生成代码功能，增加DTO、Command、VO类。
10. 独立的定时任务列表管理功能。
11. 使用java8语法，Optional、Stream、等语法功能，有相关demo。
12. 支持多端登录或只能当前账号登录功能，需要后台配置。
13. 基于CIM（基于Netty）即使通信框架的聊天板块。
14. 使用阿里云、腾讯云对象存储及短信功能，支持本地存储。

## 内置功能

1. 用户管理：用户是系统操作者，该功能主要完成系统用户配置。
2. 部门管理：配置系统组织机构（公司、部门、小组），树结构展现支持数据权限。
3. 岗位管理：配置系统用户所属担任职务。
4. 菜单管理：配置系统菜单，操作权限，按钮权限标识等。
5. 角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。
6. 字典管理：对系统中经常使用的一些较为固定的数据进行维护。
7. 参数管理：对系统动态配置常用参数。
8. 通知公告：系统通知公告信息发布维护。
9. 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
10. 登录日志：系统登录日志记录查询包含登录异常。
11. 在线用户：当前系统中活跃用户状态监控，可以踢出用户。
12. 定时任务：在线（添加、修改、删除)任务调度包含执行结果日志。
13. 代码生成：前后端代码的生成（java、html、xml、sql）支持CRUD下载 。
14. 系统接口：根据业务代码自动生成相关的api接口文档。
15. 连接池监控：监视当前系统数据库连接池状态，可进行分析SQL找出系统性能瓶颈。
16. 服务监控：监视当前系统CPU、内存、磁盘、堆栈等相关信息。
17. 缓存监控：对系统的缓存查询，删除、清空等操作。
18. 在线构建器：拖动表单元素生成相应的HTML代码。

## 环境搭建

    1、idea导入Spring-boot-fast-demo项目
    2、执行doc文件夹下面sys.sql、generator.sql文件(如需im模块，需执行im.sql文件)
    3、更改application-dev中redis连接和mysql连接配置
    4、启动SpringBootFastDemoApplication中main方法

### 开发环境

| 工具    | 版本号   | 下载                                                                                   |
|-------|-------|--------------------------------------------------------------------------------------|
| JDK   | 1.8   | https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html |
| Mysql | 5.7   | https://www.mysql.com/                                                               |
| Maven | 3.6.3 | https://maven.apache.org/                                                            |
| nginx | 1.10  | http://nginx.org/en/download.html                            ｜                       |

### 开发技术

| 技术                    | 说明                    | 官网                                                 |
| ---------------------  | ------------------------| ----------------------------------------------------|
| Spring Boot            | 容器+MVC框架            | https://spring.io/projects/spring-boot               |
| Spring Security Oauth2 | 认证和授权框架           | https://spring.io/projects/spring-security-oauth     |
| Lombok                 | 简化Java开发            | https://github.com/JourWon/test-lombok               |
| Netty                  | 网络通信框架             | https://github.com/JourWon/test-lombok               |
| JWT                    | JWT登录支持             | https://github.com/jwtk/jjwt                         |
| MyBatis-plus           | 代码生成、物理分页        | https://baomidou.com/                                |
| dynamic-datasource     | 多数据源                 | https://www.kancloud.cn/tracy5546/dynamic-datasource/2264611|
| Redis                  | 分布式缓存               | https://redis.io/                                    |
| Druid                  | 数据库连接池             | https://github.com/alibaba/druid                     |
| OSS                    | 对象存储                 | https://github.com/aliyun/aliyun-oss-java-sdk        |
| quartz                 | 定时任务                 | https://github.com/quartz-scheduler/quartz           |

### 项目模块

注意：

- 客户端示例：`master-client`
- 公共类模块：  `master-common`
- 代码案例：    `master-example`
- 工作流模块：  `master-flowable`
- 框架配置模块：`master-framework`
- 代码生成模块：`master-generator`
- 即时通讯模块：`master-im`
- 定时任务模块：`master-quartz`
- 系统设置模块：`master-sys`
- 服务端启动模块：`master-web`

---------------------------------

## 在线体验

- admin/123456

演示地址：https://test.panday94.xyz

## 演示图

<table>
    <tr>
        <td><img src="./doc/file/1.jpg"/></td>
        <td><img src="./doc/file/2.jpg"/></td>
    </tr>
    <tr>
        <td><img src="./doc/file/3.jpg"/></td>
        <td><img src="./doc/file/4.jpg"/></td>
    </tr>
</table>

## 联系我们

<div style="display: flex; gap: 20px;">
	<div style="text-align: center">
		<img style="max-width: 100%" src="doc/file/mpqrcode.jpg" alt="公众号" />
		<p>公众号</p>
	</div>
	<div style="text-align: center">
		<img style="max-width: 100%" src="doc/file/wxcode.jpg" alt="微信" />
		<p>添加微信，加入交流群</p>
	</div>
</div>

## 许可证

[Apache License 2.0](LICENSE)

Copyright (c) 2022 Master Computer Corporation Limited All rights reserved