Files
ruoyi-vue-pro/README.md
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

581 lines
28 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div align="center">
<h1>🚀 芋道 ruoyi-vue-pro</h1>
<p>基于 Spring Boot 3 + Vue 3 的全栈开源管理系统</p>
<p>
<img src="https://img.shields.io/badge/Spring%20Boot-3.4.5-brightgreen.svg" alt="Spring Boot">
<img src="https://img.shields.io/badge/Vue-3.2-brightgreen.svg" alt="Vue">
<img src="https://img.shields.io/badge/JDK-17%2B-blue.svg" alt="JDK">
<img src="https://img.shields.io/github/license/YunaiV/ruoyi-vue-pro" alt="License">
<img src="https://img.shields.io/github/stars/YunaiV/ruoyi-vue-pro.svg?style=social&label=Stars" alt="GitHub stars">
</p>
<p>
<strong>🎯 100% 开源免费 | 企业级架构 | 开箱即用</strong>
</p>
</div>
---
## 📖 目录
- [💡 项目简介](#-项目简介)
- [✨ 核心特性](#-核心特性)
- [🚀 快速开始](#-快速开始)
- [🌐 在线体验](#-在线体验)
- [📦 版本说明](#-版本说明)
- [🏗️ 系统架构](#-系统架构)
- [🔧 技术栈](#-技术栈)
- [🎯 内置功能](#-内置功能)
- [📱 演示图片](#-演示图片)
- [🤝 参与贡献](#-参与贡献)
- [📄 开源协议](#-开源协议)
---
## 💡 项目简介
**芋道管理系统** 是一个基于 **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/) 进行按需迁移
---
## 🏗️ 系统架构
<div align="center">
<img src="/.image/common/ruoyi-vue-pro-architecture.png" alt="系统架构图" width="800">
</div>
### 🎯 架构特点
- **前后端分离** - 前端Vue3后端Spring BootRESTful API
- **微服务支持** - 支持单体应用和微服务架构
- **多租户架构** - 原生支持SaaS多租户模式
- **高可用设计** - 支持集群部署Redis缓存消息队列
- **安全可靠** - Spring Security + JWT + OAuth2
### 📊 项目关系
<div align="center">
<img src="/.image/common/yudao-roadmap.png" alt="项目演进图" width="600">
</div>
---
## 🔧 技术栈
### 🖥️ 后端技术
| 技术 | 版本 | 说明 | 学习文档 |
|-----------------------|---------|---------------------|------------------------------------------------------------|
| **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 测试工具 |
---
## 🎯 内置功能
<div align="center">
<img src="/.image/common/ruoyi-vue-pro-biz.png" alt="功能分层图" width="700">
</div>
### 🏢 系统管理
<div align="center">
<img src="/.image/common/system-feature.png" alt="系统功能图" width="800">
</div>
| 功能模块 | 功能描述 | 状态 |
|--------|------------------------------------------------------|-----|
| 👥 用户管理 | 系统用户配置,支持部门、岗位、角色分配 | ✅ |
| 🔐 角色管理 | 角色菜单权限分配,支持数据范围权限控制 | ✅ |
| 📋 菜单管理 | 系统菜单配置,支持按钮级权限控制 | ✅ |
| 🏢 部门管理 | 组织机构管理,树形结构展示 | ✅ |
| 💼 岗位管理 | 用户岗位职务配置 | ✅ |
| 🏪 租户管理 | SaaS 多租户支持,租户隔离 | ✅ |
| 📊 字典管理 | 系统数据字典维护 | ✅ |
| 📱 短信管理 | 短信渠道、模板、日志管理 | ✅ |
| 📧 邮件管理 | 邮件发送配置和日志 | ✅ |
| 🔔 站内信 | 系统内消息通知 | ✅ |
| 📝 操作日志 | 用户操作行为记录 | ✅ |
| 🔑 登录日志 | 用户登录记录和安全监控 | ✅ |
| ⚠️ 错误码 | 系统错误码统一管理 | ✅ |
| 📢 通知公告 | 系统公告信息发布 | ✅ |
| 🚫 敏感词 | 内容安全敏感词过滤 | ✅ |
| 🔗 应用管理 | SSO 单点登录应用管理 | ✅ |
| 🌍 地区管理 | 省市区数据管理IP 归属地 | ✅ |
### 🔄 工作流程
<div align="center">
<img src="/.image/common/bpm-feature.png" alt="工作流功能图" width="800">
</div>
基于 **Flowable** 引擎构建,支持国产数据库,满足中国特色流程需求:
| 流程设计器类型 | BPMN 专业设计器 | 钉钉/飞书 简单设计器 |
|---------|-------------|--------------|
| **适用场景** | 复杂业务流程编排 | 轻量级审批流程 |
| **设计复杂度** | 高,支持复杂分支逻辑 | 低,拖拽式快速配置 |
| **学习成本** | 需要了解BPMN规范 | 10分钟快速上手 |
| 核心功能 | 描述 | 支持程度 |
|-----------|------------------------------------------|------|
| 🎨 **双设计器** | BPMN标准设计器 + 仿钉钉简单设计器 | ✅ |
| 👥 **会签流程** | 多人同时审批,全部同意后流转 | ✅ |
| 🔄 **或签流程** | 多人中任一审批即可流转 | ✅ |
| 📋 **依次审批** | 按顺序逐一审批(顺序会签) | ✅ |
| 📤 **抄送功能** | 审批结果通知相关人员 | ✅ |
| ↩️ **驳回功能** | 退回至发起人/上一节点/任意节点 | ✅ |
| 🔄 **转办委派** | 转办他人处理,委派协助审批 | ✅ |
| **加签减签** | 动态增减审批人员 | ✅ |
| ❌ **撤销终止** | 发起人撤销,管理员终止 | ✅ |
| 📝 **表单权限** | 每个节点配置字段读写权限 | ✅ |
| ⏰ **超时处理** | 超时自动审批通过/驳回 | ✅ |
| 🔔 **自动提醒** | 到期前自动提醒,支持多种通知方式 | ✅ |
| 👨‍👩‍👧‍👦 **父子流程** | 主流程调用子流程,支持同步/异步 | ✅ |
| 🌊 **条件分支** | 根据条件选择执行路径 | ✅ |
| 🔀 **并行分支** | 多条分支同时执行 | ✅ |
| 🎯 **包容分支** | 条件并行分支的组合 | ✅ |
| 🚀 **触发节点** | HTTP请求、数据操作等自动化 | ✅ |
| ⏳ **延迟节点** | 等待指定时间后继续 | ✅ |
### 💰 支付系统
| 功能 | 描述 | 支持渠道 |
|-------|------------------|--------------------|
| 💳 支付 | 统一支付接口 | 支付宝、微信、银联等 |
| 💸 退款 | 统一退款接口 | 支付宝、微信、银联等 |
| 📊 订单 | 支付订单管理 | 支付、退款订单查询和管理 |
| 🔔 通知 | 支付结果通知 | 异步通知和同步返回 |
| 🛠️ 配置 | 支付渠道配置 | 多应用、多渠道配置 |
| 💼 示例 | 接入代码示例 | Java、前端接入示例 |
### 🏗️ 基础设施
<div align="center">
<img src="/.image/common/infra-feature.png" alt="基础设施功能图" width="800">
</div>
| 功能模块 | 功能描述 | 核心特性 |
|-------------|-----------------------------------|-----------------------|
| ⚡ **代码生成器** | 一键生成前后端代码 | 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 |
### 📊 数据报表
| 功能 | 描述 | 特性 |
|--------|------------|-------------------|
| 📈 报表设计器 | 可视化报表设计 | 数据报表、图形报表、打印设计 |
| 📺 大屏设计器 | 数据大屏构建 | 拖拽式设计,内置丰富图表组件 |
### 📱 微信公众号
| 功能 | 描述 | 特性 |
|--------|-------------|-----------------|
| 🏪 账号管理 | 多公众号管理 | 支持多个公众号接入 |
| 📊 数据统计 | 运营数据分析 | 用户增长、消息概况、接口分析 |
| 👥 粉丝管理 | 粉丝信息管理 | 同步粉丝、标签管理、分组管理 |
| 💬 消息管理 | 消息收发管理 | 查看粉丝消息、主动回复 |
| 🤖 自动回复 | 智能回复配置 | 关注回复、关键字回复、消息回复 |
| 🏷️ 标签管理 | 粉丝标签系统 | 创建、修改、删除标签 |
| 📋 菜单管理 | 自定义菜单 | 菜单配置、同步菜单 |
| 🎨 素材管理 | 多媒体素材管理 | 图片、语音、视频管理 |
| ✍️ 图文管理 | 图文消息管理 | 草稿箱、发布记录 |
### 🛒 商城系统
<div align="center">
<img src="/.image/common/mall-feature.png" alt="商城功能图" width="800">
</div>
完整的电商解决方案,包含:
- **商品管理** - 商品分类、属性、规格、库存
- **订单管理** - 下单、支付、发货、退换货
- **会员管理** - 会员等级、积分、优惠券
- **营销工具** - 秒杀、团购、分销、拼团
- **数据统计** - 销售报表、用户分析
- **移动端** - 小程序、H5、APP
<div align="center">
<img src="/.image/common/mall-preview.png" alt="商城预览图" width="800">
</div>
### 🤝 CRM系统
<div align="center">
<img src="/.image/common/crm-feature.png" alt="CRM功能图" width="800">
</div>
专业的客户关系管理系统:
- **客户管理** - 客户信息、跟进记录、客户分析
- **销售管理** - 商机管理、销售流程、业绩统计
- **合同管理** - 合同创建、审批、执行跟踪
- **回款管理** - 回款计划、回款记录
- **报表分析** - 销售漏斗、业绩排行、客户分析
### 📋 ERP系统
<div align="center">
<img src="/.image/common/erp-feature.png" alt="ERP功能图" width="800">
</div>
企业资源规划系统:
- **采购管理** - 供应商、采购订单、入库管理
- **销售管理** - 客户、销售订单、出库管理
- **库存管理** - 商品、仓库、库存盘点
- **财务管理** - 收支管理、账目统计
### 🤖 AI大模型
<div align="center">
<img src="/.image/common/ai-feature.png" alt="AI功能图" width="800">
</div>
智能AI助手集成
- **对话聊天** - 智能问答、上下文理解
- **内容生成** - 文章写作、代码生成
- **图片生成** - AI绘画、图片处理
- **知识库** - 文档问答、知识检索
- **模型管理** - 多模型支持、API配置
<div align="center">
<img src="/.image/common/ai-preview.gif" alt="AI预览图" width="600">
</div>
### 👥 会员中心
| 功能 | 描述 | 特性 |
|--------|------------|--------------|
| 👤 会员管理 | C端用户管理 | 会员信息、搜索、管理 |
| 🏷️ 会员标签 | 用户标签系统 | 标签创建、管理、应用 |
| 🎖️ 会员等级 | 等级成长体系 | 等级权益、成长值管理 |
| 👥 会员分组 | 用户分组功能 | 用户画像、精准营销 |
| ⭐ 积分签到 | 积分奖励机制 | 签到奖励、积分兑换 |
---
## 📱 演示图片
### 🖥️ 系统功能
| 模块 | 登录首页 | 用户管理 | 角色权限 |
|----------|--------------------------------|--------------------------------|-----------------------------|
| **截图** | ![登录](/.image/登录.jpg) | ![用户管理](/.image/用户管理.jpg) | ![角色管理](/.image/角色管理.jpg) |
| **功能** | 安全登录、个人中心 | 用户CRUD、部门岗位分配 | 角色权限、菜单权限、数据权限 |
| 模块 | 菜单管理 | 部门管理 | 系统监控 |
|----------|--------------------------------|--------------------------------|-----------------------------|
| **截图** | ![菜单管理](/.image/菜单管理.jpg) | ![部门管理](/.image/部门管理.jpg) | ![系统接口](/.image/系统接口.jpg) |
| **功能** | 菜单树、权限标识、按钮权限 | 组织架构、树形展示 | API文档、在线调试 |
### 🔄 工作流程
| 模块 | 流程设计 | 流程审批 | 任务处理 |
|---------|---------------------------------|---------------------------------|-------------------------------|
| **截图** | ![流程设计](/.image/流程模型-设计.jpg) | ![我的流程](/.image/我的流程-详情.jpg) | ![任务列表](/.image/任务列表-待办.jpg) |
| **功能** | 可视化设计、拖拽建模 | 流程发起、进度跟踪 | 待办任务、审批处理 |
### 🏗️ 基础设施
| 模块 | 代码生成 | 定时任务 | 系统监控 |
|----------|--------------------------------|--------------------------------|-----------------------------|
| **截图** | ![代码生成](/.image/代码生成.jpg) | ![定时任务](/.image/定时任务.jpg) | ![Java监控](/.image/Java监控.jpg) |
| **功能** | 一键生成、模板配置 | 任务调度、执行日志 | 性能监控、JVM状态 |
### 💰 支付系统
| 模块 | 应用配置 | 支付订单 | 退款管理 |
|---------|---------------------------------|-------------------------------|---------------------------------|
| **截图** | ![应用信息](/.image/应用信息-编辑.jpg) | ![支付订单](/.image/支付订单.jpg) | ![退款订单](/.image/退款订单.jpg) |
| **功能** | 多渠道配置、参数设置 | 订单查询、状态跟踪 | 退款申请、退款记录 |
### 📊 数据报表
| 模块 | 报表设计 | 大屏设计 | 数据可视化 |
|---------|--------------------------------------|-------------------------------------|-----------------------------------|
| **截图** | ![报表设计](/.image/报表设计器-数据报表.jpg) | ![大屏设计](/.image/大屏设计器-编辑.jpg) | ![大屏预览](/.image/大屏设计器-预览.jpg) |
| **功能** | 拖拽设计、数据源配置 | 组件丰富、实时预览 | 数据大屏、可视化展示 |
### 📱 移动端管理
<div align="center">
| 登录首页 | 工作台 | 个人中心 |
|--------|------|--------|
| ![移动端1](/.image/admin-uniapp/01.png) | ![移动端2](/.image/admin-uniapp/02.png) | ![移动端3](/.image/admin-uniapp/03.png) |
| 系统管理 | 数据统计 | 消息通知 |
|--------|-------|--------|
| ![移动端4](/.image/admin-uniapp/04.png) | ![移动端5](/.image/admin-uniapp/05.png) | ![移动端6](/.image/admin-uniapp/06.png) |
</div>
移动端已实现:登录认证、工作台、个人资料、密码修改、系统管理等核心功能。
---
## 🤝 参与贡献
我们非常欢迎各种形式的贡献!
### 💡 贡献方式
- 🐛 **提交 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 更宽松** - 更少的法律限制
#### ② 真正的全部开源
<div align="center">
<img src="/.image/common/project-vs.png" alt="开源项目对比" width="800">
</div>
与其他项目对比:
| 对比项目 | 开源程度 | 商业化 | 社区活跃度 | 代码质量 | 文档完善度 |
|------|------|------|--------|------|--------|
| **芋道** | 💯 全部开源 | ❌ 永久免费 | 🔥 非常活跃 | ⭐ 优秀 | 📚 详细完整 |
| 项目A | ⚠️ 部分开源 | 💰 企业收费 | 📈 一般 | ⚖️ 良好 | 📄 基础 |
| 项目B | ⚠️ 核心收费 | 💰 按模块收费 | 📉 较少 | ⚖️ 一般 | ❓ 不完整 |
#### ③ 高质量的代码标准
- **113,770** 行 Java 代码
- **42,462** 行代码注释
- **注释覆盖率 37.3%**
- 遵循《阿里巴巴 Java 开发手册》规范
- 完整的单元测试覆盖
---
<div align="center">
### 🌟 如果这个项目对你有帮助,请给我们一个 Star
**「我喜欢写代码,乐此不疲」**
**「我喜欢做开源,以此为乐」**
---
<p>
<a href="https://gitee.com/zhijiantianya/ruoyi-vue-pro">
<img src="https://gitee.com/zhijiantianya/ruoyi-vue-pro/badge/star.svg?theme=dark" alt="Gitee Stars">
</a>
<a href="https://github.com/YunaiV/ruoyi-vue-pro">
<img src="https://img.shields.io/github/stars/YunaiV/ruoyi-vue-pro.svg?style=social&label=Stars" alt="GitHub Stars">
</a>
</p>
**感谢每一位贡献者的付出!** 🙏
</div>