How praveen10123e/mock-interview-platform works
Naan Mudhalvan is a mock-interview and technical-assessment platform. A student authenticates, selects an assessment, completes timed aptitude, coding, and HR stages, then receives an evidence-based report and learning assistance. The frontend reaches backend services through the API gateway; the interview service coordinates session stages, question retrieval, and reporting, while the judge service executes code. The README also describes faculty/admin management and course recommendations. Internal links below are limited to relationships shown in excerpts, the source index, or README; unsampled integrations are not asserted.
Main entry points: interviewSessionRoutes.ts Session routes · GatewayController.ts API gateway · App.tsx Web application · ReportService.ts Report synthesis
Components 22
Student and portal
- Web application
apps/frontend/src/App.tsx - Interview experience
apps/frontend/src/features/interview/pages/InterviewSession.tsx - Practice workspaces
apps/frontend/src/features/practice/pages/CodingWorkspace.tsx - Faculty and admin
apps/frontend/src/pages/faculty/FacultyReports.tsx
API access
- API gateway
apps/backend/gateway/src/controllers/GatewayController.ts
Assessment services
- Session routes
apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts - Session orchestration
apps/backend/services/interview-service/src/services/InterviewSessionService.ts - Aptitude stage
apps/backend/services/interview-service/src/services/AptitudeService.ts - Coding evidence
apps/backend/services/interview-service/src/services/CodingEvidenceService.ts - HR interview
apps/backend/services/interview-service/src/services/HRInterviewService.ts - Report synthesis
apps/backend/services/interview-service/src/services/ReportService.ts - Report analysis
apps/backend/services/interview-service/src/services/ReportAnalysisService.ts - Learning assistant
apps/backend/services/interview-service/src/services/ReportChatService.ts - Course recommendations
apps/backend/services/interview-service/src/services/ReportAnalysisService.ts
Identity and content
- Authentication
apps/backend/services/auth-service/src/services/AuthenticationService.ts - Profiles and users
apps/backend/services/user-service/src/services/AdminUserService.ts - Question bank
apps/backend/services/question-bank-service/src/services/QuestionManagementService.ts
Execution and AI
- Code execution API
apps/backend/services/judge-service/src/controllers/ExecutionController.ts - Execution engine
apps/backend/services/judge-service/src/services/execution/ExecutionEngine.ts - Test case runner
apps/backend/services/judge-service/src/services/execution/TestCaseRunner.ts - AI provider integrations
packages/ai/src/factory.ts
Other components
- Student
Connections 26
- Student → Web application: uses
README.md - Web application → API gateway: HTTP requests
README.md - API gateway → Authentication: routes requests
README.md - API gateway → Profiles and users: routes requests
README.md - API gateway → Session routes: routes requests
README.md - API gateway → Question bank: routes requests
README.md - API gateway → Code execution API: routes requests
README.md - Web application → Interview experience: routes to
- Web application → Practice workspaces: routes to
- Web application → Faculty and admin: routes to
- Session routes → Session orchestration: calls
apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts - Session routes → Aptitude stage: calls
apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts - Session routes → Coding evidence: calls
apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts - Session routes → HR interview: calls
apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts - Session routes → Report synthesis: calls
apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts - Session routes → Learning assistant: calls
apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts - Session orchestration → Question bank: fetches questions
apps/backend/services/interview-service/src/services/InterviewSessionService.ts - Report synthesis → Session orchestration: reads session
apps/backend/services/interview-service/src/services/ReportService.ts - Report synthesis → Report analysis: uses analysis
apps/backend/services/interview-service/src/services/ReportService.ts - Learning assistant → Report analysis: uses analysis
apps/backend/services/interview-service/src/services/ReportChatService.ts - Coding evidence → Code execution API: submits execution
- Code execution API → Execution engine: dispatches
- Execution engine → Test case runner: runs cases
apps/backend/services/judge-service/src/services/execution/ExecutionEngine.ts - Report analysis → Course recommendations: informs suggestions
README.md - Learning assistant → AI provider integrations: uses AI
- HR interview → AI provider integrations: uses AI