CodePilot — AI 编程学习平台

✨ 核心特性

🏗️ 技术栈

前端 后端 基础设施
├── Next.js 16 (App Router) ├── FastAPI (async) ├── PostgreSQL 16
├── React 19 ├── SQLAlchemy 2.0 (async) ├── Redis 7
├── TypeScript ├── Pydantic V2 ├── Docker Compose
├── TailwindCSS 3 ├── Alembic (数据库迁移) └── DeepSeek API (OpenAI 兼容)
├── Zustand (状态管理) ├── asyncpg (异步 PG 驱动)
├── SWR (数据请求) ├── httpx (异步 HTTP)
├── Monaco Editor (代码编辑) └── OpenAI SDK
├── Pyodide (浏览器 Python)
├── Remotion (动画引擎)
├── react-markdown + remark-gfm
└── Lucide React (图标)

🚀 快速开始

前置要求

1. 克隆项目

git clone https://github.com/your-username/CodePilot.git
cd CodePilot

2. 配置环境变量

cp .env.example backend/.env

DATABASE_URL=postgresql+asyncpg://codepilot:dev_password@localhost:5432/codepilot
REDIS_URL=redis://localhost:6379/0
LLM_API_KEY=your-deepseek-api-key-here
LLM_MODEL=deepseek-chat
LLM_BASE_URL=https://api.deepseek.com

3. 启动数据库

docker compose up -d postgres redis

4. 启动后端

cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# 数据库迁移
alembic upgrade head
# 启动服务
uvicorn app.main:app --reload --port 8000

5. 启动前端

cd frontend
npm install
npm run dev

📁 项目结构

CodePilot/
├── frontend/ # Next.js 前端
│ ├── src/
│ │ ├── app/ # 页面路由
│ │ │ ├── auth/ # 登录 / 注册
│ │ │ ├── dashboard/ # 学习仪表盘
│ │ │ ├── exercises/ # 练习中心(独立)
│ │ │ ├── exercise/ # 练习详情
│ │ │ ├── history/ # 学习历史
│ │ │ └── learn/ # 学习路径 / 章节详情
│ │ ├── components/ # UI 组件
│ │ │ ├── layout/ # Header / Footer
│ │ │ ├── charts/ # 统计图表
│ │ │ ├── animations/ # 动画组件
│ │ │ ├── AuthGuard.tsx # 路由鉴权守卫
│ │ │ └── MarkdownRenderer.tsx # Markdown 渲染
│ │ ├── hooks/ # 自定义 Hooks
│ │ │ ├── useAuth.ts # 认证状态管理
│ │ │ └── usePyodide.ts # Pyodide 运行时
│ │ ├── stores/ # Zustand 状态
│ │ └── lib/ # API 封装 + 工具函数
│ └── package.json
├── backend/ # FastAPI 后端
│ ├── app/
│ │ ├── main.py # 入口 + 路由注册
│ │ ├── api/v1/ # REST 路由
│ │ │ ├── auth.py # 注册 / 登录 / 当前用户
│ │ │ ├── paths.py # 学习路径 CRUD + AI 生成
│ │ │ ├── chapters.py # 章节管理
│ │ │ ├── conversations.py # 对话管理
│ │ │ ├── exercises.py # 练习 CRUD + AI 生成 / 判题
│ │ │ ├── code.py # 代码运行
│ │ │ ├── progress.py # 学习进度 / 统计
│ │ │ └── animation.py # 动画生成
│ │ ├── api/ws/ # WebSocket 路由
│ │ │ └── chat.py # 流式 AI 对话
│ │ ├── core/ # 配置 + 安全 + 依赖注入
│ │ ├── models/ # SQLAlchemy ORM 模型
│ │ ├── schemas/ # Pydantic 请求/响应模型
│ │ ├── services/ # 业务逻辑 (LLM/对话/判题)
│ │ └── db/ # 数据库 + Redis 连接
│ ├── alembic/ # 数据库迁移脚本
│ ├── Dockerfile
│ └── requirements.txt
├── design/ # UI 设计稿 (HTML + PNG)
├── docs/
│ └── ARCHITECTURE.md # 架构设计文档
├── docker-compose.yml
└── .env.example

🔌 API 接口

认证

学习路径

对话 & 练习

进度 & 其他

📸 页面预览

📝 开发路线

📄 License