# aishwarya0903/adaptive-question-generator-using-candidate-response-patterns architecture

> Architecture diagram of the GitHub repository aishwarya0903/adaptive-question-generator-using-candidate-response-patterns, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns
- Repository: https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns

## Overview

AdaptIQ is an adaptive interview engine: an interviewer starts a role-specific session, the candidate answers questions, and the backend scores each response before selecting a graph branch or generating an LLM follow-up. At session end, the engine summarizes performance and provides an AI recommendation; the dashboard presents question-effectiveness and candidate-trend analytics. The graph shows the sampled API, scoring, graph, and UI relationships plus README-documented capabilities. Authentication is listed in the README’s tech stack, but no implementation is evidenced in the supplied source.

Main entry points: [`backend/main.py`](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/main.py) (Interview and analytics API), [`backend/llm.py`](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/llm.py) (Prompt chaining), [`frontend/src/Interview.jsx`](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/frontend/src/Interview.jsx) (Interview flow), [`frontend/src/App.jsx`](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/frontend/src/App.jsx) (App navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interview_ui["Interview UI"]
  node_interview_ui["Interview flow<br/>[Interview.jsx]"]
  node_app["App navigation<br/>[App.jsx]"]
  node_browser_entry["Frontend entry<br/>[main.jsx]"]
end

subgraph group_interview_runtime["Interview runtime"]
  node_api["Interview and analytics API<br/>[main.py]"]
  node_session_state["Session state<br/>[main.py]"]
  node_models["API data models<br/>[models.py]"]
  node_scorer["Response scorer<br/>[scorer.py]"]
  node_llm["Prompt chaining<br/>[llm.py]"]
end

subgraph group_question_data["Question graph"]
  node_question_graph["Question graph operations<br/>[graph.py]"]
  node_graph_seed["Question graph seed<br/>[seed.py]"]
end

subgraph group_insights["Analytics"]
  node_dashboard["Analytics dashboard<br/>[Dashboard.jsx]"]
end

node_interviewer(("Interviewer"))
node_candidate(("Candidate"))
node_neo4j[("Neo4j")]
node_claude{{"Claude API"}}

node_interviewer -->|"starts session"| node_interview_ui
node_candidate -->|"submits answers"| node_interview_ui
node_app -->|"renders"| node_interview_ui
node_app -->|"renders"| node_dashboard
node_browser_entry -->|"renders"| node_app
node_interview_ui -->|"calls endpoints"| node_api
node_dashboard -->|"fetches analytics"| node_api
node_api -->|"uses contracts"| node_models
node_api -->|"reads and updates"| node_session_state
node_api -->|"fetches and saves"| node_question_graph
node_api -->|"scores answers"| node_scorer
node_api -->|"generates follow-ups"| node_llm
node_api -->|"generates recommendations"| node_llm
node_llm -->|"uses score type"| node_models
node_scorer -->|"returns score"| node_models
node_question_graph -->|"queries and writes"| node_neo4j
node_graph_seed -->|"seeds questions"| node_question_graph
node_llm -->|"requests completions"| node_claude

click node_interview_ui "https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/frontend/src/Interview.jsx"
click node_app "https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/frontend/src/App.jsx"
click node_dashboard "https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/frontend/src/Dashboard.jsx"
click node_api "https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/main.py"
click node_session_state "https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/main.py"
click node_models "https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/models.py"
click node_scorer "https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/scorer.py"
click node_llm "https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/llm.py"
click node_question_graph "https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/graph.py"
click node_graph_seed "https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/seed.py"
click node_browser_entry "https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/frontend/src/main.jsx"

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_interview_ui,node_app,node_browser_entry,node_interviewer toneBlue
class node_api,node_session_state,node_models,node_scorer,node_llm,node_neo4j toneAmber
class node_question_graph,node_graph_seed,node_claude toneMint
class node_dashboard toneRose
class node_candidate toneIndigo
```

## Components

### Interview UI

- [Interview flow](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/frontend/src/Interview.jsx): `frontend/src/Interview.jsx`
- [App navigation](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Frontend entry](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`

### Interview runtime

- [Interview and analytics API](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/main.py): `backend/main.py`
- [Session state](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/main.py): `backend/main.py`
- [API data models](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/models.py): `backend/models.py`
- [Response scorer](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/scorer.py): `backend/scorer.py`
- [Prompt chaining](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/llm.py): `backend/llm.py`

### Question graph

- [Question graph operations](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/graph.py): `backend/graph.py`
- [Question graph seed](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/backend/seed.py): `backend/seed.py`

### Analytics

- [Analytics dashboard](https://github.com/aishwarya0903/adaptive-question-generator-using-candidate-response-patterns/blob/main/frontend/src/Dashboard.jsx): `frontend/src/Dashboard.jsx`

### Other components

- **Interviewer**
- **Candidate**
- **Neo4j**
- **Claude API**

## Connections

- Interviewer → Interview flow: starts session (evidence: `README.md`)
- Candidate → Interview flow: submits answers (evidence: `README.md`)
- App navigation → Interview flow: renders (evidence: `frontend/src/App.jsx`)
- App navigation → Analytics dashboard: renders (evidence: `frontend/src/App.jsx`)
- Frontend entry → App navigation: renders (evidence: `frontend/src/main.jsx`)
- Interview flow → Interview and analytics API: calls endpoints (evidence: `frontend/src/Interview.jsx`)
- Analytics dashboard → Interview and analytics API: fetches analytics (evidence: `frontend/src/Dashboard.jsx`)
- Interview and analytics API → API data models: uses contracts (evidence: `backend/main.py`)
- Interview and analytics API → Session state: reads and updates (evidence: `backend/main.py`)
- Interview and analytics API → Question graph operations: fetches and saves (evidence: `backend/main.py`)
- Interview and analytics API → Response scorer: scores answers (evidence: `backend/main.py`)
- Interview and analytics API → Prompt chaining: generates follow-ups (evidence: `backend/main.py`)
- Interview and analytics API → Prompt chaining: generates recommendations (evidence: `backend/main.py`)
- Prompt chaining → API data models: uses score type (evidence: `backend/llm.py`)
- Response scorer → API data models: returns score (evidence: `backend/scorer.py`)
- Question graph operations → Neo4j: queries and writes (evidence: `backend/graph.py`)
- Question graph seed → Question graph operations: seeds questions (evidence: `backend/seed.py`)
- Prompt chaining → Claude API: requests completions (evidence: `backend/llm.py`)
