How anujtiwari1427/quiz-ai works
Quiz-AI is a browser-based school assessment and study application with teacher, student, parent, and administrator views. Users enter through the app shell, which selects a role or study-feature view from shared application state. Teachers build and import assessments, oversee proctoring, and grade work; students take tests and practice questions; parents review student information and use tutoring features. Marks, syllabus, books, and question sets provide additional study workflows. The inspected storage service persists application data in browser local storage. The README contains no usable product description, so capability coverage is based on the source tree and shown excerpts; some subsystem links rely on source-index references.
Main entry points: App.tsx View Router · TeacherConsole.tsx Teacher Console · AppContext.tsx App State · StudentTestRoom.tsx Student Test Room
Components 29
App Shell
- View Router
src/App.tsx - Marketing Landing
src/components/marketing/MarketingLanding.tsx
Assessment
- Teacher Console
src/components/teacher/TeacherConsole.tsx - Test Builder
src/components/teacher/TestBuilderWizard.tsx - Document Import
src/components/teacher/DocumentQuestionImporter.tsx - Live Proctoring
src/components/teacher/LiveProctoringHUD.tsx - Grading Queue
src/components/teacher/SubjectiveGradingQueue.tsx - Mastery Heatmap
src/components/teacher/MasteryHeatmap.tsx - Student Test Room
src/components/student/StudentTestRoom.tsx - Proctor Guard
src/components/student/ProctorGuard.tsx - Result Diagnostics
src/components/student/ResultDiagnosticSheet.tsx
Study Features
- Marks Dashboard
src/components/marks/MarksDashboard.tsx - Syllabus Dashboard
src/components/syllabus/SyllabusDashboard.tsx - Book Library
src/components/books/BookLibrary.tsx - Book Reader
src/components/books/BookReader.tsx - Question Sets
src/components/questions/QuestionSetsHub.tsx - Question Practice
src/components/questions/QuestionPracticeRoom.tsx
Stakeholder Portals
- Parent Portal
src/components/parent/ParentPortal.tsx - WhatsApp Access
src/components/parent/WhatsAppAuthModal.tsx - AI Tutor
src/components/parent/AITutorDrawer.tsx - Admin Console
src/components/admin/AdminConsole.tsx - Roster Import
src/components/admin/BulkRosterImport.tsx - DPDP Audit Logs
src/components/admin/DPDPAuditLogs.tsx
Shared Services
- App State
src/context/AppContext.tsx - Document Parser
src/services/documentParserService.ts - AI Services
src/services/aiService.ts - Browser Storage
src/services/storageService.ts - Grade Utility
src/utils/gradeUtils.ts
Other components
- User
Connections 31
- User → View Router: uses
- View Router → App State: reads view
src/App.tsx - View Router → Marketing Landing: renders
src/App.tsx - View Router → Teacher Console: renders
src/App.tsx - View Router → Student Test Room: renders
src/App.tsx - View Router → Parent Portal: renders
src/App.tsx - View Router → Admin Console: renders
src/App.tsx - View Router → Marks Dashboard: renders
src/App.tsx - View Router → Syllabus Dashboard: renders
src/App.tsx - View Router → Book Library: renders
src/App.tsx - View Router → Question Sets: renders
src/App.tsx - App State → Browser Storage: persists data
src/context/AppContext.tsx - App State → Grade Utility: calculates grades
src/context/AppContext.tsx - Teacher Console → Test Builder: opens builder
src/components/teacher/TeacherConsole.tsx - Teacher Console → Live Proctoring: shows proctoring
src/components/teacher/TeacherConsole.tsx - Teacher Console → Grading Queue: opens grading
src/components/teacher/TeacherConsole.tsx - Teacher Console → Mastery Heatmap: shows mastery
src/components/teacher/TeacherConsole.tsx - Test Builder → AI Services: generates questions
src/components/teacher/TestBuilderWizard.tsx - Test Builder → Document Import: uses importer
src/components/teacher/TestBuilderWizard.tsx - Document Import → Document Parser: parses documents
src/components/teacher/DocumentQuestionImporter.tsx - Student Test Room → Proctor Guard: checks proctoring
src/components/student/StudentTestRoom.tsx - Student Test Room → Result Diagnostics: shows diagnostics
src/components/student/StudentTestRoom.tsx - Student Test Room → App State: submits attempts
src/components/student/StudentTestRoom.tsx - Question Sets → Question Practice: opens practice
src/components/questions/QuestionSetsHub.tsx - Book Library → Book Reader: opens book
src/components/books/BookLibrary.tsx - Book Reader → App State: starts quiz
src/components/books/BookReader.tsx - Parent Portal → WhatsApp Access: requests access
src/components/parent/ParentPortal.tsx - Parent Portal → AI Tutor: opens tutor
src/components/parent/ParentPortal.tsx - AI Tutor → AI Services: requests tutoring
src/components/parent/AITutorDrawer.tsx - Admin Console → Roster Import: manages roster
src/components/admin/AdminConsole.tsx - Admin Console → DPDP Audit Logs: reviews audits
src/components/admin/AdminConsole.tsx