diff --git a/README.md b/README.md
index 62252f9ac3..abcf094b2d 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,4 @@
+
芋道快速开发平台
@@ -6,13 +7,44 @@
**严肃声明:现在、未来都不会有商业版本,所有代码全部开源!!**
-**「我喜欢写代码,乐此不疲」**
+**「我喜欢写代码,乐此不疲」**
**「我喜欢做开源,以此为乐」**
我 🐶 在上海艰苦奋斗,早中晚在 top3 大厂认真搬砖,夜里为开源做贡献。
如果这个项目让你有所收获,记得 Star 关注哦,这对我是非常不错的鼓励与支持。
+## 📖 目录
+
+- [🐶 新手必读](#-新手必读)
+- [🐰 版本说明](#-版本说明)
+- [🐯 平台简介](#-平台简介)
+- [🐷 演示图](#-演示图)
+ - [系统功能](#系统功能-1)
+ - [工作流程](#工作流程-1)
+ - [基础设施](#基础设施-1)
+ - [支付系统](#支付系统-1)
+ - [数据报表](#数据报表-1)
+ - [移动端(管理后台)](#移动端管理后台)
+- [🐼 内置功能](#-内置功能)
+ - [系统功能](#系统功能-2)
+ - [工作流程](#工作流程-2)
+ - [支付系统](#支付系统-2)
+ - [基础设施](#基础设施-2)
+ - [数据报表](#数据报表-2)
+ - [微信公众号](#微信公众号-1)
+ - [商城系统](#商城系统-1)
+ - [会员中心](#会员中心-1)
+ - [ERP 系统](#erp-系统-1)
+ - [CRM 系统](#crm-系统-1)
+ - [AI 大模型](#ai-大模型-1)
+- [🐨 技术栈](#-技术栈)
+- [🐳 项目关系](#-项目关系)
+- [🚀 本地启动](#-本地启动)
+- [🤝 如何贡献](#-如何贡献)
+- [😎 开源协议](#-开源协议)
+- [🗂️ 模块说明](#️-模块说明)
+
## 🐶 新手必读
* 演示地址【Vue3 + element-plus】:
@@ -41,7 +73,7 @@
>
> 😜 给项目点点 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` 版本
@@ -59,9 +91,9 @@
* 集成阿里云、腾讯云等短信渠道,集成 MinIO、阿里云、腾讯云、七牛云等云存储服务
* 集成报表设计器、大屏设计器,通过拖拽即可生成酷炫的报表与大屏
-## 🐳 项目关系
+## 🐳 项目关系
-
+
三个项目的功能对比,可见社区共同整理的 [国产开源项目对比](https://www.yuque.com/xiatian-bsgny/lm0ec1/wqf8mn) 表格。
@@ -71,7 +103,7 @@
|-----------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|
| [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 多模块架构 |
| [yudao-cloud](https://gitee.com/zhijiantianya/yudao-cloud) | [](https://gitee.com/zhijiantianya/yudao-cloud) [](https://github.com/YunaiV/yudao-cloud) | 基于 Spring Cloud 微服务架构 |
-| [Spring-Boot-Labs](https://gitee.com/yudaocode/SpringBoot-Labs) | [](https://gitee.com/zhijiantianya/yudao-cloud) [](https://github.com/yudaocode/SpringBoot-Labs) | 系统学习 Spring Boot & Cloud 专栏 |
+| [Spring-Boot-Labs](https://gitee.com/yudaocode/SpringBoot-Labs) | [](https://gitee.com/zhijiantianya/yudao-cloud) [](https://github.com/yudaocode/SpringBoot-Labs) | 系统学习 Spring Boot & Cloud 专栏 |
### 前端项目
@@ -84,31 +116,72 @@
| [yudao-ui-admin-uniapp](https://gitee.com/yudaocode/yudao-ui-admin-uniapp) | [](https://gitee.com/yudaocode/yudao-ui-admin-uniapp) [](https://github.com/yudaocode/yudao-ui-admin-uniapp) | 基于 Vue2 + element-ui 实现的管理后台 |
| [yudao-ui-go-view](https://gitee.com/yudaocode/yudao-ui-go-view) | [](https://gitee.com/yudaocode/yudao-ui-go-view) [](https://github.com/yudaocode/yudao-ui-go-view) | 基于 Vue3 + naive-ui 实现的大屏报表 |
-## 😎 开源协议
+## 🐷 演示图
-**为什么推荐使用本项目?**
+### 系统功能
-① 本项目采用比 Apache 2.0 更宽松的 [MIT License](https://gitee.com/zhijiantianya/ruoyi-vue-pro/blob/master/LICENSE) 开源协议,个人与企业可 100% 免费使用,不用保留类作者、Copyright 信息。
+| 模块 | biu | biu | biu |
+|----------|-----------------------------|---------------------------|--------------------------|
+| 登录 & 首页 |  |  |  |
+| 用户 & 应用 |  |  |  |
+| 租户 & 套餐 |  |  | - |
+| 部门 & 岗位 |  |  | - |
+| 菜单 & 角色 |  |  | - |
+| 审计日志 |  |  | - |
+| 短信 |  |  |  |
+| 字典 & 敏感词 |  |  |  |
+| 错误码 & 通知 |  |  | - |
-② 代码全部开源,不会像其他项目一样,只开源部分代码,让你无法了解整个项目的架构设计。[国产开源项目对比](https://www.yuque.com/xiatian-bsgny/lm0ec1/wqf8mn)
+### 工作流程
-
+| 模块 | biu | biu | biu |
+|---------|---------------------------------|---------------------------------|---------------------------------|
+| 流程模型 |  |  |  |
+| 表单 & 分组 |  |  | - |
+| 我的流程 |  |  |  |
+| 待办 & 已办 |  |  |  |
+| OA 请假 |  |  |  |
-③ 代码整洁、架构整洁,遵循《阿里巴巴 Java 开发手册》规范,代码注释详细,113770 行 Java 代码,42462 行代码注释。
+### 基础设施
-## 🤝 项目外包
+| 模块 | biu | biu | biu |
+|---------------|-------------------------------|-----------------------------|---------------------------|
+| 代码生成 |  |  | - |
+| 文档 |  |  | - |
+| 文件 & 配置 |  |  |  |
+| 定时任务 |  |  | - |
+| API 日志 |  |  | - |
+| MySQL & Redis |  |  | - |
+| 监控平台 |  |  |  |
-我们也是接外包滴,如果你有项目想要外包,可以微信联系【**Aix9975**】。
+### 支付系统
-团队包含专业的项目经理、架构师、前端工程师、后端工程师、测试工程师、运维工程师,可以提供全流程的外包服务。
+| 模块 | biu | biu | biu |
+|---------|---------------------------|---------------------------------|---------------------------------|
+| 商家 & 应用 |  |  |  |
+| 支付 & 退款 |  |  | --- |
+### 数据报表
-项目可以是商城、SCRM 系统、OA 系统、物流系统、ERP 系统、CMS 系统、HIS 系统、支付系统、IM 聊天、微信公众号、微信小程序等等。
+| 模块 | biu | biu | biu |
+|-------|---------------------------------|---------------------------------|---------------------------------------|
+| 报表设计器 |  |  |  |
+| 大屏设计器 |  |  |  |
+
+### 移动端(管理后台)
+
+| biu | biu | biu |
+|----------------------------------|----------------------------------|----------------------------------|
+|  |  |  |
+|  |  |  |
+|  |  |  |
+
+目前已经实现登录、我的、工作台、编辑资料、头像修改、密码修改、常见问题、关于我们等基础功能。
## 🐼 内置功能
系统内置多种多种业务功能,可以用于快速你的业务系统:
-
+
* 通用模块(必选):系统功能、基础设施
* 通用模块(可选):工作流程、支付系统、数据报表、会员中心
@@ -145,17 +218,17 @@
| 🚀 | 应用管理 | 管理 SSO 单点登录的应用,支持多种 OAuth2 授权方式 |
| 🚀 | 地区管理 | 展示省份、城市、区镇等城市信息,支持 IP 对应城市 |
-
+
### 工作流程
-
+
基于 Flowable 构建,可支持信创(国产)数据库,满足中国特色流程操作:
| BPMN 设计器 | 钉钉/飞书设计器 |
|------------------------------|--------------------------------|
-|  |  |
+|  |  |
> 历经头部企业生产验证,工作流引擎须标配仿钉钉/飞书 + BPMN 双设计器!!!
>
@@ -221,7 +294,7 @@
| 🚀 | 日志服务 | 轻量级日志中心,查看远程服务器的日志 |
| 🚀 | 单元测试 | 基于 JUnit + Mockito 实现单元测试,保证功能的正确性、代码的质量等 |
-
+
### 数据报表
@@ -249,9 +322,9 @@
演示地址:
-
+
-
+
### 会员中心
@@ -267,43 +340,24 @@
演示地址:
-
+
### CRM 系统
演示地址:
-
+
### AI 大模型
演示地址:
-
+
-
+
## 🐨 技术栈
-### 模块
-
-| 项目 | 说明 |
-|-----------------------|--------------------|
-| `yudao-dependencies` | Maven 依赖版本管理 |
-| `yudao-framework` | Java 框架拓展 |
-| `yudao-server` | 管理后台 + 用户 APP 的服务端 |
-| `yudao-module-system` | 系统功能的 Module 模块 |
-| `yudao-module-member` | 会员中心的 Module 模块 |
-| `yudao-module-infra` | 基础设施的 Module 模块 |
-| `yudao-module-bpm` | 工作流程的 Module 模块 |
-| `yudao-module-pay` | 支付系统的 Module 模块 |
-| `yudao-module-mall` | 商城系统的 Module 模块 |
-| `yudao-module-erp` | ERP 系统的 Module 模块 |
-| `yudao-module-crm` | CRM 系统的 Module 模块 |
-| `yudao-module-ai` | AI 大模型的 Module 模块 |
-| `yudao-module-mp` | 微信公众号的 Module 模块 |
-| `yudao-module-report` | 大屏报表 Module 模块 |
-
### 框架
| 框架 | 说明 | 版本 | 学习指南 |
@@ -329,63 +383,59 @@
| [JUnit](https://junit.org/junit5/) | Java 单元测试框架 | 5.8.2 | - |
| [Mockito](https://github.com/mockito/mockito) | Java Mock 框架 | 4.8.0 | - |
-## 🐷 演示图
+## 🚀 本地启动
-### 系统功能
+1. **准备工作**
+ - 安装 JDK 1.8
+ - 安装 Redis
+ - 安装 MySQL 5.7+
+ - 安装 Maven
+ - 下载 [代码](https://gitee.com/zhijiantianya/ruoyi-vue-pro) 到本地
+2. **启动后端**
+ - 使用 IDEA 打开项目 `ruoyi-vue-pro`
+ - 在 `sql/mysql` 目录下找到 `ruoyi-vue-pro.sql` 和 `quartz.sql`,导入数据库
+ - 修改 `yudao-server` 模块下的 `application-local.yml` 配置文件,设置数据库和 Redis 连接信息
+ - 运行 `YudaoServerApplication.java` 即可启动后端
+3. **启动前端**
+ - 本项目提供了多个前端实现,请根据需要选择
+ - [yudao-ui-admin-vue3 (Element Plus)](https://gitee.com/yudaocode/yudao-ui-admin-vue3)
+ - [yudao-ui-admin-vben (Ant Design Vue)](https://gitee.com/yudaocode/yudao-ui-admin-vben)
+ - [yudao-ui-admin-vue2 (Element UI)](https://gitee.com/yudaocode/yudao-ui-admin-vue2)
+ - 进入对应前端项目,参考其 `README.md` 的说明启动。
-| 模块 | biu | biu | biu |
-|----------|-----------------------------|---------------------------|--------------------------|
-| 登录 & 首页 |  |  |  |
-| 用户 & 应用 |  |  |  |
-| 租户 & 套餐 |  |  | - |
-| 部门 & 岗位 |  |  | - |
-| 菜单 & 角色 |  |  | - |
-| 审计日志 |  |  | - |
-| 短信 |  |  |  |
-| 字典 & 敏感词 |  |  |  |
-| 错误码 & 通知 |  |  | - |
+更详细的文档请参考 [快速启动](https://doc.iocoder.cn/quick-start/)。
-### 工作流程
+## 🤝 如何贡献
-| 模块 | biu | biu | biu |
-|---------|---------------------------------|---------------------------------|---------------------------------|
-| 流程模型 |  |  |  |
-| 表单 & 分组 |  |  | - |
-| 我的流程 |  |  |  |
-| 待办 & 已办 |  |  |  |
-| OA 请假 |  |  |  |
+非常欢迎您对本项目进行贡献!
-### 基础设施
+- **提交 Issue**:如果您在使用中遇到任何问题,或者有任何好的建议,欢迎在 [Gitee Issues](https://gitee.com/zhijiantianya/ruoyi-vue-pro/issues) 中提出。
+- **提交 Pull Request**:
+ 1. Fork 本仓库
+ 2. 创建您的特性分支 (`git checkout -b feature/AmazingFeature`)
+ 3. 提交您的修改 (`git commit -m 'Add some AmazingFeature'`)
+ 4. 推送到分支 (`git push origin feature/AmazingFeature`)
+ 5. 开启一个 Pull Request
-| 模块 | biu | biu | biu |
-|---------------|-------------------------------|-----------------------------|---------------------------|
-| 代码生成 |  |  | - |
-| 文档 |  |  | - |
-| 文件 & 配置 |  |  |  |
-| 定时任务 |  |  | - |
-| API 日志 |  |  | - |
-| MySQL & Redis |  |  | - |
-| 监控平台 |  |  |  |
+## 🗂️ 模块说明
-### 支付系统
+| 项目 | 说明 |
+|-----------------------|--------------------|
+| `yudao-dependencies` | Maven 依赖版本管理 |
+| `yudao-framework` | Java 框架拓展 |
+| `yudao-server` | 管理后台 + 用户 APP 的服务端 |
+| `yudao-module-system` | 系统功能的 Module 模块 |
+| `yudao-module-member` | 会员中心的 Module 模块 |
+| `yudao-module-infra` | 基础设施的 Module 模块 |
+| `yudao-module-bpm` | 工作流程的 Module 模块 |
+| `yudao-module-pay` | 支付系统的 Module 模块 |
+| `yudao-module-mall` | 商城系统的 Module 模块 |
+| `yudao-module-erp` | ERP 系统的 Module 模块 |
+| `yudao-module-crm` | CRM 系统的 Module 模块 |
+| `yudao-module-ai` | AI 大模型的 Module 模块 |
+| `yudao-module-mp` | 微信公众号的 Module 模块 |
+| `yudao-module-report` | 大屏报表 Module 模块 |
-| 模块 | biu | biu | biu |
-|---------|---------------------------|---------------------------------|---------------------------------|
-| 商家 & 应用 |  |  |  |
-| 支付 & 退款 |  |  | --- |
-### 数据报表
+---
-| 模块 | biu | biu | biu |
-|-------|---------------------------------|---------------------------------|---------------------------------------|
-| 报表设计器 |  |  |  |
-| 大屏设计器 |  |  |  |
-
-### 移动端(管理后台)
-
-| biu | biu | biu |
-|----------------------------------|----------------------------------|----------------------------------|
-|  |  |  |
-|  |  |  |
-|  |  |  |
-
-目前已经实现登录、我的、工作台、编辑资料、头像修改、密码修改、常见问题、关于我们等基础功能。
+*项目基于 [RuoYi-Vue](https://gitee.com/y_project/RuoYi-Vue) 修改,感谢其优秀的设计和代码!*