RuoYi-Vue-Plus 多租户权限管理系统技术文档
项目地址: https://gitcode.com/dromara/RuoYi-Vue-Plus 一、安装指南
环境要求
- JDK 17/21
- Spring Boot 3.4
- Redis 5-7
- MySQL/Oracle/PostgreSQL/SQLServer
- Maven 3.6+
后端安装
- 克隆项目仓库：
git clone https://gitee.com/dromara/RuoYi-Vue-Plus.git
-
导入IDE（推荐IntelliJ IDEA）
-
配置数据库：
- 创建数据库并执行初始化SQL脚本
- 修改
application.yml中的数据库连接信息
- 配置Redis：
- 修改
application.yml中的Redis连接信息
- 启动项目：
mvn clean install
java -jar ruoyi-admin.jar
前端安装
- 克隆前端项目：
git clone https://gitee.com/JavaLionLi/plus-ui.git
- 安装依赖：
npm install
- 配置API地址：
- 修改
.env文件中的VITE_API_URL
- 启动项目：
npm run dev
二、使用说明
系统功能
- 多租户管理
- 权限控制（基于Sa-Token）
- 数据权限控制
- 分布式任务调度
- 文件存储（Minio）
- 接口文档（SpringDoc）
登录系统
- 默认管理员账号：admin/admin123
- 监控中心账号：ruoyi/123456
三、API使用文档
1. 权限认证API
// 登录校验
@SaCheckLogin
// 角色校验（AND条件）
@SaCheckRole({"admin", "manager"})
// 权限校验（OR条件）
@SaCheckPermission(value = {"user:add", "user:edit"}, mode = SaMode.OR)
// 二级认证
@SaCheckSafe
2. 缓存API
// 自动缓存（带过期时间）
@Cacheable(value = "user_cache", key = "#userId", ttl = 60)
public User getUserById(Long userId) {
return userMapper.selectById(userId);
}
3. 数据权限API
// Mapper接口添加数据权限注解
@DataScope(
deptAlias = "d",
userAlias = "u",
permission = "system:user:list"
)
List<User> selectUserList(User user);
四、项目安装方式
1. 标准安装
- 按照上述安装指南步骤进行
2. Docker安装
# 后端服务
docker run -d --name ruoyi \
-p 8080:8080 \
-e SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/ruoyi \
dromara/ruoyi-vue-plus:latest
# 前端服务
docker run -d --name ruoyi-ui \
-p 80:80 \
-e API_URL=http://backend:8080 \
dromara/plus-ui:latest
3. 多租户模式配置
在application.yml中配置：
plus:
tenant:
enable: true
ignore-tables: sys_user,sys_dept
column: tenant_id
4. 工作流集成
- 安装流程引擎依赖
- 配置流程数据源
- 启动流程设计器模块
注意：本文档基于RuoYi-Vue-Plus 5.4.1版本编写，如需了解更多细节请参考官方文档。系统演示地址可在文档顶部查看。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
