📖 目录
💡 项目简介
芋道管理系统 是一个基于 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
📚 详细文档
🌐 在线体验
🔑 体验账号:admin / admin123
📦 版本说明
📋 版本对比
| 功能模块 |
完整版 |
精简版 |
说明 |
| 系统功能 |
✅ |
✅ |
用户、角色、菜单、部门等基础功能 |
| 基础设施 |
✅ |
✅ |
代码生成、文件存储、定时任务等 |
| 工作流程 |
✅ |
❌ |
Flowable 工作流引擎 |
| 商城系统 |
✅ |
❌ |
完整的电商解决方案 |
| 会员中心 |
✅ |
❌ |
会员管理、积分、等级等 |
| CRM系统 |
✅ |
❌ |
客户、商机、合同管理 |
| ERP系统 |
✅ |
❌ |
采购、销售、库存管理 |
| 微信公众号 |
✅ |
❌ |
公众号管理和运营 |
| AI大模型 |
✅ |
❌ |
智能对话和内容生成 |
| 数据报表 |
✅ |
❌ |
报表设计器和大屏设计器 |
| 支付系统 |
✅ |
❌ |
多渠道支付集成 |
💡 可参考 迁移文档 进行按需迁移
🏗️ 系统架构
🎯 架构特点
- 前后端分离 - 前端Vue3,后端Spring Boot,RESTful 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系统
专业的客户关系管理系统:
- 客户管理 - 客户信息、跟进记录、客户分析
- 销售管理 - 商机管理、销售流程、业绩统计
- 合同管理 - 合同创建、审批、执行跟踪
- 回款管理 - 回款计划、回款记录
- 报表分析 - 销售漏斗、业绩排行、客户分析
📋 ERP系统
企业资源规划系统:
- 采购管理 - 供应商、采购订单、入库管理
- 销售管理 - 客户、销售订单、出库管理
- 库存管理 - 商品、仓库、库存盘点
- 财务管理 - 收支管理、账目统计
🤖 AI大模型
智能AI助手集成:
- 对话聊天 - 智能问答、上下文理解
- 内容生成 - 文章写作、代码生成
- 图片生成 - AI绘画、图片处理
- 知识库 - 文档问答、知识检索
- 模型管理 - 多模型支持、API配置
👥 会员中心
| 功能 |
描述 |
特性 |
| 👤 会员管理 |
C端用户管理 |
会员信息、搜索、管理 |
| 🏷️ 会员标签 |
用户标签系统 |
标签创建、管理、应用 |
| 🎖️ 会员等级 |
等级成长体系 |
等级权益、成长值管理 |
| 👥 会员分组 |
用户分组功能 |
用户画像、精准营销 |
| ⭐ 积分签到 |
积分奖励机制 |
签到奖励、积分兑换 |
📱 演示图片
🖥️ 系统功能
| 模块 |
登录首页 |
用户管理 |
角色权限 |
| 截图 |
 |
 |
 |
| 功能 |
安全登录、个人中心 |
用户CRUD、部门岗位分配 |
角色权限、菜单权限、数据权限 |
| 模块 |
菜单管理 |
部门管理 |
系统监控 |
| 截图 |
 |
 |
 |
| 功能 |
菜单树、权限标识、按钮权限 |
组织架构、树形展示 |
API文档、在线调试 |
🔄 工作流程
| 模块 |
流程设计 |
流程审批 |
任务处理 |
| 截图 |
 |
 |
 |
| 功能 |
可视化设计、拖拽建模 |
流程发起、进度跟踪 |
待办任务、审批处理 |
🏗️ 基础设施
| 模块 |
代码生成 |
定时任务 |
系统监控 |
| 截图 |
 |
 |
 |
| 功能 |
一键生成、模板配置 |
任务调度、执行日志 |
性能监控、JVM状态 |
💰 支付系统
| 模块 |
应用配置 |
支付订单 |
退款管理 |
| 截图 |
 |
 |
 |
| 功能 |
多渠道配置、参数设置 |
订单查询、状态跟踪 |
退款申请、退款记录 |
📊 数据报表
| 模块 |
报表设计 |
大屏设计 |
数据可视化 |
| 截图 |
 |
 |
 |
| 功能 |
拖拽设计、数据源配置 |
组件丰富、实时预览 |
数据大屏、可视化展示 |
📱 移动端管理
移动端已实现:登录认证、工作台、个人资料、密码修改、系统管理等核心功能。
🤝 参与贡献
我们非常欢迎各种形式的贡献!
💡 贡献方式
- 🐛 提交 Bug - 在 Issues 中报告问题
- 💡 功能建议 - 提出新功能想法和改进建议
- 📝 代码贡献 - 提交 Pull Request
- 📖 文档完善 - 改进文档和示例
- ⭐ Star 支持 - 给项目点 Star 是对我们最大的鼓励
🔧 开发指南
- Fork 本项目
- 创建功能分支:
git checkout -b feature/new-feature
- 提交更改:
git commit -am 'Add some feature'
- 推送分支:
git push origin feature/new-feature
- 提交 Pull Request
📞 联系我们
🎯 团队服务
我们提供专业的外包开发服务:
- 全栈开发 - 前端、后端、移动端全栈解决方案
- 系统集成 - 企业级系统集成和定制开发
- 技术咨询 - 架构设计、技术选型、性能优化
- 培训服务 - 技术培训、代码审查、最佳实践
💼 联系微信:Aix9975
📄 开源协议
🎉 为什么选择我们?
① 更宽松的开源协议
采用 MIT License 开源协议:
- ✅ 个人/企业免费使用 - 无需保留版权信息
- ✅ 商业友好 - 可用于商业项目
- ✅ 无使用限制 - 修改、分发、私有化部署
- ✅ 比 Apache 2.0 更宽松 - 更少的法律限制
② 真正的全部开源
与其他项目对比:
| 对比项目 |
开源程度 |
商业化 |
社区活跃度 |
代码质量 |
文档完善度 |
| 芋道 |
💯 全部开源 |
❌ 永久免费 |
🔥 非常活跃 |
⭐ 优秀 |
📚 详细完整 |
| 项目A |
⚠️ 部分开源 |
💰 企业收费 |
📈 一般 |
⚖️ 良好 |
📄 基础 |
| 项目B |
⚠️ 核心收费 |
💰 按模块收费 |
📉 较少 |
⚖️ 一般 |
❓ 不完整 |
③ 高质量的代码标准
- 113,770 行 Java 代码
- 42,462 行代码注释
- 注释覆盖率 37.3%
- 遵循《阿里巴巴 Java 开发手册》规范
- 完整的单元测试覆盖
🌟 如果这个项目对你有帮助,请给我们一个 Star!
「我喜欢写代码,乐此不疲」
「我喜欢做开源,以此为乐」
感谢每一位贡献者的付出! 🙏