参考资料与索引
📍 本文件汇总整个学习的参考资料、源码关键位置与章节地图，方便反向查阅。
章节地图
| 章节 | 主题 | 一句话导读 |
|---|---|---|
| 00-overview.md | 全景导览 | 项目背景、技术栈、认证授权总览、缓存布局、学习路线 |
| 01-module-common.md | 通用模块翻络基座 | 响应体、实体、注解、异常、分页、Redis、工具 |
| 02-module-framework-security.md | 认证授权核心 | JWT+Redis 状态、登录链、密码锁定、权限集合 |
| 03-module-framework-web.md | Web 横切能力 | 多数据源、操作日志、限流、防重复、异步、异常、过滤器 |
| 04-module-admin-web.md | 启动与 Controller 层 | 应用启动、验证码、文件、登录/用户等控制器、Swagger |
| 05-module-system.md | 系统业务层 | 用户/角色/菜单/部门/字典/配置 Service 与数据权限落点 |
| 06-module-quartz.md | 定时任务 | invokeTarget 反射、Quartz 编排、错失策略、启动重建 |
| 07-module-generator.md | 代码生成器 | 表→元数据→Velocity 模板→文件 |
| 08-deployment.md | 环境搭建与复刻 | 依赖清单、建库、配置、启动、前端、排查、复刻要点 |
源码关键位置速查
相对源码根
source/RuoYi-Vue-springboot3/。
| 关注点 | 位置 |
|---|---|
| 启动类 | RuoYiApplication.java |
| JWT 令牌签发/续期/注销 | TokenService.java |
| 登录主流程 + 验证码 + 预检 | SysLoginService.java |
| 密码锁定计数 | SysPasswordService.java |
| 用户加载器 | UserDetailsServiceImpl.java |
权限标签服务 @ss |
PermissionService.java |
| 数据权限切面 | DataScopeAspect.java |
| 操作日志切面 | LogAspect.java |
| 多数据源切面 | DataSourceAspect.java |
| 限流切面 | RateLimiterAspect.java |
| 动态路由数据源 | DynamicDataSource.java |
| 异步任务队列 | AsyncManager.java |
| 登录用户域对象 | LoginUser.java |
| 响应体 | AjaxResult.java |
| 实体基类 | BaseEntity.java |
| Redis 封装 | RedisCache.java |
| 缓存 key 常量 | CacheConstants.java |
| 菜单 Service（buildMenus/权限集） | SysMenuServiceImpl.java |
| 菜单权限 SQL | SysMenuMapper.xml |
| Quartz 编排 | ScheduleUtils.java |
| Quartz→业务桥 | AbstractQuartzJob.java |
| 反射调用 | JobInvokeUtil.java |
| 生成器类型推断 | GenUtils.java |
| 模板上下文/文件名 | VelocityUtils.java |
| 验证码签发 | CaptchaController.java |
配置文件 / 资源
| 资源 | 用途 |
|---|---|
application.yml · 在 ruoyi-admin/src/main/resources/ |
服务端口、Redis、token 密钥/过期、验证码开关、密码锁定策略 |
| application-druid.yml · 同上 | 主/从数据源连接 |
| logback.xml | 日志输出与滚动策略 |
| sql/ry_20260417.sql | 业务表 + 种子数据 |
| sql/quartz.sql | Quartz 表结构 |
| pom.xml | 父 POM：JDK17、Spring Boot 3.5.16、Druid、fastjson2 等 |
关键依赖版本一览（来自父 pom）
| 依赖 | 版本 |
|---|---|
| 若依框架版本 | 3.9.2 |
| Java | 17 |
| Spring Boot | 3.5.16 |
| mybatis-spring-boot | 3.0.5 |
| Druid | 1.2.28 |
| pagehelper-spring-boot | 2.1.1 |
| fastjson2 | 2.0.64 |
学习路径建议
路线 A（自顶向下，推荐）：
05（业务层理解后台在管什么）→ 02（认证如何让我们登录）→ 03（Web 横切能力）→ 07（如何让新表变页面）→ 06（定时任务）→ 08（部署复刻）→ 00（收尾全景）。
路线 B（自底向上，偏源码）：
01（地基）→ 02（安全）→ 03（横切）→ 05（业务）→ 04（入口）→ 06/07（增强）→ 08（落地）。
无论哪条路线，建议先通读一遍 00-overview.md，建立整体坐标系后再深入单章。
外部参考
- 若依开源主页 / 文档：
ruoyi.vip - 前端
ruoyi-ui（Vue3 + Vite + Element Plus）需单独获取，不在本source/内。 - Spring Security、Spring Boot、MyBatis、Quartz、Apache Velocity 官方文档（按需深挖对应机制）。
本学习文档基于 source/RuoYi-Vue-springboot3 源码分析生成，非官方文档。