# fly_codex

**Repository Path**: raibinn/fly_codex

## Basic Information

- **Project Name**: fly_codex
- **Description**: 完全使用Codex开发的项目
前后端分离
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-03-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 游戏中心

一个基于 `React + Vite + TypeScript` 与 `Spring Boot 2.7 + Java 8` 的 Web 游戏门户项目，提供账号体系、游戏发现、内置小游戏、积分排行榜、个人战绩、双语展示与管理员游戏管理能力。

## 项目特性

- 用户注册、登录、忘记密码、修改密码
- 首页主推、游戏列表、游戏详情、收藏
- 内置小游戏：
  - 贪吃蛇
  - 俄罗斯方块
  - 音乐节拍
- 真实积分同步与排行榜展示
- 个人中心：总积分、最近游戏、最高分、头像上传
- 中英文切换
- 管理员游戏管理台（中英文内容、封面、访问链接维护）
- Redis 持久化登录会话

## 技术栈

### 前端
- React 18
- Vite 5
- TypeScript
- React Router DOM 6
- react-select
- react-datepicker

### 后端
- Spring Boot 2.7.18
- Java 8
- MyBatis Plus
- MySQL 8
- Redis
- Sa-Token
- Flyway

## 目录结构

```text
game-center/
├─ front/                 # React 客户端
├─ backend/               # Spring Boot 服务端
├─ docs/                  # 启动、部署、发布说明
├─ .kiro/steering/        # 项目级规则
├─ .kiro/specs/           # 规格文档
├─ CHANGELOG.md
└─ README.md
```

## 本地开发

### 1. 环境要求

- JDK 8
- Maven 3.8+
- Node.js 18+
- MySQL 8.x
- Redis 6.x / 7.x

### 2. 数据库与缓存

默认开发配置参考：

- MySQL: `localhost:3306/gamecenter`
- Redis: `localhost:6379`

开发环境配置文件：

- `backend/src/main/resources/application-dev.yml`

### 3. 启动后端

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

默认地址：

- API: `http://localhost:8080/api`
- Swagger: `http://localhost:8080/api/swagger-ui.html`

### 4. 启动前端

```bash
cd front
npm install
npm run dev
```

默认地址：

- Web: `http://localhost:5173`

## 构建

### 前端构建

```bash
cd front
npm run build
```

### 后端构建

```bash
cd backend
mvn clean package -DskipTests
```

## 数据迁移

项目使用 Flyway 管理数据库结构。

```bash
cd backend
mvn flyway:migrate
```

## 当前已接入的内置游戏

- `/play/snake`
- `/play/tetris`
- `/play/rhythm`

对应游戏入口由服务端 `games.website_url` 配置驱动。

## 管理员能力

管理员登录后可进入游戏管理台，维护：

- 游戏中英文标题
- 游戏中英文介绍
- 标签中英文内容
- 封面链接
- 访问链接
- 发布日期
- 游戏状态

## 文档索引

- 启动说明：`docs/STARTUP.md`
- 部署说明：`docs/DEPLOYMENT.md`
- 发布说明：`docs/RELEASE_NOTES.md`
- 更新日志：`CHANGELOG.md`
- 规格索引：`.kiro/specs/README.md`

## 快捷启动脚本

- Windows:
  - `run-backend.cmd`
  - `run-front.cmd`
- Linux:
  - `run-backend.sh`
  - `run-front.sh`

## 说明

- 当前真实客户端基线是 `React Web`，不再以 `uni-app` 作为现行实现方向。
- 当前排行榜与个人战绩基于真实用户游玩分数。
- 登录态通过 Redis 持久化，后端重启后可继续保持会话。