Cursor Agent a29840edc9 Refactor README with comprehensive project overview and detailed features
Co-authored-by: dingjiangying <dingjiangying@meituan.com>
2025-07-30 07:18:00 +00:00
2025-05-03 22:11:31 +08:00
2023-11-25 22:05:57 +08:00
2024-04-20 17:53:41 +08:00
2021-05-03 22:43:08 +08:00

🚀 芋道 ruoyi-vue-pro

基于 Spring Boot 3 + Vue 3 的全栈开源管理系统

Spring Boot Vue JDK License GitHub stars

🎯 100% 开源免费 | 企业级架构 | 开箱即用


📖 目录


💡 项目简介

芋道管理系统 是一个基于 Spring Boot 3 + Vue 3 的全栈开源管理系统,致力于为开发者提供一套完整的企业级快速开发解决方案。

🎯 项目愿景

「以开发者为中心,打造中国第一流的快速开发平台」

  • 完全开源免费 - 采用 MIT 协议,个人与企业可 100% 免费使用
  • 企业级架构 - 支持多租户、微服务、分布式部署
  • 开箱即用 - 内置丰富的业务功能模块,快速构建应用
  • 高质量代码 - 遵循阿里巴巴开发规范,代码注释详细
  • 持续更新 - 紧跟技术趋势,长期维护支持

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


核心特性

🔥 技术先进性

  • 🚀 最新技术栈 - Spring Boot 3.4 + Vue 3 + JDK 17+
  • 🚀 多数据库支持 - MySQL、PostgreSQL、Oracle、SQL Server 等
  • 🚀 多环境适配 - 支持 Docker、K8s 部署
  • 🚀 微服务架构 - 支持单体和微服务两种架构模式

💼 业务完整性

  • 📊 工作流引擎 - 基于 Flowable支持复杂业务流程
  • 🛒 商城系统 - 完整的电商解决方案
  • 📞 CRM系统 - 客户关系管理
  • 📋 ERP系统 - 企业资源规划
  • 🤖 AI大模型 - 集成主流AI服务
  • 💰 支付系统 - 支持多种支付方式

🛡️ 安全可靠性

  • 🔐 多重认证 - 支持 SSO、OAuth2、JWT
  • 🏢 多租户架构 - SaaS 场景完美支持
  • 🔒 权限控制 - 精细到按钮级别的权限管理
  • 📊 监控完善 - 链路追踪、性能监控、日志中心

🚀 快速开始

📋 环境要求

组件 版本要求 说明
JDK 17+ 推荐使用 JDK 21
Node.js 16+ 推荐使用 18+
MySQL 5.7+ 推荐使用 8.0+
Redis 5.0+ 推荐使用 7.0+

一键启动

# 1. 克隆项目
git clone https://gitee.com/zhijiantianya/ruoyi-vue-pro.git

# 2. 导入数据库
# 执行 sql/mysql/ruoyi-vue-pro.sql

# 3. 启动后端
cd ruoyi-vue-pro
mvn clean install
cd yudao-server
mvn spring-boot:run

# 4. 启动前端 (另开终端)
cd yudao-ui-admin-vue3
npm install
npm run dev

📚 详细文档


🌐 在线体验

版本类型 演示地址 技术栈
Vue3 标准版 http://dashboard-vue3.yudao.iocoder.cn Vue3 + Element Plus
Vue3 企业版 http://dashboard-vben.yudao.iocoder.cn Vue3 + Ant Design Vue
Vue2 经典版 http://dashboard.yudao.iocoder.cn Vue2 + Element UI
商城系统 https://doc.iocoder.cn/mall-preview/ 完整电商解决方案
CRM系统 https://doc.iocoder.cn/crm-preview/ 客户关系管理
ERP系统 https://doc.iocoder.cn/erp-preview/ 企业资源规划
AI大模型 https://doc.iocoder.cn/ai-preview/ 智能对话与内容生成

🔑 体验账号admin / admin123


📦 版本说明

版本类型 仓库地址 JDK 8 + Spring Boot 2.7 JDK 17+ + Spring Boot 3.4
完整版 ruoyi-vue-pro master 分支 master-jdk17 分支
精简版 yudao-boot-mini master 分支 master-jdk17 分支
云原生 yudao-cloud master 分支 master-jdk17 分支

📋 版本对比

功能模块 完整版 精简版 说明
系统功能 用户、角色、菜单、部门等基础功能
基础设施 代码生成、文件存储、定时任务等
工作流程 Flowable 工作流引擎
商城系统 完整的电商解决方案
会员中心 会员管理、积分、等级等
CRM系统 客户、商机、合同管理
ERP系统 采购、销售、库存管理
微信公众号 公众号管理和运营
AI大模型 智能对话和内容生成
数据报表 报表设计器和大屏设计器
支付系统 多渠道支付集成

💡 可参考 迁移文档 进行按需迁移


🏗️ 系统架构

系统架构图

🎯 架构特点

  • 前后端分离 - 前端Vue3后端Spring BootRESTful API
  • 微服务支持 - 支持单体应用和微服务架构
  • 多租户架构 - 原生支持SaaS多租户模式
  • 高可用设计 - 支持集群部署Redis缓存消息队列
  • 安全可靠 - Spring Security + JWT + OAuth2

📊 项目关系

项目演进图

🔧 技术栈

🖥️ 后端技术

技术 版本 说明 学习文档
Spring Boot 3.4.5 核心框架 📖 教程
Spring Security 6.3.1 安全框架 📖 教程
MyBatis Plus 3.5.7 ORM 框架 📖 教程
Flowable 7.0.0 工作流引擎 📖 教程
Redis 7.0+ 缓存数据库 -
MySQL 8.0+ 主数据库 -
Quartz 2.3.2 定时任务 📖 教程
SkyWalking 9.0.0 链路追踪 📖 教程

🌐 前端技术

技术 版本 说明
Vue 3.2+ 前端框架
Element Plus latest UI 组件库
Ant Design latest 企业级 UI 组件库
TypeScript latest 类型安全
Vite latest 构建工具
Pinia latest 状态管理

🔧 开发工具

工具 说明
IDEA 推荐 IDE
VS Code 前端开发工具
Navicat 数据库管理工具
Redis Desktop Redis 管理工具
Postman API 测试工具

🎯 内置功能

功能分层图

🏢 系统管理

系统功能图
功能模块 功能描述 状态
👥 用户管理 系统用户配置,支持部门、岗位、角色分配
🔐 角色管理 角色菜单权限分配,支持数据范围权限控制
📋 菜单管理 系统菜单配置,支持按钮级权限控制
🏢 部门管理 组织机构管理,树形结构展示
💼 岗位管理 用户岗位职务配置
🏪 租户管理 SaaS 多租户支持,租户隔离
📊 字典管理 系统数据字典维护
📱 短信管理 短信渠道、模板、日志管理
📧 邮件管理 邮件发送配置和日志
🔔 站内信 系统内消息通知
📝 操作日志 用户操作行为记录
🔑 登录日志 用户登录记录和安全监控
⚠️ 错误码 系统错误码统一管理
📢 通知公告 系统公告信息发布
🚫 敏感词 内容安全敏感词过滤
🔗 应用管理 SSO 单点登录应用管理
🌍 地区管理 省市区数据管理IP 归属地

🔄 工作流程

工作流功能图

基于 Flowable 引擎构建,支持国产数据库,满足中国特色流程需求:

流程设计器类型 BPMN 专业设计器 钉钉/飞书 简单设计器
适用场景 复杂业务流程编排 轻量级审批流程
设计复杂度 高,支持复杂分支逻辑 低,拖拽式快速配置
学习成本 需要了解BPMN规范 10分钟快速上手
核心功能 描述 支持程度
🎨 双设计器 BPMN标准设计器 + 仿钉钉简单设计器
👥 会签流程 多人同时审批,全部同意后流转
🔄 或签流程 多人中任一审批即可流转
📋 依次审批 按顺序逐一审批(顺序会签)
📤 抄送功能 审批结果通知相关人员
↩️ 驳回功能 退回至发起人/上一节点/任意节点
🔄 转办委派 转办他人处理,委派协助审批
加签减签 动态增减审批人员
撤销终止 发起人撤销,管理员终止
📝 表单权限 每个节点配置字段读写权限
超时处理 超时自动审批通过/驳回
🔔 自动提醒 到期前自动提醒,支持多种通知方式
👨‍👩‍👧‍👦 父子流程 主流程调用子流程,支持同步/异步
🌊 条件分支 根据条件选择执行路径
🔀 并行分支 多条分支同时执行
🎯 包容分支 条件并行分支的组合
🚀 触发节点 HTTP请求、数据操作等自动化
延迟节点 等待指定时间后继续

💰 支付系统

功能 描述 支持渠道
💳 支付 统一支付接口 支付宝、微信、银联等
💸 退款 统一退款接口 支付宝、微信、银联等
📊 订单 支付订单管理 支付、退款订单查询和管理
🔔 通知 支付结果通知 异步通知和同步返回
🛠️ 配置 支付渠道配置 多应用、多渠道配置
💼 示例 接入代码示例 Java、前端接入示例

🏗️ 基础设施

基础设施功能图
功能模块 功能描述 核心特性
代码生成器 一键生成前后端代码 Java、Vue、SQL、单元测试
📖 接口文档 基于 Swagger 自动生成 API 文档 在线调试、导出文档
📊 数据库文档 自动生成数据库设计文档 支持多种格式导出
📝 表单构建器 拖拽式表单设计 所见即所得导出Vue组件
⚙️ 配置管理 动态配置系统参数 热更新,无需重启
定时任务 在线管理定时任务 Cron表达式执行日志
📁 文件服务 多种存储方式支持 本地、云存储、FTP、数据库
💬 WebSocket 实时通信支持 一对一、一对多、广播消息
📋 API日志 接口访问日志 请求响应记录,异常日志
🗄️ 数据库监控 数据库性能监控 连接池状态SQL分析
🔴 Redis监控 Redis 使用情况监控 Key管理内存使用统计
📨 消息队列 基于 Redis 的消息队列 Stream集群消费Pub/Sub广播
📈 Java监控 应用性能监控 基于Spring Boot Admin
🔍 链路追踪 分布式链路追踪 SkyWalking集成
📝 日志中心 集中式日志管理 日志收集、查询、分析
🛡️ 服务保障 高并发场景支持 分布式锁、幂等、限流
🔬 单元测试 高质量代码保障 JUnit + Mockito

📊 数据报表

功能 描述 特性
📈 报表设计器 可视化报表设计 数据报表、图形报表、打印设计
📺 大屏设计器 数据大屏构建 拖拽式设计,内置丰富图表组件

📱 微信公众号

功能 描述 特性
🏪 账号管理 多公众号管理 支持多个公众号接入
📊 数据统计 运营数据分析 用户增长、消息概况、接口分析
👥 粉丝管理 粉丝信息管理 同步粉丝、标签管理、分组管理
💬 消息管理 消息收发管理 查看粉丝消息、主动回复
🤖 自动回复 智能回复配置 关注回复、关键字回复、消息回复
🏷️ 标签管理 粉丝标签系统 创建、修改、删除标签
📋 菜单管理 自定义菜单 菜单配置、同步菜单
🎨 素材管理 多媒体素材管理 图片、语音、视频管理
✍️ 图文管理 图文消息管理 草稿箱、发布记录

🛒 商城系统

商城功能图

完整的电商解决方案,包含:

  • 商品管理 - 商品分类、属性、规格、库存
  • 订单管理 - 下单、支付、发货、退换货
  • 会员管理 - 会员等级、积分、优惠券
  • 营销工具 - 秒杀、团购、分销、拼团
  • 数据统计 - 销售报表、用户分析
  • 移动端 - 小程序、H5、APP
商城预览图

🤝 CRM系统

CRM功能图

专业的客户关系管理系统:

  • 客户管理 - 客户信息、跟进记录、客户分析
  • 销售管理 - 商机管理、销售流程、业绩统计
  • 合同管理 - 合同创建、审批、执行跟踪
  • 回款管理 - 回款计划、回款记录
  • 报表分析 - 销售漏斗、业绩排行、客户分析

📋 ERP系统

ERP功能图

企业资源规划系统:

  • 采购管理 - 供应商、采购订单、入库管理
  • 销售管理 - 客户、销售订单、出库管理
  • 库存管理 - 商品、仓库、库存盘点
  • 财务管理 - 收支管理、账目统计

🤖 AI大模型

AI功能图

智能AI助手集成

  • 对话聊天 - 智能问答、上下文理解
  • 内容生成 - 文章写作、代码生成
  • 图片生成 - AI绘画、图片处理
  • 知识库 - 文档问答、知识检索
  • 模型管理 - 多模型支持、API配置
AI预览图

👥 会员中心

功能 描述 特性
👤 会员管理 C端用户管理 会员信息、搜索、管理
🏷️ 会员标签 用户标签系统 标签创建、管理、应用
🎖️ 会员等级 等级成长体系 等级权益、成长值管理
👥 会员分组 用户分组功能 用户画像、精准营销
积分签到 积分奖励机制 签到奖励、积分兑换

📱 演示图片

🖥️ 系统功能

模块 登录首页 用户管理 角色权限
截图 登录 用户管理 角色管理
功能 安全登录、个人中心 用户CRUD、部门岗位分配 角色权限、菜单权限、数据权限
模块 菜单管理 部门管理 系统监控
截图 菜单管理 部门管理 系统接口
功能 菜单树、权限标识、按钮权限 组织架构、树形展示 API文档、在线调试

🔄 工作流程

模块 流程设计 流程审批 任务处理
截图 流程设计 我的流程 任务列表
功能 可视化设计、拖拽建模 流程发起、进度跟踪 待办任务、审批处理

🏗️ 基础设施

模块 代码生成 定时任务 系统监控
截图 代码生成 定时任务 Java监控
功能 一键生成、模板配置 任务调度、执行日志 性能监控、JVM状态

💰 支付系统

模块 应用配置 支付订单 退款管理
截图 应用信息 支付订单 退款订单
功能 多渠道配置、参数设置 订单查询、状态跟踪 退款申请、退款记录

📊 数据报表

模块 报表设计 大屏设计 数据可视化
截图 报表设计 大屏设计 大屏预览
功能 拖拽设计、数据源配置 组件丰富、实时预览 数据大屏、可视化展示

📱 移动端管理

登录首页 工作台 个人中心
移动端1 移动端2 移动端3
系统管理 数据统计 消息通知
移动端4 移动端5 移动端6

移动端已实现:登录认证、工作台、个人资料、密码修改、系统管理等核心功能。


🤝 参与贡献

我们非常欢迎各种形式的贡献!

💡 贡献方式

  • 🐛 提交 Bug - 在 Issues 中报告问题
  • 💡 功能建议 - 提出新功能想法和改进建议
  • 📝 代码贡献 - 提交 Pull Request
  • 📖 文档完善 - 改进文档和示例
  • Star 支持 - 给项目点 Star 是对我们最大的鼓励

🔧 开发指南

  1. Fork 本项目
  2. 创建功能分支:git checkout -b feature/new-feature
  3. 提交更改:git commit -am 'Add some feature'
  4. 推送分支:git push origin feature/new-feature
  5. 提交 Pull Request

📞 联系我们

  • 💬 QQ群207719436
  • 💌 微信Aix9975 (项目外包咨询)
  • 📧 邮箱yudao@yudao.cn
  • 🌐 官网https://www.iocoder.cn

🎯 团队服务

我们提供专业的外包开发服务:

  • 全栈开发 - 前端、后端、移动端全栈解决方案
  • 系统集成 - 企业级系统集成和定制开发
  • 技术咨询 - 架构设计、技术选型、性能优化
  • 培训服务 - 技术培训、代码审查、最佳实践

💼 联系微信Aix9975


📄 开源协议

🎉 为什么选择我们?

① 更宽松的开源协议

采用 MIT License 开源协议:

  • 个人/企业免费使用 - 无需保留版权信息
  • 商业友好 - 可用于商业项目
  • 无使用限制 - 修改、分发、私有化部署
  • 比 Apache 2.0 更宽松 - 更少的法律限制

② 真正的全部开源

开源项目对比

与其他项目对比:

对比项目 开源程度 商业化 社区活跃度 代码质量 文档完善度
芋道 💯 全部开源 永久免费 🔥 非常活跃 优秀 📚 详细完整
项目A ⚠️ 部分开源 💰 企业收费 📈 一般 ⚖️ 良好 📄 基础
项目B ⚠️ 核心收费 💰 按模块收费 📉 较少 ⚖️ 一般 不完整

③ 高质量的代码标准

  • 113,770 行 Java 代码
  • 42,462 行代码注释
  • 注释覆盖率 37.3%
  • 遵循《阿里巴巴 Java 开发手册》规范
  • 完整的单元测试覆盖

🌟 如果这个项目对你有帮助,请给我们一个 Star

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


Gitee Stars GitHub Stars

感谢每一位贡献者的付出! 🙏

Description
🔥 官方推荐 🔥 RuoYi-Vue 全新 Pro 版本,优化重构所有功能。基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 微信小程序,支持 RBAC 动态权限、数据权限、SaaS 多租户、Flowable 工作流、三方登录、支付、短信、商城、CRM、ERP、AI 大模型等功能。你的 ️ Star ️,是作者生发的动力!
Readme MIT 210 MiB
Languages
Java 83.4%
TSQL 8.3%
PLpgSQL 8%
Python 0.2%