# fruit-bluff-game

**Repository Path**: grant_chen/fruit-bluff-game

## Basic Information

- **Project Name**: fruit-bluff-game
- **Description**: 果然有诈
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-21
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 果然有诈 - 水果吹牛游戏 🍎🍊🍆

> 一款 2-4 人的心理博弈卡牌游戏，核心玩法是吹牛 + 质疑 + 反杀

## 📁 项目结构

```
fruit-bluff-game/
├── backend/                  # Rust 后端 (Axum + MySQL + WebSocket)
├── frontend/
│   ├── miniprogram/          # 微信小程序
│   ├── web-pc/               # Web PC 端 (Vue 3 + TypeScript)
│   └── web-h5/               # Web H5 端 (待开发)
├── doc/                      # 项目文档
│   ├── 游戏规则说明.md       # 游戏规则
│   ├── 会员制度说明.md       # 会员制度
│   ├── 项目架构说明.md       # 架构说明
│   ├── 完整数据库设计.sql     # 数据库初始化
│   └── api.md                # API 文档
└── README.md                 # 本文件
```

## 🚀 快速开始

### 1. 后端

```bash
cd backend

# 安装依赖
cargo build

# 配置环境变量
cp .env.example .env
# 编辑 .env 填写数据库配置

# 初始化数据库
cd ../doc
mysql -u root -p < 完整数据库设计.sql

# 启动服务
cd ../backend
cargo run
```

后端运行在 `http://localhost:3000`

### 2. 前端

**微信小程序** (`frontend/miniprogram/`):
```bash
cd frontend/miniprogram
# 使用微信开发者工具打开
```

**Web PC 端** (`frontend/web-pc/`):
```bash
cd frontend/web-pc
npm install
npm run dev
```

## 🎮 游戏规则

### 核心玩法

1. **加入房间** → 2-4 人进入同一房间
2. **准备** → 所有玩家点击准备
3. **开始游戏** → 自动开始，每人发 5 张牌
4. **出牌** → 当前玩家出 1-3 张牌，声称数量和类型
5. **选择** → 下家选择相信 / 质疑 / 半信半疑
6. **结算** → 质疑判定，失败者受惩罚
7. **继续** → 直到有人出完牌或只剩一人
8. **结束** → 结算成绩，发放称号

### 卡牌类型

| 类型 | 说明 |
|------|------|
| 🍎 苹果 | 主题牌 |
| 🥕 胡萝卜 | 主题牌 |
| 🍆 茄子 | 主题牌 |
| 🥝 奇异果 | 万能牌 |
| 💀 腐烂牌 | 无效 |

### 称号系统

| 条件 | 称号 |
|------|------|
| 吹牛≥10 且 质疑成功≥5 | 👑 诈王之王 |
| 吹牛≥5 | 🎭 吹牛大师 |
| 质疑成功≥5 | 🔍 质疑高手 |
| 吹牛≥3 | 🦊 小小骗子 |
| 其他 | 👤 普通玩家 |

## 🔧 技术栈

### 后端

- **语言**: Rust
- **框架**: Axum
- **数据库**: MySQL
- **ORM**: sqlx
- **实时通信**: WebSocket
- **认证**: JWT

### 前端

- **微信小程序**: 原生开发
- **Web PC**: Vue 3 + TypeScript + Vite

## 📦 数据库

数据库设计位于 `doc/完整数据库设计.sql`，包含：

- 用户表 (users)
- 房间表 (game_room)
- 游戏表 (game)
- 会员表 (memberships)
- 订单表 (orders)
- 道具表 (game_props)
- 等等...

## 📄 许可证

MIT