How dharanidharanravikumar/elmquiz works
ELM Quiz digitizes a six-domain student self-assessment: users enter personal details, answer the question bank, and submit responses for scoring, interpretation, and report creation. They can then look up and download a personalized PDF; administrators also have a protected dashboard for report lookup and downloads. The frontend uses shared quiz and authentication state, while an Express API handles authentication and report operations backed by MongoDB. Some frontend-to-API links are documented capabilities rather than shown calls; those edges cite the README.
Main entry points: App.jsx Route application · report.js Report operations · QuizPage.jsx Assessment quiz · Login.jsx Admin login
Components 21
Assessment frontend
- Route application
frontend/src/App.jsx - Assessment home
frontend/src/pages/Home.jsx - Gender selection
frontend/src/pages/GenderSelectionPage.jsx - Personal details
frontend/src/pages/PersonalDetails.jsx - Assessment quiz
frontend/src/pages/QuizPage.jsx - Quiz state
frontend/src/contexts/QuizContext.jsx - Question bank
frontend/src/data/questions.json
Access and reports
- Admin login
frontend/src/pages/Login.jsx - Authentication state
frontend/src/contexts/AuthContext.jsx - Role guard
frontend/src/components/ProtectedRoute.jsx - Admin dashboard
frontend/src/pages/AdminDashboard.jsx - Report lookup
frontend/src/pages/MyReport.jsx
API and persistence
- Express API
backend/app.js - Admin authentication
backend/routes/auth.js - Report operations
backend/routes/report.js - Report records
backend/models/Report.js
Scoring and reporting
- Domain scoring
backend/utils/scoringHelper.js - Score interpretation
backend/utils/determineScoreRange.js - PDF report
backend/routes/report.js
Other components
- Student
- Administrator
Connections 27
- Student → Route application: uses
Readme.md - Route application → Assessment home: routes to
frontend/src/App.jsx - Route application → Gender selection: routes to
frontend/src/App.jsx - Route application → Personal details: routes to
frontend/src/App.jsx - Route application → Assessment quiz: routes to
frontend/src/App.jsx - Route application → Admin login: routes to
frontend/src/App.jsx - Route application → Admin dashboard: routes to
frontend/src/App.jsx - Route application → Report lookup: routes to
frontend/src/App.jsx - Gender selection → Personal details: renders
frontend/src/pages/GenderSelectionPage.jsx - Personal details → Assessment quiz: continues to
Readme.md - Assessment quiz → Quiz state: reads and updates
frontend/src/pages/QuizPage.jsx - Quiz state → Question bank: loads
frontend/src/contexts/QuizContext.jsx - Assessment quiz → Report operations: submits responses
frontend/src/pages/QuizPage.jsx - Admin login → Authentication state: sets login state
frontend/src/pages/Login.jsx - Role guard → Authentication state: checks role
frontend/src/components/ProtectedRoute.jsx - Route application → Role guard: protects admin
frontend/src/App.jsx - Administrator → Admin dashboard: uses
Readme.md - Admin login → Admin authentication: authenticates
Readme.md - Admin dashboard → Report operations: looks up and downloads
Readme.md - Student → Report lookup: requests report
Readme.md - Report lookup → Report operations: looks up and downloads
Readme.md - Express API → Report operations: mounts
backend/app.js - Express API → Admin authentication: mounts
backend/app.js - Report operations → Domain scoring: calculates domains
backend/routes/report.js - Domain scoring → Score interpretation: classifies scores
backend/utils/scoringHelper.js - Report operations → Report records: saves and queries
backend/routes/report.js - Report operations → PDF report: generates download
backend/routes/report.js