2025-10-04 18:08:05 +08:00
|
|
|
|
<p align="center">
|
|
|
|
|
|
<img src="https://img.shields.io/badge/Spring%20Boot-2.7.18-blue.svg" alt="Downloads">
|
|
|
|
|
|
<img src="https://img.shields.io/badge/Vue-3.2-blue.svg" alt="Downloads">
|
|
|
|
|
|
<img src="https://img.shields.io/github/license/YunaiV/ruoyi-vue-pro"/>
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
**严肃声明：现在、未来都不会有商业版本，所有代码全部开源!！**
|
|
|
|
|
|
|
|
|
|
|
|
**「我喜欢写代码，乐此不疲」**
|
|
|
|
|
|
**「我喜欢做开源，以此为乐」**
|
|
|
|
|
|
|
|
|
|
|
|
我 🐶 在上海艰苦奋斗，早中晚在 top3 大厂认真搬砖，夜里为开源做贡献。
|
|
|
|
|
|
|
|
|
|
|
|
如果这个项目让你有所收获，记得 Star 关注哦，这对我是非常不错的鼓励与支持。
|
|
|
|
|
|
|
|
|
|
|
|
## 🐶 新手必读
|
|
|
|
|
|
|
|
|
|
|
|
* 演示地址【Vue3 + element-plus】：<http://dashboard-vue3.aagro.iocoder.cn>
|
|
|
|
|
|
* 演示地址【Vue3 + vben(ant-design-vue)】：<http://dashboard-vben.aagro.iocoder.cn>
|
|
|
|
|
|
* 演示地址【Vue2 + element-ui】：<http://dashboard.aagro.iocoder.cn>
|
|
|
|
|
|
* 启动文档：<https://doc.iocoder.cn/quick-start/>
|
|
|
|
|
|
* 视频教程：<https://doc.iocoder.cn/video/>
|
|
|
|
|
|
|
|
|
|
|
|
## 🐰 版本说明
|
|
|
|
|
|
|
|
|
|
|
|
| 版本 | JDK 8 + Spring Boot 2.7 | JDK 17/21 + Spring Boot 3.2 |
|
|
|
|
|
|
|---------------------------------------------------------------------|---------------------------------------------------------------------------|---------------------------------------------------------------------------------------|
|
|
|
|
|
|
| 【完整版】[ruoyi-vue-pro](https://gitee.com/zhijiantianya/ruoyi-vue-pro) | [`master`](https://gitee.com/zhijiantianya/ruoyi-vue-pro/tree/master/) 分支 | [`master-jdk17`](https://gitee.com/zhijiantianya/ruoyi-vue-pro/tree/master-jdk17/) 分支 |
|
|
|
|
|
|
| 【精简版】[aagro-boot-mini](https://gitee.com/aagrocode/aagro-boot-mini) | [`master`](https://gitee.com/aagrocode/aagro-boot-mini/tree/master/) 分支 | [`master-jdk17`](https://gitee.com/aagrocode/aagro-boot-mini/tree/master-jdk17/) 分支 |
|
|
|
|
|
|
|
|
|
|
|
|
* 【完整版】：包括系统功能、基础设施、会员中心、数据报表、工作流程、商城系统、微信公众号、CRM、ERP 等功能
|
|
|
|
|
|
* 【精简版】：只包括系统功能、基础设施功能，不包括会员中心、数据报表、工作流程、商城系统、微信公众号、CRM、ERP 等功能
|
|
|
|
|
|
|
|
|
|
|
|
可参考 [《迁移文档》](https://doc.iocoder.cn/migrate-module/) ，只需要 5-10 分钟，即可将【完整版】按需迁移到【精简版】
|
|
|
|
|
|
|
|
|
|
|
|
## 🐯 平台简介
|
|
|
|
|
|
|
|
|
|
|
|
**芋道**，以开发者为中心，打造中国第一流的快速开发平台，全部开源，个人与企业可 100% 免费使用。
|
|
|
|
|
|
|
|
|
|
|
|
> 有任何问题，或者想要的功能，可以在 _Issues_ 中提给艿艿。
|
|
|
|
|
|
>
|
|
|
|
|
|
> 😜 给项目点点 Star 吧，这对我们真的很重要！
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* Java 后端：`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 身份校验，支持 WebSocket 集群
|
|
|
|
|
|
* 集成微信小程序、微信公众号、企业微信、钉钉等三方登陆，集成支付宝、微信等支付与退款
|
|
|
|
|
|
* 集成阿里云、腾讯云等短信渠道，集成 MinIO、阿里云、腾讯云、七牛云等云存储服务
|
|
|
|
|
|
* 集成报表设计器、大屏设计器，通过拖拽即可生成酷炫的报表与大屏
|
|
|
|
|
|
|
|
|
|
|
|
## 🐳 项目关系
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
三个项目的功能对比，可见社区共同整理的 [国产开源项目对比](https://www.yuque.com/xiatian-bsgny/lm0ec1/wqf8mn) 表格。
|
|
|
|
|
|
|
|
|
|
|
|
### 后端项目
|
|
|
|
|
|
|
|
|
|
|
|
| 项目 | Star | 简介 |
|
|
|
|
|
|
|-----------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
|
|
|
|
|
|
| [ruoyi-vue-pro](https://gitee.com/zhijiantianya/ruoyi-vue-pro) | [](https://gitee.com/zhijiantianya/ruoyi-vue-pro) [](https://github.com/YunaiV/ruoyi-vue-pro) | 基于 Spring Boot 多模块架构 |
|
|
|
|
|
|
| [aagro-cloud](https://gitee.com/zhijiantianya/aagro-cloud) | [](https://gitee.com/zhijiantianya/aagro-cloud) [](https://github.com/YunaiV/aagro-cloud) | 基于 Spring Cloud 微服务架构 |
|
|
|
|
|
|
| [Spring-Boot-Labs](https://gitee.com/aagrocode/SpringBoot-Labs) | [](https://gitee.com/zhijiantianya/aagro-cloud) [](https://github.com/aagrocode/SpringBoot-Labs) | 系统学习 Spring Boot & Cloud 专栏 |
|
|
|
|
|
|
|
|
|
|
|
|
### 前端项目
|
|
|
|
|
|
|
|
|
|
|
|
| 项目 | Star | 简介 |
|
|
|
|
|
|
|----------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------|
|
|
|
|
|
|
| [aagro-ui-admin-vue3](https://gitee.com/aagrocode/aagro-ui-admin-vue3) | [](https://gitee.com/aagrocode/aagro-ui-admin-vue3) [](https://github.com/aagrocode/aagro-ui-admin-vue3) | 基于 Vue3 + element-plus 实现的管理后台 |
|
|
|
|
|
|
| [aagro-ui-admin-vben](https://gitee.com/aagrocode/aagro-ui-admin-vben) | [](https://gitee.com/aagrocode/aagro-ui-admin-vben) [](https://github.com/aagrocode/aagro-ui-admin-vben) | 基于 Vue3 + vben(ant-design-vue) 实现的管理后台 |
|
|
|
|
|
|
| [aagro-mall-uniapp](https://gitee.com/aagrocode/aagro-mall-uniapp) | [](https://gitee.com/aagrocode/aagro-mall-uniapp) [](https://github.com/aagrocode/aagro-mall-uniapp) | 基于 uni-app 实现的商城小程序 |
|
|
|
|
|
|
| [aagro-ui-admin-vue2](https://gitee.com/aagrocode/aagro-ui-admin-vue2) | [](https://gitee.com/aagrocode/aagro-ui-admin-vue2) [](https://github.com/aagrocode/aagro-ui-admin-vue2) | 基于 Vue2 + element-ui 实现的管理后台 |
|
|
|
|
|
|
| [aagro-ui-admin-uniapp](https://gitee.com/aagrocode/aagro-ui-admin-uniapp) | [](https://gitee.com/aagrocode/aagro-ui-admin-uniapp) [](https://github.com/aagrocode/aagro-ui-admin-uniapp) | 基于 Vue2 + element-ui 实现的管理后台 |
|
|
|
|
|
|
| [aagro-ui-go-view](https://gitee.com/aagrocode/aagro-ui-go-view) | [](https://gitee.com/aagrocode/aagro-ui-go-view) [](https://github.com/aagrocode/aagro-ui-go-view) | 基于 Vue3 + naive-ui 实现的大屏报表 |
|
|
|
|
|
|
|
|
|
|
|
|
## 😎 开源协议
|
|
|
|
|
|
|
|
|
|
|
|
**为什么推荐使用本项目？**
|
|
|
|
|
|
|
|
|
|
|
|
① 本项目采用比 Apache 2.0 更宽松的 [MIT License](https://gitee.com/zhijiantianya/ruoyi-vue-pro/blob/master/LICENSE) 开源协议，个人与企业可 100% 免费使用，不用保留类作者、Copyright 信息。
|
|
|
|
|
|
|
|
|
|
|
|
② 代码全部开源，不会像其他项目一样，只开源部分代码，让你无法了解整个项目的架构设计。[国产开源项目对比](https://www.yuque.com/xiatian-bsgny/lm0ec1/wqf8mn)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
③ 代码整洁、架构整洁，遵循《阿里巴巴 Java 开发手册》规范，代码注释详细，113770 行 Java 代码，42462 行代码注释。
|
|
|
|
|
|
|
|
|
|
|
|
## 🤝 项目外包
|
|
|
|
|
|
|
|
|
|
|
|
我们也是接外包滴，如果你有项目想要外包，可以微信联系【**Aix9975**】。
|
|
|
|
|
|
|
|
|
|
|
|
团队包含专业的项目经理、架构师、前端工程师、后端工程师、测试工程师、运维工程师，可以提供全流程的外包服务。
|
|
|
|
|
|
|
|
|
|
|
|
项目可以是商城、SCRM 系统、OA 系统、物流系统、ERP 系统、CMS 系统、HIS 系统、支付系统、IM 聊天、微信公众号、微信小程序等等。
|
|
|
|
|
|
|
|
|
|
|
|
## 🐼 内置功能
|
|
|
|
|
|
|
|
|
|
|
|
系统内置多种多种业务功能，可以用于快速你的业务系统：
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* 通用模块（必选）：系统功能、基础设施
|
|
|
|
|
|
* 通用模块（可选）：工作流程、支付系统、数据报表、会员中心
|
|
|
|
|
|
* 业务系统（按需）：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 回调、更新数据、删除数据等 | ✅ |
|
|
|
|
|
|
| 延迟节点 | 执行到该节点，审批等待一段时间再执行，支持固定时长、固定日期等 | ✅ |
|
|
|
|
|
|
| 拓展设置 | 流程前置/后置通知，节点（任务）前置、后置通知，流程报表，自动审批去重，自定流程编号、标题、摘要，流程报表等 | ✅ |
|
|
|
|
|
|
|
|
|
|
|
|
### 支付系统
|
|
|
|
|
|
|
|
|
|
|
|
| | 功能 | 描述 |
|
|
|
|
|
|
|-----|------|---------------------------|
|
|
|
|
|
|
| 🚀 | 应用信息 | 配置商户的应用信息，对接支付宝、微信等多个支付渠道 |
|
|
|
|
|
|
| 🚀 | 支付订单 | 查看用户发起的支付宝、微信等的【支付】订单 |
|
|
|
|
|
|
| 🚀 | 退款订单 | 查看用户发起的支付宝、微信等的【退款】订单 |
|
|
|
|
|
|
| 🚀 | 回调通知 | 查看支付回调业务的【支付】【退款】的通知结果 |
|
|
|
|
|
|
| 🚀 | 接入示例 | 提供接入支付系统的【支付】【退款】的功能实战 |
|
|
|
|
|
|
|
2025-10-04 18:13:30 +08:00
|
|
|
|
## 部署说明
|
|
|
|
|
|
|
|
|
|
|
|
项目可以部署到远程服务器，详细说明请参考 [DEPLOYMENT_REMOTE.md](DEPLOYMENT_REMOTE.md) 文件。
|
|
|
|
|
|
|
|
|
|
|
|
### 快速部署
|
|
|
|
|
|
|
|
|
|
|
|
1. 确保已安装 Maven
|
|
|
|
|
|
2. 在项目根目录执行构建命令：
|
|
|
|
|
|
```bash
|
|
|
|
|
|
mvn clean package -Dmaven.test.skip=true
|
|
|
|
|
|
```
|
|
|
|
|
|
3. 使用提供的脚本进行部署：
|
|
|
|
|
|
- Linux/Mac: `./script/deploy-remote.sh`
|
|
|
|
|
|
- Windows: `script\deploy-remote.bat`
|
|
|
|
|
|
|
|
|
|
|
|
### 配置信息
|
|
|
|
|
|
|
|
|
|
|
|
- 数据库地址：111.3.47.177:13306
|
|
|
|
|
|
- 数据库用户名：root
|
|
|
|
|
|
- 数据库密码：aiotagro
|
|
|
|
|
|
- 数据库名：aiotmini
|
|
|
|
|
|
- Redis地址：111.3.47.177:16379
|
|
|
|
|
|
- Redis密码：aiotagro
|
|
|
|
|
|
- 部署服务器：192.168.0.95
|
|
|
|
|
|
- 部署目录：/data/java/aiotagro-mini
|
|
|
|
|
|
- 应用端口：48080
|
2025-10-04 18:08:05 +08:00
|
|
|
|
|
|
|
|
|
|
### 移动端（管理后台）
|
|
|
|
|
|
|
|
|
|
|
|
| biu | biu | biu |
|
|
|
|
|
|
|----------------------------------|----------------------------------|----------------------------------|
|
|
|
|
|
|
|  |  |  |
|
|
|
|
|
|
|  |  |  |
|
|
|
|
|
|
|  |  |  |
|
|
|
|
|
|
|
|
|
|
|
|
目前已经实现登录、我的、工作台、编辑资料、头像修改、密码修改、常见问题、关于我们等基础功能。
|
