mirror of
https://github.com/handsomezhuzhu/QQuiz.git
synced 2026-02-20 20:10:14 +00:00
handsomezhuzhu
3a9bf04401
Fix: - Remove Chinese characters causing encoding errors - Create pure English version scripts New files: - setup.bat: Simple configuration script (English) - start_app.bat: Auto-deploy script (English) - README_QUICKSTART.md: Quick start guide 🚀 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
95 lines
2.0 KiB
Markdown
95 lines
2.0 KiB
Markdown
# QQuiz Quick Start Guide
|
|
|
|
## Step 1: Configure (30 seconds)
|
|
|
|
Double-click to run:
|
|
```
|
|
setup.bat
|
|
```
|
|
|
|
This will:
|
|
- Create `.env` file
|
|
- Open it in Notepad
|
|
- You need to replace `sk-your-openai-api-key-here` with your real OpenAI API key
|
|
|
|
**Where to get API key:**
|
|
- Visit: https://platform.openai.com/api-keys
|
|
- Create new secret key
|
|
- Copy and paste into `.env` file
|
|
|
|
## Step 2: Start Application (3-5 minutes)
|
|
|
|
Double-click to run:
|
|
```
|
|
start_app.bat
|
|
```
|
|
|
|
**PostgreSQL Password:**
|
|
- When prompted, enter your PostgreSQL password
|
|
- Default is usually: `postgres`
|
|
- Or just press Enter to try without password
|
|
|
|
The script will automatically:
|
|
- ✓ Check Python and Node.js
|
|
- ✓ Create database
|
|
- ✓ Install all dependencies
|
|
- ✓ Start backend (new window)
|
|
- ✓ Start frontend (new window)
|
|
|
|
## Step 3: Access System
|
|
|
|
Browser will open automatically: http://localhost:3000
|
|
|
|
**Login:**
|
|
- Username: `admin`
|
|
- Password: `admin123`
|
|
|
|
**Test the system:**
|
|
1. Click "题库管理" (Exam Management)
|
|
2. Click "创建题库" (Create Exam)
|
|
3. Enter name: `Test Exam`
|
|
4. Upload file: `test_data/sample_questions.txt`
|
|
5. Wait 10-30 seconds for AI to process
|
|
6. Click "开始刷题" (Start Quiz)
|
|
|
|
## What You'll See
|
|
|
|
✅ Beautiful login page
|
|
✅ Dashboard with statistics
|
|
✅ Create exam and upload documents
|
|
✅ AI processes questions automatically
|
|
✅ Quiz player with different question types
|
|
✅ Automatic mistake collection
|
|
✅ Progress tracking
|
|
|
|
## Troubleshooting
|
|
|
|
### Can't find PostgreSQL password
|
|
- Try: `postgres` or leave empty
|
|
- Or check PostgreSQL installation
|
|
|
|
### Port already in use
|
|
```cmd
|
|
netstat -ano | findstr :3000
|
|
taskkill /F /PID <PID>
|
|
```
|
|
|
|
### Dependencies install failed
|
|
- Check internet connection
|
|
- Script uses China mirrors for speed
|
|
|
|
## Success!
|
|
|
|
If you see the login page at http://localhost:3000 - congratulations! 🎉
|
|
|
|
The system is now running. You can:
|
|
- Create exam banks
|
|
- Upload documents (TXT/PDF/DOCX/XLSX)
|
|
- Start quizzing
|
|
- Review mistakes
|
|
- Track progress
|
|
|
|
---
|
|
|
|
Enjoy using QQuiz! 🚀
|