# CodeQuest

**Repository Path**: wang-sports/code-quest

## Basic Information

- **Project Name**: CodeQuest
- **Description**: 项目名称：CodeQuest -- AI 驱动的编程冒险学习平台(web版）
项目类型：Java 全栈开发 + Vue 3 前端 + 游戏化学习 + AI 辅助
项目背景：  将编程学习游戏化，让用户像玩 RPG 闯关一样学习 Java、SQL、算法和 Debug 技能。 AI 根据用户水平动态生成题目、提供提示、推荐难度，实现个性化学习。
项目周期：2-3个月，每周一次进度汇报
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: cyy
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CodeQuest - AI驱动的编程冒险学习平台

![版本](https://img.shields.io/badge/版本-1.0.0-blue?style=flat-square)
![协议](https://img.shields.io/badge/协议-MIT-green?style=flat-square)
![技术栈](https://img.shields.io/badge/技术栈-Vue3%20%2B%20Spring%20Boot-purple?style=flat-square)
![平台](https://img.shields.io/badge/平台-全平台适配-orange?style=flat-square)

## 🎯 项目简介

**CodeQuest** 是一个创新的编程学习平台，将游戏化元素与 AI 技术完美结合，让编程学习变得有趣而高效。项目采用前后端分离架构，支持多种编程语言，注重用户体验和学习效果。

## 🏗️ 项目结构

```
CodeQuest/
├── frontend/                 # Vue 3 前端项目
│   ├── src/                 # 前端源代码
│   ├── public/              # 静态资源
│   ├── package.json         # 前端依赖
│   └── vite.config.ts       # Vite 配置
├── backend/                 # Spring Boot 后端项目
│   ├── src/main/java/       # Java 源代码
│   ├── src/main/resources/  # 配置文件
│   ├── pom.xml              # Maven 配置
│   └── sql/                 # 数据库脚本
├── docs/                    # 项目文档
├── package.json             # 根项目配置
└── README.md                # 项目说明
```

## 🚀 快速开始

### 环境要求

- Node.js 18+
- Java 17+
- MySQL 8.0+
- Maven 3.6+

### 安装依赖

```bash
# 安装所有依赖
npm run install:all
```

### 启动项目

```bash
# 同时启动前端和后端
npm run dev

# 或者分别启动
npm run dev:frontend  # 前端: http://localhost:5173
npm run dev:backend   # 后端: http://localhost:8080
```

### 构建项目

```bash
# 构建所有项目
npm run build

# 分别构建
npm run build:frontend
npm run build:backend
```

## 🎮 核心功能

- **🎮 游戏化学习**: RPG 式闯关模式，等级系统、徽章成就
- **🤖 AI 智能辅助**: 动态出题、智能提示、个性化推荐
- **💻 在线编程**: 集成 Monaco Editor，支持多种编程语言
- **🏆 成就系统**: 丰富的徽章和成就，记录学习历程
- **📊 学习分析**: 详细的学习统计和可视化图表

## 🛠️ 技术栈

### 前端
- **框架**: Vue 3 + TypeScript
- **构建工具**: Vite
- **状态管理**: Pinia
- **路由**: Vue Router 4
- **UI组件**: 自定义组件 + Font Awesome
- **图表库**: ECharts

### 后端
- **框架**: Spring Boot 3.2 + Java 17
- **数据库**: MySQL 8.0 + Redis 7
- **安全**: Spring Security + JWT
- **文档**: Swagger/OpenAPI 3
- **容器化**: Docker

## 📱 访问地址

- **前端应用**: http://localhost:5173
- **后端API**: http://localhost:8080/api
- **API文档**: http://localhost:8080/api/swagger-ui.html

## 🤝 参与贡献

我们欢迎各种形式的贡献！特别是：

- 📚 题库资源扩充与优化
- 🎨 界面与用户体验改进
- ✨ 新功能开发与创意
- 🌍 文档翻译与国际化
- 🐛 问题修复与代码优化

## 📜 开源协议

本项目采用 [MIT 协议](LICENSE.md)


---

**CodeQuest Team** - 让编程学习像游戏一样有趣！ 🎮⚔️