# praveen10123e/mock-interview-platform architecture

> Architecture diagram of the GitHub repository praveen10123e/mock-interview-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/praveen10123e/mock-interview-platform
- Repository: https://github.com/praveen10123e/mock-interview-platform

## Overview

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: [`apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts`](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts) (Session routes), [`apps/backend/gateway/src/controllers/GatewayController.ts`](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/gateway/src/controllers/GatewayController.ts) (API gateway), [`apps/frontend/src/App.tsx`](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/frontend/src/App.tsx) (Web application), [`apps/backend/services/interview-service/src/services/ReportService.ts`](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/ReportService.ts) (Report synthesis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Student and portal"]
  node_frontend["Web application<br/>[App.tsx]"]
  node_interview_ui["Interview experience"]
  node_practice_ui["Practice workspaces"]
  node_faculty_admin["Faculty and admin<br/>[FacultyReports.tsx]"]
end

subgraph group_edge["API access"]
  node_gateway["API gateway"]
end

subgraph group_assessment["Assessment services"]
  node_session_routes["Session routes"]
  node_session_engine["Session orchestration"]
  node_aptitude["Aptitude stage<br/>[AptitudeService.ts]"]
  node_coding_evidence["Coding evidence"]
  node_hr_interview["HR interview"]
  node_report["Report synthesis<br/>[ReportService.ts]"]
  node_report_analysis["Report analysis"]
  node_report_chat["Learning assistant"]
  node_course_recommendations["Course recommendations"]
end

subgraph group_support["Identity and content"]
  node_auth["Authentication"]
  node_users["Profiles and users"]
  node_question_bank[("Question bank")]
end

subgraph group_shared["Execution and AI"]
  node_judge["Code execution API"]
  node_execution_engine["Execution engine<br/>[ExecutionEngine.ts]"]
  node_test_runner["Test case runner<br/>[TestCaseRunner.ts]"]
  node_ai["AI provider integrations<br/>[factory.ts]"]
end

node_student(("Student"))

node_student -->|"uses"| node_frontend
node_frontend -->|"HTTP requests"| node_gateway
node_gateway -->|"routes requests"| node_auth
node_gateway -->|"routes requests"| node_users
node_gateway -->|"routes requests"| node_session_routes
node_gateway -->|"routes requests"| node_question_bank
node_gateway -->|"routes requests"| node_judge
node_frontend -->|"routes to"| node_interview_ui
node_frontend -->|"routes to"| node_practice_ui
node_frontend -->|"routes to"| node_faculty_admin
node_session_routes -->|"calls"| node_session_engine
node_session_routes -->|"calls"| node_aptitude
node_session_routes -->|"calls"| node_coding_evidence
node_session_routes -->|"calls"| node_hr_interview
node_session_routes -->|"calls"| node_report
node_session_routes -->|"calls"| node_report_chat
node_session_engine -->|"fetches questions"| node_question_bank
node_report -->|"reads session"| node_session_engine
node_report -->|"uses analysis"| node_report_analysis
node_report_chat -->|"uses analysis"| node_report_analysis
node_coding_evidence -.->|"submits execution"| node_judge
node_judge -.->|"dispatches"| node_execution_engine
node_execution_engine -->|"runs cases"| node_test_runner
node_report_analysis -->|"informs suggestions"| node_course_recommendations
node_report_chat -.->|"uses AI"| node_ai
node_hr_interview -.->|"uses AI"| node_ai

click node_frontend "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/frontend/src/App.tsx"
click node_interview_ui "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/frontend/src/features/interview/pages/InterviewSession.tsx"
click node_practice_ui "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/frontend/src/features/practice/pages/CodingWorkspace.tsx"
click node_faculty_admin "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/frontend/src/pages/faculty/FacultyReports.tsx"
click node_gateway "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/gateway/src/controllers/GatewayController.ts"
click node_auth "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/auth-service/src/services/AuthenticationService.ts"
click node_users "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/user-service/src/services/AdminUserService.ts"
click node_question_bank "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/question-bank-service/src/services/QuestionManagementService.ts"
click node_session_routes "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts"
click node_session_engine "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/InterviewSessionService.ts"
click node_aptitude "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/AptitudeService.ts"
click node_coding_evidence "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/CodingEvidenceService.ts"
click node_hr_interview "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/HRInterviewService.ts"
click node_report "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/ReportService.ts"
click node_report_analysis "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/ReportAnalysisService.ts"
click node_report_chat "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/ReportChatService.ts"
click node_judge "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/judge-service/src/controllers/ExecutionController.ts"
click node_execution_engine "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/judge-service/src/services/execution/ExecutionEngine.ts"
click node_test_runner "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/judge-service/src/services/execution/TestCaseRunner.ts"
click node_ai "https://github.com/praveen10123e/mock-interview-platform/blob/main/packages/ai/src/factory.ts"
click node_course_recommendations "https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/ReportAnalysisService.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_interview_ui,node_practice_ui,node_faculty_admin toneBlue
class node_gateway toneAmber
class node_session_routes,node_session_engine,node_aptitude,node_coding_evidence,node_hr_interview,node_report,node_report_analysis,node_report_chat,node_course_recommendations toneMint
class node_auth,node_users,node_question_bank toneRose
class node_judge,node_execution_engine,node_test_runner,node_ai,node_student toneIndigo
```

## Components

### Student and portal

- [Web application](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/frontend/src/App.tsx): `apps/frontend/src/App.tsx`
- [Interview experience](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/frontend/src/features/interview/pages/InterviewSession.tsx): `apps/frontend/src/features/interview/pages/InterviewSession.tsx`
- [Practice workspaces](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/frontend/src/features/practice/pages/CodingWorkspace.tsx): `apps/frontend/src/features/practice/pages/CodingWorkspace.tsx`
- [Faculty and admin](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/frontend/src/pages/faculty/FacultyReports.tsx): `apps/frontend/src/pages/faculty/FacultyReports.tsx`

### API access

- [API gateway](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/gateway/src/controllers/GatewayController.ts): `apps/backend/gateway/src/controllers/GatewayController.ts`

### Assessment services

- [Session routes](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts): `apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts`
- [Session orchestration](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/InterviewSessionService.ts): `apps/backend/services/interview-service/src/services/InterviewSessionService.ts`
- [Aptitude stage](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/AptitudeService.ts): `apps/backend/services/interview-service/src/services/AptitudeService.ts`
- [Coding evidence](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/CodingEvidenceService.ts): `apps/backend/services/interview-service/src/services/CodingEvidenceService.ts`
- [HR interview](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/HRInterviewService.ts): `apps/backend/services/interview-service/src/services/HRInterviewService.ts`
- [Report synthesis](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/ReportService.ts): `apps/backend/services/interview-service/src/services/ReportService.ts`
- [Report analysis](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/ReportAnalysisService.ts): `apps/backend/services/interview-service/src/services/ReportAnalysisService.ts`
- [Learning assistant](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/ReportChatService.ts): `apps/backend/services/interview-service/src/services/ReportChatService.ts`
- [Course recommendations](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/interview-service/src/services/ReportAnalysisService.ts): `apps/backend/services/interview-service/src/services/ReportAnalysisService.ts`

### Identity and content

- [Authentication](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/auth-service/src/services/AuthenticationService.ts): `apps/backend/services/auth-service/src/services/AuthenticationService.ts`
- [Profiles and users](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/user-service/src/services/AdminUserService.ts): `apps/backend/services/user-service/src/services/AdminUserService.ts`
- [Question bank](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/question-bank-service/src/services/QuestionManagementService.ts): `apps/backend/services/question-bank-service/src/services/QuestionManagementService.ts`

### Execution and AI

- [Code execution API](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/judge-service/src/controllers/ExecutionController.ts): `apps/backend/services/judge-service/src/controllers/ExecutionController.ts`
- [Execution engine](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/judge-service/src/services/execution/ExecutionEngine.ts): `apps/backend/services/judge-service/src/services/execution/ExecutionEngine.ts`
- [Test case runner](https://github.com/praveen10123e/mock-interview-platform/blob/main/apps/backend/services/judge-service/src/services/execution/TestCaseRunner.ts): `apps/backend/services/judge-service/src/services/execution/TestCaseRunner.ts`
- [AI provider integrations](https://github.com/praveen10123e/mock-interview-platform/blob/main/packages/ai/src/factory.ts): `packages/ai/src/factory.ts`

### Other components

- **Student**

## Connections

- Student → Web application: uses (evidence: `README.md`)
- Web application → API gateway: HTTP requests (evidence: `README.md`)
- API gateway → Authentication: routes requests (evidence: `README.md`)
- API gateway → Profiles and users: routes requests (evidence: `README.md`)
- API gateway → Session routes: routes requests (evidence: `README.md`)
- API gateway → Question bank: routes requests (evidence: `README.md`)
- API gateway → Code execution API: routes requests (evidence: `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 (evidence: `apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts`)
- Session routes → Aptitude stage: calls (evidence: `apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts`)
- Session routes → Coding evidence: calls (evidence: `apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts`)
- Session routes → HR interview: calls (evidence: `apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts`)
- Session routes → Report synthesis: calls (evidence: `apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts`)
- Session routes → Learning assistant: calls (evidence: `apps/backend/services/interview-service/src/routes/interviewSessionRoutes.ts`)
- Session orchestration → Question bank: fetches questions (evidence: `apps/backend/services/interview-service/src/services/InterviewSessionService.ts`)
- Report synthesis → Session orchestration: reads session (evidence: `apps/backend/services/interview-service/src/services/ReportService.ts`)
- Report synthesis → Report analysis: uses analysis (evidence: `apps/backend/services/interview-service/src/services/ReportService.ts`)
- Learning assistant → Report analysis: uses analysis (evidence: `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 (evidence: `apps/backend/services/judge-service/src/services/execution/ExecutionEngine.ts`)
- Report analysis → Course recommendations: informs suggestions (evidence: `README.md`)
- Learning assistant → AI provider integrations: uses AI
- HR interview → AI provider integrations: uses AI
