# RuoYi-Vue 架构概览

> **项目版本**: 3.8.0 | **分析日期**: 2026-06-28  
> **前端**: Vue 2.6.12 + Element UI 2.15.6 | **后端**: Spring Boot 2.5.8 + JDK 1.8

---

## 1. 系统总体架构

### 1.1 系统架构图

```
┌─────────────────────────────────────────────────────────────────────────┐
│                              浏览器客户端                                │
│  ┌───────────────────────────────────────────────────────────────────┐  │
│  │                        前端层 (Vue 2 SPA)                          │  │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────────┐ │  │
│  │  │  Views  │ │ Layout  │ │  Store  │ │ Router  │ │  Components │ │  │
│  │  │ (40+页) │ │(侧边栏/  │ │ (Vuex 5 │ │(静态+   │ │  (22个组件组)│ │  │
│  │  │         │ │ 标签页)  │ │  modules)│ │动态路由) │ │             │ │  │
│  │  └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └──────┬──────┘ │  │
│  │       └───────────┴───────────┴───────────┴─────────────┘        │  │
│  │                            │                                      │  │
│  │                   ┌────────┴────────┐                             │  │
│  │                   │  Axios 封装层    │ ← 请求/响应拦截器、错误处理   │  │
│  │                   └────────┬────────┘                             │  │
│  └───────────────────────────┼───────────────────────────────────────┘  │
└──────────────────────────────┼──────────────────────────────────────────┘
                               │ HTTP/JSON (Bearer Token)
                               ▼
┌──────────────────────────────────────────────────────────────────────────┐
│                            后端服务层                                     │
│  ┌────────────────────────────────────────────────────────────────────┐  │
│  │  ruoyi-admin (启动层 & Controller 层 — 28 个 Controller)           │  │
│  │  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌──────────────┐ │  │
│  │  │ 系统管理(13) │ │ 监控管理(5)  │ │ 业务模块(6)  │ │ 工具/公共(4)  │ │  │
│  │  └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ └──────┬───────┘ │  │
│  │         └───────────────┴───────────────┴───────────────┘         │  │
│  │                            │                                       │  │
│  │  ┌─────────────────────────┴──────────────────────────────┐       │  │
│  │  │           ruoyi-framework (框架核心层)                   │       │  │
│  │  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌───────────┐ │       │  │
│  │  │  │ Security │ │ AOP 切面 │ │ Config   │ │ Redis/JWT │ │       │  │
│  │  │  │ (认证/   │ │ (4个切面) │ │ (12个配置)│ │ (Token管理)│ │       │  │
│  │  │  │  授权)   │ │          │ │          │ │           │ │       │  │
│  │  │  └──────────┘ └──────────┘ └──────────┘ └───────────┘ │       │  │
│  │  └─────────────────────────┬──────────────────────────────┘       │  │
│  │                            │                                       │  │
│  │     ┌──────────────┬───────┴───────┬──────────────┐               │  │
│  │     ▼              ▼               ▼              ▼               │  │
│  │  ┌──────┐   ┌──────────┐   ┌──────────┐   ┌────────────┐         │  │
│  │  │ruoyi │   │ book-    │   │ stock-   │   │ ruoyi-     │         │  │
│  │  │system│   │ system   │   │ system   │   │ quartz     │         │  │
│  │  │(12S  │   │ (6S/6M)  │   │ (9M)     │   │ /generator │         │  │
│  │  │ 12M) │   │          │   │          │   │            │         │  │
│  │  └──────┘   └──────────┘   └──────────┘   └────────────┘         │  │
│  │                            │                                       │  │
│  │  ┌─────────────────────────┴──────────────────────────────┐       │  │
│  │  │              ruoyi-common (通用工具层)                    │       │  │
│  │  │  BaseController / AjaxResult / BaseEntity / 注解 /     │       │  │
│  │  │  工具类(20+) / 异常类 / 过滤器 / 常量 / 分页组件         │       │  │
│  │  └────────────────────────────────────────────────────────┘       │  │
│  └────────────────────────────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────────────────────────────┘
                               │
                               ▼
┌──────────────────────────────────────────────────────────────────────────┐
│                              数据层                                       │
│  ┌──────────────────────┐              ┌────────────────────────────┐    │
│  │      MySQL 数据库     │              │       Redis 缓存            │    │
│  │  ┌────────────────┐  │              │  ┌──────────────────────┐  │    │
│  │  │ sys_* 系统表    │  │              │  │ login_tokens:{uuid}  │  │    │
│  │  │ book_* 账本表   │  │              │  │ 用户会话 / Token     │  │    │
│  │  │ stock_* 股票表  │  │              │  ├──────────────────────┤  │    │
│  │  │ quartz_* 任务表  │  │              │  │ 限流计数器            │  │    │
│  │  │ gen_* 生成器表   │  │              │  ├──────────────────────┤  │    │
│  │  └────────────────┘  │              │  │ 配置缓存 / 字典缓存    │  │    │
│  └──────────────────────┘              │  └──────────────────────┘  │    │
│                                        └────────────────────────────┘    │
└──────────────────────────────────────────────────────────────────────────┘
```

### 1.2 分层说明

| 层级 | 职责 | 关键技术 |
|------|------|---------|
| **前端展示层** | 页面渲染、用户交互、路由导航、状态管理 | Vue 2 SPA、Element UI、Vuex、Vue Router |
| **API 通信层** | 前后端 HTTP 通信、Token 携带、错误统一处理 | Axios + 拦截器、JWT Bearer Token |
| **Controller 层** | 请求接收、参数校验、权限注解、响应封装 | Spring MVC、@PreAuthorize、@Log |
| **框架核心层** | 安全认证、AOP 切面、数据源路由、全局配置 | Spring Security、JWT、AspectJ、Druid |
| **Service 层** | 业务逻辑、事务管理、数据权限过滤 | @Transactional、@DataScope |
| **Mapper 层** | SQL 映射、动态查询、结果集映射 | MyBatis + XML + PageHelper |
| **Domain 层** | 实体模型、基类继承、VO/DTO 传输 | BaseEntity、TreeEntity |
| **数据存储层** | 持久化存储、会话缓存、限流计数 | MySQL 5.7+、Redis |

---

## 2. 技术栈总结

### 2.1 前端技术栈

| 分类 | 技术 | 版本 | 用途 |
|------|------|------|------|
| 核心框架 | Vue.js | 2.6.12 | 渐进式 MVVM 框架 |
| UI 组件库 | Element UI | 2.15.6 | 桌面端组件库 |
| 路由管理 | Vue Router | 3.4.9 | SPA 路由（含动态路由） |
| 状态管理 | Vuex | 3.6.0 | 集中式状态管理（5 个模块） |
| HTTP 客户端 | Axios | 0.24.0 | HTTP 请求封装 |
| 构建工具 | Vue CLI | 4.4.6 | 项目脚手架 |
| CSS 预处理 | Sass | 1.32.13 | 样式预处理器 |
| 图表库 | ECharts | 4.9.0 | 数据可视化 |
| 富文本编辑器 | Quill | 1.3.7 | 富文本编辑 |
| 代码高亮 | highlight.js | 9.18.5 | 代码语法高亮 |
| 拖拽排序 | vuedraggable | 2.24.3 | 列表拖拽 |
| SVG 图标 | svg-sprite-loader | 5.1.1 | SVG 雪碧图 |
| 加密 | jsencrypt | 3.2.1 | RSA 密码加密 |
| 进度条 | NProgress | 0.2.0 | 页面加载进度 |
| Cookie | js-cookie | 3.0.1 | Cookie 读写 |

### 2.2 后端技术栈

| 分类 | 技术 | 版本 | 用途 |
|------|------|------|------|
| 核心框架 | Spring Boot | 2.5.8 | 快速开发框架 |
| JDK | Java | 1.8 | 运行环境 |
| 安全框架 | Spring Security | 内置 | 认证与授权 |
| JWT | jjwt | 0.9.1 | Token 签发与验证 |
| ORM | MyBatis | 2.2.0 (starter) | SQL 映射框架 |
| 分页插件 | PageHelper | 1.4.0 | 物理分页 |
| 连接池 | Druid | 1.2.8 | 数据库连接池 + 监控 |
| 缓存 | Spring Data Redis | 内置 | 会话缓存、限流 |
| API 文档 | Springfox Swagger 3 | 3.0.0 | 接口文档 |
| JSON 解析 | FastJSON | 1.2.79 | JSON 序列化 |
| Excel 处理 | Apache POI | 4.1.2 | Excel 导入导出 |
| 验证码 | Kaptcha | 2.3.2 | 图形验证码 |
| 代码生成 | Velocity | 2.3 | 模板引擎 |
| 系统监控 | Oshi | 5.8.6 | 服务器信息采集 |
| 定时任务 | Quartz | 内置 | 任务调度 |

### 2.3 数据库技术栈

| 技术 | 用途 | 说明 |
|------|------|------|
| MySQL 5.7+ | 主数据库 | 系统表(sys_*)、业务表(book_*/stock_*)、任务表(quartz_*) |
| Redis | 缓存/会话 | Token 存储(login_tokens:{uuid})、限流计数器、配置缓存 |

---

## 3. 模块划分

### 3.1 模块清单

| 模块名 | 类型 | 职责 | 核心内容 |
|--------|------|------|----------|
| **ruoyi-admin** | 启动模块 | Spring Boot 启动入口，Controller 层聚合 | 启动类、28 个 Controller、Swagger 配置、打包部署 |
| **ruoyi-framework** | 框架核心 | 安全认证、AOP 切面、数据源、全局配置 | Security、JWT、4 个切面、12 个配置类、异步管理 |
| **ruoyi-system** | 系统管理 | 系统基础业务 | 用户/角色/菜单/部门/字典/岗位/日志 (12 Service + 12 Mapper) |
| **ruoyi-common** | 通用工具 | 基类、工具类、注解、异常、常量 | BaseController、AjaxResult、BaseEntity、20+ 工具类 |
| **ruoyi-generator** | 代码生成 | Velocity 模板驱动的代码生成器 | 表结构查询、模板渲染、2 个 Mapper |
| **ruoyi-quartz** | 定时任务 | 基于 Quartz 的任务调度管理 | 任务 CRUD、执行日志、2 个 Mapper |
| **book-system** | 账本业务 | 账务管理业务模块 | 账户/账本/操作记录/统计 (6 Service + 6 Mapper) |
| **stock-system** | 股票业务 | 股票分析业务模块 | 股票信息/行情/财务/趋势 (9 Mapper) |

### 3.2 模块依赖图

```
                     ┌─────────────┐
                     │ ruoyi-admin │  ← 启动入口，打包部署
                     └──────┬──────┘
                            │ depends on
            ┌───────────────┼───────────────┐
            ▼               ▼               ▼
     ┌────────────┐  ┌────────────┐  ┌─────────────┐
     │ ruoyi-     │  │ ruoyi-     │  │ ruoyi-      │
     │ system     │  │ quartz     │  │ generator   │
     └──────┬─────┘  └──────┬─────┘  └──────┬──────┘
            │               │               │
            ▼               ▼               ▼
     ┌─────────────────────────────────────────────┐
     │             ruoyi-framework                  │
     │    (Security, AOP, DataSource, Redis, Config)│
     └──────────────────────┬──────────────────────┘
                            │ depends on
            ┌───────────────┼───────────────┐
            ▼               ▼               ▼
     ┌────────────┐  ┌────────────┐  ┌─────────────┐
     │ book-      │  │ stock-     │  │ ruoyi-      │
     │ system     │  │ system     │  │ common      │
     └────────────┘  └────────────┘  └─────────────┘
```

**依赖规则**：
- `ruoyi-admin` → 依赖所有业务模块 + framework
- 业务模块 (`ruoyi-system` / `book-system` / `stock-system` / `quartz` / `generator`) → 依赖 `ruoyi-framework`
- `ruoyi-framework` → 依赖 `ruoyi-common`
- `ruoyi-common` → 无内部依赖（底层基础模块）

---

## 4. 关键设计模式

### 4.1 MVC 模式

```
Controller (ruoyi-admin)
    │  接收请求、参数校验、权限控制
    ▼
Service (各业务模块)
    │  业务逻辑、事务管理
    ▼
Mapper (各业务模块)
    │  SQL 映射、数据访问
    ▼
Domain (ruoyi-common / 各模块)
       实体模型、基类继承
```

- **Controller**: 统一继承 `BaseController`，获得 `startPage()`、`getDataTable()`、`toAjax()` 等通用方法
- **Service**: 接口 + 实现分离 (`ISysUserService` / `SysUserServiceImpl`)
- **Mapper**: MyBatis XML 映射 + Java 接口，大量使用动态 SQL
- **Domain**: `BaseEntity` → `TreeEntity` 继承体系

### 4.2 分层架构

**物理分层**（Maven 多模块）与 **逻辑分层**（Controller → Service → Mapper）相结合：

```
┌───────────────────────────────────────────┐
│  ruoyi-admin    → Controller 层 (表现层)   │
├───────────────────────────────────────────┤
│  ruoyi-framework → 框架支撑层 (横切关注点)  │
├───────────────────────────────────────────┤
│  ruoyi-system   → Service/Mapper (业务层)   │
│  book-system    → Service/Mapper (业务层)   │
│  stock-system   → Service/Mapper (业务层)   │
├───────────────────────────────────────────┤
│  ruoyi-common   → Domain/工具类 (基础层)    │
└───────────────────────────────────────────┘
```

### 4.3 AOP 切面

| 切面 | 注解 | 通知类型 | 优先级 | 用途 |
|------|------|---------|--------|------|
| **DataSourceAspect** | `@DataSource` | `@Around` | `@Order(1)` | 多数据源动态切换 |
| **DataScopeAspect** | `@DataScope` | `@Before` | — | 数据权限 SQL 注入 |
| **LogAspect** | `@Log` | `@AfterReturning` / `@AfterThrowing` | — | 操作日志异步记录 |
| **RateLimiterAspect** | `@RateLimiter` | `@Before` | — | Redis 限流控制 |

### 4.4 其他设计模式

| 模式 | 应用场景 | 实现方式 |
|------|---------|---------|
| **单例模式** | Spring Bean 默认作用域 | 配置类 (`SecurityConfig`、`DruidConfig` 等) 通过 `@Configuration` + `@Bean` 实现 |
| **工厂模式** | 异步任务创建 | `AsyncFactory` 创建不同类型的异步任务（操作日志、登录日志） |
| **策略模式** | 数据权限过滤 | `@DataScope` 注解根据不同数据范围类型（全部/本部门/本人等）生成不同的 SQL 过滤策略 |
| **模板方法模式** | BaseController | 基类定义通用流程（分页、响应），子类 Controller 继承复用 |
| **责任链模式** | Spring Security 过滤器链 | `CorsFilter → JwtAuthenticationTokenFilter → AuthenticationFilter` 依次处理 |
| **代理模式** | MyBatis Mapper | MyBatis 通过动态代理生成 Mapper 接口实现 |
| **观察者模式** | Spring 事件机制 | `AsyncManager` 通过线程池异步处理任务，解耦日志写入与主流程 |

---

*文档结束*