How mp-team58/assessmate works
AssessMate is an assessment platform for hosts to create and manage exams, and candidates to join, complete, and review them. The frontend routes host and candidate workflows through a shared API client to a Spring backend. Backend services cover authentication, exam/question authoring, AI-assisted generation, coding evaluation, candidate submissions, proctoring, results, and analytics. The shown source supports several service-to-dependency links; other major capabilities are retained from the repository tree but their internal calls were not sampled, so those relationships are not asserted.
Main entry points: App.jsx Role-based routes · apiClient.js HTTP API client · AIQuestionService.java AI question generation · AuthService.java Authentication service
Components 24
Web application
- Role-based routes
frontend/src/App.jsx - HTTP API client
frontend/src/services/apiClient.js - Sign-in and signup
frontend/src/pages/Login.jsx - Host exam workflows
frontend/src/pages/CreateExam.jsx - Question authoring UI
frontend/src/pages/ExamQuestions.jsx - Candidate exam room
frontend/src/pages/ActiveExam.jsx
Identity and access
- Authentication service
backend/src/main/java/com/assessmate/service/AuthService.java - JWT security
backend/src/main/java/com/assessmate/security - User persistence
backend/src/main/java/com/assessmate/repository/UserRepository.java
Exam authoring
- Exam question endpoints
backend/src/main/java/com/assessmate/controller/ExamQuestionController.java - AI question generation
backend/src/main/java/com/assessmate/service/AIQuestionService.java - Gemini integration
backend/src/main/java/com/assessmate/service/GeminiService.java - Source file processing
backend/src/main/java/com/assessmate/service/FileProcessingService.java - Exam and question model
backend/src/main/java/com/assessmate/entity - Spreadsheet import
backend/src/main/java/com/assessmate/service/ExcelService.java
Assessment runtime
- Candidate workflow
backend/src/main/java/com/assessmate/service/CandidateService.java - Enrollment persistence
backend/src/main/java/com/assessmate/repository/ExamEnrollmentRepository.java - Coding assessments
backend/src/main/java/com/assessmate/service/CodingQuestionService.java - Code execution
backend/src/main/java/com/assessmate/service/Judge0Service.java
Monitoring and results
- Proctoring workflows
backend/src/main/java/com/assessmate/service/ProctoringService.java - Host results and analytics
backend/src/main/java/com/assessmate/service/HostResultService.java - Analytics service
backend/src/main/java/com/assessmate/service/AnalyticsService.java
Other components
- Host or candidate
- Assessment API
Connections 26
- Host or candidate → Role-based routes: uses
frontend/src/App.jsx - Role-based routes → Sign-in and signup: routes to
frontend/src/App.jsx - Role-based routes → Host exam workflows: routes to
frontend/src/App.jsx - Role-based routes → Question authoring UI: routes to
frontend/src/App.jsx - Role-based routes → Candidate exam room: routes to
frontend/src/App.jsx - Sign-in and signup → HTTP API client: requests via
- Host exam workflows → HTTP API client: requests via
- Question authoring UI → HTTP API client: requests via
- Candidate exam room → HTTP API client: requests via
- HTTP API client → Assessment API: sends HTTP
frontend/src/services/apiClient.js - Assessment API → Authentication service: dispatches to
- Authentication service → User persistence: reads and writes
backend/src/main/java/com/assessmate/service/AuthService.java - Authentication service → JWT security: creates tokens
backend/src/main/java/com/assessmate/service/AuthService.java - Assessment API → Exam question endpoints: dispatches to
- Exam question endpoints → AI question generation: delegates to
backend/src/main/java/com/assessmate/controller/ExamQuestionController.java - AI question generation → Gemini integration: generates with
backend/src/main/java/com/assessmate/service/AIQuestionService.java - AI question generation → Source file processing: extracts from
backend/src/main/java/com/assessmate/service/AIQuestionService.java - AI question generation → Exam and question model: persists questions
backend/src/main/java/com/assessmate/service/AIQuestionService.java - Assessment API → Candidate workflow: dispatches to
- Candidate workflow → Enrollment persistence: reads and writes
backend/src/main/java/com/assessmate/service/CandidateService.java - Assessment API → Coding assessments: dispatches to
- Coding assessments → Code execution: runs submissions
backend/src/main/java/com/assessmate/service/CodingQuestionService.java - Assessment API → Proctoring workflows: dispatches to
- Assessment API → Host results and analytics: dispatches to
- Assessment API → Analytics service: dispatches to
- Assessment API → Spreadsheet import: dispatches to