How sudhakar-cyber/adaptive-quiz-system works
LearnSmart is a role-based adaptive learning product for students, educators, and administrators. Users enter through login and role-protected routes; students explore and take quizzes, while educators manage quizzes and review learner performance and administrators manage users and platform content. The frontend’s shared browser-storage service supplies application state. The tree also contains backend API and ML-engine modules, but their excerpts show no wiring, so their runtime relationships are not asserted. Several frontend capabilities are represented as subsystem nodes because their component files are listed but not excerpted.
Main entry points: App.jsx Role router · sharedDatabase.js Shared browser database · Dashboard.jsx Student dashboard · EducatorDashboard.jsx Educator dashboard
Components 20
Entry and identity
- Role router
frontend/src/App.jsx - Login and registration
frontend/src/pages/Login.jsx - Auth service
frontend/src/services/authService.js - Route guards
frontend/src/routes/ProtectedRoute.jsx - OAuth verification
frontend/src/components/OAuthVerification.jsx
Student learning
- Student dashboard
frontend/src/components/Dashboard.jsx - Quiz catalog data
frontend/src/data/quizData.js - Quiz and progress views
frontend/src/components
Educator and admin
- Educator dashboard
frontend/src/pages/EducatorDashboard.jsx - Educator quiz and cohort data
frontend/src/data/educatorData.js - Educator management views
frontend/src/components - Admin dashboard
frontend/src/pages/AdminDashboard.jsx - Admin management views
frontend/src/components - Shared browser database
frontend/src/services/sharedDatabase.js
Backend and ML
- Backend API modules
backend/app - Adaptive ML engine
backend/ml_engine - ML dashboard
ml_dashboard/app.py
Other components
- Learner
- Educator
- Administrator
Connections 22
- Learner → Role router: opens
- Educator → Role router: opens
- Administrator → Role router: opens
- Role router → Login and registration: routes to
frontend/src/App.jsx - Role router → Route guards: guards routes
frontend/src/App.jsx - Role router → Student dashboard: routes to
frontend/src/App.jsx - Role router → Educator dashboard: routes to
frontend/src/App.jsx - Role router → Admin dashboard: routes to
frontend/src/App.jsx - Login and registration → Auth service: uses
frontend/src/pages/Login.jsx - Route guards → Auth service: checks identity
frontend/src/routes/ProtectedRoute.jsx - Login and registration → OAuth verification: offers verification
frontend/src/pages/Login.jsx - OAuth verification → Shared browser database: registers student
frontend/src/components/OAuthVerification.jsx - Student dashboard → Quiz catalog data: reads quiz data
frontend/src/components/Dashboard.jsx - Student dashboard → Quiz and progress views: renders
frontend/src/components/Dashboard.jsx - Student dashboard → Shared browser database: uses
frontend/src/components/Dashboard.jsx - Educator dashboard → Educator quiz and cohort data: uses
frontend/src/pages/EducatorDashboard.jsx - Educator dashboard → Educator management views: renders
frontend/src/pages/EducatorDashboard.jsx - Educator dashboard → Shared browser database: updates cohort
frontend/src/pages/EducatorDashboard.jsx - Admin dashboard → Admin management views: renders
frontend/src/pages/AdminDashboard.jsx - Admin dashboard → Shared browser database: registers educator
frontend/src/pages/AdminDashboard.jsx - Shared browser database → Educator quiz and cohort data: loads initial data
frontend/src/services/sharedDatabase.js - Shared browser database → Quiz catalog data: loads catalog
frontend/src/services/sharedDatabase.js