# spring-boot-admin

**Repository Path**: sclx/spring-boot-admin

## Basic Information

- **Project Name**: spring-boot-admin
- **Description**: 我的第一个AI编码工程
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-02
- **Last Updated**: 2026-01-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Spring Boot Admin 后台管理系统

## 项目介绍
这是一个基于Spring Boot + Vue3的前后端分离的后台管理系统，提供了用户管理、角色管理、菜单管理、导航管理等基础功能。

## 技术栈
### 后端技术栈
- Spring Boot 2.3.9.RELEASE
- MyBatis-Plus 3.4.2
- MySQL 数据库
- JWT 认证
- Lombok
- Logback 日志

### 前端技术栈
- Vue 3
- Element Plus
- Vue Router
- Pinia
- Vite

## 功能模块
1. 用户管理
   - 用户列表查询
   - 新增/编辑用户
   - 删除用户
   - 重置密码
   
2. 角色管理
   - 角色列表查询
   - 新增/编辑角色
   - 删除角色
   - 角色权限配置
   - 角色用户管理

3. 菜单管理
   - 菜单树形展示
   - 新增/编辑菜单
   - 删除菜单
   
4. 导航管理
   - 导航分组管理
   - 导航链接管理

5. 系统功能
   - 登录/注册
   - 验证码
   - JWT token认证
   - 统一异常处理
   - 统一返回格式

## 项目结构
spring-boot-admin
├── src/main/java/com/example/admin
│ ├── common // 公共模块
│ │ ├── exception // 异常处理
│ │ ├── result // 统一返回
│ │ └── util // 工具类
│ ├── config // 配置类
│ ├── controller // 控制器
│ ├── entity // 实体类
│ ├── mapper // MyBatis接口
│ ├── model // 数据传输对象
│ │ ├── dto // 请求对象
│ │ └── vo // 响应对象
│ └── service // 业务逻辑
├── resources
│ ├── application.yml // 主配置文件
│ ├── application-dev.yml // 开发环境配置
│ ├── application-prod.yml // 生产环境配置
│ └── db // 数据库脚本
├── pom.xml // Maven配置
└── README.md // 项目说明

### 后端启动
1. 创建数据库并执行`db/DDL.sql`脚本
2. 修改`application-dev.yml`中的数据库配置
3. 运行`AdminApplication.java`

### 前端启动
1. 进入vue-admin目录
2. 安装依赖：`npm install`
3. 启动开发服务器：`npm run dev`

## 接口规范
- 分页查询统一使用POST方式
- 根据ID查询和删除统一使用GET方式
- 所有接口返回统一格式的JSON数据

## 开发规范
1. 代码格式化遵循阿里巴巴Java开发规范
2. 接口命名规范：
   - 查询：get/list
   - 新增：add/create
   - 修改：update
   - 删除：delete
3. 异常处理统一使用BusinessException
4. 返回结果统一使用R类封装

## 部署说明
1. 修改`application-prod.yml`中的生产环境配置
2. 打包：`mvn clean package`
3. 运行：`java -jar target/spring-boot-admin-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod`

## 许可证
Apache License 2.0