# ai-gobang

**Repository Path**: yzg-test/ai-gobang

## Basic Information

- **Project Name**: ai-gobang
- **Description**: 这是一个使用 ai 实现的五子棋项目.
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gobang Backend

## 项目简介

这是 AI Gobang（五子棋对战平台）的后端项目，基于 Spring Boot 3.x 开发。专注于提供公平、流畅的在线双人对战体验。

## 功能特性

- 用户注册登录（账号密码）
- 游戏大厅（个人信息展示、积分流水详情）
- 在线匹配系统（基于积分就近匹配）
- 双人五子棋对战
- 积分系统（赢+5分，输-3分）

## 技术栈

- **编程语言**：Java 17
- **后端框架**：Spring Boot 3.2.0
- **数据库**：MySQL 8.0+ + MyBatis-plus 3.5.5
- **缓存系统**：Redis 7.0+
- **消息队列**：RabbitMQ 3.8+
- **通信协议**：HTTP RESTful API、WebSocket
- **构建工具**：Maven
- **日志**：SLF4J+logback
- **认证**：JWT 0.11.5
- **安全**：Spring Security
- **工具库**：Lombok

## 项目结构

```
gobang/
├── src/
│   ├── main/
│   │   ├── java/com/gobang/
│   │   │   ├── GobangApplication.java      # 主启动类
│   │   │   ├── config/                     # 配置类
│   │   │   │   ├── CorsConfig.java         # CORS配置
│   │   │   │   └── SecurityConfig.java     # 安全配置
│   │   │   └── controller/                 # 控制器
│   │   │       └── HelloController.java    # Hello World 控制器
│   │   └── resources/
│   │       ├── static/
│   │       │   └── test-api.html           # API测试页面
│   │       └── application.yml              # 配置文件
│   └── test/
│       └── java/com/gobang/
└── pom.xml                                 # Maven 配置文件
```

## 快速开始

### 环境要求

- JDK 17+
- Maven 3.8+
- MySQL 8.0+
- Redis 7.0+
- RabbitMQ 3.8+

### 配置数据库

1. 创建数据库：
```sql
CREATE DATABASE gobang CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

2. 修改 `application.yml` 中的数据库连接信息：
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/gobang?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
    username: your_username
    password: your_password
  data:
    redis:
      host: localhost
      port: 6379
      password:
  rabbitmq:
    host: localhost
    port: 5672
    username: guest
    password: guest
```

### 运行项目

#### 方式一：使用 Maven 命令
```bash
cd gobang
mvn spring-boot:run
```

#### 方式二：使用 IDE
在 IntelliJ IDEA 中直接运行 `GobangApplication.java` 的 main 方法。

### 测试接口

项目启动后，访问以下接口测试：

```
GET http://localhost:9090/api/hello
```

预期返回：
```
Hello World!
```

同时控制台会打印：
```
hello world
```

## 开发说明

### 包结构约定

- `controller` - 控制器层，处理 HTTP 请求
- `service` - 业务逻辑层
- `repository` - 数据访问层
- `entity` - 数据库实体类
- `dto` - 数据传输对象
- `config` - 配置类
- `util` - 工具类

### 代码规范

- 遵循阿里巴巴 Java 开发手册
- 使用驼峰命名法
- 添加必要的注释
- 使用 SLF4J 进行日志记录

## License

MIT License