项目结构

![项目结构](/media/202404/2024-04-25_1859210.01930989586524179.png)

## [#](https://doc.iocoder.cn/project-intro/#%F0%9F%91%8D-%E7%9B%B8%E5%85%B3%E8%A7%86%E9%A2%91%E6%95%99%E7%A8%8B)👍 相关视频教程

* [从零开始 01：视频课程导读：项目简介、功能列表、技术选型(opens new window)](https://t.zsxq.com/07rbyjM7A)
* [从零开始 04：自顶向下，讲解项目的整体结构（上）(opens new window)](https://t.zsxq.com/07FiIaQr3)
* [从零开始 04：自顶向下，讲解项目的整体结构（下）(opens new window)](https://t.zsxq.com/07yNfE6un)

## [#](https://doc.iocoder.cn/project-intro/#%F0%9F%91%BB-%E5%90%8E%E7%AB%AF%E7%BB%93%E6%9E%84)👻 后端结构

后端采用模块化的架构，按照功能拆分成多个 Maven Module，提升开发与研发的效率，带来更好的可维护性。

一共有**四**类 Maven Module：

| Maven Module             | 作用                         |
| -------------------------- | ------------------------------ |
| `yudao-dependencies` | Maven 依赖版本管理           |
| `yudao-framework`    | Java 框架拓展                |
| `yudao-module-xxx`   | XXX 功能的 Module 模块       |
| `yudao-server`       | 管理后台 + 用户 App 的服务端 |

下面，我们来逐个看看。

### [#](https://doc.iocoder.cn/project-intro/#_1-yudao-dependencies)1. yudao-dependencies

该模块是一个 Maven Bom，只有一个 [`pom.xml` **(opens new window)**](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-dependencies/pom.xml)文件，定义项目中所有 Maven 依赖的 **版本号** ，解决依赖冲突问题。

> 详细的解释，可见 [《微服务中使用 Maven BOM 来管理你的版本依赖 》 **(opens new window)**](http://www.iocoder.cn/maven/bom?yudao)文章。

从定位上来说，它和 Spring Boot 的 [`spring-boot-starter-parent` **(opens new window)**](https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-parent)和 Spring Cloud 的 [`spring-cloud-dependencies` **(opens new window)**](https://mvnrepository.com/artifact/org.springframework.cloud/spring-cloud-dependencies)是一致的。

实际上，`ruoyi-vue-pro` 本质上还是个**单体**项目，直接在根目录 [`pom.xml` **(opens new window)**](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/pom.xml)管理依赖版本会更加方便，也符合绝大多数程序员的认知。但是要额外考虑一个场景，如果每个 `yudao-module-xxx` 模块都维护在一个独立的 Git 仓库，那么 `yudao-dependencies` 就可以在多个 `yudao-module-xxx` 模块下复用。

### [#](https://doc.iocoder.cn/project-intro/#_2-yudao-framework)2. yudao-framework

该模块是 `ruoyi-vue-pro` 项目的框架封装，其下的每个 Maven Module 都是一个组件，分成两种类型：

① 技术组件：技术相关的组件封装，例如说 MyBatis、Redis 等等。

| Maven Module                                       | 作用                                                                                        |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| `yudao-common`                                 | 定义基础 pojo 类、枚举、工具类等                                                            |
| `yudao-spring-boot-starter-web`                | Web 封装，提供全局异常、访问日志等                                                          |
| `yudao-spring-boot-starter-websocket`          | WebSocket 封装，提供 Token 认证、WebSocket 集群广播、Message 监听                           |
| `yudao-spring-boot-starter-security`           | 认证授权，基于 Spring Security 实现                                                         |
| `yudao-spring-boot-starter-mybatis`            | 数据库操作，基于 MyBatis Plus 实现                                                          |
| `yudao-spring-boot-starter-redis`              | 缓存操作，基于 Spring Data Redis + Redisson 实现                                            |
| `yudao-spring-boot-starter-mq`                 | 消息队列，基于 Redis 实现，支持集群消费和广播消费                                           |
| `yudao-spring-boot-starter-job`                | 定时任务，基于 Quartz 实现，支持集群模式                                                    |
| `yudao-spring-boot-starter-flowable`           | 工作流，基于 Flowable 实现                                                                  |
| `yudao-spring-boot-starter-protection`         | 服务保障，提供幂等、分布式锁、限流、熔断等功能                                              |
| `yudao-spring-boot-starter-excel`              | Excel 导入导出，基于 EasyExcel 实现                                                         |
| `yudao-spring-boot-starter-monitor`            | 服务监控，提供链路追踪、日志服务、指标收集等功能                                            |
| `yudao-spring-boot-starter-test`               | 单元测试，基于 Junit + Mockito 实现                                                         |
| `yudao-spring-boot-starter-file` 【已合并】    | 文件客户端，支持将文件存储到 S3（MinIO、阿里云、腾讯云、七牛云）、本地、FTP、SFTP、数据库等 |
| `yudao-spring-boot-starter-captcha` 【已合并】 | 验证码 Captcha，提供滑块验证码                                                              |

友情提示：

* `yudao-spring-boot-starter-file` 组件：自 `2.0.1` 版本，合并到 `yudao-module-infra-biz` 模块的 `framework/file` 包下，一方面减少 starter 提升编译速度，一方面只有 infra 模块使用到
* `yudao-spring-boot-starter-captcha` 组件：自 `2.0.1` 版本，合并到 `yudao-module-system-biz` 模块的 `framework/captcha` 包下，一方面减少 starter 提升编译速度，一方面只有 system 模块使用到

② 业务组件：业务相关的组件封装，例如说数据字典、操作日志等等。如果是业务组件，名字会包含 `biz` 关键字。

| Maven Module                                        | 作用                                       |
| ----------------------------------------------------- | -------------------------------------------- |
| `yudao-spring-boot-starter-biz-tenant`          | SaaS 多租户                                |
| `yudao-spring-boot-starter-biz-data-permission` | 数据权限                                   |
| `yudao-spring-boot-starter-biz-operatelog`      | 操作日志                                   |
| `yudao-spring-boot-starter-biz-pay`             | 支付客户端，对接微信支付、支付宝等支付平台 |
| `yudao-spring-boot-starter-biz-ip`              | 地区 & IP 库                               |

友情提示：

* `yudao-spring-boot-starter-biz-operatelog` 组件：自 `2.1.0` 版本，合并到 `yudao-spring-boot-starter-security` 组件的 `operatelog` 包下，主要减少 starter 提升编译速度

---

每个组件，包含两部分：

1. `core` 包：组件的核心封装，拓展相关的功能。
2. `config` 包：组件的 Spring Boot 自动配置。

![ 示例](/media/202404/2024-04-25_1859210.5525465387537594.png)

### [#](https://doc.iocoder.cn/project-intro/#_3-yudao-module-xxx)3. yudao-module-xxx

该模块是 XXX 功能的 Module 模块，目前内置了 8 个模块。

| 项目                      | 说明       | 是否必须 |
| --------------------------- | ------------ | ---------- |
| `yudao-module-system` | 系统功能   | √       |
| `yudao-module-infra`  | 基础设施   | √       |
| `yudao-module-member` | 会员中心   | x        |
| `yudao-module-bpm`    | 工作流程   | x        |
| `yudao-module-pay`    | 支付系统   | x        |
| `yudao-module-report` | 大屏报表   | x        |
| `yudao-module-mall`   | 商城系统   | x        |
| `yudao-module-erp`    | ERP 系统   | x        |
| `yudao-module-crm`    | CRM 系统   | x        |
| `yudao-module-mp`     | 微信公众号 | x        |

---

每个模块包含两个 Maven Module，分别是：

| Maven Module               | 作用                      |
| ---------------------------- | --------------------------- |
| `yudao-module-xxx-api` | 提供给其它模块的 API 定义 |
| `yudao-module-xxx-biz` | 模块的功能的具体实现      |

例如说，`yudao-module-infra` 想要访问 `yudao-module-system` 的用户、部门等数据，需要引入 `yudao-module-system-api` 子模块。示例如下：

![引用的示例](/media/202404/2024-04-25_1859210.8589251592918918.png)

疑问：为什么设计 `yudao-module-xxx-api` 模块呢？

1. **明确**需要提供给其它模块的 API 定义，方便未来迁移微服务架构。
2. 模块之间可能会存在相互引用的情况，虽然说从系统设计上要尽量避免，但是有时在快速迭代的情况下，可能会出现。此时，通过只引用对方模块的 API 子模块，解决相互引用导致 Maven 无法打包的问题。

`yudao-module-xxx-api` 子模块的项目结构如下：

![ 项目结构](/media/202404/2024-04-25_1859210.8771682068904234.png)

| 所在包      | 类                    | 作用                                | 示例                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------- | ----------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `api`   | Api 接口              | 提供给其它模块的 API 接口           | [AdminUserApi(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/api/user/AdminUserApi.java)                                                                                                                                                                                                                                    |
| `api`   | DTO 类                | Api 接口的入参 ReqDTO、出参 RespDTO | [LoginLogCreateReqDTO **(opens new window)**](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/api/logger/dto/LoginLogCreateReqDTO.java)[DeptRespDTO(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/api/dept/dto/DeptRespDTO.java) |
| `enums` | Enum 类               | 字段的枚举                          | [LoginLogTypeEnum(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/enums/logger/LoginLogTypeEnum.java)                                                                                                                                                                                                                        |
| `enums` | DictTypeConstants 类  | 数据字典的枚举                      | [DictTypeConstants(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/enums/DictTypeConstants.java)                                                                                                                                                                                                                             |
| `enums` | ErrorCodeConstants 类 | 错误码的枚举                        | [ErrorCodeConstants(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-api/src/main/java/cn/iocoder/yudao/module/system/enums/ErrorCodeConstants.java)                                                                                                                                                                                                                           |

`yudao-module-xxx-biz` 子模块的项目结构如下：

![ 项目结构](/media/202404/2024-04-25_1859210.2789827185881387.png)

| 所在包                | 类                                     | 作用                                                                                                                           | 示例                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `api`             | ApiImpl 类                             | 提供给其它模块的 API 实现类                                                                                                    | [AdminUserApiImpl(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/api/user/AdminUserApiImpl.java)                                                                                                                                                                                                                                                        |
| `controler.admin` | Controller 类                          | 提供给管理后台的 RESTful API，默认以 `admin-api/` 作为前缀。例如 `admin-api/system/auth/login` 登录接口               | [AuthController(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/auth/AuthController.java)                                                                                                                                                                                                                                               |
| `controler.admin` | VO 类                                  | Admin Controller 接口的入参 ReqVO、出参 RespVO                                                                                 | [AuthLoginReqVO **(opens new window)**](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/auth/vo/auth/AuthLoginReqVO.java)[AuthLoginRespVO(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/auth/vo/auth/AuthLoginRespVO.java) |
| `controler.app`   | Controller 类，**以 App 为前缀** | 提供给用户 App 的 RESTful API，默认以 `app-api/` 作为前缀。例如 `app-api/member/auth/login` 登录接口                  | [AppAuthController(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-member/yudao-module-member-biz/src/main/java/cn/iocoder/yudao/module/member/controller/app/auth/AppAuthController.java)                                                                                                                                                                                                                                           |
| `controler.app`   | VO 类，**以 App 为前缀**         | App Controller 接口的入参 ReqVO、出参 RespVO                                                                                   | [AppAuthLoginReqVO **(opens new window)**](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-member/yudao-module-member-biz/src/main/java/cn/iocoder/yudao/module/member/controller/app/auth/vo/AppAuthLoginReqVO.java)[AppAuthLoginRespVO(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-member/yudao-module-member-biz/src/main/java/cn/iocoder/yudao/module/member/controller/app/auth/vo/AppAuthLoginRespVO.java)   |
| `controler`       | `.http` 文件                       | [IDEA Http Client 插件 **(opens new window)**](https://www.iocoder.cn/Spring-Boot/IDEA-HTTP-Client/?yudao)，模拟请求 RESTful 接口 | [AuthController.http(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/controller/admin/auth/AuthController.http)                                                                                                                                                                                                                                          |
| `service`         | Service 接口                           | 业务逻辑的接口定义                                                                                                             | [AdminUserService(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/service/user/AdminUserService.java)                                                                                                                                                                                                                                                    |
| `service`         | ServiceImpl 类                         | 业务逻辑的实现类                                                                                                               | [AdminUserServiceImpl(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/service/user/AdminUserServiceImpl.java)                                                                                                                                                                                                                                            |
| `dal`             | -                                      | Data Access Layer，数据访问层                                                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `dal.dataobject`  | DO 类                                  | Data Object，映射数据库表、或者 Redis 对象                                                                                     | [AdminUserDO(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/dal/dataobject/user/AdminUserDO.java)                                                                                                                                                                                                                                                       |
| `dal.mysql`       | Mapper 接口                            | 数据库的操作                                                                                                                   | [AdminUserMapper(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/dal/mysql/user/AdminUserMapper.java)                                                                                                                                                                                                                                                    |
| `dal.redis`       | RedisDAO 类                            | Redis 的操作                                                                                                                   | [LoginUserRedisDAO(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/dal/redis/auth/LoginUserRedisDAO.java)                                                                                                                                                                                                                                                |
| `convert`         | Convert 接口                           | DTO / VO / DO 等对象之间的转换器                                                                                               | [UserConvert(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/convert/user/UserConvert.java)                                                                                                                                                                                                                                                              |
| `job`             | Job 类                                 | 定时任务                                                                                                                       | [DemoJob(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/job/DemoJob.java)                                                                                                                                                                                                                                                                               |
| `mq`              | -                                      | Message Queue，消息队列                                                                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `mq.message`      | Message 类                             | 发送和消费的消息                                                                                                               | [SmsSendMessage(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/mq/message/sms/SmsSendMessage.java)                                                                                                                                                                                                                                                      |
| `mq.producer`     | Producer 类                            | 消息的生产者                                                                                                                   | [SmsProducer(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/mq/producer/sms/SmsProducer.java)                                                                                                                                                                                                                                                           |
| `mq.consumer`     | Producer 类                            | 消息的消费者                                                                                                                   | [SmsSendConsumer(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/blob/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/mq/consumer/sms/SmsSendConsumer.java)                                                                                                                                                                                                                                                   |
| `framework`       | -                                      | 模块自身的框架封装                                                                                                             | [`framework`(opens new window)](https://github.com/YunaiV/ruoyi-vue-pro/tree/master/yudao-module-system/yudao-module-system-biz/src/main/java/cn/iocoder/yudao/module/system/framework)                                                                                                                                                                                                                                                                              |

疑问：为什么 Controller 分成 Admin 和 App 两种？

提供给 Admin 和 App 的 RESTful API 接口是不同的，拆分后更加清晰。

疑问：为什么 VO 分成 Admin 和 App 两种？

相同功能的 RESTful API 接口，对于 Admin 和 App 传入的参数、返回的结果都可能是不同的。例如说，Admin 查询某个用户的基本信息时，可以返回全部字段；而 App 查询时，不会返回 mobile 手机等敏感字段。

疑问：为什么 DO 不作为 Controller 的出入参？

1. 明确每个 RESTful API 接口的出入参。例如说，创建部门时，只需要传入 name、parentId 字段，使用 DO 接参就会导致 type、createTime、creator 等字段可以被传入，导致前端同学一脸懵逼。
2. 每个 RESTful API 有自己独立的 VO，可以更好的设置 Swagger 注解、Validator 校验规则，而让 DO 保持整洁，专注映射好数据库表。

疑问：为什么操作 Redis 需要通过 RedisDAO？

Service 直接使用 RedisTemplate 操作 Redis，导致大量 Redis 的操作细节和业务逻辑杂糅在一起，导致代码不够整洁。通过 RedisDAO 类，将每个 Redis Key 像一个数据表一样对待，清晰易维护。

总结来说，每个模块采用**三层**架构 + **非严格**分层，如下图所示：

![项目分层](/media/202404/2024-04-25_1859210.4040567999981627.png)

疑问：如果 message 需要跨模块共享，类似 api 的效果，可以怎么做？

可以在 `yudao-module-xxx-api` 子模块下，新建一个 `message` 包，可参考 MemberUserCreateMessage 类。

### [#](https://doc.iocoder.cn/project-intro/#_4-yudao-server)4. yudao-server

该模块是后端 Server 的 **主项目** ，通过引入需要 `yudao-module-xxx` 业务模块，从而实现提供 RESTful API 给 `yudao-ui-admin-vue3`、`yudao-mall-uniapp` 等前端项目。

本质上来说，它就是个空壳（容器）！如下图所示：

![ 项目](/media/202404/2024-04-25_1859210.08200380277786512.png)

## [#](https://doc.iocoder.cn/project-intro/#%F0%9F%91%BE-%E5%89%8D%E7%AB%AF%E7%BB%93%E6%9E%84)👾 前端结构

前端一共有六个项目，分别是：

| 项目                                                                                              | 说明                                            |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| [`yudao-ui-admin-vue3`(opens new window)](https://github.com/yudaocode/yudao-ui-admin-vue3/)     | 基于 Vue3 + element-plus 实现的管理后台         |
| [`yudao-ui-admin-vben`(opens new window)](https://github.com/yudaocode/yudao-ui-admin-vben/)     | 基于 Vue3 + vben(ant-design-vue) 实现的管理后台 |
| [`yudao-ui-admin-vue2`(opens new window)](https://github.com/yudaocode/yudao-ui-admin-vue2/)     | 基于 Vue2 + element-ui 实现的管理后台           |
| [`yudao-ui-go-view`(opens new window)](https://gitee.com/yudaocode/yudao-ui-go-view)             | 基于 Vue3 + naive-ui 实现的大屏报表             |
| [`yudao-ui-admin-uniapp`(opens new window)](https://github.com/yudaocode/yudao-ui-admin-uniapp/) | 基于 uni-app + uni-ui 实现的管理后台的小程序    |
| [`yudao-mall-uniapp`(opens new window)](https://github.com/yudaocode/yudao-mall-uniapp)          | 基于 uni-app + uview 实现的用户 App             |

### [#](https://doc.iocoder.cn/project-intro/#_1-yudao-admin-ui-vue3)1. yudao-admin-ui-vue3

```text
.
├── .github # github workflows 相关
├── .husky # husky 配置
├── .vscode # vscode 配置
├── mock # 自定义 mock 数据及配置
├── public # 静态资源
├── src # 项目代码
│   ├── api # api接口管理
│   ├── assets # 静态资源
│   ├── components # 公用组件
│   ├── hooks # 常用hooks
│   ├── layout # 布局组件
│   ├── locales # 语言文件
│   ├── plugins # 外部插件
│   ├── router # 路由配置
│   ├── store # 状态管理
│   ├── styles # 全局样式
│   ├── utils # 全局工具类
│   ├── views # 路由页面
│   ├── App.vue # 入口vue文件
│   ├── main.ts # 主入口文件
│   └── permission.ts # 路由拦截
├── types # 全局类型
├── .env.base # 本地开发环境 环境变量配置
├── .env.dev # 打包到开发环境 环境变量配置
├── .env.gitee # 针对 gitee 的环境变量 可忽略
├── .env.pro # 打包到生产环境 环境变量配置
├── .env.test # 打包到测试环境 环境变量配置
├── .eslintignore # eslint 跳过检测配置
├── .eslintrc.js # eslint 配置
├── .gitignore # git 跳过配置
├── .prettierignore # prettier 跳过检测配置
├── .stylelintignore # stylelint 跳过检测配置
├── .versionrc 自动生成版本号及更新记录配置
├── CHANGELOG.md # 更新记录
├── commitlint.config.js # git commit 提交规范配置
├── index.html # 入口页面
├── package.json
├── .postcssrc.js # postcss 配置
├── prettier.config.js # prettier 配置
├── README.md # 英文 README
├── README.zh-CN.md # 中文 README
├── stylelint.config.js # stylelint 配置
├── tsconfig.json # typescript 配置
├── vite.config.ts # vite 配置
└── windi.config.ts # windicss 配置
```

### [#](https://doc.iocoder.cn/project-intro/#_2-yudao-ui-admin-vben)2. yudao-ui-admin-vben

```text
.
├── build # 打包脚本相关
│   ├── config # 配置文件
│   ├── generate # 生成器
│   ├── script # 脚本
│   └── vite # vite配置
├── mock # mock文件夹
├── public # 公共静态资源目录
├── src # 主目录
│   ├── api # 接口文件
│   ├── assets # 资源文件
│   │   ├── icons # icon sprite 图标文件夹
│   │   ├── images # 项目存放图片的文件夹
│   │   └── svg # 项目存放svg图片的文件夹
│   ├── components # 公共组件
│   ├── design # 样式文件
│   ├── directives # 指令
│   ├── enums # 枚举/常量
│   ├── hooks # hook
│   │   ├── component # 组件相关hook
│   │   ├── core # 基础hook
│   │   ├── event # 事件相关hook
│   │   ├── setting # 配置相关hook
│   │   └── web # web相关hook
│   ├── layouts # 布局文件
│   │   ├── default # 默认布局
│   │   ├── iframe # iframe布局
│   │   └── page # 页面布局
│   ├── locales # 多语言
│   ├── logics # 逻辑
│   ├── main.ts # 主入口
│   ├── router # 路由配置
│   ├── settings # 项目配置
│   │   ├── componentSetting.ts # 组件配置
│   │   ├── designSetting.ts # 样式配置
│   │   ├── encryptionSetting.ts # 加密配置
│   │   ├── localeSetting.ts # 多语言配置
│   │   ├── projectSetting.ts # 项目配置
│   │   └── siteSetting.ts # 站点配置
│   ├── store # 数据仓库
│   ├── utils # 工具类
│   └── views # 页面
├── test # 测试
│   └── server # 测试用到的服务
│       ├── api # 测试服务器
│       ├── upload # 测试上传服务器
│       └── websocket # 测试ws服务器
├── types # 类型文件
├── vite.config.ts # vite配置文件
└── windi.config.ts # windcss配置文件
```

### [#](https://doc.iocoder.cn/project-intro/#_3-yudao-admin-ui)3. yudao-admin-ui

```text
├── bin                        // 执行脚本
├── build                      // 构建相关  
├── public                     // 公共文件
│   ├── favicon.ico            // favicon 图标
│   └── index.html             // html 模板
│   └── robots.txt             // 反爬虫
├── src                        // 源代码
│   ├── api                    // 所有请求【重要】
│   ├── assets                 // 主题、字体等静态资源
│   ├── components             // 全局公用组件
│   ├── directive              // 全局指令
│   ├── icons                  // 图标
│   ├── layout                 // 布局
│   ├── plugins                // 插件
│   ├── router                 // 路由
│   ├── store                  // 全局 store 管理
│   ├── utils                  // 全局公用方法
│   ├── views                  // 视图【重要】
│   ├── App.vue                // 入口页面
│   ├── main.js                // 入口 JS，加载组件、初始化等
│   ├── permission.js          // 权限管理
│   └── settings.js            // 系统配置
├── .editorconfig              // 编码格式
├── .env.development           // 开发环境配置
├── .env.production            // 生产环境配置
├── .env.staging               // 测试环境配置
├── .eslintignore              // 忽略语法检查
├── .eslintrc.js               // eslint 配置项
├── .gitignore                 // git 忽略项
├── babel.config.js            // babel.config.js
├── package.json               // package.json
└── vue.config.js              // vue.config.js
```

### [#](https://doc.iocoder.cn/project-intro/#_4-yudao-admin-ui-uniapp)4. yudao-admin-ui-uniapp

TODO 待补充

### [#](https://doc.iocoder.cn/project-intro/#_5-yudao-mall-uniapp)5. yudao-mall-uniapp

```text
├── pages                   // 页面
│      ├── index            // 入口页面
│      ├── user             // 用户相关
│      ├── public           // 公共页面
│      ├── activity         // 活动页面
│      ├── app              // 积分、签到页面
│      ├── chat             // 客服页面
│      ├── commission       // 分销页面
│      ├── coupon           // 优惠券页面
│      ├── goods            // 商品页面
│      ├── order            // 订单页面
│      ├── pay              // 支付页面
├── sheep                   // 底层依赖/工具库
│      ├── api              // 服务端接口
│      ├── components       // 自定义功能组件
│      ├── config           // 配置文件
│      ├── helper           // 助手函数
│      ├── hooks            // vue-hooks
│      ├── libs             // 自定义依赖
│      ├── platform         // 第三方平台登录、分享、支付
│      ├── request          // 请求类库
│      ├── router           // 自定义路由跳转
│      ├── scss             // 主样式库
│      ├── store            // pinia状态管理模块
│      ├── ui               // 自定义UI组件
│      ├── url              // cdn图片地址格式化
│      ├── validate         // 通用验证器
│      ├── index.js         // Shopro入口文件
├── uni_modules             // dcloud第三方插件
```

### [#](https://doc.iocoder.cn/project-intro/#_6-yudao-ui-go-view)6. yudao-ui-go-view

TODO 待补充