# AI德州扑克

**Repository Path**: simple_is_efficient/texas-holdem

## Basic Information

- **Project Name**: AI德州扑克
- **Description**: 目前代码均由AI生成-完成度大概80%左右
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-02
- **Last Updated**: 2026-01-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



## 🎯 项目概述

这是一个完整的德州扑克游戏项目，全部代码由AI生成，完成度只有80%左右，采用前后端分离架构，支持多人游戏、实时状态同步、数据持久化等功能。

### 🏗️ 项目架构

```
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   前端 (React)   │    │   后端 (Spring Boot)   │    │   数据库 (MySQL)   │
│                 │    │                  │    │                 │
│ • 游戏界面      │◄──►│ • REST API      │◄──►│ • 用户数据      │
│ • 游戏逻辑      │    │ • WebSocket     │    │ • 游戏记录      │
│ • 用户认证      │    │ • 游戏状态管理  │    │ • 统计分析      │
│ • 实时更新      │    │ • AI决策引擎    │    │ • 房间管理      │
└─────────────────┘    └──────────────────┘    └─────────────────┘
```

## 🚀 快速开始

### 环境要求

- Node.js 18+
- Python 3.8+
- Java 11+ (可选，用于生产环境)
- MySQL 8.0+ (可选，用于生产环境)

### 1. 启动后端服务

```bash
# 进入后端目录
cd texas-holdem-backend

# 启动Python测试API (推荐用于开发)
python3 test-api-8081.py

# 或启动Spring Boot生产环境 (需要Java和MySQL)
java -jar target/texas-holdem-backend-1.0.0.jar

# 后端服务将运行在: http://localhost:8081
```

### 2. 启动前端服务

```bash
# 进入前端目录
cd texas-holdem

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 前端服务将运行在: http://localhost:5173
```

### 3. 访问游戏

打开浏览器访问: http://localhost:5173

## 📱 功能特性

### 🎮 游戏功能

- **完整德州扑克规则**: 支持标准德州扑克玩法
- **分阶段下注**: 4轮下注流程 (翻牌前/翻牌/转牌/河牌)
- **座位系统**: 支持2-10个座位，灵活配置AI/真实玩家
- **智能AI**: 具备决策能力的AI对手
- **快速下注**: 1/4池、1/2池、满池、2倍池快捷按钮
- **私人牌保密**: 符合德州扑克规则的牌面保密机制

### ⏰ 实时功能

- **超时机制**: 人类玩家60秒，AI玩家10秒倒计时
- **状态同步**: 游戏状态实时更新
- **断线重连**: 支持玩家断线后重新连接

### 📊 数据管理

- **用户系统**: 注册、登录、个人资料
- **游戏记录**: 完整的游戏历史追踪
- **统计分析**: 胜率、盈亏、最佳牌型等统计
- **数据持久化**: 所有数据保存到后端数据库

### 🔧 技术特性

- **前后端分离**: 清晰的架构分层
- **RESTful API**: 标准化的接口设计
- **WebSocket预留**: 为实时功能预留扩展
- **响应式设计**: 支持桌面和移动设备

## 🗂️ 项目结构

```
texas-holdem-project/
├── texas-holdem/              # 前端项目
│   ├── src/
│   │   ├── components/        # React组件
│   │   ├── services/          # API服务
│   │   ├── contexts/          # 状态管理
│   │   └── utils/             # 工具函数
│   ├── public/                # 静态资源
│   └── package.json           # 依赖配置
│
├── texas-holdem-backend/       # 后端项目
│   ├── src/
│   │   ├── main/java/         # Java源码 (Spring Boot)
│   │   └── main/resources/    # 配置文件
│   ├── test-api-8081.py       # Python测试API
│   └── pom.xml                # Maven配置
│
└── README.md                   # 项目说明
```

## 🔌 API接口

### 用户管理

| 接口                           | 方法   | 描述     |
| ---------------------------- | ---- | ------ |
| `/api/users/register`        | POST | 用户注册   |
| `/api/users/{id}`            | GET  | 获取用户信息 |
| `/api/users/{id}/history`    | GET  | 游戏历史   |
| `/api/users/{id}/statistics` | GET  | 用户统计   |

### 房间管理

| 接口                     | 方法   | 描述   |
| ---------------------- | ---- | ---- |
| `/api/rooms`           | POST | 创建房间 |
| `/api/rooms`           | GET  | 房间列表 |
| `/api/rooms/{id}`      | GET  | 房间详情 |
| `/api/rooms/{id}/join` | POST | 加入房间 |

### 游戏控制

| 接口                          | 方法   | 描述   |
| --------------------------- | ---- | ---- |
| `/api/game/start/{room_id}` | POST | 开始游戏 |
| `/api/records`              | GET  | 游戏记录 |
| `/api/statistics`           | GET  | 全局统计 |
| `/api/health`               | GET  | 健康检查 |

## 🧪 测试

### 后端API测试

```bash
# 运行集成测试
cd texas-holdem-backend
python3 test-integration.py
```

### 前端功能测试

1. 打开 http://localhost:5173
2. 注册新用户
3. 创建游戏房间
4. 配置座位和玩家类型
5. 开始游戏并测试各种功能

## 📈 WebSocket预留接口

项目已为WebSocket实时功能预留接口:

```typescript
// WebSocket消息类型
interface WebSocketMessage {
  type: 'GAME_STATE_UPDATE' | 'PLAYER_ACTION' | 'PLAYER_JOIN' | 'PLAYER_LEAVE';
  data: any;
  timestamp: string;
}
```

## 🔧 开发说明

### 环境变量配置

**前端环境变量** (.env.local):

```env
VITE_API_BASE_URL=http://localhost:8081/api
VITE_WS_BASE_URL=ws://localhost:8081/ws
VITE_DEV_MODE=true
```

**后端配置** (application.yml):

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/poker_db
    username: root
    password: root123
```

### 自定义配置

- **座位数量**: 可配置2-10个座位
- **倒计时设置**: 人类60秒，AI 10秒
- **筹码设置**: 默认10000筹码
- **AI难度**: 可调整AI决策策略

## 🚀 部署

### 生产环境部署

1. **数据库准备**: 配置MySQL数据库
2. **后端部署**: 打包Spring Boot应用
3. **前端部署**: 构建React应用并部署
4. **环境配置**: 配置生产环境变量

### Docker部署 (可选)

```bash
# 后端Docker部署
cd texas-holdem-backend
docker-compose up -d
```

## 🔮 未来扩展

- [ ] WebSocket实时游戏同步
- [ ] 多人在线匹配系统
- [ ] 高级AI算法优化
- [ ] 移动端APP开发
- [ ] 排行榜系统
- [ ] 锦标赛模式
- [ ] 社交功能 (好友、聊天)

## 📄 许可证

MIT License

## 🤝 贡献

欢迎提交Issue和Pull Request来改进项目！

---

**开发团队**: MiniMax Agent  
**版本**: v1.0.0  
**更新时间**: 2026-01-02