# ReactAdmin

**Repository Path**: lambcc/ReactAdmin

## Basic Information

- **Project Name**: ReactAdmin
- **Description**: 最新版本React后台管理系统，后端使用JDK21 + SpringBoot3.2.0；前端使用NodeJS v22.17.0 + React 19 + Ant Design React 5.x；支持MySQL，PostgreSQL，SQL Server，Oracle等多种数据库
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-01-12
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: jdk21, React19, antdesign5, React后台管理系统, SpringBoot3

## README

# 挑战全网最简单功能最全最好学的RBAC管理系统!

### 项目概述

**ReactAdmin** 是一套基于 RBAC 模型的后台管理脚手架。

做这个项目的初衷很简单：市面上大多数后台管理系统要么太重，依赖一堆复杂组件，上手门槛高；要么太轻，只搭了个壳子，离实际开发还有一段距离。我希望能做一个介于两者之间的东西——功能完整，但结构足够清晰，代码也足够干净。

整个系统只有 7 张表，但用户管理、角色权限、菜单配置、操作日志、文件管理、数据字典这些后台必备的能力全都包含在内。你可以把它当成一个“刚刚好”的起点，无论是拿来直接做项目，还是作为学习 RBAC 和 Spring Boot + React 全家桶的示例，都挺合适。

登录账号：admin / admin123

这套东西，能帮你省掉多少重复劳动？
如果你接过后台管理系统的需求，一定对这几件事不陌生：

用户、角色、菜单，这三张表怎么设计才能灵活又清晰？

文件到底存本地、MinIO 还是云厂商？能不能别一换方案就改代码？

缓存用 Redis 还是本地 Caffeine，能不能配置一把就切？

这些事，ReactAdmin 都替你考虑完了。不玩虚的，每一行代码都经得起推敲，也经得起业务场景的折腾。

### 技术栈

#### 后端技术栈
- **编程语言**: Java 21
- **框架**: Spring Boot 3.2.0
- **持久层**: MyBatis-Plus 3.5.15
- **安全认证**: Sa-Token 1.40.0
- **数据库连接池**: Druid 1.2.20
- **文档工具**: Knife4j 4.4.0
- **后端仓库**: [ReactAdmin](https://github.com/AxisLamb/ReactAdmin)

#### 前端技术栈
- **运行环境**: Node.js 22.17.0
- **React版本**: 19.x
- **构建工具**: Vite 7.x
- **UI框架**: Ant Design React 5.x
- **前端仓库**: [ReactAdminFront](https://github.com/AxisLamb/ReactAdminFront)

## 后端启动方法
如果没有数据库需要预先安装数据库。执行命令：
```bash
mvn clean install
```
参考下面的`数据库配置示例`，`文件存储配置示例`，`缓存配置示例` 修改配置文件 `application-dev.yml`，并启动项目。

## 前端启动方法
To start the frontend application, simply run these two commands:
```bash
npm install
npm run dev
```

## 核心特性

### 1. 多数据库支持

项目支持多种主流数据库，可根据实际需求灵活切换：

#### 已集成数据库驱动
- **MySQL**
- **SQL Server**
- **PostgreSQL**
- **Oracle**

#### 数据库配置示例
```yaml
spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    druid:
      # SQL Server 配置示例，可以按需改成MySQL，Oracle，PostgreSQL数据库等
      driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver
      url: jdbc:sqlserver://localhost:1433;DatabaseName=test;encrypt=false
      username: sa
      password: admin123
```


### 2. 多文件存储系统

项目支持多种文件存储方案，满足不同部署环境的需求：

#### 支持的存储方式
- **本地存储**: 直接保存到服务器本地文件系统
- **MinIO**: 分布式对象存储解决方案
- **阿里云OSS**: 阿里云对象存储服务
- **华为云OBS**: 华为云对象存储服务（已集成但未启用）
- **七牛云**: 七牛云对象存储服务（已集成但未启用）

#### 文件存储配置示例
```yaml
os:
  file:
    type: MINIO # 支持 LOCAL, MINIO, ALIYUN 等
    local:
      base-path: ./uploads # 本地存储路径
    
    minio:
      endpoint: http://localhost:9000
      access-key: admin
      secret-key: password
    
    aliyun:
      endpoint: your-endpoint
      access-key-id: your-access-key-id
      access-key-secret: your-access-key-secret
```


### 3. 多缓存策略

项目支持多种缓存实现，提升系统性能：

#### 缓存选项
- **Redis**: 分布式缓存，支持集群部署
- **本地缓存**: 基于 Caffeine 的高性能本地缓存

#### 缓存配置示例
```yaml
os:
  cache:
    type: REDIS  # 支持 LOCAL, REDIS
    redis:
      # ip: 10.10.10.181
      ip: localhost
      port: 6379
      password: '123456'
      database: 0
```


## 项目架构

### 核心功能模块
- **用户管理**: 用户账号、个人信息管理
- **角色管理**: 权限分配与角色管理
- **菜单管理**: 动态菜单配置
- **系统日志**: 操作审计日志
- **数据字典**: 系统参数配置
- **文件管理**: 多存储后端文件管理

### 安全机制
- **权限控制**: 基于 RBAC 模型的细粒度权限控制
- **身份认证**: Sa-Token 实现的会话管理和认证
- **审计日志**: 完整的操作记录和审计追踪

## 部署配置

### 环境配置
项目支持多环境配置（开发、测试、生产），通过 Maven Profile 管理：

- **dev**: 开发环境
- **test**: 测试环境
- **prod**: 生产环境

### 数据源配置
支持多数据源动态切换，可在配置文件中灵活调整数据库连接参数。

## 适用场景

### 企业级应用
- 中大型企业管理系统的后台支撑
- 需要复杂权限控制的业务系统
- 对数据安全和审计有要求的应用

### 技术优势
- **高扩展性**: 插件化的存储和缓存系统
- **多环境适配**: 一套代码适应不同部署环境
- **开箱即用**: 完整的权限管理和基础功能模块
- **技术前沿**: 采用最新的 Java 21 和 Spring Boot 3.2.0

### 总结

如果要用一句话概括 ReactAdmin，那就是：**该有的都有，不该有的绝不乱加。**

它不像一些重型框架那样让你花大量时间理解它的约定和插件机制，也不像简单的 demo 那样只能看看不能实战。我们在设计时最看重两件事：一是**核心功能要完整**，权限、日志、存储、缓存这些企业级必备的能力都要覆盖；二是**扩展要简单**，数据库可以从 MySQL 切到 PostgreSQL，文件存储可以从本地换成 MinIO 或阿里云，缓存可以从本地切到 Redis，改几行配置就能搞定。

这套简单的RBAC系统目前还在开发中，不敢说完美，但胜在实在。欢迎提 Issue 或一起贡献代码，让这个项目对更多人有用。