AEGIS ExamLab is a production-ready, open-source examination management platform built on Next.js 14 and MongoDB. It enforces strict server-side validation, real-time telemetry, and AI-assisted question management for lab-scale deployments.
Next.js 14
App Router Framework
MongoDB
Primary Database
Genkit AI
Question Intelligence
TypeScript
End-to-End Type Safety
Every component is purpose-built for security and reliability in academic lab environments.
PCs self-register via a browser form and receive a
cryptographic uniqueIdentifier persisted to localStorage. Admin approval gates all exam access.
Full CRUD with bulk CSV ingestion (10-column schema), duplicate
roll number detection, and optional exam assignment per student. Enforces DB-level uniqueness on rollNumber.
Powered by Google Genkit (Gemini model). Auto-classifies questions by difficulty (Easy/Medium/Hard), generates semantic tags, and supports LaTeX and coding snippet rendering.
No exam data reaches the client without passing a 5-point server-side validation chain: PC approval → student mapping → exam assignment → status check → duplicate submission guard.
Every active workstation pulses heartbeats to the server every
15 seconds via HTTP polling, updating its liveStatus from
Online → Attempting → Finished with lastSeen
timestamps.
Every admin action (login, student creation, exam control) is
recorded with a timestamp and admin identity into the admin_logs
collection. Fully queryable from the Logs dashboard panel.
Installation, environment config, database seeding, Docker deployment.
System design, data models, security posture, telemetry, and routing.
Complete documentation for all Server Actions, parameters, and return types.
Roadmap, OS-level future work, PR guidelines, and development setup.