# airbox-service

**Repository Path**: bgwp/airbox-service

## Basic Information

- **Project Name**: airbox-service
- **Description**: No description available
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2018-07-27
- **Last Updated**: 2026-03-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Airbox Service

Airbox Service 是一个基于 Laravel 框架开发的后端服务系统，为游戏平台提供用户管理、游戏数据统计、社区互动等核心功能。

## 项目简介

本项目是一个完整的 RESTful API 后端服务，采用 Laravel 框架构建，支持用户认证、游戏数据管理、评论系统、排行榜等功能。适用于游戏平台、移动应用后端等服务场景。

## 技术栈

- **框架**: Laravel 5.7+
- **数据库**: MySQL
- **认证**: JWT / Laravel Passport (OAuth2)
- **前端**: Bootstrap 4.0 (管理后台)

## 功能特性

### 用户系统
- 用户注册与登录
- 用户信息管理
- 密码重置
- OAuth2 认证支持

### 游戏管理
- 游戏列表查询
- 游戏详情查看
- 游戏数据保存
- 游戏排行榜
- 游戏统计数据
- 游戏错误上报

### 社区功能
- 评论查询与发布
- 创意内容查询
- 用户反馈提交

## 目录结构

```
airbox-service/
├── app/                    # 应用核心代码
│   ├── Http/Controllers/  # 控制器
│   │   └── API/           # API 接口控制器
│   ├── Providers/         # 服务提供者
│   └── Models/            # 数据模型
├── config/                 # 配置文件
├── database/               # 数据库迁移与填充
│   ├── migrations/        # 数据表结构
│   └── seeds/             # 种子数据
├── public/                 # 公开访问资源
├── resources/              # 视图资源
├── routes/                 # 路由定义
└── tests/                  # 单元测试
```

## 快速开始

### 环境要求

- PHP >= 7.1.3
- Composer
- MySQL >= 5.7
- Laravel CLI

### 安装步骤

1. 克隆项目
```bash
git clone https://gitee.com/bgwp/airbox-service.git
cd airbox-service
```

2. 安装依赖
```bash
composer install
```

3. 配置环境
```bash
cp .env.example .env
```

4. 生成应用密钥
```bash
php artisan key:generate
```

5. 配置数据库
编辑 `.env` 文件，设置数据库连接信息：
```
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=airbox
DB_USERNAME=root
DB_PASSWORD=
```

6. 执行迁移
```bash
php artisan migrate
```

7. 启动服务
```bash
php artisan serve
```

## API 接口

### 用户接口

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | /api/register | 用户注册 |
| POST | /api/login | 用户登录 |
| GET | /api/user | 获取用户信息 |
| POST | /api/feedback | 提交反馈 |

### 游戏接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/games | 游戏列表查询 |
| GET | /api/games/{id} | 游戏详情 |
| POST | /api/games/save | 保存游戏数据 |
| GET | /api/games/records | 游戏记录 |
| GET | /api/games/rank | 游戏排行榜 |
| GET | /api/games/statistics | 游戏统计 |
| POST | /api/games/error | 错误上报 |

### 社区接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/comments | 评论列表 |
| POST | /api/comments/send | 发表评论 |
| GET | /api/creative | 创意内容 |

## 配置说明

### 认证配置

项目支持 Laravel Passport 进行 OAuth2 认证。配置信息位于 `config/auth.php`。

### 路由配置

- API 路由: `routes/api.php`
- Web 路由: `routes/web.php`
- 控制台路由: `routes/console.php`

## 扩展包

项目使用的主要扩展包包括：

- `laravel/passport`: OAuth2 认证
- `predis/predis`: Redis 客户端

## 开发指南

### 创建控制器
```bash
php artisan make:controller API/GameController
```

### 创建模型
```bash
php artisan make:model Game
```

### 创建迁移
```bash
php artisan make:migration create_games_table
```

### 运行测试
```bash
php artisan test
```

## 许可证

本项目仅供学习交流使用。