Co-authored-by: dingjiangying <dingjiangying@meituan.com>
芋道 ruoyi-vue-pro
基于 Spring Boot 3.x + Vue 3.x 的现代化企业级快速开发平台
⭐ 项目简介
芋道 ruoyi-vue-pro 是一个基于 Spring Boot + Vue 的全栈企业级快速开发平台,致力于为开发者提供现代化、标准化的开发解决方案。
🎯 核心特性
- 🚀 技术前沿:采用 Spring Boot 3.x + Vue 3.x 等主流技术栈
- 🏗️ 架构完善:多模块设计,支持微服务架构演进
- 🔐 权限完备:基于 RBAC 模型,支持多租户、数据权限
- 📊 功能丰富:涵盖系统管理、工作流、商城、CRM、ERP 等业务场景
- 🛠️ 开发高效:代码生成器、接口文档、数据库文档等开发工具
- 📱 多端适配:支持 PC 端、移动端、小程序等多终端
- 💯 质量保障:单元测试覆盖,代码规范化
📋 重要声明
本项目采用 MIT 开源协议,个人与企业可 100% 免费使用,现在、未来都不会有商业版本!
🚀 快速开始
📺 演示地址
- Vue3 + Element Plus:http://dashboard-vue3.yudao.iocoder.cn
- Vue3 + Vben (Ant Design Vue):http://dashboard-vben.yudao.iocoder.cn
- Vue2 + Element UI:http://dashboard.yudao.iocoder.cn
📖 文档教程
- 快速启动:https://doc.iocoder.cn/quick-start/
- 视频教程:https://doc.iocoder.cn/video/
- 开发文档:https://doc.iocoder.cn/
🐰 版本说明
| 版本 | JDK 8 + Spring Boot 2.7 | JDK 17/21 + Spring Boot 3.2 |
|---|---|---|
| 【完整版】ruoyi-vue-pro | master 分支 |
master-jdk17 分支 |
| 【精简版】yudao-boot-mini | master 分支 |
master-jdk17 分支 |
- 【完整版】:包括系统功能、基础设施、会员中心、数据报表、工作流程、商城系统、微信公众号、CRM、ERP 等功能
- 【精简版】:只包括系统功能、基础设施功能,不包括会员中心、数据报表、工作流程、商城系统、微信公众号、CRM、ERP 等功能
可参考 《迁移文档》 ,只需要 5-10 分钟,即可将【完整版】按需迁移到【精简版】
🐯 平台介绍
芋道致力于打造中国一流的快速开发平台,以开发者为中心,提供完整的企业级解决方案。
💡 有任何问题或功能建议,欢迎在 Issues 中反馈
⭐ 如果这个项目对您有帮助,请给我们一个 Star 支持!
🏗️ 技术架构
- 后端架构:
master分支基于 JDK 8 + Spring Boot 2.7,master-jdk17分支基于 JDK 17/21 + Spring Boot 3.2 - 前端技术:Vue3 提供 Element Plus、Vben (Ant Design Vue) 版本,Vue2 提供 Element UI 版本
- 移动端:采用 uni-app 方案,支持 APP、小程序、H5 多端适配
- 数据存储:Spring Boot 多模块架构 + MySQL + MyBatis Plus + Redis + Redisson
- 数据库支持:MySQL、Oracle、PostgreSQL、SQL Server、MariaDB、达梦 DM、TiDB 等
- 消息队列:Event、Redis、RabbitMQ、Kafka、RocketMQ 等多种选择
- 权限认证:Spring Security + Token + Redis,支持多终端认证、SSO 单点登录
- 性能优化:Redis 缓存、动态权限菜单、按钮级权限控制
- 多租户:SaaS 多租户架构,支持自定义租户权限
- 工作流:集成 Flowable,支持动态表单、在线设计、多种审批方式
- 代码生成:一键生成 Java、Vue 前后端代码、SQL 脚本、接口文档
- 实时通信:Spring WebSocket 实现,支持 Token 认证、集群部署
- 第三方集成:微信、支付宝、阿里云、腾讯云等主流平台
- 监控运维:集成报表设计器、大屏设计器、链路追踪等
🐳 项目关系
三个项目的功能对比,可见社区共同整理的 国产开源项目对比 表格。
后端项目
| 项目 | Star | 简介 |
|---|---|---|
| ruoyi-vue-pro | 基于 Spring Boot 多模块架构 | |
| yudao-cloud | 基于 Spring Cloud 微服务架构 | |
| Spring-Boot-Labs | 系统学习 Spring Boot & Cloud 专栏 |
前端项目
| 项目 | Star | 简介 |
|---|---|---|
| yudao-ui-admin-vue3 | 基于 Vue3 + element-plus 实现的管理后台 | |
| yudao-ui-admin-vben | 基于 Vue3 + vben(ant-design-vue) 实现的管理后台 | |
| yudao-mall-uniapp | 基于 uni-app 实现的商城小程序 | |
| yudao-ui-admin-vue2 | 基于 Vue2 + element-ui 实现的管理后台 | |
| yudao-ui-admin-uniapp | 基于 Vue2 + element-ui 实现的管理后台 | |
| yudao-ui-go-view | 基于 Vue3 + naive-ui 实现的大屏报表 |
💼 开源协议与优势
📜 开源协议
本项目采用 MIT License 开源协议,个人与企业可 100% 免费使用,无需保留作者信息或 Copyright 声明。
🌟 项目优势
- 📖 完全开源:代码全部开源,不像某些项目只开源部分代码,让您完全了解整个架构设计
- 🏆 代码质量:遵循《阿里巴巴 Java 开发手册》规范,代码注释详细(113,770 行 Java 代码,42,462 行注释)
- 🔄 持续维护:项目持续更新维护,社区活跃,问题响应及时
详细对比请参考:国产开源项目对比
🤝 商业合作
💻 技术咨询
我们提供专业的技术咨询和项目开发服务,涵盖:
- 🏪 电商系统
- 📊 企业管理系统(OA、ERP、CRM)
- 💰 支付系统
- 💬 即时通讯系统
- 📱 微信公众号/小程序开发
👥 团队介绍
专业团队包括项目经理、架构师、前端/后端工程师、测试工程师、运维工程师,提供全流程开发服务。
联系方式:微信 Aix9975
🔧 功能模块
📋 功能分层架构
🎯 模块分类
- 核心模块(必选):系统功能、基础设施
- 扩展模块(可选):工作流程、支付系统、数据报表、会员中心
- 业务模块(按需):ERP 系统、CRM 系统、商城系统、微信公众号、AI 大模型
📝 图例说明
- 🚀 新增功能:本项目扩展的创新功能
- ⭐️ 重构功能:基于 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 继续审批后进入下一节点 | ✅ |
| 加签 | 允许当前审批人根据需要,自行增加当前节点的审批人,支持向前、向后加签 | ✅ |
| 减签 | (取消加签)在当前审批人操作之前,减少审批人 | ✅ |
| 撤销 | (取消流程)流程发起人,可以对流程进行撤销处理 | ✅ |
| 终止 | 系统管理员,在任意节点终止流程实例 | ✅ |
| 表单权限 | 支持拖拉拽配置表单,每个审批节点可配置只读、编辑、隐藏权限 | ✅ |
| 超时审批 | 配置超时审批时间,超时后自动触发审批通过、不通过、驳回等操作 | ✅ |
| 自动提醒 | 配置提醒时间,到达时间后自动触发短信、邮箱、站内信等通知提醒,支持自定义重复提醒频次 | ✅ |
| 父子流程 | 主流程设置子流程节点,子流程节点会自动触发子流程。子流程结束后,主流程才会执行(继续往下下执行),支持同步子流程、异步子流程 | ✅ |
| 条件分支 | (排它分支)用于在流程中实现决策,即根据条件选择一个分支执行 | ✅ |
| 并行分支 | 允许将流程分成多条分支,不进行条件判断,所有分支都会执行 | ✅ |
| 包容分支 | (条件分支 + 并行分支的结合体)允许基于条件选择多条分支执行,但如果没有任何一个分支满足条件,则可以选择默认分支 | ✅ |
| 路由分支 | 根据条件选择一个分支执行(重定向到指定配置节点),也可以选择默认分支执行(继续往下执行) | ✅ |
| 触发节点 | 执行到该节点,触发 HTTP 请求、HTTP 回调、更新数据、删除数据等 | ✅ |
| 延迟节点 | 执行到该节点,审批等待一段时间再执行,支持固定时长、固定日期等 | ✅ |
| 拓展设置 | 流程前置/后置通知,节点(任务)前置、后置通知,流程报表,自动审批去重,自定流程编号、标题、摘要,流程报表等 | ✅ |
支付系统
| 功能 | 描述 | |
|---|---|---|
| 🚀 | 应用信息 | 配置商户的应用信息,对接支付宝、微信等多个支付渠道 |
| 🚀 | 支付订单 | 查看用户发起的支付宝、微信等的【支付】订单 |
| 🚀 | 退款订单 | 查看用户发起的支付宝、微信等的【退款】订单 |
| 🚀 | 回调通知 | 查看支付回调业务的【支付】【退款】的通知结果 |
| 🚀 | 接入示例 | 提供接入支付系统的【支付】【退款】的功能实战 |
基础设施
| 功能 | 描述 | |
|---|---|---|
| 🚀 | 代码生成 | 前后端代码的生成(Java、Vue、SQL、单元测试),支持 CRUD 下载 |
| 🚀 | 系统接口 | 基于 Swagger 自动生成相关的 RESTful API 接口文档 |
| 🚀 | 数据库文档 | 基于 Screw 自动生成数据库文档,支持导出 Word、HTML、MD 格式 |
| 表单构建 | 拖动表单元素生成相应的 HTML 代码,支持导出 JSON、Vue 文件 | |
| 🚀 | 配置管理 | 对系统动态配置常用参数,支持 SpringBoot 加载 |
| ⭐️ | 定时任务 | 在线(添加、修改、删除)任务调度包含执行结果日志 |
| 🚀 | 文件服务 | 支持将文件存储到 S3(MinIO、阿里云、腾讯云、七牛云)、本地、FTP、数据库等 |
| 🚀 | WebSocket | 提供 WebSocket 接入示例,支持一对一、一对多发送方式 |
| 🚀 | API 日志 | 包括 RESTful API 访问日志、异常日志两部分,方便排查 API 相关的问题 |
| MySQL 监控 | 监视当前系统数据库连接池状态,可进行分析SQL找出系统性能瓶颈 | |
| Redis 监控 | 监控 Redis 数据库的使用情况,使用的 Redis Key 管理 | |
| 🚀 | 消息队列 | 基于 Redis 实现消息队列,Stream 提供集群消费,Pub/Sub 提供广播消费 |
| 🚀 | Java 监控 | 基于 Spring Boot Admin 实现 Java 应用的监控 |
| 🚀 | 链路追踪 | 接入 SkyWalking 组件,实现链路追踪 |
| 🚀 | 日志中心 | 接入 SkyWalking 组件,实现日志中心 |
| 🚀 | 服务保障 | 基于 Redis 实现分布式锁、幂等、限流功能,满足高并发场景 |
| 🚀 | 日志服务 | 轻量级日志中心,查看远程服务器的日志 |
| 🚀 | 单元测试 | 基于 JUnit + Mockito 实现单元测试,保证功能的正确性、代码的质量等 |
数据报表
| 功能 | 描述 | |
|---|---|---|
| 🚀 | 报表设计器 | 支持数据报表、图形报表、打印设计等 |
| 🚀 | 大屏设计器 | 拖拽生成数据大屏,内置几十种图表组件 |
微信公众号
| 功能 | 描述 | |
|---|---|---|
| 🚀 | 账号管理 | 配置接入的微信公众号,可支持多个公众号 |
| 🚀 | 数据统计 | 统计公众号的用户增减、累计用户、消息概况、接口分析等数据 |
| 🚀 | 粉丝管理 | 查看已关注、取关的粉丝列表,可对粉丝进行同步、打标签等操作 |
| 🚀 | 消息管理 | 查看粉丝发送的消息列表,可主动回复粉丝消息 |
| 🚀 | 自动回复 | 自动回复粉丝发送的消息,支持关注回复、消息回复、关键字回复 |
| 🚀 | 标签管理 | 对公众号的标签进行创建、查询、修改、删除等操作 |
| 🚀 | 菜单管理 | 自定义公众号的菜单,也可以从公众号同步菜单 |
| 🚀 | 素材管理 | 管理公众号的图片、语音、视频等素材,支持在线播放语音、视频 |
| 🚀 | 图文草稿箱 | 新增常用的图文素材到草稿箱,可发布到公众号 |
| 🚀 | 图文发表记录 | 查看已发布成功的图文素材,支持删除操作 |
商城系统
演示地址:https://doc.iocoder.cn/mall-preview/
会员中心
| 功能 | 描述 | |
|---|---|---|
| 🚀 | 会员管理 | 会员是 C 端的消费者,该功能用于会员的搜索与管理 |
| 🚀 | 会员标签 | 对会员的标签进行创建、查询、修改、删除等操作 |
| 🚀 | 会员等级 | 对会员的等级、成长值进行管理,可用于订单折扣等会员权益 |
| 🚀 | 会员分组 | 对会员进行分组,用于用户画像、内容推送等运营手段 |
| 🚀 | 积分签到 | 回馈给签到、消费等行为的积分,会员可订单抵现、积分兑换等途径消耗 |
ERP 系统
演示地址:https://doc.iocoder.cn/erp-preview/
CRM 系统
演示地址:https://doc.iocoder.cn/crm-preview/
AI 大模型
演示地址:https://doc.iocoder.cn/ai-preview/
🛠️ 技术栈
🏗️ 项目结构
| 模块 | 说明 |
|---|---|
yudao-dependencies |
Maven 依赖版本管理 |
yudao-framework |
Java 框架扩展 |
yudao-server |
管理后台 + 用户 APP 服务端 |
yudao-module-system |
系统功能模块 |
yudao-module-infra |
基础设施模块 |
yudao-module-bpm |
工作流程模块 |
yudao-module-pay |
支付系统模块 |
yudao-module-member |
会员中心模块 |
yudao-module-mall |
商城系统模块 |
yudao-module-erp |
ERP 系统模块 |
yudao-module-crm |
CRM 系统模块 |
yudao-module-ai |
AI 大模型模块 |
yudao-module-mp |
微信公众号模块 |
yudao-module-report |
数据报表模块 |
🔧 技术框架
| 框架 | 说明 | 版本 | 学习指南 |
|---|---|---|---|
| Spring Boot | 应用开发框架 | 2.7.18 | 文档 |
| MySQL | 数据库服务器 | 5.7 / 8.0+ | |
| Druid | JDBC 连接池、监控组件 | 1.2.23 | 文档 |
| MyBatis Plus | MyBatis 增强工具包 | 3.5.7 | 文档 |
| Dynamic Datasource | 动态数据源 | 3.6.1 | 文档 |
| Redis | key-value 数据库 | 5.0 / 6.0 /7.0 | |
| Redisson | Redis 客户端 | 3.32.0 | 文档 |
| Spring MVC | MVC 框架 | 5.3.24 | 文档 |
| Spring Security | Spring 安全框架 | 5.7.11 | 文档 |
| Hibernate Validator | 参数校验组件 | 6.2.5 | 文档 |
| Flowable | 工作流引擎 | 6.8.0 | 文档 |
| Quartz | 任务调度组件 | 2.3.2 | 文档 |
| Springdoc | Swagger 文档 | 1.7.0 | 文档 |
| SkyWalking | 分布式应用追踪系统 | 8.12.0 | 文档 |
| Spring Boot Admin | Spring Boot 监控平台 | 2.7.10 | 文档 |
| Jackson | JSON 工具库 | 2.13.5 | |
| MapStruct | Java Bean 转换 | 1.6.3 | 文档 |
| Lombok | 消除冗长的 Java 代码 | 1.18.34 | 文档 |
| JUnit | Java 单元测试框架 | 5.8.2 | - |
| Mockito | Java Mock 框架 | 4.8.0 | - |
🐷 演示图
系统功能
| 模块 | biu | biu | biu |
|---|---|---|---|
| 登录 & 首页 | ![]() |
![]() |
![]() |
| 用户 & 应用 | ![]() |
![]() |
![]() |
| 租户 & 套餐 | ![]() |
![]() |
- |
| 部门 & 岗位 | ![]() |
![]() |
- |
| 菜单 & 角色 | ![]() |
![]() |
- |
| 审计日志 | ![]() |
![]() |
- |
| 短信 | ![]() |
![]() |
![]() |
| 字典 & 敏感词 | ![]() |
![]() |
![]() |
| 错误码 & 通知 | ![]() |
![]() |
- |
工作流程
| 模块 | biu | biu | biu |
|---|---|---|---|
| 流程模型 | ![]() |
![]() |
![]() |
| 表单 & 分组 | ![]() |
![]() |
- |
| 我的流程 | ![]() |
![]() |
![]() |
| 待办 & 已办 | ![]() |
![]() |
![]() |
| OA 请假 | ![]() |
![]() |
![]() |
基础设施
| 模块 | biu | biu | biu |
|---|---|---|---|
| 代码生成 | ![]() |
![]() |
- |
| 文档 | ![]() |
![]() |
- |
| 文件 & 配置 | ![]() |
![]() |
![]() |
| 定时任务 | ![]() |
![]() |
- |
| API 日志 | ![]() |
![]() |
- |
| MySQL & Redis | ![]() |
![]() |
- |
| 监控平台 | ![]() |
![]() |
![]() |
支付系统
| 模块 | biu | biu | biu |
|---|---|---|---|
| 商家 & 应用 | ![]() |
![]() |
![]() |
| 支付 & 退款 | ![]() |
![]() |
--- |
数据报表
| 模块 | biu | biu | biu |
|---|---|---|---|
| 报表设计器 | ![]() |
![]() |
![]() |
| 大屏设计器 | ![]() |
![]() |
![]() |
移动端(管理后台)
| biu | biu | biu |
|---|---|---|
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
目前已实现登录、我的、工作台、编辑资料、头像修改、密码修改、常见问题、关于我们等基础功能。
🤝 贡献指南
欢迎参与项目贡献!请遵循以下流程:
- Fork 本项目
- 创建 功能分支:
git checkout -b feature/AmazingFeature - 提交 您的修改:
git commit -m 'Add some AmazingFeature' - 推送 到分支:
git push origin feature/AmazingFeature - 提交 Pull Request
📋 开发规范
- 遵循阿里巴巴 Java 开发手册
- 保持代码风格一致
- 添加必要的单元测试
- 完善文档说明
📞 联系我们
- 官方文档:https://doc.iocoder.cn/
- 问题反馈:GitHub Issues
- 技术交流:加入官方微信群(扫码关注公众号获取入群方式)
🙏 致谢
感谢以下开源项目为本项目提供支持:
- RuoYi-Vue - 基础框架
- Spring Boot - 应用框架
- Vue.js - 前端框架
- Element Plus - UI 组件库
⭐ 如果这个项目对您有帮助,请给我们一个 Star 支持!






















































































