LE\le c4270c69e5 Initial commit hai 1 mes
..
src c4270c69e5 Initial commit hai 1 mes
.gitignore c4270c69e5 Initial commit hai 1 mes
README.md c4270c69e5 Initial commit hai 1 mes
pom.xml c4270c69e5 Initial commit hai 1 mes

README.md

教育游戏 - 后端服务

项目简介

这是教育游戏系统的后端服务,基于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. 创建数据库:
CREATE DATABASE edu_game DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  1. 修改配置文件 src/main/resources/application.yml 中的数据库连接信息

启动服务

mvn spring-boot:run

服务默认端口: 8080

配置说明

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

数据库配置

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

服务端口

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

构建部署

构建

mvn clean package

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

运行

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