Alice-exam-proctor

• 

``` █████╗ ██╗ ██╗ ██████╗███████╗ ██╔══██╗██║ ██║██╔════╝██╔════╝ ███████║██║ ██║██║ █████╗ ██╔══██║██║ ██║██║ ██╔══╝ ██║ ██║███████╗██║╚██████╗███████╗ ╚═╝ ╚═╝╚══════╝╚═╝ ╚═════╝╚══════╝ ``` # 🎓 Alice Exam Proctor ### *AI-Powered Online Proctoring — Real-time. Intelligent. Unstoppable.*
[](https://alice-exam-proctor01.vercel.app) [](https://alice-exam-proctor.onrender.com)
       
> **Alice** is a full-stack exam proctoring platform with real-time AI monitoring, WebSocket-powered violation detection, and role-based dashboards for Students, Teachers, and Admins — with **zero video sent too the server**.

---

✨ Features at a Glance

	Feature	Description
🤖	AI Proctoring	Real-time face detection, gaze tracking, head pose analysis — all client-side
👥	Multi-face Detection	Instantly flags when more than one person is in frame
🎙️	Audio Monitoring	Live risk-level indicator + calibration modal
📡	WebSocket Streaming	Violations broadcast to teachers in real-time via Django Channels + Redis
🔑	Join Codes	Auto-generated unique 6-character exam codes
⏱️	Auto-submit	Timed exams submit automatically on timeout
🚨	Violation System	low / medium / high severity, per-student breakdown
🤖	Alice AI Chat	Built-in assistant powered by Google Gemini 1.5 Flash
🌙	Dark / Light Theme	Full theme support via ThemeContext
📱	Responsive	Mobile bottom nav for student & teacher views

---

🎭 Role-Based Dashboards

🧑‍🎓 Student Dashboard — click to expand
| Section | What you get | |---|---| | 🏠 Overview | Upcoming exams, recent violations, performance summary | | 📚 My Exams | History of all completed quizzes with scores | | 🔑 Join Exam | Enter quiz code to enter an exam | | ⚠️ Violations | Full personal violation log | | 👤 Profile | Manage name, bio, department, avatar | 👨‍🏫 Teacher Dashboard — click to expand
| Section | What you get | |---|---| | 📊 Stats | Total quizzes, students, submissions, violations at a glance | | 📝 Exam Management | Create, edit, toggle active/inactive, delete quizzes | | 👥 Student Management | View enrolled students and their details | | 🔴 Live Monitoring | Real-time WebSocket violation feed per exam | | 📈 Results | Submission scores + attached proctoring reports | | ⚠️ Violations | Per-quiz violation breakdown with Recharts charts | 🛡️ Super Admin Dashboard — click to expand
| Section | What you get | |---|---| | 📊 Platform Stats | Bird's-eye view of all activity across the platform | | 👥 User Management | List, activate/deactivate accounts, change roles | | 📝 Exam Management | View and act on every exam on the platform | | ⚠️ Violations | Complete platform-wide violation log | | 🗒️ Audit Logs | Full history of admin actions | | ⚙️ System Settings | Configure platform-level behavior |

---

🏗️ Architecture

Data Flow

Student Browser
     │
     ├── REST (Axios) ──────────────► Django REST API ──► MongoDB
     │                                                    (users, quizzes,
     │                                                     submissions, violations)
     │
     └── WebSocket ─────────────────► Django Channels ──► Redis Channel Layer
                                            │
                                            └── Broadcast ──► Teacher Browser
                                                              (live monitoring)

Project Structure

alice-exam-proctor/
├── src/                              ⚛️  React Frontend (Vite)
│   ├── pages/
│   │   ├── student/                  MyExams, ExamPage, Violations, Profile
│   │   ├── teacher/                  Exams, Students, LiveMonitoring, Results
│   │   └── admin/                    SuperAdminDashboard, UsersManagement
│   ├── components/
│   │   ├── exam/                     ProctorPanel, QuestionPanel, GazeWarning
│   │   ├── student/                  Dashboard widgets, QuizInterface, QuizResult
│   │   ├── teacher/                  QuizCreator, ExamTable, FlagMonitor
│   │   ├── admin/                    StatCard, ViolationChart, LiveActivityFeed
│   │   ├── ai/                       AliceAIChat
│   │   └── common/                   ProtectedRoute, UserAvatar, PremiumFooter
│   ├── contexts/                     AuthContext, ThemeContext
│   ├── hooks/                        useViolationWebSocket
│   └── App.jsx                       Routes with role-based ProtectedRoute
│
└── django_backend/                   🐍 Django + Channels Backend
    ├── api/
    │   ├── models.py                 MongoDB: users, quizzes, submissions, violations
    │   ├── authentication.py         JWT, bcrypt, require_auth / require_role
    │   ├── consumers.py              ProctoringConsumer, TeacherMonitoringConsumer
    │   ├── routing.py                WebSocket URL routing
    │   └── views/
    │       ├── auth.py               register, login, google_auth, update_profile
    │       ├── quiz.py               CRUD, toggle-active, submit, get-by-code
    │       ├── violation.py          create, list, stats, per-student breakdown
    │       ├── ai.py                 Gemini chat endpoint
    │       └── admin_api.py          Admin CRUD + audit logs
    └── exam_proctoring/
        ├── settings.py               MongoDB, Redis, CORS, security headers
        ├── asgi.py                   ASGI entry — Daphne + Channels
        └── urls.py                   Root URL config

🧩 Key Design Decisions

Decision	Reason
MongoDB via PyMongo (no ORM)	Flexible schema for proctoring metadata
SQLite retained	Django admin session & auth tables only
Redis as channel layer	WebSocket group messaging at scale
All AI/ML runs client-side	Zero video ever sent to server — privacy first
JWT stored client-side	Validated per-request via require_auth / require_role decorators

---

🛠️ Tech Stack

Layer	Technology
⚛️ Frontend	React 18, Vite, React Router v6, Axios
🎨 Styling	Tailwind CSS, Framer Motion
📊 Charts	Recharts
🐍 Backend	Django 4.2, Django REST Framework
📡 Real-time	Django Channels, Daphne, Redis
🗄️ Database	MongoDB (PyMongo) + SQLite (Django admin)
🔐 Auth	JWT (PyJWT), bcrypt, Google OAuth 2.0
🤖 AI / ML	face-api.js (client), Google Gemini 1.5 Flash (server)
🚀 Deployment	Vercel (frontend), Render (backend)

---

⚡ Local Setup

🐍 Backend

cd django_backend

# Create and activate virtual environment
python -m venv venv
venv\Scripts\activate        # Windows
source venv/bin/activate     # macOS / Linux

# Install dependencies and initialize
pip install -r requirements.txt
copy .env.example .env       # Fill in your values
python init_database.py
python create_sample_data.py

# Start the server
daphne -b 0.0.0.0 -p 8000 exam_proctoring.asgi:application

⚛️ Frontend

npm install
npm run dev

---

🔑 Environment Variables

Frontend — .env.local

VITE_API_URL=http://localhost:8000/api
VITE_WS_URL=ws://localhost:8000/ws
VITE_GOOGLE_CLIENT_ID=your_google_client_id

Backend — django_backend/.env

SECRET_KEY=your_secret_key
DEBUG=True
MONGODB_URI=your_mongodb_uri
MONGODB_DB=alice_exam_proctor
REDIS_URL=redis://localhost:6379
GEMINI_API_KEY=your_gemini_key
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
EMAIL_HOST_USER=your_email
EMAIL_HOST_PASSWORD=your_email_password

---

🎮 Demo Credentials

Role	Email	Password
🧑‍🎓 Student	[email protected]	password123
👨‍🏫 Teacher	[email protected]	password123

💡 Or use Continue with Google on the auth page — no setup needed!

---

🔐 Auth & Security

• 🔒 JWT-based auth with 7-day token expiry
• 🌐 Google OAuth 2.0 sign-in & registration
• 🛡️ Role-based access control — Student / Teacher / Admin
• 🔑 bcrypt password hashing
• 👤 DiceBear avatars — unique per user, no image uploads needed

---

## 👨‍💻 Author **Aditya Singh Rajput** [](mailto:[email protected])
Made with ❤️ by the **Alice Team**
⭐ **If this project helped you or you found it interesting, please drop a star — it really helps!** ⭐

Built With

• batchfile
• css
• html
• javascript
• procfile
• python