# 教育游戏 - 后端服务

## 项目简介

这是教育游戏系统的后端服务，基于Spring Boot 2.7.18构建，提供用户管理、题目管理、游戏数据存储、成就系统等核心功能。

## 技术栈

- Spring Boot 2.7.18
- Java 1.8
- MySQL 8.0+
- Maven

## 项目结构

```
edu_game_backend/
├── src/
│   └── main/
│       ├── java/com/example/edugame/
│       │   ├── controller/      # 控制器
│       │   ├── service/         # 业务逻辑
│       │   ├── repository/      # 数据访问
│       │   └── model/           # 数据模型
│       └── resources/
│           ├── application.yml  # 配置文件
│           └── db/mysql/        # 数据库脚本
└── pom.xml
```

## 快速启动

### 环境要求

- JDK 8+
- Maven 3.6+
- MySQL 8.0+

### 数据库准备

1. 创建数据库：

```sql
CREATE DATABASE edu_game DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

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

### 启动服务

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

服务默认端口: `8080`

## 配置说明

配置文件位于 `src/main/resources/application.yml`

### 数据库配置

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/edu_game
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
```

### 服务端口

```yaml
server:
  port: 8080
```

## 默认账号

系统初始化时会创建一个管理员账号：

- 用户名: `admin`
- 密码: `admin123`

## 数据库初始化

数据库脚本位于 `src/main/resources/db/mysql/`：

- `init.sql` - 完整初始化（表结构 + 初始数据）

应用启动时会自动执行初始化脚本。

## API 接口

主要接口模块：

- 认证接口 (`/api/auth/*`)
- 用户接口 (`/api/users/*`)
- 题目接口 (`/api/questions/*`)
- 游戏接口 (`/api/game/*`)
- 成就接口 (`/api/achievements/*`)
- 管理接口 (`/api/admin/*`)

详细接口文档请参考 `../docs/API.md`

## 构建部署

### 构建

```bash
mvn clean package
```

构建产物位于 `target/edu-game-backend-0.0.1-SNAPSHOT.jar`

### 运行

```bash
java -jar target/edu-game-backend-0.0.1-SNAPSHOT.jar
```