How amrendrasharma1328-a11y/interview-dost works
Interview Dost is a local-first interview-practice application. Candidates configure a session from resume and job-description details, complete an adaptive interview, then review a report and personalized drills; completed sessions also drive home, progress, and library views. The graph emphasizes the documented user journey and the sampled API, AI, state, and persistence boundaries. Some page-to-API wiring is documented but not excerpted, so those relationships cite the README; unsampled internals are represented only where the README or source index supports them.
Main entry points: route.js Answer evaluation API · interviewer.js Adaptive interviewer · sessions.js Session persistence · SetupWizard.js Setup wizard
Components 25
Candidate experience
- Home dashboard
app/(app)/home/page.js - Practice studio
app/(app)/practice/page.js - Practice library
app/(app)/library/page.js - Interview room
components/interview/InterviewRoom.js - Interview report
app/(app)/results/[id]/page.js - Progress dashboard
app/(app)/progress/page.js
Session preparation
- Setup wizard
components/practice/SetupWizard.js - Resume intake
app/api/resume/route.js - Resume parser
lib/ai/resume-parser.js - Job intake
app/api/jd/route.js - Job parser
lib/ai/jd-parser.js - Drill catalog
lib/practice/catalog.js
Interview engine
- Interview start API
app/api/interview/route.js - Answer evaluation API
app/api/evaluate/route.js - Adaptive interviewer
lib/ai/interviewer.js - Interview planner
lib/ai/planner.js - Interview state machine
lib/interview/state.js - Validated AI schemas
lib/ai/schemas.js - AI provider selector
lib/ai/provider.js - Ollama provider
lib/ai/ollama.js - Demo provider
lib/ai/demo.js
Session data
- Session persistence
lib/db/sessions.js - SQLite database
prisma - Session statistics
lib/db/stats.js
Other components
- Candidate
Connections 33
- Candidate → Practice studio: opens practice
README.md - Candidate → Setup wizard: configures session
README.md - Setup wizard → Resume intake: submits resume
README.md - Resume intake → Resume parser: parses resume
app/api/resume/route.js - Setup wizard → Job intake: submits job text
README.md - Job intake → Job parser: parses job text
app/api/jd/route.js - Candidate → Practice library: browses library
README.md - Practice library → Drill catalog: uses catalog
- Setup wizard → Interview start API: starts session
README.md - Interview start API → AI provider selector: selects provider
app/api/interview/route.js - Interview start API → Adaptive interviewer: starts interview
app/api/interview/route.js - Interview start API → Session persistence: creates session
app/api/interview/route.js - Adaptive interviewer → Interview planner: builds plan
lib/ai/interviewer.js - Adaptive interviewer → Interview state machine: updates state
lib/ai/interviewer.js - Adaptive interviewer → Validated AI schemas: validates output
lib/ai/interviewer.js - AI provider selector → Ollama provider: selects live
lib/ai/provider.js - AI provider selector → Demo provider: selects demo
lib/ai/provider.js - Candidate → Interview room: answers questions
README.md - Interview room → Answer evaluation API: submits answer
README.md - Answer evaluation API → Session persistence: loads state
app/api/evaluate/route.js - Answer evaluation API → AI provider selector: selects provider
app/api/evaluate/route.js - Answer evaluation API → Adaptive interviewer: evaluates turn
app/api/evaluate/route.js - Answer evaluation API → Interview state machine: publicizes result
app/api/evaluate/route.js - Answer evaluation API → Session persistence: persists turn
app/api/evaluate/route.js - Session persistence → SQLite database: reads and writes
lib/db/sessions.js - Candidate → Interview report: views report
README.md - Adaptive interviewer → Interview report: generates report
README.md - Session persistence → Interview report: loads results
README.md - Candidate → Home dashboard: views activity
README.md - Candidate → Progress dashboard: reviews progress
README.md - Home dashboard → Session statistics: loads statistics
app/(app)/home/page.js - Progress dashboard → Session statistics: loads statistics
app/(app)/progress/page.js - Session statistics → SQLite database: queries sessions
lib/db/stats.js