# yun_picture_backend

**Repository Path**: rust111/yun

## Basic Information

- **Project Name**: yun_picture_backend
- **Description**: 智能协同云图库项目后端工程
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 云图 - YunPicture 用户管理系统

## 项目简介

YunPicture 是一个基于 Spring Boot + MyBatis-Plus 构建的现代化用户管理系统，提供完整的用户注册、登录、权限管理等功能。本项目采用分层架构设计，具有良好的扩展性和可维护性。

## 技术栈

- **后端框架**: Spring Boot 2.7.x
- **数据库**: MySQL
- **ORM 框架**: MyBatis-Plus
- **日志**: Lombok + SLF4J
- **工具库**: Apache Commons

## 核心功能

### 用户认证
- **用户注册**: 支持账号密码注册，密码加密存储
- **用户登录**: 登录态管理，支持 Session 机制
- **用户登出**: 安全退出登录状态
- **获取登录用户**: 查询当前登录用户信息

### 用户管理
- **用户信息查询**: 支持单个用户查询和分页列表
- **用户信息更新**: 更新用户基本信息
- **用户删除**: 逻辑删除用户
- **权限控制**: 区分普通用户和管理员角色

## 快速开始

### 环境要求
- JDK 1.8+
- MySQL 5.7+
- Maven 3.6+

### 数据库配置

1. 创建数据库
```sql
CREATE DATABASE yun_picture DEFAULT CHARACTER SET utf8mb4;
```

2. 执行初始化脚本
```sql
sql/create_table.sql
```

3. 修改配置文件 `src/main/resources/application.yml` 中的数据库连接信息

### 运行项目

```bash
mvn spring-boot:run
```

服务启动后访问 http://localhost:8080/health 检查服务状态

## API 文档

### 基础响应结构

```json
{
  "code": 0,
  "data": {},
  "message": "success"
}
```

### 用户注册
- **接口**: `POST /user/register`
- **请求体**:
```json
{
  "userAccount": "test",
  "userPassword": "123456",
  "checkPassword": "123456"
}
```

### 用户登录
- **接口**: `POST /user/login`
- **请求体**:
```json
{
  "userAccount": "test",
  "userPassword": "123456"
}
```

### 获取登录用户
- **接口**: `GET /user/get/login`
- **需要登录状态**

### 用户分页查询
- **接口**: `POST /user/list/page/vo`
- **请求体**:
```json
{
  "current": 1,
  "pageSize": 10,
  "userName": "test",
  "userRole": "user"
}
```

## 项目结构

```
src/main/java/com/itggm/yunpicture/
├── YunPictureApplication.java       # 启动类
├── config/                          # 配置类
│   └── CorsConfig.java              # 跨域配置
├── controller/                      # 控制器层
│   ├── MainController.java         # 健康检查
│   └── UserController.java          # 用户接口
├── enums/                           # 枚举类
│   ├── Errcode.java                # 错误码
│   └── UserRoleEnum.java           # 用户角色
├── exception/                       # 异常处理
│   ├── BusinessException.java      # 业务异常
│   └── GlobalExceptionHandler.java # 全局异常处理器
├── mapper/                          # 数据访问层
│   └── UserMapper.java
├── pojo/
│   ├── dto/                        # 数据传输对象
│   │   ├── user/                   # 用户相关请求
│   │   │   ├── UserAddRequest.java
│   │   │   ├── UserLoginRequest.java
│   │   │   ├── UserQueryRequest.java
│   │   │   ├── UserRegisterRequest.java
│   │   │   └── UserUpdateRequest.java
│   ├── entity/                     # 实体类
│   │   └── User.java
│   └── vo/                         # 视图对象
│       ├── LoginUserVO.java
│       └── UserVO.java
├── request/                        # 公共请求类
│   ├── DeleteRequest.java
│   └── PageRequest.java
├── response/                       # 公共响应类
│   └── BaseResponse.java
├── service/                        # 服务层
│   ├── UserService.java
│   └── impl/
│       └── UserServiceImpl.java
└── utils/                          # 工具类
    ├── ResultUtils.java
    └── ThrowUtils.java
```

## 安全特性

- 密码使用 SHA-256 + 盐值加密存储
- 登录态通过 Session 管理
- 全局异常处理，统一错误响应
- 接口权限控制

## 测试

```bash
# 运行单元测试
mvn test
```

测试用例位于 `src/test/java/com/itggm/yunpicture/service/UserServiceTest.java`

## License

本项目仅供学习交流使用。