158 lines
3.1 KiB
Markdown
158 lines
3.1 KiB
Markdown
# AI学习平台
|
||
|
||
面向开发者的AI知识学习平台，提供结构化的课程内容和智能学习路径推荐。
|
||
|
||
## 功能特性
|
||
|
||
- 📚 **结构化课程**：精心设计的课程体系，涵盖机器学习、深度学习、NLP、LLM、AI工具等
|
||
- 🎯 **个性化路径**：基于兴趣和水平智能推荐学习路径
|
||
- 📊 **进度跟踪**：实时记录学习进度
|
||
- 💻 **现代化UI**：使用React + Tailwind CSS构建美观界面
|
||
- 📝 **Markdown支持**：课程内容支持Markdown格式，代码高亮
|
||
|
||
## 技术栈
|
||
|
||
### 前端
|
||
- React 18 + TypeScript
|
||
- Vite
|
||
- Tailwind CSS
|
||
- React Router
|
||
- React Markdown
|
||
|
||
### 后端
|
||
- Node.js + Express + TypeScript
|
||
- Prisma ORM
|
||
- SQLite数据库
|
||
|
||
## 快速开始
|
||
|
||
### 1. 安装依赖
|
||
|
||
```bash
|
||
npm install
|
||
npm run install:all
|
||
```
|
||
|
||
### 2. 初始化数据库
|
||
|
||
**方式一：使用自动化脚本（推荐）**
|
||
|
||
```bash
|
||
cd backend
|
||
npm run setup:db
|
||
```
|
||
|
||
**方式二：手动执行**
|
||
|
||
```bash
|
||
cd backend
|
||
npm run prisma:generate # 生成Prisma Client
|
||
npm run prisma:migrate # 创建数据库和表结构
|
||
npm run prisma:seed # 填充初始课程数据
|
||
```
|
||
|
||
数据库文件将创建在 `backend/prisma/dev.db`
|
||
|
||
### 3. 启动开发服务器
|
||
|
||
在项目根目录运行：
|
||
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
这将同时启动：
|
||
- 前端开发服务器：http://localhost:3000
|
||
- 后端API服务器：http://localhost:3001
|
||
|
||
### 单独启动
|
||
|
||
```bash
|
||
# 启动前端
|
||
npm run dev:frontend
|
||
|
||
# 启动后端
|
||
npm run dev:backend
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
ai-learning-platform/
|
||
├── frontend/ # React前端应用
|
||
│ ├── src/
|
||
│ │ ├── components/ # 可复用组件
|
||
│ │ ├── pages/ # 页面组件
|
||
│ │ ├── services/ # API服务
|
||
│ │ └── ...
|
||
│ └── package.json
|
||
├── backend/ # Express后端
|
||
│ ├── src/
|
||
│ │ ├── routes/ # API路由
|
||
│ │ ├── controllers/# 控制器
|
||
│ │ ├── services/ # 业务逻辑
|
||
│ │ └── ...
|
||
│ ├── prisma/ # 数据库Schema和Seed
|
||
│ └── package.json
|
||
├── shared/ # 共享TypeScript类型
|
||
└── package.json # 根package.json
|
||
```
|
||
|
||
## API端点
|
||
|
||
### 课程相关
|
||
- `GET /api/courses` - 获取课程列表
|
||
- `GET /api/courses/:id` - 获取课程详情
|
||
- `GET /api/courses/:id/chapters` - 获取章节列表
|
||
- `GET /api/chapters/:id` - 获取章节内容
|
||
|
||
### 学习路径相关
|
||
- `GET /api/paths` - 获取所有学习路径
|
||
- `POST /api/paths/generate` - 生成个性化路径
|
||
- `GET /api/paths/:id` - 获取路径详情
|
||
|
||
### 进度相关
|
||
- `GET /api/progress` - 获取用户进度
|
||
- `POST /api/progress` - 更新学习进度
|
||
|
||
## 课程分类
|
||
|
||
- **机器学习基础** (ML_BASICS)
|
||
- **深度学习** (DEEP_LEARNING)
|
||
- **自然语言处理** (NLP)
|
||
- **大语言模型** (LLM)
|
||
- **AI工具** (AI_TOOLS)
|
||
|
||
## 开发说明
|
||
|
||
### 数据库迁移
|
||
|
||
```bash
|
||
cd backend
|
||
npm run prisma:migrate
|
||
```
|
||
|
||
### 重新生成Prisma Client
|
||
|
||
```bash
|
||
cd backend
|
||
npm run prisma:generate
|
||
```
|
||
|
||
### 重新初始化数据
|
||
|
||
```bash
|
||
cd backend
|
||
npm run prisma:seed
|
||
```
|
||
|
||
## 构建生产版本
|
||
|
||
```bash
|
||
npm run build
|
||
```
|
||
|
||
## 许可证
|
||
|
||
MIT
|