MCPcopy Index your code
hub / github.com/dromara/RuoYi-Vue-Plus

github.com/dromara/RuoYi-Vue-Plus @v5.6.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v5.6.2 ↗ · + Follow
2,836 symbols 8,756 edges 617 files 2,364 documented · 83%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README


平台简介

码云Gitee GitHub Star License

RuoYi-Vue-Plus Spring Boot JDK-17 JDK-21

Dromara RuoYi-Vue-Plus 是重写 RuoYi-Vue 针对 分布式集群与多租户 场景全方位升级(不兼容原框架)

项目代码、文档 均开源免费可商用 遵循开源协议在项目中保留开源协议文件即可

活到老写到老 为兴趣而开源 为学习而开源 为让大家真正可以学到技术而开源

系统演示: 传送门

官方前端项目地址: gitee - github - gitcode

成员前端项目地址: 基于vben5 ruoyi-plus-vben5

成员前端项目地址: 基于soybean ruoyi-plus-soybean

成员项目地址: 删除多租户与工作流 RuoYi-Vue-Plus-Single

文档地址: plus-doc 国内加速: plus-doc.top

赞助商

MaxKey 业界领先单点登录产品 - https://gitee.com/dromara/MaxKey

CCFlow 驰聘低代码-流程-表单 - https://gitee.com/opencc/RuoYi-JFlow

数舵科技 软件定制开发APP小程序等 - https://www.shuduokeji.com/

Mall4J 高质量Java商城系统 - https://www.mall4j.com/cn/?statId=11

aizuda flowlong 工作流 - https://gitee.com/aizuda/flowlong

Ruoyi-Plus-Uniapp - https://ruoyi.plus

Topiam IAM/IDaaS身份管理平台 - https://www.topiam.cn/

稳定低价的大模型中转站 - https://aicodelink.top/register?aff=pHeG

如何成为赞助商 加群联系作者详谈 每日PV2500-3000 IP1700-2500

本框架与RuoYi的功能差异

功能 本框架 RuoYi
前端项目 采用 Vue3 + TS + ElementPlus 重写 基于Vue2/Vue3 + JS
后端项目结构 采用插件化 + 扩展包形式 结构解耦 易于扩展 模块相互注入耦合严重难以扩展
后端代码风格 严格遵守Alibaba规范与项目统一配置的代码格式化 代码书写与常规结构不同阅读障碍大
Web容器 采用 Undertow 基于 XNIO 的高性能容器 采用 Tomcat
权限认证 采用 Sa-Token、Jwt 静态使用功能齐全 低耦合 高扩展 Spring Security 配置繁琐扩展性极差
权限注解 采用 Sa-Token 支持注解 登录校验、角色校验、权限校验、二级认证校验、HttpBasic校验、忽略校验

角色与权限校验支持多种条件 如 AND OR权限 OR 角色 等复杂表达式 | 只支持是否存在匹配 | | 三方鉴权 | 采用 JustAuth 第三方登录组件 支持微信、钉钉等数十种三方认证 | 无 | | 关系数据库支持 | 原生支持 MySQL、Oracle、PostgreSQL、SQLServer

可同时使用异构切换(支持其他 mybatis-plus 支持的所有数据库 只需要增加jdbc依赖即可使用 达梦金仓等均有成功案例) | 支持 Mysql、Oracle 不支持同时使用、不支持异构切换 | | 缓存数据库 | 支持 Redis >= 6 支持大部分新功能特性 如 分布式限流、分布式队列 | 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等 | 无 | | 接口传输加密 | 采用 动态 AES + RSA 加密请求 body 每一次请求秘钥都不同大幅度降低可破解性 | 无 | | 数据翻译 | 采用 注解 + jackson 序列化期间动态修改数据 数据进行翻译

支持多种模式: 映射翻译 直接翻译 其他扩展条件翻译 接口化两步即可完成自定义扩展 内置多种翻译实现 | 无 | | 多数据源框架 | 采用 dynamic-datasource 支持市面大部分数据库

通过yml配置即可动态管理异构不同种类的数据库 也可通过前端页面添加数据源

支持spel表达式从请求头参数等条件切换数据源 | 基于 druid 手动编写代码配置数据源 配置繁琐 支持性差 | | 多数据源事务 | 采用 dynamic-datasource 支持多数据源不同种类的数据库事务回滚 | 不支持 | | 数据库连接池 | 采用 HikariCP Spring官方内置连接池 配置简单 以性能与稳定性闻名天下 | 采用 druid bug众多 社区维护差 活跃度低 配置众多繁琐性能一般 | | 数据库主键 | 采用 雪花ID 基于时间戳的 有序增长 唯一ID 再也不用为分库分表 数据合并主键冲突重复而发愁 | 采用 数据库自增ID 支持数据量有限 不支持多数据源主键唯一 | | WebSocket协议 | 基于 Spring 封装的 WebSocket 协议 扩展了Token鉴权与分布式会话同步 不再只是基于单机的废物 | 无 | | SSE推送 | 采用 Spring SSE 实现 扩展了Token鉴权与分布式会话同步 | 无 | | 序列化 | 采用 Jackson Spring官方内置序列化 靠谱!!! | 采用 fastjson bugjson 远近闻名 | | 分布式幂等 | 参考美团GTIS防重系统简化实现(细节可看文档) | 手动编写注解基于aop实现 | | 分布式锁 | 采用 Lock4j 底层基于 Redisson | 无 | | 分布式任务调度 | 采用 SnailJob 天生支持分布式 统一的管理中心 支持多种数据库 支持分片重试DAG任务流等 | 采用 Quartz 基于数据库锁性能差 集群需要做很多配置与改造 | | 文件存储 | 采用 Minio 分布式文件存储 天生支持多机、多硬盘、多分片、多副本存储

支持权限管理 安全可靠 文件可加密存储 | 采用 本机文件存储 文件裸漏 易丢失泄漏 不支持集群有单点效应 | | 云存储 | 采用 AWS S3 协议客户端 支持 七牛、阿里、腾讯 等一切支持S3协议的厂家 | 不支持 | | 短信 | 采用 sms4j 短信融合包 支持数十种短信厂家 只需在yml配置好厂家密钥即可使用 可多厂家共用 | 不支持 | | 邮件 | 采用 mail-api 通用协议支持大部分邮件厂商 | 不支持 | | 接口文档 | 采用 SpringDoc、javadoc 无注解零入侵基于java注释

只需把注释写好 无需再写一大堆的文档注解了 | 采用 Springfox 已停止维护 需要编写大量的注解来支持文档生成 | | 校验框架 | 采用 Validation 支持注解与工具类校验 注解支持国际化 | 仅支持注解 且注解不支持国际化 | | Excel框架 | 采用 FastExcel(原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
租户管理 系统内租户的管理 如:租户套餐、过期时间、用户数量、企业信息等 支持
租户套餐管理 系统内租户所能使用的套餐管理 如:套餐内所包含的菜单等 支持
客户端管理 系统内对接的所有客户端管理 如: pc端、小程序端等

支持动态授权登录方式 如: 短信登录、密码登录等 支持动态控制token时效 | 支持 | 无 | | 用户管理 | 用户的管理配置 如:新增用户、分配用户所属部门、角色、岗位等 | 支持 | 支持 | | 部门管理 | 配置系统组织机构(公司、部门、小组) 树结构展现支持数据权限 | 支持 | 支持 | | 岗位管理 | 配置系统用户所属担任职务 | 支持 | 支持 | | 菜单管理 | 配置系统菜单、操作权限、按钮权限标识等 | 支持 | 支持 | | 角色管理 | 角色菜单权限分配、设置角色按机构进行数据范围权限划分 | 支持 | 支持 | | 字典管理 | 对系统中经常使用的一些较为固定的数据进行维护 | 支持 | 支持 | | 参数管理 | 对系统动态配置常用参数

Extension points exported contracts — how you extend this code

TranslationInterface (Interface)
翻译接口 (实现类需标注 TranslationType 注解标明翻译类型) @author Lion Li [6 implementers]
ruoyi-common/ruoyi-common-translation/src/main/java/org/dromara/common/translation/core/TranslationInterface.java
IEncryptor (Interface)
加解者 @author 老马 @version 4.6.0 [6 implementers]
ruoyi-common/ruoyi-common-encrypt/src/main/java/org/dromara/common/encrypt/core/IEncryptor.java
ITestTreeService (Interface)
测试树表Service接口 @author Lion Li @date 2021-07-26 [8 implementers]
ruoyi-modules/ruoyi-demo/src/main/java/org/dromara/demo/service/ITestTreeService.java
IAuthStrategy (Interface)
授权策略 @author Michelle.Chung [12 implementers]
ruoyi-admin/src/main/java/org/dromara/web/service/IAuthStrategy.java
NodeExtEnum (Interface)
节点扩展属性枚举 @author AprilWind [3 implementers]
ruoyi-modules/ruoyi-workflow/src/main/java/org/dromara/workflow/common/enums/NodeExtEnum.java
ExcelListener (Interface)
Excel 导入监听 @author Lion Li [2 implementers]
ruoyi-common/ruoyi-common-excel/src/main/java/org/dromara/common/excel/core/ExcelListener.java
PostService (Interface)
通用 岗位服务 @author AprilWind [2 implementers]
ruoyi-common/ruoyi-common-core/src/main/java/org/dromara/common/core/service/PostService.java
SensitiveService (Interface)
脱敏服务 默认管理员不过滤 需自行根据业务重写实现 @author Lion Li @version 3.6.0 [2 implementers]
ruoyi-common/ruoyi-common-sensitive/src/main/java/org/dromara/common/sensitive/core/SensitiveService.java

Core symbols most depended-on inside this repo

ok
called by 178
ruoyi-common/ruoyi-common-core/src/main/java/org/dromara/common/core/domain/R.java
isEmpty
called by 165
ruoyi-common/ruoyi-common-core/src/main/java/org/dromara/common/core/utils/StringUtils.java
put
called by 133
ruoyi-common/ruoyi-common-redis/src/main/java/org/dromara/common/redis/utils/CacheUtils.java
build
called by 127
ruoyi-common/ruoyi-common-core/src/main/java/org/dromara/common/core/utils/TreeBuildUtils.java
isNotEmpty
called by 121
ruoyi-common/ruoyi-common-core/src/main/java/org/dromara/common/core/utils/StringUtils.java
fail
called by 98
ruoyi-common/ruoyi-common-core/src/main/java/org/dromara/common/core/domain/R.java
get
called by 89
ruoyi-common/ruoyi-common-sms/src/main/java/org/dromara/common/sms/core/dao/PlusSmsDao.java
getUserId
called by 82
ruoyi-common/ruoyi-common-satoken/src/main/java/org/dromara/common/satoken/utils/LoginHelper.java

Shape

Method 2,225
Class 482
Interface 101
Enum 28

Languages

Java100%

Modules by API surface

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysUserServiceImpl.java41 symbols
ruoyi-common/ruoyi-common-redis/src/main/java/org/dromara/common/redis/utils/RedisUtils.java39 symbols
ruoyi-modules/ruoyi-workflow/src/main/java/org/dromara/workflow/service/impl/FlwTaskServiceImpl.java30 symbols
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysRoleServiceImpl.java30 symbols
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/ISysUserService.java27 symbols
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/ISysRoleService.java26 symbols
ruoyi-modules/ruoyi-workflow/src/main/java/org/dromara/workflow/service/IFlwTaskService.java24 symbols
ruoyi-common/ruoyi-common-core/src/main/java/org/dromara/common/core/utils/StringUtils.java24 symbols
ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/SysDeptServiceImpl.java23 symbols
ruoyi-common/ruoyi-common-core/src/main/java/org/dromara/common/core/utils/DateUtils.java22 symbols
ruoyi-modules/ruoyi-workflow/src/main/java/org/dromara/workflow/service/impl/FlwInstanceServiceImpl.java21 symbols
ruoyi-common/ruoyi-common-redis/src/main/java/org/dromara/common/redis/utils/QueueUtils.java20 symbols

Datastores touched

(mysql)Database · 1 repos
ry-vueDatabase · 1 repos
postgresDatabase · 1 repos

For agents

$ claude mcp add RuoYi-Vue-Plus \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page