# youlai-boot-multi
**Spring Boot 4 多模块企业级权限管理系统后端**
[](https://spring.io/projects/spring-boot)
[](https://openjdk.org/)
[](LICENSE)
[](https://www.youlai.tech/docs/server/spring-boot/)
[](https://vue.youlai.tech)
[](https://gitee.com/youlaiorg/youlai-boot/stargazers)
## 简介
**youlai-boot-multi** 是 [youlai-boot](https://gitee.com/youlaiorg/youlai-boot) 的多模块版本，基于 Spring Boot 4，将原单体项目拆分为独立模块，实现业务解耦与按需引用。配套前端 [vue3-element-admin](https://gitee.com/youlaiorg/vue3-element-admin)，共享同一套 API 规范与数据库结构。
> 📌 本项目为 [youlai-boot](https://gitee.com/youlaiorg/youlai-boot) 的 `multi-module` 分支，克隆时请切换分支。
## 核心特性
- 🔐 **安全体系** — Spring Security + JWT/Redis Token 双会话模式、令牌续期、多端互斥
- 🛡️ **细粒度权限** — RBAC 五级：数据 → 菜单 → 按钮 → 接口 → 字段
- ⚡ **代码生成器** — 一键生成前后端 CRUD 代码
- 📦 **模块齐全** — 用户、角色、菜单、部门、字典、文件、定时任务、消息中心、操作日志
- 🔌 **实时通信** — SSE 推送：在线用户数、字典同步、通知广播
- 🧩 **模块解耦** — 事件驱动通信，模块间零循环依赖
## 快速开始
**环境要求**：JDK 17+ · MySQL 8.0+ · Redis 6.0+
1. 克隆项目：`git clone -b multi-module https://gitee.com/youlaiorg/youlai-boot.git`
2. 导入数据库：`sql/youlai_admin.sql`
3. 修改配置（可选，默认已配置线上只读数据源）：`youlai-application/src/main/resources/application-dev.yml`
4. 启动服务（运行 `youlai-application` 模块的 `YouLaiBootApplication`），访问 http://localhost:8000/doc.html
默认账号：`admin` / `123456`
**Docker 部署**：`cd docker && docker-compose up -d`
详细指南：[部署文档](https://www.youlai.tech/docs/server/spring-boot/deploy) · [开发规范](https://www.youlai.tech/docs/server/spring-boot/dev-standards)
## 技术栈
| 技术 | 版本 | 说明 |
|:-----|:-----|:-----|
| Spring Boot | 4.0.5 | 核心框架 |
| Spring Security | 6.x | 认证授权 |
| MyBatis-Plus | 3.5.15 | ORM 框架 |
| Druid | 1.2.24 | 数据库连接池 |
| Redis + Redisson | 6.0+ / 4.1.0 | 缓存 · 会话 · 分布式锁 |
| Caffeine | 2.9.3 | 本地缓存 |
| XXL-Job | 3.2.0 | 分布式定时任务 |
| Knife4j | 4.5.0 | API 文档 |
| MapStruct | 1.6.3 | 对象映射 |
| MinIO | 8.5.10 | 对象存储 |
## 目录结构
```
youlai-boot-multi/
├── youlai-application/ # 启动模块（入口）
├── youlai-common/ # 公共模块（常量/枚举/事件/统一响应）
├── youlai-framework/ # 技术框架层
│ ├── apidoc/ # OpenAPI / Knife4j
│ ├── cache/ # Redis / Caffeine 缓存
│ ├── captcha/ # 图形验证码
│ ├── integration/ # 短信 / 邮件 / 微信
│ ├── job/ # XXL-Job 定时任务
│ ├── mybatis/ # MyBatis-Plus 配置
│ ├── security/ # Security / JWT / Token
│ └── web/ # 全局异常 / 跨域 / 限流
├── youlai-system/ # 系统业务（用户/角色/菜单/部门）
├── youlai-auth/ # 认证授权（登录/登出/令牌）
├── youlai-file/ # 文件服务（MinIO/本地/OSS）
├── youlai-message/ # SSE 消息推送
├── youlai-codegen/ # 代码生成器
├── docker/ # Docker 部署编排
├── sql/ # 数据库初始化脚本
└── pom.xml # Maven 依赖管理
```
## 模块依赖关系
```
youlai-application ──→ youlai-system ──→ youlai-framework ──→ youlai-common
──→ youlai-auth ──→ youlai-framework
──→ youlai-file ──→ youlai-framework
──→ youlai-message──→ youlai-framework
──→ youlai-codegen──→ youlai-framework
```
## 生态矩阵
**前端**
| 项目 | 技术栈 | 说明 |
|:-----|:-------|:-----|
| [vue3-element-admin](https://gitee.com/youlaiorg/vue3-element-admin) | Vue 3 + Element Plus | PC 管理前端（主推） |
| [youlai-app](https://gitee.com/youlaiorg/youlai-app) | Vue 3 + UniApp | 移动端 App |
**后端**
| 项目 | 技术栈 | 说明 |
|:-----|:-------|:-----|
| [youlai-nest](https://gitee.com/youlaiorg/youlai-nest) | NestJS + TypeORM | Node.js |
| [youlai-gin](https://gitee.com/youlaiorg/youlai-gin) | Go + Gorm | Go |
| [youlai-django](https://gitee.com/youlaiorg/youlai-django) | Django + DRF | Python |
| [youlai-thinkphp](https://gitee.com/youlaiorg/youlai-thinkphp) | ThinkPHP 8 | PHP |
| [youlai-aspnet](https://gitee.com/youlaiorg/youlai-aspnet) | ASP.NET Core | C# |
> **youlai-boot** 还提供以下变种和分支版本：[多租户](https://gitee.com/youlaiorg/youlai-boot-tenant)（Spring Boot 4）· [MyBatis-Flex](https://gitee.com/youlaiorg/youlai-boot-flex)（Spring Boot 4）· [Spring Boot 3](https://gitee.com/youlaiorg/youlai-boot/tree/spring-boot-3) · [PostgreSQL](https://gitee.com/youlaiorg/youlai-boot/tree/db-pg) · [多模块](https://gitee.com/youlaiorg/youlai-boot/tree/multi-module)
>
> 六种后端共享同一套 **RESTful API 规范** 和 **数据库结构**，前端可无缝切换。
## 文档资源
| 资源 | 地址 |
|:-----|:-----|
| 📖 完整文档站 | [www.youlai.tech](https://www.youlai.tech/) |
| 🖥️ PC 端在线预览 | [vue.youlai.tech](https://vue.youlai.tech) |
| 📱 移动端在线预览 | [app.youlai.tech](https://app.youlai.tech) |
| 🔗 Apifox 接口文档 | [apifox.com](https://www.apifox.cn/apidoc/shared-195e783f-4d85-4235-a038-eec696de4ea5) |
| 🔗 本地接口文档 | [localhost:8000/doc.html](http://localhost:8000/doc.html) |
## 参与贡献
欢迎提交 Issue 和 Pull Request！详见 [贡献指南](https://www.youlai.tech/faq/help)。
[](https://github.com/haoxianrui/youlai-boot/graphs/contributors)
## 开源协议
本项目基于 [Apache License 2.0](LICENSE) 开源，可免费用于商业项目。
---
