How vishesh233/interviewpilot works
InterviewPilot turns a job description into a saved, editable interview-preparation kit, then supports studying and practicing from it. The principal workflow runs through authenticated browser requests, background generation jobs, staged preparation, and MongoDB persistence; the frontend polls jobs and presents the resulting kit. Distinct stages include requirement extraction, company research, question generation, coverage and gap filling, and schedule creation. The README also documents optional resume matching, answer feedback, and mock interviews. Some subsystem paths are present in the tree but their implementation was not sampled, so those capabilities are shown without inferred internal call edges.
Main entry points: server.js Express API · interviewPrepPipelineService.js Prep pipeline · InterviewPrepKit.js Interview kits · layout.js InterviewPilot UI
Components 30
Web app
- InterviewPilot UI
frontend/app/layout.js - New kit form
frontend/components/kit/NewKitForm.js - Job polling
frontend/components/jobs/useJobPolling.js - Kit workspace
frontend/components/kit/KitWorkspace.js - Study views
frontend/components/questions/QuestionsPanel.js - Practice modes
frontend/components/practice/PracticeMode.js
API and jobs
- Express API
backend/src/server.js - Kit routes
backend/src/routes/interviewPrepKitsRoutes.js - Job routes
backend/src/routes/generationJobRoutes.js - Kit controllers
backend/src/controllers/interviewPrepKitsController.js - Builder controller
backend/src/controllers/interviewPrepKitBuilderController.js - Job controller
backend/src/controllers/generationJobsController.js - Generation job runner
backend/src/services/generationJobService.js
Kit generation
- Prep pipeline
backend/src/services/interviewPrepPipelineService.js - Requirement extraction
backend/src/services/requirementExtractionService.js - Company research
backend/src/services/companyResearchPipelineService.js - Company brief
backend/src/services/companyBriefService.js - Question generation
backend/src/services/questionGenerationService.js - Coverage and gap fill
backend/src/services/coverageService.js - Gap filling
backend/src/services/gapFillService.js - Study schedule
backend/src/services/scheduleService.js - Resume matching
backend/src/services/resumeMatchService.js
Kit and practice
- Kit shaping and validation
backend/src/services/kitBuilderService.js - Answer feedback
backend/src/services/answerFeedbackService.js - Mock interviews
backend/src/services/mockInterviewService.js
Persistence and AI
- Interview kits
backend/src/models/InterviewPrepKit.js - Generation jobs
backend/src/models/GenerationJob.js - Gemini model adapter
backend/src/services/geminiClient.js
Other components
- Job seeker
- MongoDB
Connections 37
- Job seeker → InterviewPilot UI: uses
README.md - InterviewPilot UI → New kit form: starts kit
README.md - New kit form → Express API: submits request
README.md - InterviewPilot UI → Express API: calls API
README.md - Express API → Kit routes: mounts routes
backend/src/server.js - Express API → Job routes: mounts routes
backend/src/server.js - Kit routes → Kit controllers: routes requests
backend/src/routes/interviewPrepKitsRoutes.js - Kit routes → Builder controller: routes edits
backend/src/routes/interviewPrepKitsRoutes.js - Job routes → Job controller: routes polling
backend/src/routes/generationJobRoutes.js - Job controller → Generation job runner: starts and reads jobs
backend/src/controllers/generationJobsController.js - Generation job runner → Prep pipeline: runs pipeline
- Prep pipeline → Requirement extraction: extracts
backend/src/services/interviewPrepPipelineService.js - Prep pipeline → Company research: researches company
backend/src/services/interviewPrepPipelineService.js - Company research → Company brief: builds brief
- Prep pipeline → Question generation: generates questions
backend/src/services/interviewPrepPipelineService.js - Prep pipeline → Coverage and gap fill: checks coverage
backend/src/services/interviewPrepPipelineService.js - Prep pipeline → Gap filling: fills gaps
backend/src/services/interviewPrepPipelineService.js - Prep pipeline → Study schedule: creates schedule
backend/src/services/interviewPrepPipelineService.js - Prep pipeline → Resume matching: matches resume
backend/src/services/interviewPrepPipelineService.js - Prep pipeline → Gemini model adapter: uses model
- Job polling → Express API: polls job
README.md - Generation job runner → Generation jobs: persists checkpoints
- Kit controllers → Interview kits: reads and writes kits
backend/src/controllers/interviewPrepKitsController.js - Kit controllers → Kit shaping and validation: prepares kit
backend/src/controllers/interviewPrepKitsController.js - Kit shaping and validation → Coverage and gap fill: checks coverage
backend/src/services/kitBuilderService.js - Builder controller → Interview kits: loads and saves
backend/src/controllers/interviewPrepKitBuilderController.js - Builder controller → Answer feedback: requests grading
backend/src/controllers/interviewPrepKitBuilderController.js - Kit workspace → Express API: loads kit
- Kit workspace → Study views: shows kit content
- Study views → Express API: edits questions
- Practice modes → Express API: saves practice
- Answer feedback → Gemini model adapter: grades answer
backend/src/services/answerFeedbackService.js - Express API → Mock interviews: serves mock interviews
- Interview kits → MongoDB: stored in
backend/src/models/InterviewPrepKit.js - Generation jobs → MongoDB: stored in
- Company brief → Express API
- Mock interviews → Interview kits: uses kit