# demo-server-sh

**Repository Path**: shengdev/demo-server-sh

## Basic Information

- **Project Name**: demo-server-sh
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 用户权限管理系统后端项目

## 项目简介

这是一个用户权限管理系统后端项目，基于 Spring Boot 3.5.14 开发，提供用户管理和认证功能。

## 技术栈

- **Spring Boot 3.5.14**：后端框架
- **MyBatis**：数据访问框架
- **MySQL**：数据库
- **Log4j2**：日志框架
- **JWT**：认证框架

## 项目结构

```
├── src
│   ├── main
│   │   ├── java
│   │   │   └── edu
│   │   │       └── eurasia
│   │   │           └── demo
│   │   │               ├── common          # 通用工具类和异常处理
│   │   │               │   ├── dto         # 数据传输对象
│   │   │               │   └── exception   # 异常处理
│   │   │               ├── controller     # 控制器层
│   │   │               ├── mapper        # 数据访问层
│   │   │               ├── model         # 实体类和请求/响应模型
│   │   │               │   ├── entity     # 实体类
│   │   │               │   ├── request    # 请求模型
│   │   │               │   └── response   # 响应模型
│   │   │               ├── service       # 业务逻辑层
│   │   │               │   └── impl      # 业务逻辑实现
│   │   │               └── util          # 工具类
│   │   └── resources
│   │       ├── mapper        # MyBatis 映射文件
│   │       └── application.properties  # 项目配置文件
│   └── test
│       └── java
│           └── edu
│               └── eurasia
│                   └── demo
│                       ├── controller     # 控制器层单元测试
│                       ├── service       # 业务逻辑层单元测试
│                       └── util          # 工具类单元测试
└── pom.xml  # Maven 项目配置文件
```

## 核心功能

### 用户管理

- **用户注册**：提供用户注册接口，支持用户名、密码、昵称、邮箱和手机号的注册。
- **用户登录**：提供用户登录接口，支持用户名和密码的登录。
- **用户信息管理**：提供用户信息查询和更新接口。

### 管理员用户管理

- **用户列表查询**：提供管理员用户列表查询接口，支持分页和搜索。
- **用户更新**：提供管理员用户更新接口，支持用户信息的更新。
- **用户删除**：提供管理员用户删除接口，支持用户的删除。

### 认证管理

- **JWT 认证**：使用 JWT 进行用户认证，支持 token 的生成和解析。

## 配置文件

### application.properties

```properties
# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/springbootdata?serverTimezone=UTC&characterEncoding=utf-8
spring.datasource.username=root
spring.datasource.password=root

# MyBatis 配置
mybatis.mapper-locations=classpath:mapper/*.xml
mybatis.type-aliases-package=edu.eurasia.demo.model.entity
mybatis.configuration.map-underscore-to-camel-case=true

# Log4j2 配置
log4j2.configurationFile=classpath:log4j2.xml
```

### log4j2.xml

```xml
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
    <Properties>
        <Property name="log-path">logs</Property>
    </Properties>
    <Appenders>
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %C{1}.%M(%L) - %msg%n"/>
        </Console>
        <RollingFile name="RollingFile" fileName="${log-path}/app.log" filePattern="${log-path}/app-%d{yyyy-MM-dd}-%i.log.gz">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} [%t] %-5level %C{1}.%M(%L) - %msg%n"/>
            <Policies>
                <TimeBasedTriggeringPolicy interval="1" modulate="true"/>
                <SizeBasedTriggeringPolicy size="100 MB"/>
            </Policies>
            <DefaultRolloverStrategy max="10"/>
        </RollingFile>
    </Appenders>
    <Loggers>
        <Root level="info">
            <AppenderRef ref="Console" />
            <AppenderRef ref="RollingFile" />
        </Root>
    </Loggers>
</Configuration>
```

## 接口文档

### 用户注册接口

**请求地址**：`POST /user/register`

**请求参数**：

```json
{
    "username": "testuser",
    "password": "123456",
    "nickname": "测试用户",
    "email": "test@example.com",
    "phone": "13800138000"
}
```

**响应参数**：

```json
{
    "code": 200,
    "msg": "操作成功",
    "data": null
}
```

### 用户登录接口

**请求地址**：`POST /user/login`

**请求参数**：

```json
{
    "username": "testuser",
    "password": "123456"
}
```

**响应参数**：

```json
{
    "code": 200,
    "msg": "操作成功",
    "data": {
        "username": "testuser",
        "nickname": "测试用户",
        "role": "NORMAL_USER",
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
    }
}
```

### 用户信息查询接口

**请求地址**：`GET /user/info`

**请求头**：

```
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
```

**响应参数**：

```json
{
    "code": 200,
    "msg": "操作成功",
    "data": {
        "userId": 1,
        "username": "testuser",
        "nickname": "测试用户",
        "role": "NORMAL_USER",
        "status": "NORMAL"
    }
}
```

## 部署说明

### 环境要求

- Java 21
- MySQL 8.0

### 部署步骤

1. **创建数据库**：

```sql
CREATE DATABASE springbootdata;
```

2. **修改配置文件**：

修改 `application.properties` 文件中的数据库配置。

3. **启动项目**：

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

## 测试说明

### 单元测试

```bash
mvn test
```

### 集成测试

```bash
mvn verify
```

## 版本历史

- **1.0.0**：初始版本

## 作者信息

- **作者**：Eurasia
- **邮箱**：demo@example.com