How krish-2466/exam-portal works
QuizVault is a React and Spring Boot assessment platform. Admins create and configure quizzes, author questions manually or with AI, grant access, and inspect attempts; students see eligible live quizzes, start or resume timed attempts, submit answers, and review results and history. The graph shows the documented end-to-end workflow and major capabilities, with backend business and persistence layers. Backend implementation details and AI/PDF wiring were not excerpted, so those documented relationships are represented as unverified dashed links.
Main entry points: controller REST controllers · axiosInstance.js HTTP client · repository JPA repositories · QuizDetails.js Quiz management
Components 33
Web application
- Route application
frontend/src/App.js - Sign in / register
frontend/src/pages/auth/RegisterPage.js - Auth context
frontend/src/context/AuthContext.js - Quiz management
frontend/src/pages/admin/QuizDetails.js - Question editor
frontend/src/pages/admin/QuestionManager.js - Access manager
frontend/src/pages/admin/AccessManager.js - AI generator
frontend/src/pages/admin/AIQuestionGenerator.js - Attempt review
frontend/src/pages/admin/AttemptsList.js - Student quiz flow
frontend/src/pages/student/LiveQuizzes.js - Timed quiz
frontend/src/pages/student/TakeQuiz.js - Results and history
frontend/src/pages/student/QuizResult.js - Auth API client
frontend/src/api/authApi.js - Admin API clients
frontend/src/api/adminQuizApi.js - Access API client
frontend/src/api/adminAccessApi.js - AI API client
frontend/src/api/adminAiApi.js - Attempt API client
frontend/src/api/adminAttemptApi.js - Student API client
frontend/src/api/studentApi.js - HTTP client
frontend/src/api/axiosInstance.js
API and domain
- REST controllers
backend/src/main/java/com/example/backend/controller - Quiz service
backend/src/main/java/com/example/backend/service/QuizService.java - Question service
backend/src/main/java/com/example/backend/service/QuestionService.java - Quiz access service
backend/src/main/java/com/example/backend/service/QuizAccessService.java - AI question service
backend/src/main/java/com/example/backend/service/AIQuestionService.java - Student quiz service
backend/src/main/java/com/example/backend/service/StudentQuizService.java - Attempt service
backend/src/main/java/com/example/backend/service/AttemptService.java
Identity and security
- Authentication service
backend/src/main/java/com/example/backend/service/AuthService.java - JWT security
backend/src/main/java/com/example/backend/security/JwtAuthFilter.java
Persistence
- JPA repositories
backend/src/main/java/com/example/backend/repository - PostgreSQL
backend/src/main/java/com/example/backend/entity
Other components
- Instructor
- Student
- Groq LLM
- PDF text extraction
Connections 44
- Route application → Auth context: provides auth
frontend/src/App.js - Route application → Sign in / register: routes to
frontend/src/App.js - Route application → Quiz management: routes to
frontend/src/App.js - Route application → Student quiz flow: routes to
frontend/src/App.js - Instructor → Quiz management: manages quizzes
README.md - Student → Student quiz flow: accesses quizzes
README.md - Sign in / register → Auth API client: submits credentials
frontend/src/pages/auth/RegisterPage.js - Sign in / register → Auth context: stores session
frontend/src/pages/auth/RegisterPage.js - Auth API client → HTTP client: sends requests
frontend/src/api/authApi.js - Quiz management → Admin API clients: loads and updates
frontend/src/pages/admin/QuizDetails.js - Quiz management → Question editor: renders
frontend/src/pages/admin/QuizDetails.js - Quiz management → Access manager: renders
frontend/src/pages/admin/QuizDetails.js - Quiz management → Attempt review: renders
frontend/src/pages/admin/QuizDetails.js - Question editor → Admin API clients: manages questions
frontend/src/pages/admin/QuestionManager.js - Question editor → AI generator: renders
frontend/src/pages/admin/QuestionManager.js - AI generator → AI API client: requests generation
frontend/src/pages/admin/AIQuestionGenerator.js - Access manager → Access API client: grants and revokes
frontend/src/pages/admin/AccessManager.js - Attempt review → Attempt API client: loads attempts
frontend/src/pages/admin/AttemptsList.js - Student quiz flow → Student API client: loads live quizzes
frontend/src/pages/student/LiveQuizzes.js - Timed quiz → Student API client: starts and submits
frontend/src/api/studentApi.js - Results and history → Student API client: loads attempt detail
- Admin API clients → HTTP client: sends requests
frontend/src/api/adminQuizApi.js - Access API client → HTTP client: sends requests
frontend/src/api/adminAccessApi.js - AI API client → HTTP client: sends requests
frontend/src/api/adminAiApi.js - Attempt API client → HTTP client: sends requests
frontend/src/api/adminAttemptApi.js - Student API client → HTTP client: sends requests
frontend/src/api/studentApi.js - HTTP client → REST controllers: calls REST endpoints
README.md - REST controllers → Authentication service: delegates auth
- REST controllers → Quiz service: delegates quiz ops
- REST controllers → Question service: delegates question ops
- REST controllers → Quiz access service: delegates access ops
- REST controllers → AI question service: delegates generation
- REST controllers → Student quiz service: delegates student flow
- REST controllers → Attempt service: delegates reviews
- JWT security → Authentication service: resolves identity
- Authentication service → JPA repositories: uses user data
- Quiz service → JPA repositories: uses quiz data
- Question service → JPA repositories: uses question data
- Quiz access service → JPA repositories: uses access data
- AI question service → Groq LLM: generates questions
README.md - AI question service → PDF text extraction: extracts PDF text
README.md - Student quiz service → JPA repositories: uses quiz and access data
- Attempt service → JPA repositories: uses attempt data
- JPA repositories → PostgreSQL: persists domain data
README.md