crowd-admin

分支名称	Spring Boot 版本	JDK 版本
main	2.7.16	17
spring4.0	spring4.0	1.8

Language

简体中文|English

项目介绍

基于jdk17、springboot2.7重构而来，crowd-admin是一个后台权限管理系统脚手架，集成了rbac权限管理、消息推送、邮件发送、任务调度、代码生成、elfinder文件管理等常用功能，系统内各个业务按照模块划分，前台使用H+模板。是一个java新人易于上手，学习之后能够快速融入企业开发的指导项目

主要特性

前后端支持stomp高级协议，完善的websocket配置，支持自定义用户认证、连接周期监听等
支持系统参数配置，支持spring内存的@Cacheable注解
项目按功能模块化拆分，自定义全局统一异常输出，代码清晰合理
集成elfinder模块，包含完整的文件管理操作，包含文件上传、删除、压缩、移动、预览等诸多操作
支持后台消息/邮件推送、数据字典、系统参数配置、各模块操作日记记录
支持系统服务监控、在线用户监控、数据源监控等操作
支持redis/ehcache切换使用
支持ip2region本地化
支持多数据源操作
前端使用H+模板，样式美观，支持ajax下载文件，js代码简洁，清晰，避免过度封装
在线地址

如果有任何使用问题，欢迎提交Issue或加关注我公众号私信我告知，方便互相交流反馈～ 💘。最后，喜欢的话麻烦给我个star

关注公众号：waynblog，每周更新最新技术文章。回复关键字：

学习：加群交流，群内问题都会一一解答。
演示账号：获得线上项目管理后台演示账号。
开源项目：获取博主自己写的三个开源项目，包含PC、H5商城、后台权限管理系统等。

crowd-admin

内置模块

系统管理
- 用户管理：系统操作者，可绑定多角色
- 角色管理：菜单权限携带者，可配置到按钮级权限
- 菜单管理：配置系统目录，菜单链接，操作权限
- 部门管理：用户所属部门
- 日志操作：记录用户操作，包含请求参数
邮件服务
- 邮件发送：基于activeMQ异步发送邮件
办公通知
- 我的通知：接收当前用户得通知信息
- 通知管理：管理员发送并管理通知消息
基础管理
- 数据字典：对系统中经常使用的一些较为固定的数据进行维护
- 文件管理：集成elfinder，便于对系统内文件进行查看修改
系统工具
- 代码生成：可动态根据数据库表，生成后台java代码
- 任务调度：根据调度策略以及执行目标配置任务调度
- 任务日志：记录任务日志，方便排错追踪
系统监控
- 在线用户：当前系统中活跃用户状态监控，可强制下线用户
- 数据监控：监视当前系统数据库连接池状态，可进行分析SQL找出系统性能瓶颈
- 系统服务：监视当前系统CPU、内存、磁盘、堆栈等相关信息

技术选型

后端
- 核心框架：Spring
- 控制层框架：SpringMVC
- 权限控制：Shiro
- 消息中间件：activeMQ
- 消息推送：Websocket
- 邮件发送：javax.mail
- 任务调度：Quartz
- 持久层框架：Mybatis-Plus
- 日志管理：SLF4J > logback
- 缓存控制：Ehcache/Redis可切换
- 环境控制：使用spring profile可根据-Dspring.profiles.active=dev参数灵活切换配置文件
前端
- 模板选型：thymeleaf
- 管理模板：H+
- JS框架：jQuery
- 数据表格：bootstrapTable
- 文件管理：elfinder
- 弹出层：layer
- 通知消息：Toastr
- 消息推送/轮询：sockJs、stomp
- 树结构控件：jsTree
- checkbox选择控件：bootstrapSwitch
开发平台
- JDK版本：17+
- Maven：3.5+
- 数据库：mysql8+（设置表名称大小写忽略）
- 缓存：ehcache/redis
- ide：Eclipse/Idea

本地开发

# 1. 克隆项目
git clone git@github.com:wayn111/crowd-amin.git

# 2. 导入项目依赖
将crowd-admin目录用idea打开，导入maven依赖

# 3. 安装Mysql8.0+、Redis3.0+、Jdk17+、Maven3.5+

# 4. 导入sql文件
在项目根目录下crowd-web文件夹下，找到`crowd-admin.sql`文件，新建mysql数据库crowd-admin，导入其中

# 5. 修改Mysql、Redis连接配置
修改`application-dev.yml`文件中数据连接配置相关信息

# 6. 启动项目
进入crowd-web木块，找到CrowdApplication文件，在idea中右键run application运行

# 7. 访问
打开浏览器输入：http://localhost:8080/crowd/

远程部署

推荐使用 Dockerfile 方式进行远程部署，这里介绍 CentOS 系统下部署方式（默认大家已安装 docker 环境）

# 1. 修改 application-dev.yml 文件数据库、Redis 连接

# 2. 服务器上新建 /opt/wayn/crowd 目录
mkdir -p /opt/wayn/crowd/crowd-web/target
mkdir -p /opt/wayn/crowd/logs

# 3. 在项目根目录执行如下 mvn 命令对 crowd-web 模块进行打包操作
mvn clean package -DskipTests -pl crowd-web -am
打包完成后在 crowd-web/target 目录下会生成 crowd.jar 文件

# 4. 上传 crowd.jar 文件至目录服务器 /opt/wayn/crowd/crowd-web/target 目录下

# 6. 上传项目根目录下 ip2region.xdb 文件至服务器 /opt/wayn/crowd 目录下 

# 7. 上传项目根目录下 Dockerfile 文件至服务器 /opt/wayn/crowd 目录下

# 8. 构建 docker 镜像，启动容器
cd /opt/wayn/crowd
docker build -t crowd .
docker run -p 8080:8080 -v /opt/wayn/crowd:/opt/wayn/crowd --name crowd-web crowd 

# 9. 在服务器终端输入 curl -L http://localhost:8080/crowd，有网页内容返回则代表部署成功