🎉 Initial commit: QQuiz - 智能刷题与题库管理平台

## 功能特性

✅ **核心功能**
- 多文件上传与智能去重（基于 content_hash）
- 异步文档解析（支持 TXT/PDF/DOCX/XLSX）
- AI 智能题目提取与评分（OpenAI/Anthropic/Qwen）
- 断点续做与进度管理
- 自动错题本收集

✅ **技术栈**
- Backend: FastAPI + SQLAlchemy 2.0 + PostgreSQL
- Frontend: React 18 + Vite + Tailwind CSS
- Deployment: Docker Compose

✅ **项目结构**
- 53 个文件
- 完整的前后端分离架构
- Docker/源码双模部署支持

🚀 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

frontend/src/api/client.js

@@ -0,0 +1,166 @@
+/**
+ * API Client for QQuiz Backend
+ */
+import axios from 'axios'
+import toast from 'react-hot-toast'
+
+// Create axios instance
+const api = axios.create({
+  baseURL: import.meta.env.VITE_API_URL || 'http://localhost:8000',
+  timeout: 30000,
+  headers: {
+    'Content-Type': 'application/json'
+  }
+})
+
+// Request interceptor - Add auth token
+api.interceptors.request.use(
+  (config) => {
+    const token = localStorage.getItem('access_token')
+    if (token) {
+      config.headers.Authorization = `Bearer ${token}`
+    }
+    return config
+  },
+  (error) => {
+    return Promise.reject(error)
+  }
+)
+
+// Response interceptor - Handle errors
+api.interceptors.response.use(
+  (response) => response,
+  (error) => {
+    const message = error.response?.data?.detail || 'An error occurred'
+
+    if (error.response?.status === 401) {
+      // Unauthorized - Clear token and redirect to login
+      localStorage.removeItem('access_token')
+      localStorage.removeItem('user')
+      window.location.href = '/login'
+      toast.error('Session expired. Please login again.')
+    } else if (error.response?.status === 403) {
+      toast.error('Permission denied')
+    } else if (error.response?.status === 429) {
+      toast.error(message)
+    } else if (error.response?.status >= 500) {
+      toast.error('Server error. Please try again later.')
+    } else {
+      toast.error(message)
+    }
+
+    return Promise.reject(error)
+  }
+)
+
+// ============ Auth APIs ============
+export const authAPI = {
+  register: (username, password) =>
+    api.post('/api/auth/register', { username, password }),
+
+  login: (username, password) =>
+    api.post('/api/auth/login', { username, password }),
+
+  getCurrentUser: () =>
+    api.get('/api/auth/me'),
+
+  changePassword: (oldPassword, newPassword) =>
+    api.post('/api/auth/change-password', null, {
+      params: { old_password: oldPassword, new_password: newPassword }
+    })
+}
+
+// ============ Exam APIs ============
+export const examAPI = {
+  // Create exam with first document
+  create: (title, file) => {
+    const formData = new FormData()
+    formData.append('title', title)
+    formData.append('file', file)
+    return api.post('/api/exams/create', formData, {
+      headers: { 'Content-Type': 'multipart/form-data' }
+    })
+  },
+
+  // Append document to existing exam
+  appendDocument: (examId, file) => {
+    const formData = new FormData()
+    formData.append('file', file)
+    return api.post(`/api/exams/${examId}/append`, formData, {
+      headers: { 'Content-Type': 'multipart/form-data' }
+    })
+  },
+
+  // Get user's exam list
+  getList: (skip = 0, limit = 20) =>
+    api.get('/api/exams/', { params: { skip, limit } }),
+
+  // Get exam detail
+  getDetail: (examId) =>
+    api.get(`/api/exams/${examId}`),
+
+  // Delete exam
+  delete: (examId) =>
+    api.delete(`/api/exams/${examId}`),
+
+  // Update quiz progress
+  updateProgress: (examId, currentIndex) =>
+    api.put(`/api/exams/${examId}/progress`, { current_index: currentIndex })
+}
+
+// ============ Question APIs ============
+export const questionAPI = {
+  // Get all questions for an exam
+  getExamQuestions: (examId, skip = 0, limit = 50) =>
+    api.get(`/api/questions/exam/${examId}/questions`, { params: { skip, limit } }),
+
+  // Get current question (based on exam's current_index)
+  getCurrentQuestion: (examId) =>
+    api.get(`/api/questions/exam/${examId}/current`),
+
+  // Get question by ID
+  getById: (questionId) =>
+    api.get(`/api/questions/${questionId}`),
+
+  // Check answer
+  checkAnswer: (questionId, userAnswer) =>
+    api.post('/api/questions/check', {
+      question_id: questionId,
+      user_answer: userAnswer
+    })
+}
+
+// ============ Mistake APIs ============
+export const mistakeAPI = {
+  // Get user's mistake book
+  getList: (skip = 0, limit = 50, examId = null) => {
+    const params = { skip, limit }
+    if (examId) params.exam_id = examId
+    return api.get('/api/mistakes/', { params })
+  },
+
+  // Add to mistake book
+  add: (questionId) =>
+    api.post('/api/mistakes/add', { question_id: questionId }),
+
+  // Remove from mistake book by mistake ID
+  remove: (mistakeId) =>
+    api.delete(`/api/mistakes/${mistakeId}`),
+
+  // Remove from mistake book by question ID
+  removeByQuestionId: (questionId) =>
+    api.delete(`/api/mistakes/question/${questionId}`)
+}
+
+// ============ Admin APIs ============
+export const adminAPI = {
+  // Get system config
+  getConfig: () =>
+    api.get('/api/admin/config'),
+
+  // Update system config
+  updateConfig: (config) =>
+    api.put('/api/admin/config', config)
+}
+
+export default api