README.md · 硅谷工具人/springboot-manager

# springboot-manager

## 介绍
基于SpringBoot + Thymeleaf + Layui + Apache Shiro + Redis + Mybatis Plus 的后台管理系统  
提供代码生成器，基本增删改查无需编写，可快速完成开发任务。  
后台接口RESTful 风格，支持前后端分离，可与app公用一套接口。  
开发最精简，可当脚手架，适合你来diy

## 特征
- 后台接口RESTful 风格，支持前后端分离，可与app公用一套接口
- 采用RBAC的权限控制
- 统一响应结果封装及生成工具
- 统一异常处理
- Shiro + Redis 实现 Token 角色权限认证
- 使用Druid Spring Boot Starter 集成Druid数据库连接池与监控
- 集成MyBatis-Plus，实现单表业务零SQL
- 支持多数据源，自由切换，只需方法或类上用 @DS 切换数据源
- 集成国人风格的knife4j，自动生成接口文档
- 提供代码生成器，生成从Html到Mapper，爽歪歪

## 代码仓库
Gitee地址：[https://gitee.com/zwens/springboot-manager](https://gitee.com/zwens/springboot-manager)   
GitHub地址：[https://github.com/aitangbao/springboot-manager](https://github.com/aitangbao/springboot-manager)

## 项目演示
- 演示地址：[http://manager.aitangbao.com.cn](http://manager.aitangbao.com.cn/login) 
- 账号密码：guest/123456
- 带宽1m 不太给力 请见谅 :joy:

## 技术
* 核心框架：spring boot 2.1.6
* 持久层框架：mybatis plus
* 数据库连接池：alibaba druid
* 安全框架：apache shiro
* 缓存框架：redis
* 日志框架：logback
* 接口文档：Knife4j
* 前端模板：thymeleaf+layui2x

## 开发建议
- Model内成员变量建议与表字段数量对应，如需扩展成员变量（比如连表查询）建议创建VO，否则需在扩展的成员变量上加@TableField(exist = false)
- 如果表有是否删除字段，需要在Model注解@TableLogic 默认1未删 0删除， 或@TableLogic(value="逻辑未删除值",delval="逻辑删除值")   
- 建议业务失败直接使用throw new BusinessException("ErrorMessage")抛出，由统一异常处理器来封装业务失败的响应结果，会直接被封装为{"code":500002,"message":"ErrorMessage"}返回，尽情抛出；

## 使用说明
- 使用IDE导入本项目，IDE需要安装lombok插件
- 下载redis 启动redis
- 创建company_project数据库，导入doc下的company_project.sql
- 运行项目
   	1. 直接运行CompanyProjectApplication.java
	2. 项目根目录下执行mvn -X clean package -Dmaven.test.skip=true编译打包，然后执行java -jar manager.jar
- 接口文档访问 http://localhost:8080/doc.html
- 登录地址 http://localhost:8080/index/login 用户名密码:admin/123456
- 代码生成使用：
	1. 点击[代码生成]菜单，生成一个或多个表的代码，下载到本地
	2. 解压下载的代码，直接复制main文件夹到本地项目的src目录下
	3. 数据库执行sql，生成菜单
	4. 点击[角色管理]菜单，修改角色所绑定的菜单的权限，刷新页面查看
## 参与贡献
1. Fork 本项目
2. 新建 feature_xxx 分支
3. 提交代码
4. 提交 Pull Request

## **效果图**

![image-20200507134713461](http://tuchuang.aitangbao.com.cn/20200507134721.png)

![2](http://tuchuang.aitangbao.com.cn/20200429161348.png)

![3](http://tuchuang.aitangbao.com.cn/20200429161353.png)

![4](http://tuchuang.aitangbao.com.cn/20200429161355.png)

![5](http://tuchuang.aitangbao.com.cn/20200429161404.png)

![7](http://tuchuang.aitangbao.com.cn/20200429161359.png)

![image-20200430172452726](http://tuchuang.aitangbao.com.cn/20200430172453.png)

![9](http://tuchuang.aitangbao.com.cn/20200429161414.png)

![12](http://tuchuang.aitangbao.com.cn/20200429161423.png)

![13](http://tuchuang.aitangbao.com.cn/20200429161425.png)

![16](http://tuchuang.aitangbao.com.cn/20200429161428.png)

### 捐赠
> 项目的发展离不开您的支持， 如果您够宽裕，请作者喝杯咖啡吧！

![image-20200506154143271](http://tuchuang.aitangbao.com.cn/20200506154222.png)

### 交流群
> 群二维码每周会定期更新，如果二维码过期请先清除浏览器缓存后，重新扫码二维码；如再不行可以私信作者，或邮箱lwb_1128@163.com

硅谷工具人/springboot-manager

简介

发行版

贡献者

近期动态

硅谷工具人/springboot-manager .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

硅谷工具人/springboot-manager