This commit is contained in:
2026-01-20 15:37:11 +08:00
parent 4f11a7a705
commit 3359d667c6

92
README.md Normal file
View File

@@ -0,0 +1,92 @@
# Hertz 权限管理系统
Hertz 权限管理系统是一个基于 Spring Boot 3 和 Vue 3 的前后端分离架构的轻量级权限管理平台。系统集成了用户管理、角色管理、菜单管理等核心功能,采用 RBACRole-Based Access Control模型实现细粒度的权限控制。
## 🛠 技术栈
### 后端 (Backend)
- **核心框架**: Spring Boot 3.4.1
- **持久层**: MyBatis-Plus 3.5.8
- **安全认证**: Spring Security + JJWT 0.12.6 (Stateless JWT)
- **数据库**: MySQL 8.0+
- **构建工具**: Maven
- **运行环境**: JDK 21
### 前端 (Frontend)
- **核心框架**: Vue 3.5.24
- **构建工具**: Vite 7.2.4
- **UI 组件库**: Element Plus 2.13.1
- **状态管理**: Pinia 3.0.4
- **路由管理**: Vue Router 4.6.4
- **HTTP 客户端**: Axios 1.13.2
## ✨ 主要功能
- **用户管理**: 用户增删改查、角色分配、状态控制。
- **角色管理**: 角色创建与权限分配(菜单/按钮级)。
- **菜单管理**: 动态路由配置,支持目录、菜单、按钮三种类型。
- **个人中心**: 用户资料更新、密码修改。
## 🚀 快速开始
### 环境要求
- JDK 21+
- Node.js 18+
- MySQL 8.0+
### 后端启动
1. 进入后端目录:
```bash
cd hertz_springboot
```
2. 数据库配置:
- 创建数据库 `hertz_springboot`。
- 导入初始化脚本 `src/main/resources/schema.sql`。
- 修改 `src/main/resources/application.yml` 中的数据库连接配置。
3. 启动服务:
```bash
mvn spring-boot:run
```
服务默认运行在 `http://localhost:8080`。
### 前端启动
1. 进入前端目录:
```bash
cd hertz_springboot_ui
```
2. 安装依赖:
```bash
npm install
```
3. 启动开发服务:
```bash
npm run dev
```
服务默认运行在 `http://localhost:5173`。
## 👤 初始账号
| 角色 | 用户名 | 密码 | 权限 |
| :--- | :--- | :--- | :--- |
| **管理员** | `hertz` | `123456` | 拥有所有系统权限 |
| **普通用户** | `demo` | `123456` | 仅拥有基本查看权限 |
## 📂 项目结构
```text
hertz_admin_spring/
├── hertz_springboot/ # 后端工程 (Spring Boot)
├── hertz_springboot_ui/ # 前端工程 (Vue 3 + Vite)
├── 项目说明文档.md # 详细项目文档
├── 数据库说明文档.md # 数据库设计文档
└── README.md # 项目概览 (本文档)
```
## 📄 许可证
本项目采用 MIT 许可证。