---
## 📖 目录
- [💡 项目简介](#-项目简介)
- [✨ 核心特性](#-核心特性)
- [🚀 快速开始](#-快速开始)
- [🌐 在线体验](#-在线体验)
- [📦 版本说明](#-版本说明)
- [🏗️ 系统架构](#️-系统架构)
- [🔧 技术栈](#-技术栈)
- [🎯 内置功能](#-内置功能)
- [📱 演示图片](#-演示图片)
- [🤝 参与贡献](#-参与贡献)
- [📄 开源协议](#-开源协议)
---
## 💡 项目简介
**芋道管理系统** 是一个基于 **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+ |
### ⚡ 一键启动
```bash
# 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
```
### 📚 详细文档
- 🔗 **启动指南**：[https://doc.iocoder.cn/quick-start/](https://doc.iocoder.cn/quick-start/)
- 🎥 **视频教程**：[https://doc.iocoder.cn/video/](https://doc.iocoder.cn/video/)
- 📖 **开发文档**：[https://doc.iocoder.cn/](https://doc.iocoder.cn/)
---
## 🌐 在线体验
| 版本类型 | 演示地址 | 技术栈 |
|-----------------|-------------------------------------------------------------------------------------------|---------------------------|
| **Vue3 标准版** | [http://dashboard-vue3.yudao.iocoder.cn](http://dashboard-vue3.yudao.iocoder.cn) | Vue3 + Element Plus |
| **Vue3 企业版** | [http://dashboard-vben.yudao.iocoder.cn](http://dashboard-vben.yudao.iocoder.cn) | Vue3 + Ant Design Vue |
| **Vue2 经典版** | [http://dashboard.yudao.iocoder.cn](http://dashboard.yudao.iocoder.cn) | Vue2 + Element UI |
| **商城系统** | [https://doc.iocoder.cn/mall-preview/](https://doc.iocoder.cn/mall-preview/) | 完整电商解决方案 |
| **CRM系统** | [https://doc.iocoder.cn/crm-preview/](https://doc.iocoder.cn/crm-preview/) | 客户关系管理 |
| **ERP系统** | [https://doc.iocoder.cn/erp-preview/](https://doc.iocoder.cn/erp-preview/) | 企业资源规划 |
| **AI大模型** | [https://doc.iocoder.cn/ai-preview/](https://doc.iocoder.cn/ai-preview/) | 智能对话与内容生成 |
> 🔑 **体验账号**：admin / admin123
---
## 📦 版本说明
| 版本类型 | 仓库地址 | JDK 8 + Spring Boot 2.7 | JDK 17+ + Spring Boot 3.4 |
|-------|------------------------------------------------------------------------|--------------------------|----------------------------|
| **完整版** | [ruoyi-vue-pro](https://gitee.com/zhijiantianya/ruoyi-vue-pro) | `master` 分支 | `master-jdk17` 分支 |
| **精简版** | [yudao-boot-mini](https://gitee.com/yudaocode/yudao-boot-mini) | `master` 分支 | `master-jdk17` 分支 |
| **云原生** | [yudao-cloud](https://gitee.com/zhijiantianya/yudao-cloud) | `master` 分支 | `master-jdk17` 分支 |
### 📋 版本对比
| 功能模块 | 完整版 | 精简版 | 说明 |
|----------|-----|-----|-------------------|
| 系统功能 | ✅ | ✅ | 用户、角色、菜单、部门等基础功能 |
| 基础设施 | ✅ | ✅ | 代码生成、文件存储、定时任务等 |
| 工作流程 | ✅ | ❌ | Flowable 工作流引擎 |
| 商城系统 | ✅ | ❌ | 完整的电商解决方案 |
| 会员中心 | ✅ | ❌ | 会员管理、积分、等级等 |
| CRM系统 | ✅ | ❌ | 客户、商机、合同管理 |
| ERP系统 | ✅ | ❌ | 采购、销售、库存管理 |
| 微信公众号 | ✅ | ❌ | 公众号管理和运营 |
| AI大模型 | ✅ | ❌ | 智能对话和内容生成 |
| 数据报表 | ✅ | ❌ | 报表设计器和大屏设计器 |
| 支付系统 | ✅ | ❌ | 多渠道支付集成 |
> 💡 可参考 [迁移文档](https://doc.iocoder.cn/migrate-module/) 进行按需迁移
---
## 🏗️ 系统架构
### 🎯 架构特点
- **前后端分离** - 前端Vue3，后端Spring Boot，RESTful API
- **微服务支持** - 支持单体应用和微服务架构
- **多租户架构** - 原生支持SaaS多租户模式
- **高可用设计** - 支持集群部署，Redis缓存，消息队列
- **安全可靠** - Spring Security + JWT + OAuth2
### 📊 项目关系
---
## 🔧 技术栈
### 🖥️ 后端技术
| 技术 | 版本 | 说明 | 学习文档 |
|-----------------------|---------|---------------------|------------------------------------------------------------|
| **Spring Boot** | 3.4.5 | 核心框架 | [📖 教程](https://github.com/YunaiV/SpringBoot-Labs) |
| **Spring Security** | 6.3.1 | 安全框架 | [📖 教程](http://www.iocoder.cn/Spring-Boot/Spring-Security/) |
| **MyBatis Plus** | 3.5.7 | ORM 框架 | [📖 教程](http://www.iocoder.cn/Spring-Boot/MyBatis/) |
| **Flowable** | 7.0.0 | 工作流引擎 | [📖 教程](https://doc.iocoder.cn/bpm/) |
| **Redis** | 7.0+ | 缓存数据库 | - |
| **MySQL** | 8.0+ | 主数据库 | - |
| **Quartz** | 2.3.2 | 定时任务 | [📖 教程](http://www.iocoder.cn/Spring-Boot/Job/) |
| **SkyWalking** | 9.0.0 | 链路追踪 | [📖 教程](http://www.iocoder.cn/Spring-Boot/SkyWalking/) |
### 🌐 前端技术
| 技术 | 版本 | 说明 |
|------------------|--------|-------------|
| **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](https://gitee.com/zhijiantianya/ruoyi-vue-pro/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](https://www.iocoder.cn)
### 🎯 团队服务
我们提供专业的外包开发服务：
- **全栈开发** - 前端、后端、移动端全栈解决方案
- **系统集成** - 企业级系统集成和定制开发
- **技术咨询** - 架构设计、技术选型、性能优化
- **培训服务** - 技术培训、代码审查、最佳实践
> 💼 **联系微信**：Aix9975
---
## 📄 开源协议
### 🎉 为什么选择我们？
#### ① 更宽松的开源协议
采用 [MIT License](https://gitee.com/zhijiantianya/ruoyi-vue-pro/blob/master/LICENSE) 开源协议：
- ✅ **个人/企业免费使用** - 无需保留版权信息
- ✅ **商业友好** - 可用于商业项目
- ✅ **无使用限制** - 修改、分发、私有化部署
- ✅ **比 Apache 2.0 更宽松** - 更少的法律限制
#### ② 真正的全部开源
与其他项目对比：
| 对比项目 | 开源程度 | 商业化 | 社区活跃度 | 代码质量 | 文档完善度 |
|------|------|------|--------|------|--------|
| **芋道** | 💯 全部开源 | ❌ 永久免费 | 🔥 非常活跃 | ⭐ 优秀 | 📚 详细完整 |
| 项目A | ⚠️ 部分开源 | 💰 企业收费 | 📈 一般 | ⚖️ 良好 | 📄 基础 |
| 项目B | ⚠️ 核心收费 | 💰 按模块收费 | 📉 较少 | ⚖️ 一般 | ❓ 不完整 |
#### ③ 高质量的代码标准
- **113,770** 行 Java 代码
- **42,462** 行代码注释
- **注释覆盖率 37.3%**
- 遵循《阿里巴巴 Java 开发手册》规范
- 完整的单元测试覆盖
---
### 🌟 如果这个项目对你有帮助，请给我们一个 Star！
**「我喜欢写代码，乐此不疲」**
**「我喜欢做开源，以此为乐」**
---
**感谢每一位贡献者的付出！** 🙏
