|
|
||
|---|---|---|
| .opencode | ||
| bin | ||
| doc | ||
| ruoyi-admin | ||
| ruoyi-common | ||
| ruoyi-framework | ||
| ruoyi-generator | ||
| ruoyi-jd-project | ||
| ruoyi-quartz | ||
| ruoyi-system | ||
| ruoyi-ui | ||
| sql | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
| pom.xml | ||
| ry.bat | ||
| ry.sh | ||
README.md
RuoYi-Vue 若依管理系统
基于 Spring Boot 和 Vue.js 的前后端分离权限管理系统,采用 Maven 多模块组织后端代码,前端使用 Vue CLI 构建。
架构概览
本项目采用经典的前后端分离架构:后端提供 RESTful API,前端通过 Axios 调用。后端由七个 Maven 模块组成,其中 ruoyi-admin 为启动入口,依赖其他业务模块;ruoyi-framework 和 ruoyi-common 为底层支撑模块,提供安全、缓存、工具类等基础能力;ruoyi-system 为核心业务模块;ruoyi-quartz、ruoyi-generator、ruoyi-jd-project 为可选功能模块。
模块间依赖关系如下:
graph TD
A[ruoyi-admin<br/>启动入口] --> B[ruoyi-framework<br/>核心框架]
A --> C[ruoyi-system<br/>系统业务]
A --> D[ruoyi-common<br/>通用工具]
A --> E[ruoyi-quartz<br/>定时任务]
A --> F[ruoyi-generator<br/>代码生成]
A --> G[ruoyi-jd-project<br/>京东定制]
B --> D
C --> B
C --> D
E --> B
E --> D
F --> B
F --> D
G --> B
G --> D
H[ruoyi-ui<br/>前端Vue项目] -- HTTP API --> A
核心模块说明
| 模块路径 | 主要职责 |
|---|---|
ruoyi-admin/ |
Spring Boot 启动模块,包含主类、全局配置、Web入口 |
ruoyi-framework/ |
核心框架模块,提供安全认证(Spring Security + JWT)、缓存、日志、Web通用处理 |
ruoyi-system/ |
系统业务模块,包含用户、角色、菜单、部门、岗位等核心业务实体与服务 |
ruoyi-common/ |
通用工具模块,封装字符串处理、文件操作、Excel导入导出、常量定义等 |
ruoyi-quartz/ |
定时任务模块,基于 Quartz 实现任务调度与管理 |
ruoyi-generator/ |
代码生成模块,通过 Velocity 模板自动生成 Controller、Service、Mapper 等代码 |
ruoyi-jd-project/ |
京东相关定制业务模块,扩展原有系统功能 |
ruoyi-ui/ |
前端 Vue 项目,使用 Element UI 组件库,包含路由、状态管理、API 封装等 |
快速开始
环境要求
- Java 8
- Maven 3.x
- Node.js ≥ 8.9, npm ≥ 3.0.0
- MySQL 5.7+
启动步骤
- 导入数据库:执行
sql/目录下的 SQL 脚本。 - 启动后端:
服务默认运行在cd ruoyi-admin mvn spring-boot:runhttp://localhost:8080。 - 启动前端:
前端开发服务器默认运行在cd ruoyi-ui npm install npm run devhttp://localhost:80。
一键启动
Windows 环境下可直接运行根目录的 ry.bat,Linux/Mac 运行 ry.sh。
关键配置文件
| 文件路径 | 作用 |
|---|---|
ruoyi-admin/src/main/resources/application.yml |
后端主配置文件,设置端口、上下文路径、日志级别等 |
ruoyi-admin/src/main/resources/application-druid.yml |
数据库连接池(Druid)配置,包含数据源、连接池参数 |
ruoyi-ui/vue.config.js |
前端构建配置,代理设置、打包优化、插件配置等 |
注:更多配置详见各模块
src/main/resources/目录下的application-*.yml文件。