🎓 For Teachers

1. Register & Login: Create your teacher account to access the quiz creation dashboard
2. Create Quizzes: Build interactive quizzes with 3 question types:
   • Multiple Choice (MCQ): Students select one correct answer from options
   • Fill in the Blank: Students type the exact answer (case-insensitive)
   • Drag & Drop: Students match descriptions with correct answers by dragging items into order
3. Set Timers: Add optional time limits per question to increase challenge
4. Start Session: Launch a game session and share the unique game code with students
5. Monitor Live: Watch students join in real-time via Pusher WebSocket connection
6. Control Flow: Questions advance automatically when all students answer, or when the timer expires
7. View Results: See live leaderboard ranking students by correct answers and speed

🎮 For Students

1. Get Game Code: Receive a 4-6 character code from your teacher
2. Validate & Join: Enter the code on this page - the system checks if:
   • The code exists in the database
   • The game hasn't started yet (can only join before first question)
   • The game hasn't finished
3. Enter Your Name: Provide your name to identify yourself in the game
4. Wait for Start: The teacher controls when questions begin
5. Answer Questions: Submit answers quickly for bonus points - scoring considers:
   • Correctness: You must answer correctly to earn points
   • Speed: Faster correct answers rank higher on leaderboard
   • Time Tracking: Response time is measured from question start to submission
6. One Answer Only: You cannot change your answer after submission
7. Auto-Advance: Questions move forward when everyone answers or time runs out
8. See Rankings: Check the live leaderboard to see your position

⚙️ System Features

• Real-Time Sync: Uses Pusher for instant updates across all connected devices
• Session Management: Each game has unique code, tracks progress, and prevents late joins
• Smart Scoring: Ranks by correct answers first, then by total response time
• Answer Validation:
  • MCQ: Exact option match required
  • Fill Blank: Case-insensitive text comparison
  • Drag & Drop: All pairs must match in exact order
• Timer System: Optional per-question countdown with auto-advance
• Duplicate Prevention: Students cannot submit multiple answers per question
• Session States: Tracks waiting → playing → finished lifecycle