若依搭建若依版本官方若依官方针对不同开发需求提供了多个版本的框架，每个版本都有其独特的特点和适用场景：
前后端混合版本：RuoYi结合了SpringBoot和Bootstrap的前端开发框架，适合快速构建传统的Web应用程序，其中前端和后端代码在同一项目中协同工作。
前后端分离版本：RuoYi-Vue利用SpringBoot作为后端开发框架，与Vue.js结合，实现了前后端分离的开发模式。这种架构有助于提高开发效率，前后端可以独立开发和部署，更适合现代化的Web应用开发。
微服务版本：RuoYi-Cloud基于Spring Cloud & Alibaba微服务架构，为构建大型分布式系统提供了完整的解决方案。它支持服务发现、配置管理、负载均衡等微服务特性，适合需要高可扩展性和高可用性的企业级应用。
移动端版本：RuoYi-App采用Uniapp进行开发，结合了Vue.js的优势，可以实现跨平台的移动端应用开发。一次编写，多端运行的能力使得它成为开发iOS和Android应用的理想选择。
这些版本的框架为开发者提供了多样化的选择，无论是传统的Web应用、现代化的前后端分离应用，还是复杂的微服务架构和跨平台的移动端应用，都能找到合适的若依框架版本来满足开发需求。
非官方若依框架因其强大的功能和灵活性，吸引了众多第三方开发者基于其核心架构进行扩展和优化，从而形成了丰富的生态系统。
这些扩展不仅增强了若依框架的功能性，也满足了开发者在不同场景下的具体需求。例如：
RuoYi-Vue3（前端升级Vue3 Element Plus Vite）
https://github.com/yangzongzhuan/RuoYi-Vue3
RuoYi-Vue-Plus（后端集成Mybatis-Plus、Hutool、OSS存储、分布式锁等组件）
https://gitee.com/dromara/RuoYi-Vue-Plus
这些扩展版本的推出，使得若依框架能够更好地适应不同规模和类型的项目需求，从小型快速开发到大型企业级应用，都能提供相应的解决方案。开发者可以根据自己的具体需求选择合适的版本进行开发。
RuoYi-VuelRuoYi-Vue版本，采用了前后端分离的单体架构设计：
软件环境：JDK、MySQL 、Redis 、Maven、Node
技术选型：Spring Boot、Spring Security、MyBatis、Jwt、Vue3、Element-Plus
官方地址：https://gitee.com/y_project/RuoYi-Vue
扩展地址：https://gitee.com/ys-gitee/RuoYi-Vue3
官方推荐
课程版本
JDK >= 1.8
JDK 11
Mysql >= 5.7.0
MySQL 8
Redis >= 3.0
Redis 5（Win）
Maven >= 3.0
Maven 3.6
Node >= 12
Node 16（Vue3）
为了确保教学活动的顺利进行，建议所有学生在开始前安装并配置好这些软件的版本。
如果学生在安装或配置过程中遇到问题，可以联系播妞获取帮助，播妞将提供详细的安装文档和安装包，
运行后端项目初始化项目Git下载通过idea克隆若依源码，仓库地址：https://gitee.com/y_project/RuoYi-Vue.git
Maven构建使用idea打开项目后，等待环境检查（主要是Maven下载项目依赖）
MySQL相关导入sql1、创建数据库create schema ry-vue;
2、执行下图的sql脚本文件，完成导入
3、导入后ry-vue库内置30张表
配置信息在ruoyi-admin模块下，编辑resources目录下的application-druid.yml，修改数据库连接
1234567891011# 数据源配置spring: datasource: type: com.alibaba.druid.pool.DruidDataSource driverClassName: com.mysql.cj.jdbc.Driver druid: # 主库数据源 master: url: 数据库地址 username: 数据库账号 password: 数据库密码
Redis相关启动在redis解压目录下，执行redis-server.exe redis.windows.conf启动
配置信息在ruoyi-admin模块下，resources目录下的application.yml，可以设置redis密码等相关信息
项目运行在ruoyi-admin模块下，运行com.ruoyi.RuoYiApplication.java，出现如下图表示启动成功
后端运行成功可以通过([http://localhost:8080 )访问，但是不会出现静态页面，可以继续参考下面步骤部署前端，然后通过前端地址来访问。
运行前端项目初始化项目进入开发目录下，使用vscode命令code打开项目
12345# 克隆vue3项目git clone https://gitee.com/ys-gitee/RuoYi-Vue3.git# 通过vscode打开项目code ./RuoYi-Vue3
项目运行在vscode终端中输入以下命令：
12345678# 安装依赖npm install# 建议不要直接使用 cnpm 安装依赖，会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题npm install --registry=https://registry.npmmirror.com# 启动服务npm run dev
打开浏览器，输入：([http://localhost:80) 默认账户/密码 admin/admin123）若能正确展示登录页面，并能成功登录，菜单及页面展示正常，则表明环境搭建成功
入门案例在若依项目成功搭建之后，深入了解其代码生成器功能是掌握框架的重要一环。
接下来，我们将利用若依框架的代码生成器实现CRM系统中的课程管理功能，这将使我们能够实际体验并掌握如何在项目中有效使用这一工具。
功能需求
实现CRM系统中的课程管理功能，涵盖增加、删除、修改和查询课程信息的完整前后端代码。
原型地址：https://app.mockplus.cn/run/prototype/_lwaPYSV9Ue6/byFT7QUzmCqJ/2AadzZnerRIDo?cps=collapse&isShare=true
步骤分析1、准备课程表结构和数据sql文件，导入到数据库中
2、登录系统（系统工具 -> 代码生成 -> 导入课程表）
3、代码生成列表中找到课程表（可预览、编辑、同步、删除生成配置）
4、点击生成代码会得到一个ruoyi.zip
5、执行sql文件导入菜单，按照包内目录结构复制到自己的项目中即可
代码生成提供课程表准备课程表结构和数据sql文件，导入到数据库中
系统导入登录系统（系统工具 -> 代码生成 -> 导入课程表）
配置代码代码生成列表中找到课程表（可预览、编辑、同步、删除生成配置）
点击生成点击生成代码，得到一个ruoyi.zip
解压后得到：后端代码、前端代码、菜单sql
代码导入导入课程菜单执行sql脚本，导入菜单数据
导入后端代码将生成的后端代码和mappep文件，导入ruoyi-admin模块中
注意：如果导入后的代码重启后没生效，可以通过maven先clean再启动
导入前端代码将生成的前端代码，导入ruoyi-ui模块中
访问测试代码生成器默认生成的课程管理模块在系统工具菜单下，打开测试CRUD功能
功能详解我们将对若依的通用功能进行详解。本章内容分为三个重点部分：
系统管理权限系统演示若依提供了企业级通用权限系统，我们这里拿CRM系统先给大家演示下：
地址：https://huike-crm.itheima.net/
demo账号（超级管理员），可以查看所有功能菜单
zhangsan账号（市场专员），可以查看线索管理菜单
yueyue账号（销售专员），可以查看商机、合同等菜单
RBAClRBAC（基于角色的访问控制）是一种广泛使用的访问控制模型，通过角色来分配和管理用户的菜单权限。
表关系
案例创建新用户小智并关联课研人员角色，仅限课程管理和统计分析菜单访问。
实现步骤：
①创建菜单
②创建角色，并分配权限
③创建用户，并关联角色
数据字典介绍若依内置的数据字典，用于维护系统中常见的静态数据。例如：性别、状态…
功能包括：字典类型管理、字典数据管理
表关系
案例将课程管理的学科字段改为数据字典维护。
实现步骤：
①添加字典类型和数据
②修改代码生成信息
③下载代码，导入前端
参数设置参数设置：对系统中的参数进行动态维护。
关闭登录验证码
通知公告RuoYi的通知公告功能提供了一个方便的方式来发布和管理通知、公告和新闻等信息。管理员可以创建、编辑和删除通知（支持富文本编辑和附件上传）。
系统将信息发送给指定的用户、部门或角色。用户可以通过系统界面或电子邮件接收通知，从而确保信息及时传达（这部分需要自己开发）。
通知公告功能有助于组织内部沟通和信息传递，提高了工作效率和信息共享。
日志管理登录日志
记录用户的登录信息，包括登录时间和地点（IP地址）。
帮助管理员监控登录行为，及时发现任何可疑的登录尝试。
同样提供搜索和筛选功能，方便查找特定用户的登录历史。
操作日志
记录用户在系统中的所有操作，如查看、修改数据等。
帮助管理员检查谁做了什么，以及何时做的，确保数据准确无误。
可以快速搜索和找到特定的操作记录，便于管理和审查。
系统监控监控相关若依提供了一些列强大的监控工具，能够帮助开发者和运维快速了解应用程序的性能状态。
在线用户：
管理员可以看到当前谁在系统里，他们什么时候登录的，从哪里登录的，属于哪个部门。
如果有人没权限还赖着不走，管理员可以一键让他们下线，保证系统的安全。
数据监控：
管理员可以实时看到系统的各项指标，比如资源使用情况，数据库状态等。
通过图表可以直观地看出系统是否健康，如果出现问题，系统会发出警报。
服务监控：
管理员可以监控系统中各个服务是否正常运行，以及它们的性能指标。
如果服务出现问题，系统会立即通知管理员，并通过仪表板展示，方便管理员快速了解情况。
缓存监控：
管理员可以监控系统的缓存使用情况，比如缓存是否经常被用到，缓存的大小等。
系统还可以自动清理缓存，保持数据的新鲜度，如果缓存有问题，也会发出警报。
定时任务介绍若依为定时任务功能提供方便友好的web界面，实现动态管理任务。
案例每间隔5秒，控制台输出系统时间。
实现步骤：
①创建任务类
②添加任务规则
任务名称：自定义，如：定时查询任务状态
任务分组：根据字典sys_job_group配置，可自行进行配置
调用目标字符串：设置后台任务方法名称参数
执行表达式：可查询官方cron表达式介绍
执行策略：定时任务自定义执行策略
并发执行：是否需要多个任务间同时执行
③启动任务
系统工具表单构建介绍
允许用户通过拖放等可视化操作创建表单，比如用来收集数据的表格或调查问卷。
可以自定义表单的各个部分，比如添加不同的输入项和设置验证规则，无需编写代码。
提供了导出数据、导入数据、分享表单和设置权限的功能，方便数据管理和共享。
案例通过表单构建工具，单独制作一个添加课程的表单页面。
实现步骤：
①制作表单并导出
②复制到前端工程
③创建动态菜单
代码生成
自动化工具，可以快速生成项目中常用的代码，如数据库操作类、后端控制器、前端页面等。
支持根据数据库的表结构反向生成代码，减少手动编写的工作量。
提供三种生成模板：单表、 树表、主子表（一对多），可以生成适用于Spring Boot、MyBatis等流行框架的代码，提高开发效率和代码质量。
树表是一种展示层级数据的表格，能展开折叠，清晰呈现父子关系，便于管理。
代码生成配置主表实现细节：
系统接口
Swagger，能够自动生成 API 的同步在线文档，并提供Web界面进行接口调用和测试。
项目结构在功能的讲解过程中，涉及的前后端项目的结构和配置文件，我们还比较陌生，为了更好的使用若依进行项目开发，所以接下来，我们开始进入项目结构这部分内容的学习
后端结构12345678910111213141516171819202122232425262728com.ruoyi├── ruoyi-admin // 后台服务模块│ └── web // 内置功能的表现层│ └── RuoYiApplication // 若依项目启动类 ├── ruoyi-common // 通用工具模块│ └── annotation // 自定义注解│ └── config // 全局配置│ └── constant // 通用常量│ └── core // 核心控制│ └── enums // 通用枚举│ └── exception // 通用异常│ └── filter // 过滤器处理│ └── utils // 通用类处理│ └── xss // 自定义xss校验├── ruoyi-framework // 框架核心模块│ └── aspectj // AOP配置│ └── config // 系统配置│ └── datasource // 多数据源配置 │ └── interceptor // 拦截器│ └── manager // 异步处理│ └── security // 权限控制│ └── web // 前端控制├── ruoyi-generator // 代码生成模块（可移除） ├── ruoyi-quartz // 定时任务模块（可移除） ├── ruoyi-system // 系统代码模块│ └── domain // 系统代码的实体类│ └── mapper // 系统代码的持久层│ └── service // 系统代码的业务层
项目中配置项目中的配置文件都在ruoyi-admin模块下，如下图：
i18n：国际化处理
META-INF：存储了项目的元信息（描述数据的数据），无需修改
mybatis：mybatis相关的配置信息
application.yml：项目中的核心配置
application-druid.yml：数据库连接配置
banner.txt：默认的banner图标信息，项目启动，控制台打印显示
logback.xml：日志配置
最主要的两个配置文件：application.yml
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129# 项目相关配置ruoyi: # 名称 name: RuoYi # 版本 version: 3.8.7 # 版权年份 copyrightYear: 2024 # 文件路径 示例（ Windows配置D:/ruoyi/uploadPath，Linux配置 /home/ruoyi/uploadPath） profile: D:/ruoyi/uploadPath # 获取ip地址开关 addressEnabled: false # 验证码类型 math 数字计算 char 字符验证 captchaType: math# 开发环境配置server: # 服务器的HTTP端口，默认为8080 port: 8080 servlet: # 应用的访问路径 context-path: / tomcat: # tomcat的URI编码 uri-encoding: UTF-8 # 连接数满后的排队数，默认为100 accept-count: 1000 threads: # tomcat最大线程数，默认为200 max: 800 # Tomcat启动初始化的线程数，默认值10 min-spare: 100# 日志配置logging: level: com.ruoyi: debug org.springframework: warn# 用户配置user: password: # 密码最大错误次数 maxRetryCount: 5 # 密码锁定时间（默认10分钟） lockTime: 10# Spring配置spring: # 资源信息 messages: # 国际化资源文件路径 basename: i18n/messages profiles: active: druid # 文件上传 servlet: multipart: # 单个文件大小 max-file-size: 10MB # 设置总上传的文件大小 max-request-size: 20MB # 服务模块 devtools: restart: # 热部署开关 enabled: true # redis 配置 redis: # 地址 host: localhost # 端口，默认为6379 port: 6379 # 数据库索引 database: 0 # 密码 password: 123456 # 连接超时时间 timeout: 10s lettuce: pool: # 连接池中的最小空闲连接 min-idle: 0 # 连接池中的最大空闲连接 max-idle: 8 # 连接池的最大数据库连接数 max-active: 8 # #连接池最大阻塞等待时间（使用负值表示没有限制） max-wait: -1ms# token配置token: # 令牌自定义标识 header: Authorization # 令牌密钥 secret: abcdefghijklmnopqrstuvwxyz # 令牌有效期（默认30分钟） expireTime: 30# MyBatis配置mybatis: # 搜索指定包别名 typeAliasesPackage: com.ruoyi.**.domain # 配置mapper的扫描，找到所有的mapper.xml映射文件 mapperLocations: classpath*:mapper/**/*Mapper.xml # 加载全局的配置文件 configLocation: classpath:mybatis/mybatis-config.xml# PageHelper分页插件pagehelper: helperDialect: mysql supportMethodsArguments: true params: count=countSql# Swagger配置swagger: # 是否开启swagger enabled: true # 请求前缀 pathMapping: /dev-api# 防止XSS攻击xss: # 过滤开关 enabled: true # 排除链接（多个用逗号分隔） excludes: /system/notice # 匹配链接 urlPatterns: /system/*,/monitor/*,/tool/*
模块依赖关系各个模块之间的依赖关系：
前端结构1234567891011121314151617181920212223242526272829ruoyi-vue3├── bin // 执行脚本├── html // IE低版本提示页├── node_modules // 第三方依赖库├── public // 公共资源│ ├── favicon.ico // favicon图标├── src // 源代码│ ├── api // 所有请求│ ├── assets // 静态资源│ ├── components // 全局公用组件│ ├── directive // 全局指令│ ├── layout // 布局│ ├── plugins // 通用插件│ ├── router // 路由配置│ ├── store // 状态管理│ ├── utils // 全局公用方法│ ├── views // 视图组件│ ├── App.vue // 入口组件│ ├── main.js // 入口文件│ ├── permission.js // 权限管理│ └── settings.js // 系统配置├── vite // 构建工具├── .env.development // 开发环境配置├── .env.production // 生产环境配置├── .env.staging // 测试环境配置├── .gitignore // git 忽略项├── index.html // 入口页面├── package.json // 项目配置文件（相当于pom.xml）└── vue.config.js // Vue项目的配置信息（相当于application.yml）
表结构介绍ruoyi-vue数据库设计包含了多个表结构，用于支持系统的各种功能模块。
这些表可以根据它们的功能和用途进行分类，以便在后期使用时能够快速定位和理解。以下是对这些表结构的分类和简要说明：
源码阅读本章我们将围绕入门案例生成的课程管理进行讲解，包含前后端代码的分析，以及前后端代码交互的流程，通过这部分的学习，不仅能让我们掌握若依的基础业务逻辑，在此基础上还能为我们日后的定制开发提供强有力的支撑。
前端代码分析找到src/views/course/course/index.vue文件，护理项目的前端代码已经添加了详细的注释，如下：
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339
后端代码分析CourseControllerruoyi-admin模块下找到这个类：com.ruoyi.web.controller.course.CourseController里面有5个对应的方法接口，详细代码如下：
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100package com.sky.course.controller;import com.sky.common.annotation.Log;import com.sky.common.core.controller.BaseController;import com.sky.common.core.domain.AjaxResult;import com.sky.common.core.page.TableDataInfo;import com.sky.common.enums.BusinessType;import com.sky.common.utils.poi.ExcelUtil;import com.sky.course.domain.Course;import com.sky.course.service.ICourseService;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.security.access.prepost.PreAuthorize;import org.springframework.web.bind.annotation.*;import javax.servlet.http.HttpServletResponse;import java.util.List;/** * 课程管理Controller * * @author itheima */@RestController@RequestMapping("/course/course")public class CourseController extends BaseController{ @Autowired private ICourseService courseService; /** * 查询课程管理列表 */ @PreAuthorize("@ss.hasPermi('course:course:list')") @GetMapping("/list") public TableDataInfo list(Course course) { //1. 开启分页 startPage(); //2. 查询课程列表 List
BaseControllerController继承了BaseController，其中BaseController详细定义如下图：
TableDataInfo分页查询统一返回对象：表格分页数据对象
AjaxResult增删改查统一返回对象：操作消息提醒
BaseEntity所有实体类默认继承的BaseEntity基类
权限注解@PreAuthorize 注解是 Spring Security 框架中用来做权限检查的。
它在运行方法前先验证权限，权限够就放行，不够就拦截。
权限控制流程图
前后端交互流程查询课程管理列表
接口文档
跨域在前端开发中，跨域是一个常见的问题，特别是在使用Vue框架进行开发时。跨域是指在浏览器中发送的AJAX请求的目标地址与当前页面的地址不在同一个域下，这会导致浏览器的同源策略产生限制，从而阻止了跨域请求的发送。然而，我们可以通过代理服务器来解决这个问题。
代理服务器是位于客户端和目标服务器之间的一台服务器，它接收客户端发送的请求，并将请求转发给目标服务器。通过在代理服务器上进行请求转发，可以绕过浏览器的同源策略限制，从而实现跨域请求。
在vue.config.js文件中添加以下内容：
二次开发接下来我们将利用这些知识，实现外卖管理系统的业务功能开发，本章培养的是大家如何基于若依进行二次开发的技能，所以这里我们拿其中一个菜品管理功能给同学们进行讲解
模块定制若依框架修改器若依框架修改器是一个可以一键修改RuoYi框架包名、项目名等的工具。
地址：https://gitee.com/lpf_project/RuoYi-MT/releases
资料中已提供，将项目打成压缩包，直接修改即可：
新建业务模块新建子模块在sky父工程下创建sky-merchant子模块，在pom.xml中导入核心模块依赖
版本锁定在RuoYi-Vue父工程pom.xml中进行版本锁定
添加模块依赖在ruoyi-admin模块pom.xml中添加模块依赖
菜品管理利用若依代码生成器（主子表模板），生成菜品管理的前后端代码。
代码生成①准备SQL并导入数据库
②配置代码生成信息
③下载代码并导入项目
升级改造页面组件找到src/views/merchant/dish/index.vue文件，改造菜品查询列表和口味列表，如下：
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413
图片上传组件由于之前的图片访问是本地的路径和服务，需要发起请求才能获取图片，现在我们使用了OSS，图片可直接访问，无需再次访问后端服务，所以前端的图片访问逻辑我们需要修改
修改文件位置：src/components/imageUpload/index.vue
如果图片路径是以http开头的，则不走后台服务访问，直接访问OSS，之前的不变，如下图
页面调整如果使用若依框架项目做为脚手架，那么我们肯定需要在页面显示中，符合自己公司或者项目的标识才行，需要更换的地方很多，我们依次来解决它
浏览器标签页logo标识、标题
系统页面中的logo标识、标题
去除源码地址 & 文档地址
主题风格和菜单图标
登录名称及背景图
浏览器标签页icon、标题找到资料中的logo图标，替换前端项目中的public文件夹，删除原有的favicon.ico，把新拷贝过来的logo更名为favicon.ico即可
找到根目录下的index.html文件，把title更换为自己想要的内容即可
系统页面中的logo、标题找到资料中的logo文件，替换 src/logo/logo.png文件
若依的系统页面标题引用的是开发环境的配置，我们只需要修改开发的环境的VITE_APP_TITLE属性即可
去除源码 & 文档
主题和自定义图标在目前的前端项目中，已经提供了非常便利的操作方式，可以切换主题的风格
操作：点击右上角的头像，可以找到布局设置，如下操作
在前端代码中也有对应的操作，更好主题风格文件位置：src/setting.js
更换主题颜色文件位置：src/store/modules/settings.js
访问阿里巴巴矢量图库，搜索图标：https://www.iconfont.cn/search/index?searchType=icon&q=%E8%8F%9C%E5%93%81%E7%AE%A1%E7%90%86
将下载好的图标复制到src/icons/svg目录下，就可以给指定菜单设置图标了
登录页面中标题、背景图登录名称和背景图，我们可以直接找到登录的组件进行修改即可
组件位置：src/views/login.vue