ruoyi-vue-pro README

The project's README from github.com/YunaiV/ruoyi-vue-pro. As one markdown file: README.md.

Downloads Downloads

严肃声明：现在、未来都不会有商业版本，所有代码全部开源!！

「我喜欢写代码，乐此不疲」
「我喜欢做开源，以此为乐」

我 🐶 在上海艰苦奋斗，早中晚在 top3 大厂认真搬砖，夜里为开源做贡献。

如果这个项目让你有所收获，记得 Star 关注哦，这对我是非常不错的鼓励与支持。

🐶 新手必读

🐰 版本说明

版本 JDK 8 + Spring Boot 2.7 JDK 17/21 + Spring Boot 3.5 JDK 25 + Spring Boot 4.x
【完整版】ruoyi-vue-pro master 分支 master-jdk17 分支 master-jdk25 分支
【精简版】yudao-boot-mini master 分支 master-jdk17 分支 master-jdk25 分支

可参考 《迁移文档》 ，只需要 5-10 分钟，即可将【完整版】按需迁移到【精简版】

🐯 平台简介

芋道，以开发者为中心，打造中国第一流的快速开发平台，全部开源，个人与企业可 100% 免费使用。

有任何问题，或者想要的功能，可以在 Issues 中提给艿艿。

😜 给项目点点 Star 吧，这对我们真的很重要！

架构图

🐳 项目关系

架构演进

三个项目的功能对比，可见社区共同整理的 国产开源项目对比 表格。

后端项目

项目 Star 简介
ruoyi-vue-pro Gitee star GitHub stars 基于 Spring Boot 多模块架构
yudao-cloud Gitee star GitHub stars 基于 Spring Cloud 微服务架构
Spring-Boot-Labs Gitee star GitHub stars 系统学习 Spring Boot & Cloud 专栏

前端项目

项目 Star 简介
yudao-ui-admin-vue3 Gitee star GitHub stars 基于 Vue3 + element-plus 实现的管理后台
yudao-ui-admin-vben Gitee star GitHub stars 基于 Vue3 + vben(ant-design-vue) 实现的管理后台
yudao-mall-uniapp Gitee star GitHub stars 基于 uni-app 实现的商城小程序
yudao-ui-admin-vue2 Gitee star GitHub stars 基于 Vue2 + element-ui 实现的管理后台
yudao-ui-admin-uniapp Gitee star GitHub stars 基于 Vue2 + element-ui 实现的管理后台
yudao-ui-go-view Gitee star GitHub stars 基于 Vue3 + naive-ui 实现的大屏报表

😎 开源协议

为什么推荐使用本项目？

① 本项目采用比 Apache 2.0 更宽松的 MIT License 开源协议，个人与企业可 100% 免费使用，不用保留类作者、Copyright 信息。

② 代码全部开源，不会像其他项目一样，只开源部分代码，让你无法了解整个项目的架构设计。国产开源项目对比

开源项目对比

③ 代码整洁、架构整洁，遵循《阿里巴巴 Java 开发手册》规范，代码注释详细，113770 行 Java 代码，42462 行代码注释。

🤝 项目外包

我们也是接外包滴，如果你有项目想要外包，可以微信联系【Aix9975】。

团队包含专业的项目经理、架构师、前端工程师、后端工程师、测试工程师、运维工程师，可以提供全流程的外包服务。

项目可以是商城、SCRM 系统、OA 系统、物流系统、ERP 系统、HRM 人力资源系统、FMS 财务系统、PMS 项目管理系统、CMS 系统、HIS 系统、支付系统、IM 即时通讯、微信公众号、微信小程序等等。

🐼 内置功能

系统内置多种多种业务功能，可以用于快速你的业务系统：

功能分层

友情提示：本项目基于 RuoYi-Vue 修改，重构优化后端的代码，美化前端的界面。

  • 额外新增的功能，我们使用 🚀 标记。
  • 重新实现的功能，我们使用 ⭐️ 标记。

🙂 所有功能，都通过 单元测试 保证高质量。

系统功能

功能 描述
用户管理 用户是系统操作者，该功能主要完成系统用户配置
⭐️ 在线用户 当前系统中活跃用户状态监控，支持手动踢下线
角色管理 角色菜单权限分配、设置角色按机构进行数据范围权限划分
菜单管理 配置系统菜单、操作权限、按钮权限标识等，本地缓存提供性能
部门管理 配置系统组织机构（公司、部门、小组），树结构展现支持数据权限
岗位管理 配置系统用户所属担任职务
🚀 租户管理 配置系统租户，支持 SaaS 场景下的多租户功能
🚀 租户套餐 配置租户套餐，自定每个租户的菜单、操作、按钮的权限
字典管理 对系统中经常使用的一些较为固定的数据进行维护
🚀 短信管理 短信渠道、短息模板、短信日志，对接阿里云、腾讯云等主流短信平台
🚀 邮件管理 邮箱账号、邮件模版、邮件发送日志，支持所有邮件平台
🚀 站内信 系统内的消息通知，提供站内信模版、站内信消息
🚀 操作日志 系统正常操作日志记录和查询，集成 Swagger 生成日志内容
⭐️ 登录日志 系统登录日志记录查询，包含登录异常
🚀 错误码管理 系统所有错误码的管理，可在线修改错误提示，无需重启服务
通知公告 系统通知公告信息发布维护
🚀 敏感词 配置系统敏感词，支持标签分组
🚀 应用管理 管理 SSO 单点登录的应用，支持多种 OAuth2 授权方式
🚀 地区管理 展示省份、城市、区镇等城市信息，支持 IP 对应城市

功能图

工作流程

功能图

基于 Flowable 构建，可支持信创（国产）数据库，满足中国特色流程操作：

BPMN 设计器 钉钉/飞书设计器

历经头部企业生产验证，工作流引擎须标配仿钉钉/飞书 + BPMN 双设计器！！！

前者支持轻量配置简单流程，后者实现复杂场景深度编排

功能列表 功能描述 是否完成
SIMPLE 设计器 仿钉钉/飞书设计器，支持拖拽搭建表单流程，10 分钟快速完成审批流程配置 ✅
BPMN 设计器 基于 BPMN 标准开发，适配复杂业务场景，满足多层级审批及流程自动化需求 ✅
会签 同一个审批节点设置多个人（如 A、B、C 三人，三人会同时收到待办任务），需全部同意之后，审批才可到下一审批节点 ✅
或签 同一个审批节点设置多个人，任意一个人处理后，就能进入下一个节点 ✅
依次审批 （顺序会签）同一个审批节点设置多个人（如 A、B、C 三人），三人按顺序依次收到待办，即 A 先审批，A 提交后 B 才能审批，需全部同意之后，审批才可到下一审批节点 ✅
抄送 将审批结果通知给抄送人，同一个审批默认排重，不重复抄送给同一人 ✅
驳回 （退回）将审批重置发送给某节点，重新审批。可驳回至发起人、上一节点、任意节点 ✅
转办 A 转给其 B 审批，B 审批后，进入下一节点 ✅
委派 A 转给其 B 审批，B 审批后，转给 A，A 继续审批后进入下一节点 ✅
加签 允许当前审批人根据需要，自行增加当前节点的审批人，支持向前、向后加签 ✅
减签 （取消加签）在当前审批人操作之前，减少审批人 ✅
撤销 （取消流程）流程发起人，可以对流程进行撤销处理 ✅
终止 系统管理员，在任意节点终止流程实例 ✅
表单权限 支持拖拉拽配置表单，每个审批节点可配置只读、编辑、隐藏权限 ✅
超时审批 配置超时审批时间，超时后自动触发审批通过、不通过、驳回等操作 ✅
自动提醒 配置提醒时间，到达时间后自动触发短信、邮箱、站内信等通知提醒，支持自定义重复提醒频次 ✅
父子流程 主流程设置子流程节点，子流程节点会自动触发子流程。子流程结束后，主流程才会执行（继续往下下执行），支持同步子流程、异步子流程 ✅
条件分支 （排它分支）用于在流程中实现决策，即根据条件选择一个分支执行 ✅
并行分支 允许将流程分成多条分支，不进行条件判断，所有分支都会执行 ✅
包容分支 （条件分支 + 并行分支的结合体）允许基于条件选择多条分支执行，但如果没有任何一个分支满足条件，则可以选择默认分支 ✅
路由分支 根据条件选择一个分支执行（重定向到指定配置节点），也可以选择默认分支执行（继续往下执行）

ruoyi-vue-pro (YunaiV/ruoyi-vue-pro)

Searching Database…

39.9K ·GitHub
Ruoyi-vue-pro
这是什么？RuoYi-Vue-Pro 是一个开源的企业管理后台后端系统，基于 Spring Boot、MyBatis Plus 和 Vue/Element 构建，附带微信小程序，并提供可选的业务模块，如商城、CRM、ERP、OA、MES 和 IM。
这是现成的应用，还是可以用来二次开发的框架？它是一个多模块的 Spring Boot 后端框架（而非成品应用），供二次开发使用：管理后台前端位于独立的 Vue3/vben/Vue2 UI 仓库中，需与此后端配合使用。
我该怎么把它跑起来？克隆后端代码，并选择与你的 JDK 版本匹配的分支（master=JDK8+Spring Boot 2.7，master-jdk17=JDK17/21+Spring Boot 3.5，master-jdk25=JDK25+Spring Boot 4.x），然后将其连接到独立的管理后台前端仓库之一（Vue3 的 element-plus/vben，或 Vue2 的 element-ui）。
运行之前，我需要准备哪些数据库和基础设施？需要 MySQL（或 Oracle/PostgreSQL/SQL Server/MariaDB/TiDB），以及用于缓存的 Redis（配合 Redisson 使用）；消息队列可选 RabbitMQ/Kafka/RocketMQ。
有付费版或仅限企业的版本吗？否——作者明确表示没有、也永远不会推出商业版；所有功能均完全开源。
这适合用来做哪类企业系统？面向开发中国企业后台管理系统的团队，可选模块包括：商城电商、OA、ERP、WMS、CRM、CMS、MES、HRM、FMS、PMS、AI 平台和物联网（IoT）。
内置的工作流引擎支持哪些功能？它基于 Flowable 构建，提供两种设计器：类似钉钉/飞书的简易设计器和 BPMN 设计器，支持多级审批、会签/或签、委派、加签、超时处理以及条件分支与并行分支。
它包含代码生成器吗？包含。它可以一键生成 Java 和 Vue 的前后端代码、SQL 脚本和 API 文档，适用于单表、树表和主子表。
它支持多租户 SaaS 部署吗？支持。它内置 SaaS 多租户功能，可按租户自定义权限，并在底层提供对业务透明的租户隔离层。
它自带哪些第三方集成？它集成了微信小程序、微信公众号和企业微信，支持钉钉登录、支付宝/微信支付、阿里云/腾讯云短信，以及通过 MinIO、阿里云、腾讯云和七牛云实现的云存储。
What are similar projects?yudao-cloud, JeecgBoot, vhr, mall, financial_intelligence_system_web, Smartstore, SpringAll, newbee-mall
Which topics is it in?bpmn, erp, multi-tenancy, spring-security, crm, springboot, payments, vue3, sso, ecommerce, admin-dashboard, rbac
Creator
YunaiV
Size
196.2 MB
Stars
39.9K
Updated
CommitOct 05Releasev2026.09(jdk25)Sep 30
Age
5y
Commits · 90 Days