# 游戏管理系统 **Repository Path**: chill109/game-management-system ## Basic Information - **Project Name**: 游戏管理系统 - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-01-18 - **Last Updated**: 2026-01-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 游戏管理系统 (Game Management System) 一个完整的全栈游戏管理平台,提供游戏浏览、分类管理、标签管理、用户游戏库管理等功能。 ## 项目简介 本项目是一个基于 Spring Boot 和 Vue 3 构建的游戏管理系统,支持用户注册登录、游戏浏览与搜索、分类管理、标签管理、用户游戏库管理等功能。系统采用前后端分离架构,支持 Docker 容器化部署。 ## 主要功能 - **用户系统**:用户注册、登录、个人信息管理 - **游戏管理**:游戏列表、热榜推荐、搜索筛选、详情查看 - **分类管理**:树形分类结构,支持多级分类 - **标签管理**:游戏标签的增删改查 - **用户游戏库**:用户可管理自己的游戏收藏、愿望单、游戏库等 - **文件上传**:支持游戏封面、用户头像等图片上传 ## 技术栈 ### 后端 - **框架**:Spring Boot 3.x - **语言**:Java 17 - **数据库**:MySQL 8.0 - **ORM**:Spring Data JPA - **安全**:Spring Security + JWT - **构建工具**:Maven ### 前端 - **框架**:Vue 3 - **语言**:TypeScript - **构建工具**:Vite - **状态管理**:Pinia - **路由**:Vue Router - **UI 样式**:CSS3 ### 部署 - **容器化**:Docker、Docker Compose - **Web 服务器**:Nginx(前端) ## 项目结构 ``` game-management-system/ ├── backend/ # Spring Boot 后端项目 │ ├── src/main/java/com/gamemanagement/ │ │ ├── config/ # 配置类(安全配置、数据初始化等) │ │ ├── common/ # 公共组件(异常处理、响应封装、JWT工具等) │ │ ├── controller/ # REST API 控制器 │ │ ├── entity/ # 实体类 │ │ ├── repository/ # 数据访问层 │ │ └── service/ # 业务逻辑层 │ ├── src/main/resources/ # 配置文件 │ └── Dockerfile # 后端 Docker 构建文件 ├── frontend/ # Vue 3 前端项目 │ ├── src/ │ │ ├── api/ # API 接口封装 │ │ ├── components/ # 公共组件 │ │ ├── router/ # 路由配置 │ │ ├── store/ # Pinia 状态管理 │ │ ├── views/ # 页面视图 │ │ └── types/ # TypeScript 类型定义 │ ├── public/ # 静态资源 │ └── Dockerfile # 前端 Docker 构建文件 ├── docker-compose.yml # Docker Compose 配置 ├── database.sql # 数据库初始化脚本 └── game.sql # 游戏数据脚本 ``` ## 快速开始 ### 环境要求 - JDK 17+ - Node.js 18+ - MySQL 8.0 - Maven 3.9+ ### 数据库配置 1. 创建数据库: ```sql CREATE DATABASE game_management DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ``` 2. 执行初始化脚本: ```bash mysql -u root -p game_management < database.sql mysql -u root -p game_management < game.sql ``` ### 后端配置 修改 `backend/src/main/resources/application.yml` 中的数据库连接配置: ```yaml spring: datasource: url: jdbc:mysql://localhost:3306/game_management?useSSL=false&serverTimezone=Asia/Shanghai username: your_username password: your_password ``` 启动后端服务: ```bash cd backend mvn spring-boot:run ``` 后端服务默认运行在 `http://localhost:8080` ### 前端配置 安装依赖并启动开发服务器: ```bash cd frontend npm install npm run dev ``` 前端服务默认运行在 `http://localhost:5173` ### Docker 部署 使用 Docker Compose 一键部署: ```bash docker-compose up -d ``` ## API 接口文档 ### 认证接口 | 接口 | 方法 | 说明 | |------|------|------| | `/auth/register` | POST | 用户注册 | | `/auth/login` | POST | 用户登录 | | `/auth/me` | GET | 获取当前用户信息 | ### 游戏接口 | 接口 | 方法 | 说明 | |------|------|------| | `/games` | GET | 获取游戏列表(分页) | | `/games/hot` | GET | 获取热门游戏 | | `/games/search` | GET | 搜索游戏(支持分类、标签、价格筛选) | | `/games/{id}` | GET | 获取游戏详情 | | `/games` | POST | 添加游戏(需登录) | | `/games/{id}` | PUT | 更新游戏 | | `/games/{id}` | DELETE | 删除游戏 | ### 分类接口 | 接口 | 方法 | 说明 | |------|------|------| | `/categories` | GET | 获取所有分类 | | `/categories/tree` | GET | 获取分类树结构 | | `/categories/child/{parentId}` | GET | 获取子分类 | | `/categories` | POST | 添加分类 | | `/categories/{id}` | PUT | 更新分类 | | `/categories/{id}` | DELETE | 删除分类 | ### 标签接口 | 接口 | 方法 | 说明 | |------|------|------| | `/tags` | GET | 获取所有标签 | | `/tags` | POST | 添加标签 | | `/tags/{id}` | PUT | 更新标签 | | `/tags/{id}` | DELETE | 删除标签 | ### 用户游戏库接口 | 接口 | 方法 | 说明 | |------|------|------| | `/list/user/{userId}` | GET | 获取用户的游戏列表 | | `/list/add` | POST | 添加游戏到列表 | | `/list/{id}` | PUT | 更新游戏库记录 | | `/list/{id}` | DELETE | 从列表移除游戏 | | `/list/stats/{userId}` | GET | 获取用户游戏统计 | | `/list/batch/add` | POST | 批量添加游戏 | | `/list/switch` | POST | 切换游戏列表类型 | ### 文件上传接口 | 接口 | 方法 | 说明 | |------|------|------| | `/upload/game-cover` | POST | 上传游戏封面 | | `/upload/user-avatar` | POST | 上传用户头像 | | `/upload/other` | POST | 上传其他图片 | | `/upload/images/**` | GET | 获取上传的图片 | ## License 本项目基于 MIT License 开源。