zero-admin

zero-admin管理系统是作者在github上面的一个开源项目，这个开源项目使用了如今市场上Web开发的各种常用技术，包括但不限于SpringBoot，MyBatisPlus，Jwt，Swagger等等，作者会通过SpringBoot的系列博客的方式，将项目中使用的技术一一展示出来，供同学们学习。
该项目作者已经托管至github开源平台，有兴趣的同学可以前往github平台浏览，也欢迎每一个同学给该项目一个star。

项目演示地址：http://zeroadmin.herenpeng.com （用户名/密码：user/111111）
github下载地址：https://github.com/herenpeng/zero-admin.git
gitee地址：https://gitee.com/herenpeng/zero-admin.git

项目特点

项目基于前后端分离开发，前后端使用JSON格式的数据进行通信。
基于用户-角色-权限进行系统权限管理，可以自由进行用户，角色，权限的添加，修改，删除。
系统权限管理粒度精细至接口，每一个后台接口都可以通过系统进行权限管理。
系统级别启动触发事件，系统资源接口自动扫描，无需手动添加，系统事件可自由配置开关。
系统静态资源文件管理功能，系统静态资源文件自由管理。
基于注解的AOP日志管理功能，记录每一个接口请求的详细信息。
逻辑删除数据，及数据回收站功能。

项目开发环境

JDK 1.8
Maven 3.6.3
MySQL 5.7.30
Redis(Windows) 3.2.100

项目技术栈

SpringBoot
MyBatisPlus
JWT
WebSocket
Swagger
FreeMarker
SpringDataRedis
easyPoi
oshi

运行项目

1、从github地址上将项目下载下来。

2、将项目设置为Maven项目，并使用Maven下载相关依赖。

3、修改application-dev.yml里面的MySQL数据库和Redis数据库的连接信息。

4、启动MySQL数据库，并导入sql脚本文件。

5、启动Redis数据库。

6、运行MyApplication的main()方法，启动项目。

【备注】如果需要使用项目的邮件发送功能，需要修改application.yml文件中的spring.mail.username和spring.mail.password配置。

项目开发约束

代码规范

本项目代码开发规范遵循《阿里巴巴Java开发手册》，在进行开发前，请下载阿里巴巴Java代码开发约束插件，保证项目代码质量。
链接：《阿里巴巴Java开发手册——嵩山版》

模块规范

本项目功能使用分模块开发，如果需要在本项目的基础上进行开发，请按照以下的三个步骤进行：

请在zero-admin项目下新建模块，并以zero-admin为父项目，需要的第三方依赖，请在zero-admin父模块的pom.xml文件中添加。
在新建模块的pom.xml文件中添加zero-sys模块的依赖。
在zero-web模块的pom.xml文件中添加新建模块的依赖。

数据库规范

所有数据库表的设计，除数据库的业务字段外，都必须包含以下6个通用字段。

-- 这是通用的表数据结构字段
CREATE TABLE `base_table` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键',
	-- 在这里添加表数据业务功能字段
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '数据库数据插入时间',
  `create_user_id` int(11) NOT NULL DEFAULT '0' COMMENT '数据库数据插入用户主键',
  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '数据库数据更新时间',
  `update_user_id` int(11) NOT NULL DEFAULT '0' COMMENT '数据库数据更新用户主键',
  `deleted` tinyint(1) NOT NULL DEFAULT '0' COMMENT '逻辑删除标识，0为正常，1为逻辑删除，默认为0',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 ROW_FORMAT=COMPACT COMMENT='数据库基本表';

业务规范

项目中的所有实体类统一继承com.zero.common.base.entity.BaseEntity类，BaseEntity中包含了数据库规范中包含的六个通用字段。
所有Mapper接口统一继承com.baomidou.mybatisplus.core.mapper.BaseMapper接口。
所有Service接口统一继承com.zero.common.base.service.BaseService接口，所有ServiceImpl类继承com.zero.common.base.service.impl.BaseServiceImpl类。
所有Controller类统一继承com.zero.common.base.controller.BaseController类。