# kunalsolanki01/mockmateai architecture

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

- Interactive diagram: https://gitdiagram.com/kunalsolanki01/mockmateai
- Repository: https://github.com/kunalsolanki01/mockmateai

## Overview

MockMate AI is a full-stack mock-interview platform: candidates authenticate, prepare and take interview or coding sessions, then review reports and progress. The frontend presents these workflows; the Express backend routes requests to domain handlers; AI services provide question generation, evaluation, resume/JD analysis, company context, speech transcription, and analytics. The README documents broader capabilities, but many implementation paths were not sampled, so those branches and cross-workspace calls are shown only where documented or marked unverified.

Main entry points: [`ai-services/src/index.ts`](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/index.ts) (AI service exports), [`backend/src/app.ts`](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/app.ts) (Route assembly), [`frontend/src/App.tsx`](https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/App.tsx) (Web app), [`frontend/src/services/api.ts`](https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/services/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Candidate experience"]
  node_webapp["Web app<br/>[App.tsx]"]
  node_authstate["Auth state<br/>[AuthContext.tsx]"]
  node_interviewui["Interview experience"]
  node_dashboard["Dashboard and reports<br/>[DashboardPage.tsx]"]
  node_frontendapi["API client<br/>[api.ts]"]
end

subgraph group_backend["Application backend"]
  node_server["HTTP server<br/>[server.ts]"]
  node_app["Route assembly<br/>[app.ts]"]
  node_authroutes["Authentication routes<br/>[auth.routes.ts]"]
  node_interviewroutes["Interview routes"]
  node_behavioralroutes["Behavioral routes"]
  node_codingroutes["Coding routes<br/>[coding.routes.ts]"]
  node_interviewcontroller["Interview handling"]
  node_behavioralcontroller["Behavioral analysis handling"]
  node_codingcontroller["Coding challenge handling"]
  node_authmiddleware["Request authentication<br/>[auth.ts]"]
  node_authservice["Account service<br/>[auth.service.ts]"]
  node_coderunner["Code execution"]
end

subgraph group_ai["AI services"]
  node_aiindex["AI service exports<br/>[index.ts]"]
  node_questiongen["Question generation<br/>[index.ts]"]
  node_evaluation["Interview evaluation<br/>[index.ts]"]
  node_resumeparser["Resume parsing<br/>[index.ts]"]
  node_jdanalyzer["Job description analysis<br/>[index.ts]"]
  node_matching["Resume-job matching<br/>[index.ts]"]
  node_rag["Company-context retrieval<br/>[index.ts]"]
  node_companypacks["Company interview packs<br/>[index.ts]"]
  node_speech["Speech transcription<br/>[index.ts]"]
  node_analytics["Interview analytics<br/>[index.ts]"]
end

subgraph group_integrations["Data and integrations"]
  node_llm["LLM provider client<br/>[client.ts]"]
  node_supabase[("Supabase auth and data<br/>[supabase.ts]")]
end

node_candidate(("Candidate"))
node_externalmodels{{"LLM providers"}}
node_codeexecution{{"Code execution provider"}}

node_candidate -->|"uses"| node_webapp
node_webapp -->|"provides auth"| node_authstate
node_webapp -->|"routes to"| node_interviewui
node_webapp -->|"routes to"| node_dashboard
node_authstate -->|"calls"| node_frontendapi
node_interviewui -.->|"requests data"| node_frontendapi
node_dashboard -.->|"requests data"| node_frontendapi
node_frontendapi -.->|"sends requests"| node_app
node_server -->|"creates"| node_app
node_app -->|"mounts"| node_authroutes
node_app -->|"mounts"| node_interviewroutes
node_app -->|"mounts"| node_behavioralroutes
node_app -->|"mounts"| node_codingroutes
node_authroutes -.->|"dispatches"| node_authservice
node_interviewroutes -->|"dispatches"| node_interviewcontroller
node_behavioralroutes -->|"dispatches"| node_behavioralcontroller
node_codingroutes -->|"dispatches"| node_codingcontroller
node_interviewcontroller -->|"uses"| node_authmiddleware
node_codingcontroller -->|"executes code"| node_coderunner
node_codingcontroller -->|"generates challenge"| node_aiindex
node_authmiddleware -->|"verifies token"| node_authservice
node_authservice -->|"uses auth clients"| node_supabase
node_coderunner -.->|"may delegate"| node_codeexecution
node_aiindex -->|"exports"| node_questiongen
node_aiindex -->|"exports"| node_evaluation
node_aiindex -->|"exports"| node_resumeparser
node_aiindex -->|"exports"| node_jdanalyzer
node_aiindex -->|"exports"| node_matching
node_aiindex -->|"exports"| node_rag
node_aiindex -->|"exports"| node_companypacks
node_aiindex -->|"exports"| node_speech
node_aiindex -->|"exports"| node_analytics
node_questiongen -->|"retrieves context"| node_rag
node_questiongen -->|"generates questions"| node_llm
node_evaluation -->|"requests completion"| node_llm
node_llm -->|"calls provider"| node_externalmodels

click node_webapp "https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/App.tsx"
click node_authstate "https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/context/AuthContext.tsx"
click node_interviewui "https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/pages/LiveInterviewPage.tsx"
click node_dashboard "https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/pages/DashboardPage.tsx"
click node_frontendapi "https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/services/api.ts"
click node_server "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/server.ts"
click node_app "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/app.ts"
click node_authroutes "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/routes/auth.routes.ts"
click node_interviewroutes "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/routes/interview.routes.ts"
click node_behavioralroutes "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/routes/behavioral.routes.ts"
click node_codingroutes "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/routes/coding.routes.ts"
click node_interviewcontroller "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/controllers/interview.controller.ts"
click node_behavioralcontroller "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/controllers/behavioral.controller.ts"
click node_codingcontroller "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/controllers/coding.controller.ts"
click node_authmiddleware "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/middlewares/auth.ts"
click node_authservice "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/services/auth.service.ts"
click node_coderunner "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/services/code-runner.service.ts"
click node_aiindex "https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/index.ts"
click node_questiongen "https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/question-generator/index.ts"
click node_evaluation "https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/evaluation-engine/index.ts"
click node_resumeparser "https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/resume-parser/index.ts"
click node_jdanalyzer "https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/jd-analyzer/index.ts"
click node_matching "https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/resume-jd-matcher/index.ts"
click node_rag "https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/rag-pipeline/index.ts"
click node_companypacks "https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/company-pack-engine/index.ts"
click node_speech "https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/speech-to-text/index.ts"
click node_analytics "https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/analytics-engine/index.ts"
click node_llm "https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/llm/client.ts"
click node_supabase "https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/config/supabase.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_webapp,node_authstate,node_interviewui,node_dashboard,node_frontendapi toneBlue
class node_server,node_app,node_authroutes,node_interviewroutes,node_behavioralroutes,node_codingroutes,node_interviewcontroller,node_behavioralcontroller,node_codingcontroller,node_authmiddleware,node_authservice,node_coderunner toneAmber
class node_aiindex,node_questiongen,node_evaluation,node_resumeparser,node_jdanalyzer,node_matching,node_rag,node_companypacks,node_speech,node_analytics toneMint
class node_llm,node_supabase toneRose
class node_candidate,node_externalmodels,node_codeexecution toneIndigo
```

## Components

### Candidate experience

- [Web app](https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth state](https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Interview experience](https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/pages/LiveInterviewPage.tsx): `frontend/src/pages/LiveInterviewPage.tsx`
- [Dashboard and reports](https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/pages/DashboardPage.tsx): `frontend/src/pages/DashboardPage.tsx`
- [API client](https://github.com/kunalsolanki01/mockmateai/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Application backend

- [HTTP server](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [Route assembly](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Authentication routes](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/routes/auth.routes.ts): `backend/src/routes/auth.routes.ts`
- [Interview routes](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/routes/interview.routes.ts): `backend/src/routes/interview.routes.ts`
- [Behavioral routes](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/routes/behavioral.routes.ts): `backend/src/routes/behavioral.routes.ts`
- [Coding routes](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/routes/coding.routes.ts): `backend/src/routes/coding.routes.ts`
- [Interview handling](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/controllers/interview.controller.ts): `backend/src/controllers/interview.controller.ts`
- [Behavioral analysis handling](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/controllers/behavioral.controller.ts): `backend/src/controllers/behavioral.controller.ts`
- [Coding challenge handling](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/controllers/coding.controller.ts): `backend/src/controllers/coding.controller.ts`
- [Request authentication](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/middlewares/auth.ts): `backend/src/middlewares/auth.ts`
- [Account service](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/services/auth.service.ts): `backend/src/services/auth.service.ts`
- [Code execution](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/services/code-runner.service.ts): `backend/src/services/code-runner.service.ts`

### AI services

- [AI service exports](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/index.ts): `ai-services/src/index.ts`
- [Question generation](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/question-generator/index.ts): `ai-services/src/services/question-generator/index.ts`
- [Interview evaluation](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/evaluation-engine/index.ts): `ai-services/src/services/evaluation-engine/index.ts`
- [Resume parsing](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/resume-parser/index.ts): `ai-services/src/services/resume-parser/index.ts`
- [Job description analysis](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/jd-analyzer/index.ts): `ai-services/src/services/jd-analyzer/index.ts`
- [Resume-job matching](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/resume-jd-matcher/index.ts): `ai-services/src/services/resume-jd-matcher/index.ts`
- [Company-context retrieval](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/rag-pipeline/index.ts): `ai-services/src/services/rag-pipeline/index.ts`
- [Company interview packs](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/company-pack-engine/index.ts): `ai-services/src/services/company-pack-engine/index.ts`
- [Speech transcription](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/speech-to-text/index.ts): `ai-services/src/services/speech-to-text/index.ts`
- [Interview analytics](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/services/analytics-engine/index.ts): `ai-services/src/services/analytics-engine/index.ts`

### Data and integrations

- [LLM provider client](https://github.com/kunalsolanki01/mockmateai/blob/main/ai-services/src/llm/client.ts): `ai-services/src/llm/client.ts`
- [Supabase auth and data](https://github.com/kunalsolanki01/mockmateai/blob/main/backend/src/config/supabase.ts): `backend/src/config/supabase.ts`

### Other components

- **Candidate**
- **LLM providers**
- **Code execution provider**

## Connections

- Candidate → Web app: uses (evidence: `frontend/src/App.tsx`)
- Web app → Auth state: provides auth (evidence: `frontend/src/App.tsx`)
- Web app → Interview experience: routes to (evidence: `frontend/src/App.tsx`)
- Web app → Dashboard and reports: routes to (evidence: `frontend/src/App.tsx`)
- Auth state → API client: calls (evidence: `frontend/src/context/AuthContext.tsx`)
- Interview experience → API client: requests data
- Dashboard and reports → API client: requests data
- API client → Route assembly: sends requests
- HTTP server → Route assembly: creates (evidence: `backend/src/server.ts`)
- Route assembly → Authentication routes: mounts (evidence: `backend/src/app.ts`)
- Route assembly → Interview routes: mounts (evidence: `backend/src/app.ts`)
- Route assembly → Behavioral routes: mounts (evidence: `backend/src/app.ts`)
- Route assembly → Coding routes: mounts (evidence: `backend/src/app.ts`)
- Authentication routes → Account service: dispatches
- Interview routes → Interview handling: dispatches (evidence: `backend/src/routes/interview.routes.ts`)
- Behavioral routes → Behavioral analysis handling: dispatches (evidence: `backend/src/routes/behavioral.routes.ts`)
- Coding routes → Coding challenge handling: dispatches (evidence: `backend/src/routes/coding.routes.ts`)
- Interview handling → Request authentication: uses (evidence: `backend/src/controllers/interview.controller.ts`)
- Coding challenge handling → Code execution: executes code (evidence: `backend/src/controllers/coding.controller.ts`)
- Coding challenge handling → AI service exports: generates challenge (evidence: `backend/src/controllers/coding.controller.ts`)
- Request authentication → Account service: verifies token (evidence: `backend/src/middlewares/auth.ts`)
- Account service → Supabase auth and data: uses auth clients (evidence: `backend/src/services/auth.service.ts`)
- Code execution → Code execution provider: may delegate
- AI service exports → Question generation: exports (evidence: `ai-services/src/index.ts`)
- AI service exports → Interview evaluation: exports (evidence: `ai-services/src/index.ts`)
- AI service exports → Resume parsing: exports (evidence: `ai-services/src/index.ts`)
- AI service exports → Job description analysis: exports (evidence: `ai-services/src/index.ts`)
- AI service exports → Resume-job matching: exports (evidence: `ai-services/src/index.ts`)
- AI service exports → Company-context retrieval: exports (evidence: `ai-services/src/index.ts`)
- AI service exports → Company interview packs: exports (evidence: `ai-services/src/index.ts`)
- AI service exports → Speech transcription: exports (evidence: `ai-services/src/index.ts`)
- AI service exports → Interview analytics: exports (evidence: `ai-services/src/index.ts`)
- Question generation → Company-context retrieval: retrieves context (evidence: `ai-services/src/services/question-generator/index.ts`)
- Question generation → LLM provider client: generates questions (evidence: `ai-services/src/services/question-generator/index.ts`)
- Interview evaluation → LLM provider client: requests completion (evidence: `ai-services/src/services/evaluation-engine/index.ts`)
- LLM provider client → LLM providers: calls provider (evidence: `ai-services/src/llm/client.ts`)
