# authority-system

**Repository Path**: SnowDreamXUE/authority-system

## Basic Information

- **Project Name**: authority-system
- **Description**: 基于前后端分离的权限管理系统，包含用户管理、菜单管理、部门管理和角色管理功能。后端采用 SpringBoot 和 Spring Security 实现认证授权，前端使用 Vue2 和 Element UI 开发，Redis 缓存提升性能，MySQL 存储数据
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-09-03
- **Last Updated**: 2025-09-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 权限管理系统

这是一个基于Spring Boot的权限管理系统，实现了部门、用户、角色、权限等模块的管理功能，并集成了JWT鉴权、Redis缓存、OSS文件上传等功能。

## 功能特性

- **权限控制**：基于Spring Security和JWT的认证与鉴权机制，支持细粒度的权限控制。
- **部门管理**：支持部门的增删改查、层级结构管理。
- **用户管理**：支持用户的增删改查、角色分配、密码加密等。
- **角色管理**：支持角色的增删改查、权限分配。
- **权限管理**：支持菜单权限的增删改查，支持权限树结构。
- **文件上传**：集成阿里云OSS，支持文件上传与删除。
- **缓存管理**：使用Redis进行缓存管理，提升系统性能。
- **跨域支持**：支持前后端分离架构下的CORS跨域请求。

## 模块结构

- **Controller层**：提供RESTful API接口，包括用户、角色、权限、部门、文件上传等模块。
- **Service层**：实现业务逻辑，包括用户、角色、权限、部门等服务类。
- **DAO层**：基于MyBatis Plus的Mapper接口，实现数据库操作。
- **Entity层**：实体类，映射数据库表结构。
- **Utils工具类**：包括JWT工具、Redis工具、结果封装类、树结构构建工具等。
- **配置类**：包括Spring Security安全配置、MyBatis Plus配置、Redis配置、OSS配置等。

## 技术栈

- Spring Boot
- Spring Security
- JWT
- MyBatis Plus
- Redis
- MySQL
- OSS
- Swagger（可选）

## 安装与部署

1. **数据库准备**：导入`db_authority_system.sql`数据库文件。
2. **配置文件修改**：在`application.properties`中配置数据库连接、Redis、OSS、JWT等参数。
3. **启动项目**：运行`AuthorityApplication.java`启动Spring Boot应用。
4. **访问接口**：通过RESTful API访问系统功能，建议使用Postman或Swagger进行测试。

## 使用说明

- **用户登录**：通过`/api/sysUser/login`接口进行登录，获取JWT Token。
- **权限控制**：在Controller方法上使用`@PreAuthorize("hasAuthority('xxx')")`进行权限控制。
- **文件上传**：通过`/api/oss/file/upload`接口上传文件。
- **数据缓存**：使用Redis缓存用户信息、Token等数据。
- **跨域请求**：系统已配置CORS，支持跨域请求。

## 接口文档

建议集成Swagger UI生成API文档，便于前后端协作开发。

## 贡献指南

欢迎贡献代码，请遵循以下步骤：

1. Fork仓库。
2. 创建新分支。
3. 提交代码。
4. 创建Pull Request。

## 许可证

本项目遵循 [MIT License](https://opensource.org/licenses/MIT)。