Passenger-rex/exam-city

Full-stack CBT examination engine for West African students. Features real-time grading, analytics, and anti-cheat logic # Exam City 🎓 An intelligent, AI-powered mock examination platform tailored for WAEC, JAMB, NECO candidates, and university-level or professional certification test takers. Exam City provides standard past questions alongside AI-generated predictive mock exams, providing a hyper-realistic and intellectually rigorous testing environment. ## ✨ Features - **Dual Question Banks:** Access an authentic public bank of past questions powered by the ALOC Past Questions API. - **AI-Powered Fallback & Rigor Engine:** Powered by Google Gemini (`@google/genai`). If a specific subject or topic isn't found in the past question database, Exam City utilizes AI to generate highly rigorous, multi-disciplinary questions. - **Deep Scenarios & Mixed Modalities:** The engine generates diverse question sets encompassing "clinical vignettes", "gross anatomy", "histology", "pathophysiology", and deep theoretical reasoning, guaranteeing you get well-rounded practice not basic memory recall. - **Micro & Standard Modes:** Choose between rapid 5-question micro-targeted sessions or full 40-question standard exams. - **Audio Accessibility:** Built-in Text-to-Speech (TTS) integration to read out questions and options. - **Real-time Grading:** Instant assessment and detailed breakdown of exam results. - **AI Explanations:** Powered by Google Gemini to explain incorrect answers and act as a study coach. - **Offline Output:** Generate and print offline PDFs of exams for physical practice. - **User Dashboard:** Track performance trends, total tests taken, and overall readiness. ## 🔌 API Integrations & Data Sources 1. **ALOC API (`questions.aloc.com.ng`)** Provides real past questions for Nigerian subjects including: Mathematics, English, Biology, Chemistry, Physics, Economics, Geography, Government, Literature, CRK, IRK, Commerce, Accounting, Agric, and Civic Education. 2. **Google Gemini (`@google/genai`)** Used for dynamic question generation, rigorous fallback mechanisms, mixing clinical and no …