- - - ## 平台简介 [![码云Gitee](https://gitee.com/dromara/RuoYi-Vue-Plus/badge/star.svg?theme=blue)](https://gitee.com/dromara/RuoYi-Vue-Plus)[![GitHub](https://img.shields.io/github/stars/JavaLionLi/RuoYi-Vue-Plus.svg?style=social&label=Stars)](https://github.com/dromara/RuoYi-Vue-Plus)[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://gitee.com/dromara/RuoYi-Vue-Plus/blob/master/LICENSE)[![使用IntelliJ IDEA开发维护](https://img.shields.io/badge/IntelliJ%20IDEA-提供支持-blue.svg)](https://www.jetbrains.com/?from=RuoYi-Vue-Plus) [![RuoYi-Vue-Plus](https://img.shields.io/badge/RuoYi_Vue_Plus-4.7.0-success.svg)](https://gitee.com/dromara/RuoYi-Vue-Plus)[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-2.7-blue.svg)]()[![JDK-8+](https://img.shields.io/badge/JDK-8-green.svg)]()[![JDK-11](https://img.shields.io/badge/JDK-11-green.svg)]() > RuoYi-Vue-Plus 是重写 RuoYi-Vue 针对 `分布式集群` 场景全方位升级(不兼容原框架) > 项目代码、文档均开源免费可商用遵循开源协议在项目中保留开源协议文件即可
活到老写到老为兴趣而开源为学习而开源为让大家真正可以学到技术而开源 > 系统演示: [传送门](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages?sort_id=4836388&doc_id=1469725) # 本框架与RuoYi的功能差异 | 功能 | 本框架 | RuoYi | |-------------|-------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------| | 前端项目 | 基于vue3-element-admin开源项目重写
Vue3 + TS + ElementPlus | 基于Vue2/Vue3 + JS | | 后端项目结构 | 采用插件化 + 扩展包形式结构解耦易于扩展 | 模块相互注入耦合严重难以扩展 | | 后端代码风格 | 严格遵守Alibaba规范与项目统一配置的代码格式化 | 代码书写与常规结构不同阅读障碍大 | | Web容器 | 采用 Undertow 基于 XNIO 的高性能容器 | 采用 Tomcat | | 权限认证 | 采用 Sa-Token、Jwt 静态使用功能齐全低耦合高扩展 | Spring Security 配置繁琐扩展性极差 | | 权限注解 | 采用 Sa-Token 支持注解登录校验、角色校验、权限校验、二级认证校验、HttpBasic校验、忽略校验
角色与权限校验支持多种条件如 `AND` `OR` 或 `权限 OR 角色` 等复杂表达式 | 只支持是否存在匹配 | | 关系数据库支持 | 原生支持 MySQL、Oracle、PostgreSQL、SQLServer
可同时使用异构切换 | 支持 Mysql、Oracle 不支持同时使用、不支持异构切换 | | 缓存数据库 | 支持 Redis 5-7 支持大部分新功能特性如分布式限流、分布式队列 | Redis 简单 get set 支持 | | Redis客户端 | 采用 Redisson Redis官方推荐基于Netty的客户端工具
支持Redis 90%以上的命令底层优化规避很多不正确的用法例如: keys被转换为scan
支持单机、哨兵、单主集群、多主集群等模式 | Lettuce + RedisTemplate 支持模式少工具使用繁琐
连接池采用 common-pool Bug多经常性出问题 | | 缓存注解 | 采用 Spring-Cache 注解对其扩展了实现支持了更多功能
例如过期时间最大空闲时间组最大长度等只需一个注解即可完成数据自动缓存 | 需手动编写Redis代码逻辑 | | ORM框架 | 采用 Mybatis-Plus 基于对象几乎不用写SQL全java操作功能强大插件众多
例如多租户插件分页插件乐观锁插件等等 | 采用 Mybatis 基于XML需要手写SQL | | SQL监控 | 采用 p6spy 可输出完整SQL与执行时间监控 | log输出需手动拼接sql与参数无法快速查看调试问题 | | 数据分页 | 采用 Mybatis-Plus 分页插件
框架对其进行了扩展对象化分页对象支持多种方式传参支持前端多排序复杂排序 | 采用 PageHelper 仅支持单查询分页参数只能从param传只能单排序功能扩展性差体验不好 | | 数据权限 | 采用 Mybatis-Plus 插件自行分析拼接SQL 无感式过滤
只需为Mapper设置好注解条件支持多种自定义不限于部门角色 | 采用注解+aop 实现基于部门角色生成的sql兼容性差不支持其他业务扩展
生成sql后需手动拼接到具体业务sql上对于多个Mapper查询不起作用 | | 数据脱敏 | 采用注解 + jackson 序列化期间脱敏支持不同模块不同的脱敏条件
支持多种策略如身份证、手机号、地址、邮箱、银行卡等可自行扩展 | 无 | | 数据加解密 | 采用注解 + mybatis 拦截器对存取数据期间自动加解密
支持多种策略如BASE64、AES、RSA、SM2、SM4等 | 无 | | 数据翻译 | 采用注解 + jackson 序列化期间动态修改数据数据进行翻译
支持多种模式: `映射翻译` `直接翻译` `其他扩展条件翻译` 接口化两步即可完成自定义扩展内置多种翻译实现 | 无 | | 多数据源框架 | 采用 dynamic-datasource 支持世面大部分数据库
通过yml配置即可动态管理异构不同种类的数据库也可通过前端页面添加数据源
支持spel表达式从请求头参数等条件切换数据源 | 基于 druid 手动编写代码配置数据源配置繁琐支持性差 | | 多数据源事务 | 采用 dynamic-datasource 支持多数据源不同种类的数据库事务回滚 | 不支持 | | 数据库连接池 | 采用 HikariCP Spring官方内置连接池配置简单以性能与稳定性闻名天下 | 采用 druid bug众多社区维护差活跃度低配置众多繁琐性能一般 | | 数据库主键 | 采用雪花ID 基于时间戳的有序增长唯一ID 再也不用为分库分表数据合并主键冲突重复而发愁 | 采用数据库自增ID 支持数据量有限不支持多数据源主键唯一 | | WebSocket协议 | 基于 Spring 封装的 WebSocket 协议扩展了Token鉴权与分布式会话同步不再只是基于单机的废物 | 无 | | 序列化 | 采用 Jackson Spring官方内置序列化靠谱!!! | 采用 fastjson bugjson 远近闻名 | | 分布式幂等 | 参考美团GTIS防重系统简化实现(细节可看文档) | 手动编写注解基于aop实现 | | 分布式任务调度 | 采用 Xxl-Job 天生支持分布式统一的管理中心 | 采用 Quartz 基于数据库锁性能差集群需要做很多配置与改造 | | 文件存储 | 采用 Minio 分布式文件存储天生支持多机、多硬盘、多分片、多副本存储
支持权限管理安全可靠文件可加密存储 | 采用本机文件存储文件裸漏易丢失泄漏不支持集群有单点效应 | | 云存储 | 采用 AWS S3 协议客户端支持七牛、阿里、腾讯等一切支持S3协议的厂家 | 不支持 | | 短信 | 支持阿里、腾讯只需在yml配置好厂家密钥即可使用接口化支持扩展其他厂家 | 不支持 | | 邮件 | 采用 mail-api 通用协议支持大部分邮件厂商 | 不支持 | | 接口文档 | 采用 SpringDoc、javadoc 无注解零入侵基于java注释
只需把注释写好无需再写一大堆的文档注解了 | 采用 Springfox 已停止维护需要编写大量的注解来支持文档生成 | | 校验框架 | 采用 Validation 支持注解与工具类校验注解支持国际化 | 仅支持注解且注解不支持国际化 | | Excel框架 | 采用 Alibaba EasyExcel 基于插件化
框架对其增加了很多功能例如自动合并相同内容自动排列布局字典翻译等 | 基于 POI 手写实现功能有限复杂扩展性差 | | 工具类框架 | 采用 Hutool、Lombok 上百种工具覆盖90%的使用需求基于注解自动生成 get set 等简化框架大量代码 | 手写工具稳定性差易出问题工具数量有限代码臃肿需自己手写 get set 等 | | 监控框架 | 采用 SpringBoot-Admin 基于SpringBoot官方 actuator 探针机制
实时监控服务状态框架还为其扩展了在线日志查看监控 | 无 | | 链路追踪 | 采用 Apache SkyWalking 还在为请求不知道去哪了到哪出了问题而烦恼吗
用了它即可实时查看请求经过的每一处每一个节点 | 无 | | 代码生成器 | 只需设计好表结构一键生成所有crud代码与页面
降低80%的开发量把精力都投入到业务设计上
框架为其适配MP、SpringDoc规范化代码同时支持动态多数据源代码生成 | 代码生成原生结构只支持单数据源生成 | | 部署方式 | 支持 Docker 编排一键搭建所有环境让开发人员从此不再为搭建环境而烦恼 | 原生jar部署其他环境需手动下载安装自行搭建 | | 项目路径修改 | 提供详细的修改方案文档并为其做了一些改动非常简单即可修改成自己想要的 | 需要做很多改造文档说明有限 | | 国际化 | 基于请求头动态返回不同语种的文本内容开发难度低有对应的工具类支持大部分注解内容国际化 | 只提供基础功能其他需自行编写扩展 | | 代码单例测试 | 提供单例测试使用方式编写方法与maven多环境单测插件 | 只提供基础功能其他需自行编写扩展 | | Demo案例 | 提供框架功能的实际使用案例单独一个模块提供了很多很全 | 无 | ## 本框架与RuoYi的业务差异 | 业务 | 功能说明 | 本框架 | RuoYi | |--------|-----------------------------------------|-----|------------------| | 用户管理 | 用户的管理配置如:新增用户、分配用户所属部门、角色、岗位等 | 支持 | 支持 | | 部门管理 | 配置系统组织机构（公司、部门、小组）树结构展现支持数据权限 | 支持 | 支持 | | 岗位管理 | 配置系统用户所属担任职务 | 支持 | 支持 | | 菜单管理 | 配置系统菜单、操作权限、按钮权限标识等 | 支持 | 支持 | | 角色管理 | 角色菜单权限分配、设置角色按机构进行数据范围权限划分 | 支持 | 支持 | | 字典管理 | 对系统中经常使用的一些较为固定的数据进行维护 | 支持 | 支持 | | 参数管理 | 对系统动态配置常用参数 | 支持 | 支持 | | 通知公告 | 系统通知公告信息发布维护 | 支持 | 支持 | | 操作日志 | 系统正常操作日志记录和查询系统异常信息日志记录和查询 | 支持 | 支持 | | 登录日志 | 系统登录日志记录查询包含登录异常 | 支持 | 支持 | | 文件管理 | 系统文件展示、上传、下载、删除等管理 | 支持 | 无 | | 文件配置管理 | 系统文件上传、下载所需要的配置信息动态添加、修改、删除等管理 | 支持 | 无 | | 在线用户管理 | 已登录系统的在线用户信息监控与强制踢出操作 | 支持 | 支持 | | 定时任务 | 运行报表、任务管理(添加、修改、删除)、日志管理、执行器管理等 | 支持 | 仅支持任务与日志管理 | | 代码生成 | 多数据源前后端代码的生成（java、html、xml、sql）支持CRUD下载 | 支持 | 仅支持单数据源 | | 系统接口 | 根据业务代码自动生成相关的api接口文档 | 支持 | 支持 | | 服务监控 | 监视集群系统CPU、内存、磁盘、堆栈、在线日志、Spring相关配置等 | 支持 | 仅支持单机CPU、内存、磁盘监控 | | 缓存监控 | 对系统的缓存信息查询，命令统计等。 | 支持 | 支持 | | 在线构建器 | 拖动表单元素生成相应的HTML代码。 | 支持 | 支持 | | 使用案例 | 系统的一些功能案例 | 支持 | 不支持 | ## 参考文档使用框架前请仔细阅读文档重点注意事项
>[初始化项目必看](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages?sort_id=4164117&doc_id=1469725) >>[https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages?sort_id=4164117&doc_id=1469725](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages?sort_id=4164117&doc_id=1469725) > >[专栏与视频入门必看](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages?sort_id=5473272&doc_id=1469725) >>[https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages?sort_id=5473272&doc_id=1469725](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages?sort_id=5473272&doc_id=1469725) > >[部署项目必看](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages?sort_id=4219382&doc_id=1469725) >>[https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages?sort_id=4219382&doc_id=1469725](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages?sort_id=4219382&doc_id=1469725) > >[参考文档 Wiki](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages) >>[https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages) ## 软件架构图 ![Plus部署架构图](https://images.gitee.com/uploads/images/2021/1112/202137_673ac5d2_1766278.png "Plus部署架构图.png") ## 贡献代码欢迎各路英雄豪杰 `PR` 代码请提交到 `dev` 开发分支统一测试发版框架定位为 `通用后台管理系统(分布式集群强化)` 原则上不接受业务 `PR` ### 其他 * 同步升级 RuoYi-Vue * GitHub 地址 [RuoYi-Vue-Plus-github](https://github.com/dromara/RuoYi-Vue-Plus) * 单模块分支 [RuoYi-Vue-Plus-fast](https://gitee.com/dromara/RuoYi-Vue-Plus/tree/fast/) * 微服务分支 [RuoYi-Cloud-Plus](https://gitee.com/JavaLionLi/RuoYi-Cloud-Plus) * Vue3 分支 [RuoYi-Vue-Plus-UI](https://gitee.com/JavaLionLi/RuoYi-Vue-Plus-UI) * 用户扩展项目 [扩展项目列表](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/pages?sort_id=4478302&doc_id=1469725) ## 加群与捐献 >[加群与捐献](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/加群与捐献?sort_id=4104598) >>[https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/加群与捐献?sort_id=4104598](https://gitee.com/dromara/RuoYi-Vue-Plus/wikis/加群与捐献?sort_id=4104598) ## 捐献作者作者为兼职做开源,平时还需要工作,如果帮到了您可以请作者吃个盒饭

## 演示图例 | | | |--------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------| | ![输入图片说明](https://foruda.gitee.com/images/1680077524361362822/270bb429_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680077619939771291/989bf9b6_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680077681751513929/1c27c5bd_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680077721559267315/74d63e23_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680077765638904515/1b75d4a6_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078026375951297/eded7a4b_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078237104531207/0eb1b6a7_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078254306078709/5931e22f_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078287971528493/0b9af60a_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078308138770249/8d3b6696_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078352553634393/db5ef880_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078378238393374/601e4357_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078414983206024/2aae27c1_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078446738419874/ecce7d59_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078475971341775/149e8634_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078491666717143/3fadece7_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078558863188826/fb8ced2a_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078574561685461/ae68a0b2_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078594932772013/9d8bfec6_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078626493093532/fcfe4ff6_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078643608812515/0295bd4f_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078685196286463/d7612c81_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078703877318597/56fce0bc_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078716586545643/b6dbd68f_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078734103217688/eb1e6aa6_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078759131415480/73c525d8_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078779416197879/75e3ed02_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078802329118061/77e10915_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078893627848351/34a1c342_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078928175016986/f126ec4a_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078941718318363/b68a0f72_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078963175518631/3bb769a1_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078982294090567/b31c343d_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680079000642440444/77ca82a9_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680079020995074177/03b7d52e_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680079039367822173/76811806_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680079274333484664/4dfdc7c0_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680079290467458224/d6715fcf_1766278.png "屏幕截图") |