# gof23-game

**Repository Path**: MagicJson/gof23-game

## Basic Information

- **Project Name**: gof23-game
- **Description**: GoF23 Game是一个交互式学习平台，通过实际编程挑战帮助开发者掌握23种Gang of Four设计模式。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-06-18
- **Last Updated**: 2025-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GoF23 Game - 设计模式学习游戏

GoF23 Game是一个交互式学习平台，通过实际编程挑战帮助开发者掌握23种Gang of Four设计模式。

## 功能特点

- 23种经典设计模式的详细说明和示例代码
- 基于难度级别（初级、中级、高级）的渐进式学习路径
- 实时代码评估和反馈
- 个人进度跟踪和成就系统
- 支持多种AI模型进行代码评估（OpenAI、Claude、DeepSeek）

## 技术栈

- **前端**：React + TypeScript + Material-UI + Redux
- **后端**：Node.js + Express
- **数据库**：MongoDB
- **AI集成**：抽象层支持多种LLM提供商

## 快速开始

### 前提条件

- Node.js 14+
- Docker和Docker Compose（用于MongoDB）
- npm或yarn

### 安装步骤

1. **克隆仓库**

```bash
git clone <repository-url>
cd gof23-game
```

2. **安装依赖**

```bash
# 安装服务器依赖
npm install

# 安装客户端依赖
cd client
npm install
cd ..
```

3. **启动MongoDB**

使用Docker启动MongoDB：

- **Windows**：
  ```
  docker\start-mongodb.bat
  ```

- **Linux/Mac**：
  ```
  chmod +x docker/start-mongodb.sh
  ./docker/start-mongodb.sh
  ```

或直接使用Docker Compose：

```bash
cd docker
docker-compose up -d
```

4. **启动应用**

```bash
npm run dev
```

应用将在以下地址运行：
- 前端：http://localhost:3000
- 后端：http://localhost:9000

## 使用指南

1. 注册账号或使用测试账号（用户名：testuser，密码：password）
2. 从仪表盘浏览可用的设计模式
3. 选择一个模式开始学习
4. 完成编程挑战并提交解决方案
5. 获取AI评估和改进建议
6. 达到要求评级后解锁更高难度的挑战

## 开发

### 项目结构

```
gof23-game/
├── client/              # 前端React应用
│   ├── public/          # 静态资源
│   └── src/             # React源代码
│       ├── components/  # 可复用组件
│       ├── pages/       # 页面组件
│       ├── redux/       # Redux状态管理
│       └── ...
├── server/              # 后端Node.js/Express应用
│   ├── api/             # API路由
│   ├── models/          # MongoDB模型
│   ├── middleware/      # 中间件
│   └── services/        # 服务层（包括AI服务）
└── docker/              # Docker配置
    ├── docker-compose.yml  # MongoDB配置
    └── mongo-init.js       # 数据库初始化脚本
```

## 许可证

[MIT](LICENSE)

## 联系方式

如有问题或建议，请提交Issue或联系项目维护者。