How kunalsolanki01/mockmateai works
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: index.ts AI service exports · app.ts Route assembly · App.tsx Web app · api.ts API client
Components 32
Candidate experience
- Web app
frontend/src/App.tsx - Auth state
frontend/src/context/AuthContext.tsx - Interview experience
frontend/src/pages/LiveInterviewPage.tsx - Dashboard and reports
frontend/src/pages/DashboardPage.tsx - API client
frontend/src/services/api.ts
Application backend
- HTTP server
backend/src/server.ts - Route assembly
backend/src/app.ts - Authentication routes
backend/src/routes/auth.routes.ts - Interview routes
backend/src/routes/interview.routes.ts - Behavioral routes
backend/src/routes/behavioral.routes.ts - Coding routes
backend/src/routes/coding.routes.ts - Interview handling
backend/src/controllers/interview.controller.ts - Behavioral analysis handling
backend/src/controllers/behavioral.controller.ts - Coding challenge handling
backend/src/controllers/coding.controller.ts - Request authentication
backend/src/middlewares/auth.ts - Account service
backend/src/services/auth.service.ts - Code execution
backend/src/services/code-runner.service.ts
AI services
- AI service exports
ai-services/src/index.ts - Question generation
ai-services/src/services/question-generator/index.ts - Interview evaluation
ai-services/src/services/evaluation-engine/index.ts - Resume parsing
ai-services/src/services/resume-parser/index.ts - Job description analysis
ai-services/src/services/jd-analyzer/index.ts - Resume-job matching
ai-services/src/services/resume-jd-matcher/index.ts - Company-context retrieval
ai-services/src/services/rag-pipeline/index.ts - Company interview packs
ai-services/src/services/company-pack-engine/index.ts - Speech transcription
ai-services/src/services/speech-to-text/index.ts - Interview analytics
ai-services/src/services/analytics-engine/index.ts
Data and integrations
- LLM provider client
ai-services/src/llm/client.ts - Supabase auth and data
backend/src/config/supabase.ts
Other components
- Candidate
- LLM providers
- Code execution provider
Connections 36
- Candidate → Web app: uses
frontend/src/App.tsx - Web app → Auth state: provides auth
frontend/src/App.tsx - Web app → Interview experience: routes to
frontend/src/App.tsx - Web app → Dashboard and reports: routes to
frontend/src/App.tsx - Auth state → API client: calls
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
backend/src/server.ts - Route assembly → Authentication routes: mounts
backend/src/app.ts - Route assembly → Interview routes: mounts
backend/src/app.ts - Route assembly → Behavioral routes: mounts
backend/src/app.ts - Route assembly → Coding routes: mounts
backend/src/app.ts - Authentication routes → Account service: dispatches
- Interview routes → Interview handling: dispatches
backend/src/routes/interview.routes.ts - Behavioral routes → Behavioral analysis handling: dispatches
backend/src/routes/behavioral.routes.ts - Coding routes → Coding challenge handling: dispatches
backend/src/routes/coding.routes.ts - Interview handling → Request authentication: uses
backend/src/controllers/interview.controller.ts - Coding challenge handling → Code execution: executes code
backend/src/controllers/coding.controller.ts - Coding challenge handling → AI service exports: generates challenge
backend/src/controllers/coding.controller.ts - Request authentication → Account service: verifies token
backend/src/middlewares/auth.ts - Account service → Supabase auth and data: uses auth clients
backend/src/services/auth.service.ts - Code execution → Code execution provider: may delegate
- AI service exports → Question generation: exports
ai-services/src/index.ts - AI service exports → Interview evaluation: exports
ai-services/src/index.ts - AI service exports → Resume parsing: exports
ai-services/src/index.ts - AI service exports → Job description analysis: exports
ai-services/src/index.ts - AI service exports → Resume-job matching: exports
ai-services/src/index.ts - AI service exports → Company-context retrieval: exports
ai-services/src/index.ts - AI service exports → Company interview packs: exports
ai-services/src/index.ts - AI service exports → Speech transcription: exports
ai-services/src/index.ts - AI service exports → Interview analytics: exports
ai-services/src/index.ts - Question generation → Company-context retrieval: retrieves context
ai-services/src/services/question-generator/index.ts - Question generation → LLM provider client: generates questions
ai-services/src/services/question-generator/index.ts - Interview evaluation → LLM provider client: requests completion
ai-services/src/services/evaluation-engine/index.ts - LLM provider client → LLM providers: calls provider
ai-services/src/llm/client.ts