How rahulshah1256/examportal-application works
ExamPortal is a multi-role online examination and assessment platform. The main learner journey is to authenticate, browse and start a quiz, take it under server-managed session/proctoring, and review results; instructors also create and manage quiz content. The repository adds question-bank workflows, coding assessments, AI assistance, analytics, community discussion, and notifications. The excerpts show selected service calls and routing; other connections below are documented product-level flows, not claims that every unsampled implementation path was inspected.
Main entry points: App.jsx React application · CodingJudgeService.java Coding judge · QuestionBankService.java Question bank · AiQuestionGenerationService.java AI question generation
Components 27
Web client
- React application
ExamPortal-Frontend-React/src/App.jsx - Login flow
ExamPortal-Frontend-React/src/pages/auth/useLogin.js - Live exam UI
ExamPortal-Frontend-React/src/features/exam/LiveExamPage.tsx - Question-bank UI
ExamPortal-Frontend-React/src/features/questionbank/QuestionBankPage.tsx - Coding assessment UI
ExamPortal-Frontend-React/src/features/coding/CodingProblemDetailPage.tsx - AI assistant UI
ExamPortal-Frontend-React/src/features/ai/AiAssistantPage.tsx
Quiz delivery
- Exam API
ExamPortal-Backend/examserver/src/main/java/com/exam/ExamserverApplication.java - Quiz and result APIs
ExamPortal-Backend/examserver/src/main/java/com/exam/controller/QuizController.java - Quiz and result services
ExamPortal-Backend/examserver/src/main/java/com/exam/service/impl/QuizServiceImpl.java - Quiz data
ExamPortal-Backend/examserver/src/main/java/com/exam/model/exam/Quiz.java - Realtime exam sessions
ExamPortal-Backend/examserver/src/main/java/com/exam/realtime/service/ExamSessionService.java
Assessment authoring
- Question bank
ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionBankService.java - Question CSV
ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionCsvService.java - Question-bank data
ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/model/BankQuestion.java
Assessment extensions
- Coding judge
ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingJudgeService.java - Problem management
ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingProblemService.java - Execution engine
ExamPortal-Backend/examserver/src/main/java/com/exam/coding/judge/SimulatedExecutionEngine.java - AI question generation
ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiQuestionGenerationService.java - AI gateway
ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiGateway.java - Analytics
ExamPortal-Backend/examserver/src/main/java/com/exam/analytics/service/AnalyticsService.java - Coding discussions
ExamPortal-Backend/examserver/src/main/java/com/exam/community/service/CommunityService.java
Platform services
- JWT and refresh auth
ExamPortal-Backend/examserver/src/main/java/com/exam/auth/service/RefreshTokenService.java - User and token data
ExamPortal-Backend/examserver/src/main/java/com/exam/auth/repo/RefreshTokenRepository.java - Notifications
ExamPortal-Backend/examserver/src/main/java/com/exam/notification/service/NotificationService.java - Relational database
Other components
- Learner / instructor
- AI provider
Connections 25
- Learner / instructor → React application: uses
README.md - React application → Login flow: routes to
ExamPortal-Frontend-React/src/App.jsx - Login flow → JWT and refresh auth: authenticates
- React application → Live exam UI: routes to
ExamPortal-Frontend-React/src/App.jsx - Live exam UI → Realtime exam sessions: exchanges session events
- React application → Exam API: uses API
- Exam API → Quiz and result APIs: routes requests
- Quiz and result APIs → Quiz and result services: delegates
- Quiz and result services → Quiz data: manages quiz data
- Realtime exam sessions → Relational database: persists sessions
- JWT and refresh auth → User and token data: uses token repository
ExamPortal-Backend/examserver/src/main/java/com/exam/auth/service/RefreshTokenService.java - Question-bank UI → Question bank: manages questions
- Question bank → Question-bank data: creates and reviews
ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionBankService.java - Question CSV → Question bank: imports questions
ExamPortal-Backend/examserver/src/main/java/com/exam/questionbank/service/QuestionCsvService.java - Coding assessment UI → Coding judge: submits code
- Coding judge → Problem management: loads problem
ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingJudgeService.java - Coding judge → Execution engine: executes test cases
ExamPortal-Backend/examserver/src/main/java/com/exam/coding/service/CodingJudgeService.java - Coding judge → Relational database: stores submissions
- AI assistant UI → AI question generation: requests generation
- AI question generation → AI gateway: requests completion
ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiQuestionGenerationService.java - AI question generation → Question bank: persists draft
ExamPortal-Backend/examserver/src/main/java/com/exam/ai/service/AiQuestionGenerationService.java - AI gateway → AI provider: calls provider
- Analytics → Relational database: reads assessment data
- Coding discussions → Notifications: notifies reply author
ExamPortal-Backend/examserver/src/main/java/com/exam/community/service/CommunityService.java - Notifications → Relational database: stores notifications