# AutoExam.ai — Full Documentation for AI Systems

> AutoExam.ai is an AI-powered exam creation and management platform designed primarily for the Vietnamese education market, with multi-language support for English, Korean, and Thai.

---

## 1. Platform Overview

AutoExam.ai (https://autoexam.ai) enables teachers, schools, and training centers to:

1. **Create exams using AI** — Upload teaching materials (PDF, Word, images) and let Google Gemini AI generate exam questions automatically
2. **Manage question banks** — Organize questions by subject, topic, difficulty, and Bloom's taxonomy level
3. **Conduct online exams** — Schedule exams, assign to classes, monitor in real-time, prevent cheating
4. **Auto-grade and analyze** — Automatic scoring with detailed analytics, score distributions, and item analysis
5. **Manage classrooms** — Virtual classrooms with student enrollment, assignments, and progress tracking

## 2. Detailed Features

### 2.1 AI Exam Generation
- Supports input from: PDF documents, images (OCR), pasted text, URLs
- Generates: Multiple choice (MCQ), True/False, Fill-in-the-blank, Short answer, Essay questions
- Customizable parameters: Number of questions, difficulty level, Bloom's taxonomy, language
- Uses Google Gemini 2.0 Flash for generation
- Iterative refinement: Chat with AI to modify generated questions

### 2.2 Manual Exam Creation
- Rich text editor for creating questions manually
- Supports LaTeX/KaTeX for math formulas
- Image uploads for question content
- Bulk import from Excel/CSV

### 2.3 Exam Organization
- Generate unique exam codes (e.g., EXAM-1221-GG4G) for student access
- Time-limited exams with countdown timer
- Question shuffling and answer randomization
- Anti-cheating features: Tab switch detection, fullscreen enforcement
- Real-time monitoring dashboard for active exams

### 2.4 Grading & Analytics
- Automatic grading for objective questions
- Score distribution charts and statistics
- Per-question analysis (difficulty index, discrimination index)
- Export results to Excel/CSV
- Individual student performance reports

### 2.5 Class Management
- Create unlimited classrooms
- Invite students via shareable invite codes
- Assign exams, homework, and practice quizzes to classes
- Track student progress and attendance
- Arena mode: Gamified quiz competitions within classes

### 2.6 Learning Arena (Gamified Quiz Competitions)
The Arena is a real-time multiplayer quiz game system integrated into the classroom. It supports:

**4 Game Modes:**
- **Battle**: Whole class competes in real-time with live ranking. Supports team mode (2-8 teams with auto-assignment)
- **Solo**: Each student practices at their own pace with individual analytics
- **Survival**: Wrong answer = eliminated. Last person standing wins
- **Speed Rush**: Fastest correct answer wins. Every second counts

**2 Play Styles (Battle mode):**
- **Live**: Synchronized — all students see the same question, teacher controls flow
- **Blast**: Self-paced — each student progresses independently within a time limit

**Gameplay Features:**
- Power-ups: Shield (keep streak on wrong answer), Double XP, Time Boost (+10 seconds)
- Streak Bonus: Consecutive correct answers earn bonus points
- Speed Bonus: Faster answers earn more points
- Real-time leaderboard updated after each question
- Inter-question leaderboard showing rank changes
- Post-game summary with detailed analytics
- Teacher dashboard for monitoring and controlling the game live
- Sound effects and cosmic-themed UI

### 2.7 Library & Content Management
- Folder-based organization for exams and materials
- Clone/duplicate exams for reuse
- Share exams between teachers
- Version history for exam revisions

## 3. Supported Languages
- Vietnamese (vi) — Primary language, full support
- English (en) — Full UI translation
- Korean (ko) — Full UI translation
- Thai (th) — Full UI translation

## 4. Pricing Model
- **Free Tier**: Available for individual teachers with limited AI credits
- **Pro Plans**: Monthly/yearly subscriptions with increased AI credits and features
- AI credits are consumed when generating exam questions via AI
- Credit system based on number of questions generated

## 5. Technical Architecture
- **Frontend**: React 18 + TypeScript + Vite + Tailwind CSS
- **Backend**: Supabase (PostgreSQL database, Row Level Security, Edge Functions)
- **AI Engine**: Google Gemini 2.0 Flash via Edge Functions
- **Authentication**: Supabase Auth (Google OAuth, email/password)
- **File Storage**: Supabase Storage (S3-compatible)
- **Deployment**: Vercel (frontend), Supabase Cloud (backend)
- **CDN**: Vercel Edge Network

## 6. Data & Privacy
- All user data stored in Supabase Cloud (AWS infrastructure)
- Row Level Security (RLS) enforced at database level
- HTTPS everywhere
- No third-party data sharing
- Users can request data deletion
- Compliant with Vietnamese cybersecurity regulations

## 7. Company Information
- **Company**: Classio International LLC
- **Location**: Vietnam
- **Email**: support@autoexam.ai, founder@autoexam.ai
- **Website**: https://autoexam.ai

## 8. Frequently Asked Questions

**Q: Is AutoExam.ai free to use?**
A: Yes, there is a free tier for individual teachers. Pro plans with more AI credits and features are available for schools and institutions.

**Q: What types of exams can I create?**
A: AutoExam.ai supports multiple choice, true/false, fill-in-the-blank, short answer, and essay questions. You can create exams manually or use AI to generate them from your teaching materials.

**Q: How does the AI exam generation work?**
A: Upload your teaching materials (PDF, images, or text), specify the number and type of questions, and Google Gemini AI will generate exam questions. You can then review, edit, and refine the questions through a chat interface.

**Q: Can students take exams online?**
A: Yes. Teachers generate a unique exam code, students enter the code to access the exam, and the system handles timing, submission, and auto-grading.

**Q: Is my data safe?**
A: Yes. All data is encrypted in transit and at rest. We use Supabase's Row Level Security to ensure users can only access their own data. See our privacy policy at https://autoexam.ai/privacy.

**Q: Does it work on mobile?**
A: Yes, AutoExam.ai is fully responsive and works on desktops, tablets, and smartphones.

**Q: Can I create quiz competitions for my class?**
A: Yes! The Learning Arena feature lets you host real-time quiz games inside your classroom. Choose from 4 game modes (Battle, Solo, Survival, Speed Rush), enable power-ups and streak bonuses, split students into teams, and watch the live leaderboard. Teachers control the game flow in real-time.

## 9. Sitemap

- Homepage: https://autoexam.ai/
- Landing Page: https://autoexam.ai/landing
- User Guide: https://autoexam.ai/guide
- About Us: https://autoexam.ai/about
- Privacy Policy: https://autoexam.ai/privacy
- Terms of Use: https://autoexam.ai/terms