# game_pass

**Repository Path**: jack1995/game_pass

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-30
- **Last Updated**: 2025-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 休闲游戏平台

一个基于Vue3 + PixiJS + Node.js的休闲游戏平台，支持统一金币体系的多款小游戏。

## 项目特色

### 核心功能
- 🎮 **统一金币体系** - 所有游戏共享金币，互通进度
- 🍎 **水果消消乐** - 经典三消游戏，关卡挑战模式
- 🥷 **水果忍者切切乐** - 手速反应游戏，连击系统
- 👤 **用户系统** - 支持游客、手机号、微信登录
- 🏆 **排行榜系统** - 多维度排行榜，激发竞争
- 💰 **金币经济** - 游戏掉落、每日签到、广告奖励
- 📱 **移动端优化** - 响应式设计，完美适配手机

### 技术架构
- **前端**: Vue 3 + TypeScript + PixiJS + Pinia
- **后端**: Go + Gin + JWT
- **数据库**: SQLite (内置数据库)
- **部署**: 原生二进制文件

## 项目结构

```
h5-game3/
├── frontend/                 # 前端Vue3项目
│   ├── src/
│   │   ├── api/             # API接口层
│   │   ├── components/      # 通用组件
│   │   ├── games/           # 游戏模块
│   │   │   ├── match3/      # 消消乐游戏
│   │   │   └── ninja/       # 水果忍者
│   │   ├── stores/          # 状态管理
│   │   ├── views/           # 页面组件
│   │   └── utils/           # 工具函数
│   └── package.json
├── backend/                  # 后端Go项目
│   ├── cmd/                 # 主程序入口
│   ├── internal/
│   │   ├── handlers/        # HTTP处理器
│   │   ├── models/          # 数据模型
│   │   ├── middleware/      # 中间件
│   │   ├── database/        # 数据库层
│   │   └── utils/           # 工具函数
│   ├── data/                # SQLite数据库文件
│   └── go.mod
└── README.md
```

## 快速开始

### 环境要求
- Go >= 1.21
- Node.js >= 18.0.0

### 快速启动

```bash
# 一键启动（推荐）
./start.sh
```

### 手动启动

```bash
# 1. 安装Go后端依赖
cd backend
go mod tidy

# 2. 安装前端依赖
cd ../frontend
npm install

# 3. 启动后端服务
cd ../backend
go run cmd/main.go

# 4. 启动前端服务 (新终端)
cd frontend
npm run dev
```

### 访问应用

打开浏览器访问 `http://localhost:3000`

## 游戏玩法

### 水果消消乐
- **目标**: 在30秒内达到目标分数
- **操作**: 点击选择水果，再点击相邻水果交换位置
- **消除**: 形成3个或以上相同水果的连线即可消除
- **特殊**: L型、T型消除有额外分数和金币奖励
- **道具**: 炸弹、彩虹水果、时间延长

### 水果忍者切切乐
- **目标**: 在60秒内获得最高分数
- **操作**: 滑动屏幕切割飞出的水果
- **连击**: 连续切割获得连击加分
- **避险**: 避开炸弹，碰到游戏结束
- **特殊**: 金币水果、冰冻水果等特殊道具

## 金币系统

### 获得方式
- 🎮 游戏内掉落（主要来源）
- ✅ 每日签到奖励
- 📺 观看广告获得
- 🎯 完成每日任务

### 消费方式
- 🔓 解锁新关卡：100金币/关
- 🛡️ 购买道具：20-30金币/个
- ❤️ 游戏复活：50金币/次

### 经济平衡
- 金币获取有每日上限
- 高等级关卡解锁成本递增
- 免费玩家每日可获得200-300金币

## API文档

### 认证接口
- `POST /api/auth/guest-login` - 游客登录
- `POST /api/auth/phone-login` - 手机号登录
- `POST /api/auth/send-sms` - 发送短信验证码

### 用户接口
- `GET /api/user/profile` - 获取用户信息
- `PUT /api/user/profile` - 更新用户信息
- `GET /api/user/stats` - 获取用户统计

### 游戏接口
- `POST /api/game/start` - 开始游戏
- `POST /api/game/finish` - 结束游戏
- `GET /api/game/progress` - 获取游戏进度

### 金币接口
- `POST /api/coins/transaction` - 金币交易
- `GET /api/coins/balance` - 获取余额
- `POST /api/coins/checkin` - 每日签到

## 开发说明

### 前端开发
```bash
cd frontend
npm run dev      # 启动开发服务器
npm run build    # 构建生产版本
npm run lint     # 代码检查
```

### 后端开发
```bash
cd backend
go run cmd/main.go    # 启动开发服务器
go build -o game-platform cmd/main.go  # 构建生产版本
```

### 数据库管理
```bash
# 数据库文件位置
backend/data/game_platform.db

# 数据库在首次启动时自动创建
# 支持标准SQL查询和SQLite语法
```

## 部署说明

### 生产环境部署
```bash
# 1. 构建Go后端
cd backend
go build -o game-platform cmd/main.go

# 2. 构建前端
cd ../frontend
npm run build

# 3. 启动后端服务
./backend/game-platform

# 4. 配置Nginx代理前端静态文件
```

### Docker部署 (可选)
```bash
# 创建Docker镜像和容器
# 参考 docker-compose.yml 配置文件
```

### 系统服务配置
1. 配置systemd服务文件
2. 使用Nginx处理静态资源和反向代理
3. 配置SSL证书（HTTPS）
4. 设置日志轮转和监控

## 项目特点

### 技术亮点
- ✨ **现代化技术栈** - Vue3 Composition API + TypeScript + Go
- 🎨 **游戏引擎集成** - PixiJS实现高性能2D游戏
- 🔒 **安全认证** - JWT + bcrypt密码加密
- 📊 **数据分析** - 完整的用户行为统计
- 🚀 **性能优化** - 内置SQLite + 数据库索引优化
- 💾 **轻量部署** - 单文件部署，无需外部数据库

### 业务特色
- 🎯 **统一金币体系** - 跨游戏金币流通
- 🏆 **进度保存** - 云端同步，多端通用
- 📱 **移动优先** - 响应式设计，触屏优化
- 🎮 **可扩展性** - 模块化架构，易于新增游戏

## 许可证

MIT License

## 联系方式

如有问题或建议，请通过以下方式联系：
- 提交Issue：[GitHub Issues](https://github.com/your-repo/issues)
- 邮箱：your-email@example.com

---

**享受游戏，赚取金币！** 🎮💰