# amrendrasharma1328-a11y/interview-dost architecture

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

- Interactive diagram: https://gitdiagram.com/amrendrasharma1328-a11y/interview-dost
- Repository: https://github.com/amrendrasharma1328-a11y/interview-dost

## Overview

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: [`app/api/evaluate/route.js`](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/api/evaluate/route.js) (Answer evaluation API), [`lib/ai/interviewer.js`](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/interviewer.js) (Adaptive interviewer), [`lib/db/sessions.js`](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/db/sessions.js) (Session persistence), [`components/practice/SetupWizard.js`](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/components/practice/SetupWizard.js) (Setup wizard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Candidate experience"]
  node_home["Home dashboard<br/>[page.js]"]
  node_practice["Practice studio<br/>[page.js]"]
  node_library["Practice library<br/>[page.js]"]
  node_interview_ui["Interview room<br/>[InterviewRoom.js]"]
  node_results["Interview report<br/>[page.js]"]
  node_progress["Progress dashboard<br/>[page.js]"]
end

subgraph group_intake["Session preparation"]
  node_setup["Setup wizard<br/>[SetupWizard.js]"]
  node_resume_api["Resume intake<br/>[route.js]"]
  node_resume_parser["Resume parser<br/>[resume-parser.js]"]
  node_jd_api["Job intake<br/>[route.js]"]
  node_jd_parser["Job parser<br/>[jd-parser.js]"]
  node_catalog["Drill catalog<br/>[catalog.js]"]
end

subgraph group_engine["Interview engine"]
  node_start_api["Interview start API<br/>[route.js]"]
  node_evaluate_api["Answer evaluation API<br/>[route.js]"]
  node_interviewer["Adaptive interviewer<br/>[interviewer.js]"]
  node_planner["Interview planner<br/>[planner.js]"]
  node_state["Interview state machine<br/>[state.js]"]
  node_schemas["Validated AI schemas<br/>[schemas.js]"]
  node_provider["AI provider selector<br/>[provider.js]"]
  node_ollama["Ollama provider<br/>[ollama.js]"]
  node_demo["Demo provider<br/>[demo.js]"]
end

subgraph group_data["Session data"]
  node_sessions["Session persistence<br/>[sessions.js]"]
  node_sqlite[("SQLite database")]
  node_stats["Session statistics<br/>[stats.js]"]
end

node_candidate(("Candidate"))

node_candidate -->|"opens practice"| node_practice
node_candidate -->|"configures session"| node_setup
node_setup -->|"submits resume"| node_resume_api
node_resume_api -->|"parses resume"| node_resume_parser
node_setup -->|"submits job text"| node_jd_api
node_jd_api -->|"parses job text"| node_jd_parser
node_candidate -->|"browses library"| node_library
node_library -->|"uses catalog"| node_catalog
node_setup -->|"starts session"| node_start_api
node_start_api -->|"selects provider"| node_provider
node_start_api -->|"starts interview"| node_interviewer
node_start_api -->|"creates session"| node_sessions
node_interviewer -->|"builds plan"| node_planner
node_interviewer -->|"updates state"| node_state
node_interviewer -->|"validates output"| node_schemas
node_provider -->|"selects live"| node_ollama
node_provider -->|"selects demo"| node_demo
node_candidate -->|"answers questions"| node_interview_ui
node_interview_ui -->|"submits answer"| node_evaluate_api
node_evaluate_api -->|"loads state"| node_sessions
node_evaluate_api -->|"selects provider"| node_provider
node_evaluate_api -->|"evaluates turn"| node_interviewer
node_evaluate_api -->|"publicizes result"| node_state
node_evaluate_api -->|"persists turn"| node_sessions
node_sessions -->|"reads and writes"| node_sqlite
node_candidate -->|"views report"| node_results
node_interviewer -->|"generates report"| node_results
node_sessions -->|"loads results"| node_results
node_candidate -->|"views activity"| node_home
node_candidate -->|"reviews progress"| node_progress
node_home -->|"loads statistics"| node_stats
node_progress -->|"loads statistics"| node_stats
node_stats -->|"queries sessions"| node_sqlite

click node_home "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/(app)/home/page.js"
click node_practice "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/(app)/practice/page.js"
click node_setup "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/components/practice/SetupWizard.js"
click node_resume_api "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/api/resume/route.js"
click node_resume_parser "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/resume-parser.js"
click node_jd_api "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/api/jd/route.js"
click node_jd_parser "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/jd-parser.js"
click node_library "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/(app)/library/page.js"
click node_catalog "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/practice/catalog.js"
click node_interview_ui "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/components/interview/InterviewRoom.js"
click node_start_api "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/api/interview/route.js"
click node_evaluate_api "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/api/evaluate/route.js"
click node_interviewer "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/interviewer.js"
click node_planner "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/planner.js"
click node_state "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/interview/state.js"
click node_schemas "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/schemas.js"
click node_provider "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/provider.js"
click node_ollama "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/ollama.js"
click node_demo "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/demo.js"
click node_sessions "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/db/sessions.js"
click node_sqlite "https://github.com/amrendrasharma1328-a11y/interview-dost/tree/main/prisma"
click node_results "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/(app)/results/%5Bid%5D/page.js"
click node_progress "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/(app)/progress/page.js"
click node_stats "https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/db/stats.js"

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_home,node_practice,node_library,node_interview_ui,node_results,node_progress toneBlue
class node_setup,node_resume_api,node_resume_parser,node_jd_api,node_jd_parser,node_catalog toneAmber
class node_start_api,node_evaluate_api,node_interviewer,node_planner,node_state,node_schemas,node_provider,node_ollama,node_demo toneMint
class node_sessions,node_sqlite,node_stats toneRose
class node_candidate toneIndigo
```

## Components

### Candidate experience

- [Home dashboard](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/(app)/home/page.js): `app/(app)/home/page.js`
- [Practice studio](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/(app)/practice/page.js): `app/(app)/practice/page.js`
- [Practice library](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/(app)/library/page.js): `app/(app)/library/page.js`
- [Interview room](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/components/interview/InterviewRoom.js): `components/interview/InterviewRoom.js`
- [Interview report](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/(app)/results/%5Bid%5D/page.js): `app/(app)/results/[id]/page.js`
- [Progress dashboard](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/(app)/progress/page.js): `app/(app)/progress/page.js`

### Session preparation

- [Setup wizard](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/components/practice/SetupWizard.js): `components/practice/SetupWizard.js`
- [Resume intake](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/api/resume/route.js): `app/api/resume/route.js`
- [Resume parser](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/resume-parser.js): `lib/ai/resume-parser.js`
- [Job intake](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/api/jd/route.js): `app/api/jd/route.js`
- [Job parser](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/jd-parser.js): `lib/ai/jd-parser.js`
- [Drill catalog](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/practice/catalog.js): `lib/practice/catalog.js`

### Interview engine

- [Interview start API](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/api/interview/route.js): `app/api/interview/route.js`
- [Answer evaluation API](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/app/api/evaluate/route.js): `app/api/evaluate/route.js`
- [Adaptive interviewer](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/interviewer.js): `lib/ai/interviewer.js`
- [Interview planner](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/planner.js): `lib/ai/planner.js`
- [Interview state machine](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/interview/state.js): `lib/interview/state.js`
- [Validated AI schemas](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/schemas.js): `lib/ai/schemas.js`
- [AI provider selector](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/provider.js): `lib/ai/provider.js`
- [Ollama provider](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/ollama.js): `lib/ai/ollama.js`
- [Demo provider](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/ai/demo.js): `lib/ai/demo.js`

### Session data

- [Session persistence](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/db/sessions.js): `lib/db/sessions.js`
- [SQLite database](https://github.com/amrendrasharma1328-a11y/interview-dost/tree/main/prisma): `prisma`
- [Session statistics](https://github.com/amrendrasharma1328-a11y/interview-dost/blob/main/lib/db/stats.js): `lib/db/stats.js`

### Other components

- **Candidate**

## Connections

- Candidate → Practice studio: opens practice (evidence: `README.md`)
- Candidate → Setup wizard: configures session (evidence: `README.md`)
- Setup wizard → Resume intake: submits resume (evidence: `README.md`)
- Resume intake → Resume parser: parses resume (evidence: `app/api/resume/route.js`)
- Setup wizard → Job intake: submits job text (evidence: `README.md`)
- Job intake → Job parser: parses job text (evidence: `app/api/jd/route.js`)
- Candidate → Practice library: browses library (evidence: `README.md`)
- Practice library → Drill catalog: uses catalog
- Setup wizard → Interview start API: starts session (evidence: `README.md`)
- Interview start API → AI provider selector: selects provider (evidence: `app/api/interview/route.js`)
- Interview start API → Adaptive interviewer: starts interview (evidence: `app/api/interview/route.js`)
- Interview start API → Session persistence: creates session (evidence: `app/api/interview/route.js`)
- Adaptive interviewer → Interview planner: builds plan (evidence: `lib/ai/interviewer.js`)
- Adaptive interviewer → Interview state machine: updates state (evidence: `lib/ai/interviewer.js`)
- Adaptive interviewer → Validated AI schemas: validates output (evidence: `lib/ai/interviewer.js`)
- AI provider selector → Ollama provider: selects live (evidence: `lib/ai/provider.js`)
- AI provider selector → Demo provider: selects demo (evidence: `lib/ai/provider.js`)
- Candidate → Interview room: answers questions (evidence: `README.md`)
- Interview room → Answer evaluation API: submits answer (evidence: `README.md`)
- Answer evaluation API → Session persistence: loads state (evidence: `app/api/evaluate/route.js`)
- Answer evaluation API → AI provider selector: selects provider (evidence: `app/api/evaluate/route.js`)
- Answer evaluation API → Adaptive interviewer: evaluates turn (evidence: `app/api/evaluate/route.js`)
- Answer evaluation API → Interview state machine: publicizes result (evidence: `app/api/evaluate/route.js`)
- Answer evaluation API → Session persistence: persists turn (evidence: `app/api/evaluate/route.js`)
- Session persistence → SQLite database: reads and writes (evidence: `lib/db/sessions.js`)
- Candidate → Interview report: views report (evidence: `README.md`)
- Adaptive interviewer → Interview report: generates report (evidence: `README.md`)
- Session persistence → Interview report: loads results (evidence: `README.md`)
- Candidate → Home dashboard: views activity (evidence: `README.md`)
- Candidate → Progress dashboard: reviews progress (evidence: `README.md`)
- Home dashboard → Session statistics: loads statistics (evidence: `app/(app)/home/page.js`)
- Progress dashboard → Session statistics: loads statistics (evidence: `app/(app)/progress/page.js`)
- Session statistics → SQLite database: queries sessions (evidence: `lib/db/stats.js`)
