# RuoYi-plus **Repository Path**: quickthinking/RuoYi-plus ## Basic Information - **Project Name**: RuoYi-plus - **Description**: RuoYi - plus开源后台管理系统（包含API接口服务）由java开发基于SpringBoot2.x， springcloud G的全新版本， 架构更清晰、 代码更整洁、 页面更美观， 非常适用于公司管理平台旧版本升级、 新平台搭建快速整合、 也是接私活利器， 同时提供API接口服务（ 供APP、 微端、 h5等使用）。 - **Primary Language**: Java - **License**: GPL-2.0 - **Default Branch**: master - **Homepage**: http://www.yritsz.com/ruoyi-plus - **GVP Project**: No ## Statistics - **Stars**: 4 - **Forks**: 614 - **Created**: 2019-09-17 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # RuoYi-plus ### 数据库脚本请加QQ群，在群文件下载。 【技术支持群】687672649ruoyi-plus【技术交流群】751872263ruoyi-plus #### 通知！！！ **一、由于近期公司事务比较多，短期内暂停更新，RuoYi-plusv3.0版本重点在SMP管理平台和API核心服务微服务生态构建，致力于提供微服务和分布式事务解决方案**：计划API核心服务增加两个服务模块以制造分布式事务环境，SMP管理平台只做优化不进行结构调整。
**二、RuoYi-plusv2.0版本重磅上线**:该版本不在局限于单一的后台管理框架，重点打造RuoYi-plus管理平台生态圈，增加API接口服务（供APP、微端、h5等使用），API接口服务概述： 1. API接口服务与smp管理平台完全分离，只依赖通用dbean模块和统一父类。 2. 服务提供者负责DB交互通用dbean模块。 3. 服务消费者负对外开放包括APP、微端、h5等，不负责业务逻辑处理（后期增加【验签】保证API接口服务的安全性）。 4. API接口服务使用Eureka为注册中心，消费者负载使用Feign并使用Hystrix熔断器。 #### 介绍 RuoYi-plus开源后台管理系统由java开发基于SpringBoot2.x， springcloud G的全新版本，架构更清晰、代码更整洁、页面更美观， 可用于OA系统、 CRM系统、 PDM系统等二次开发，非常适用于公司管理平台旧版本升级、新平台搭建快速整合、同时也是接私活利器。同时提供API接口服务（供APP、微端、h5等使用）。 **特别注意： 本项目是在开源项目RuoYi（若依） 的基础上进行升级调整，感谢诺依大神。** #### 软件架构 通用模块架构： - zebra-yritsz-smp-parent模块：所有项目父类，负责jar的依赖和版本管理。 - zebra-yritsz-commons-dbean模块：通用db和bean。 - zebra-yritsz-commons-redis模块：通用redis。 核心服务模块架构： - zebra-yritsz-config-servser模块：cloud配置中心服务 **（独立：不依赖Eureka注册中心）** - zebra-yritsz-application-eureka模块：Eureka注册中心。 SMP管理平台架构 - zebra-yritsz-smp-smp模块：管理平台，主要为controller层和视图文件。 - zebra-yritsz-smp-generator模块：代码生成器。 - zebra-yritsz-smp-quartz模块：定时任务。 - zebra-yritsz-smp-core模块：核心模块，包过权限处理、持久化操作、工具类、配置中心客户端、数据源等。 - **依赖cloud配置中心服务模块（可选）** API接口服务架构： - zebra-yritsz-api-provider模块：服务提供者对内开放包括消费者consumer。 - zebra-yritsz-api-consumer模块：服务消费者，对外开放包括APP、微端、h5等。 - **依赖cloud配置中心服务模块（可选）** - **依赖Eureka注册中心模块（必选）** **后台框架介绍：** | 序号 | 核心技术 | 框架 | 阐述 | | --- | --- | --- | --- | |1|核心框架|Spring Boot2.x，springcloud G版本|springBoot为核心框架，springcloud为辅核心框架（API接口服务，config配置中心）| |2|安全框架|Apache Shiro|core模块| |3|模板引擎|Thymeleaf|smp模块| |4|持久层框架|MyBatis|实现：dbean模块 配置：core模块| |5|定时任务|Quartz|quartz模块| |6|数据库连接池|Druid|实现：dbean模块 配置：core模块| |7|代码生成|Velocity|generator模块 | |8|项目管理|Maven|缺省 | |9|缓存技术|Redis，Shiro自带缓存| （实现：redis模块， 配置：core模块），core模块 | |10|注册中心|Eureka|注册中心application-eureka模块 | |11|负载均衡|Feign|服务消费者consumer模块 | |12|熔断机制|Hystrix|服务提供者provider模块 | |13|其他插件|tk.mybatis，lombok等|（dben模块，core模块），全局 | **前端框架：** | 序号 | 核心技术 | 框架 | 阐述 | | --- | --- | --- | --- | |1|核心框架|JQuery、Bootstrap|缺省| |2|table表格|bootstrap-table|缺省| |3|表格树插件|bootstrap-treetable|缺省| |4|表单导出|bootstrap-table-export、tableExport|缺省| |5|遮罩层弹出框|layui、layer|缺省| |6|ztree树插件|jquery.ztree|缺省| |7|下拉框插件|select2.min、bootstrap-select|缺省| |8|时间插件|bootstrap-datetimepicker|缺省| |9|富文本编辑|summernote|缺省| |10|文件上传|bootstrap-fileinput|缺省| |11|统计报表|echarts-all、jquery.peity、jquery.sparkline|缺省| |12|表单验证|jquery.validate|缺省| #### 下个版本： 1. 增加API接口服务【验签】保证API接口服务的安全性。 2. 增加smp管理平台sso实现。 #### 原版RuoYi升级调整介绍 1. **取消项目聚合：** 本人多接触快速搭建管理平台的需求，评估后感觉聚合项目不太适合，所以改使用普通父类子类集成，有新项目时直接继承统一父类，保障快速开发，版本统一。 2. **模块调整：** 整合system持久化模块，为通用的zebra-yritsz-commons-dbean可以供其他服务（如：微端服务、APP接口服务）使用。整合common通用模块，framework核心模块为zebra-yritsz-smp-core核心模块，对于中小项目来说，原项目模块太繁琐，各个模块分工不明确，整合为一个模块当有新项目需求事可以快速搭建。 3. **项目调整：** 增加Redis存储系统、java代码神器lombok、消息转换器HttpMessageConverter... 4. **框架管理：** 增加tk.mybatis插件，原项目虽然可以用代码生成器直接生成增删改查语句，但是繁琐业务下，需要在xml写sql映射过于繁琐，使用tk.mybatis插件可以直接使用封装快速方法，极高的保障了开发的效率。 5. **配置管理：** 增加cloud config配置中心，当项目生态系统不仅限于管理平台，繁琐的配置成为增加工作量和出现问题的关键，所以增加配置中心，统一管理配置文件。 6. **增加模块：** 增加redis通用模块（可选），config-servser配置中心模块（可选），API接口服务模块（独立）。 7. **API接口服务：** 2.0版本不在局限于单一的后台管理框架，重点打造RuoYi-plus管理平台生态圈，增加API接口服务（供APP、微端、h5等使用），该服务以spring cloud为核心，使用Eureka为注册中心、Feign负载、Hystrix熔断器。 ![输入图片说明](https://images.gitee.com/uploads/images/2019/0714/135757_cbf2decc_2038874.jpeg "1562921075(1).jpg") #### 项目部署要求 - JDK-v1.8 - MySql-v5.7.x（建议） - Maven-v3.3.x（建议） - SVN服务器（可选）如果使用配置中心则需要此项，反之 **需要调整代码不通过springCloud config获取配置信息** ，或者使用git。 - GIT服务器（可选）如果使用配置中心则需要此项，反之 **需要调整代码不通过springCloud config获取配置信息** ，或者使用svn。 #### 项目运行须知 1. 项目运行有两种模式，详细见项目运行步骤。 2. redis如果不需要，可以保留（不用搭建redis服务器也可以启动成功）。 #### SMP项目运行步骤一： **使用配置中心** 1. 创建数据库，执行数据库脚本;导入项目，导入完成后需要确保是maven项目，如果不是需要转换成maven项目。 2. 发布项目到maven仓库，依次为zebra-yritsz-smp-parent->zebra-yritsz-commons-dbean->zebra-yritsz-smp-core/generator/quartz 。 3. 启动zebra-yritsz-smp-config模块，该模块为springCloud config-server端 ，需要svn服务器或git服务器把配置中心文件放到对应svn/git上，并且需要配置bootstrap.properties文件。![输入图片说明](https://images.gitee.com/uploads/images/2019/0715/134215_78272869_2038874.jpeg "1563169313(1).jpg") 4. 启动zebra-yritsz-smp-smp，如果使用springCloud config需要配置bootstrap.properties文件。![输入图片说明](https://images.gitee.com/uploads/images/2019/0715/135500_380c9fc3_2038874.jpeg "1563170081(1).jpg") #### SMP项目运行步骤二： **不使用配置中心** 1. 创建数据库，执行数据库脚本;导入项目，导入完成后需要确保是maven项目，如果不是需要转换成maven项目。 2. 发布项目到maven仓库，依次为zebra-yritsz-smp-parent->zebra-yritsz-commons-dbean->zebra-yritsz-smp-core/generator/quartz。 4. 把配置中心文件放入项目resources目录下，启动zebra-yritsz-smp-smp。 ![输入图片说明](https://images.gitee.com/uploads/images/2019/0809/095055_bf4c3fd1_2038874.jpeg "1565315429(1).jpg") #### API项目运行步骤： 1. 启动zebra-yritsz-smp-config配置中心模块。 2. 启动zebra-yritsz-application-eureka注册中心模块。 3. 启动zebra-yritsz-api-provider服务提供者模块。 4. 启动zebra-yritsz-api-consumer服务消费者模块。 注：参考SMP项目运行步骤 ![输入图片说明](https://images.gitee.com/uploads/images/2019/0813/105232_d3785635_2038874.jpeg "1565664767(1).jpg") #### 技术交流 - 官方技术QQ交流号：1579927646 **技术支持（不涉及复杂问题免费）** - 官方QQ技术交流群：751872263ruoyi-plus **免费入群**，数据库脚本和配置中心文件在群文件 - 官方QQ技术支持群：687672649ruoyi-plus **免费入群**，数据库脚本和配置中心文件在群文件 #### 演示地址 - 地址：http://www.yritsz.com/ruoyi-plus - 账号：tecom - 密码：123456 #### 源码地址 - Gitee(主)：https://gitee.com/aimeng2017/RuoYi-plus - Github(辅)：https://github.com/zebra-ruoyi-plus/ruoyi-plus