How adityaraj1910/exam-genie works
Project type and purpose
• This is a full-stack MERN application named “Exam-Scribe AI.”
• Frontend: React (TypeScript) with Vite, Tailwind CSS, Shadcn UI; Backend: Node.js/Express; Database: MongoDB.
• Purpose: Enable educators to register/login, manage courses, set up exams, and generate AI-powered questions.
File structure
• Top level separates frontend and backend:
• Root folders/files: index.html, src/, public/, vite.config.ts, tailwind.config.ts (frontend)
• server/: Express app, routes/, models/, middlewares/, scripts/
• Frontend follows a component/page pattern:
• src/pages/: route-level views (Login, Dashboard, ExamSetup, etc.)
• src/components/ui/: reusable UI primitives (buttons, dialogs, forms)
• src/lib/api.ts: HTTP client for REST calls
• src/contexts/AuthContext: user state management
• Backend is structured in MVC style:
• server/models/: Mongoose schemas (Course, Educator, Exam, Question)
• server/routes/: REST endpoints (auth, courses, exams, questions)
• server/middlewares/: auth checks, admin guards
• server/scripts/: DB initialization/seed
README for additional insights
• Confirms MERN stack, environment variables, startup scripts.
• Mentions AI question-generation (likely calls external AI service).
Detail
• Layer: UI → application logic → API client → server middleware → controllers → database.
• Question-generation flow separately: backend → AI service → back to client.
• Configuration nodes (env vars, scripts for DB init).
• Don’t overthink: break the system into as many logical components as needed to make the architecture crystal clear.