# thakshil/jobradar-ai architecture

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

- Interactive diagram: https://gitdiagram.com/thakshil/jobradar-ai
- Repository: https://github.com/thakshil/jobradar-ai

## Overview

JobRadar AI takes a candidate from resume upload through document and skill analysis, aggregated job search, skill-match ranking, and dashboard presentation or Excel export. The React client calls a FastAPI API; the backend keeps session data and search results in memory and queries external job boards. The graph preserves the documented Adzuna, Remotive, and Jobicy integrations and filtering/caching behavior. Source excerpts show the upload, API orchestration, resume parsing, provider fetches, scoring, and export; dashboard search wiring is only partly excerpted, so its backend connection is documented by the README.

Main entry points: [`backend/main.py`](https://github.com/thakshil/jobradar-ai/blob/main/backend/main.py) (FastAPI endpoints), [`backend/job_search.py`](https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py) (Search orchestration), [`frontend/src/pages/Dashboard.jsx`](https://github.com/thakshil/jobradar-ai/blob/main/frontend/src/pages/Dashboard.jsx) (Match dashboard), [`frontend/src/pages/Upload.jsx`](https://github.com/thakshil/jobradar-ai/blob/main/frontend/src/pages/Upload.jsx) (Resume upload)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["SPA routes<br/>[App.jsx]"]
  node_upload["Resume upload<br/>[Upload.jsx]"]
  node_dashboard["Match dashboard<br/>[Dashboard.jsx]"]
end

subgraph group_api["API and session"]
  node_api["FastAPI endpoints<br/>[main.py]"]
  node_sessions[("Session state<br/>[main.py]")]
end

subgraph group_analysis["Resume and matching"]
  node_parser["Resume parser<br/>[resume_parser.py]"]
  node_matching["Match scoring<br/>[job_search.py]"]
end

subgraph group_discovery["Job discovery"]
  node_search["Search orchestration<br/>[job_search.py]"]
  node_adzuna["Adzuna search<br/>[job_search.py]"]
  node_remotive["Remotive search<br/>[job_search.py]"]
  node_jobicy["Jobicy search<br/>[job_search.py]"]
  node_cache[("Result cache<br/>[job_search.py]")]
  node_filtering["Search filters<br/>[job_search.py]"]
end

subgraph group_delivery["Results delivery"]
  node_export["Excel export<br/>[excel_export.py]"]
end

node_candidate(("Candidate"))
node_boards{{"Job boards"}}

node_candidate -->|"selects resume"| node_upload
node_app -->|"routes to"| node_upload
node_app -->|"routes to"| node_dashboard
node_upload -->|"uploads file"| node_api
node_api -->|"parses resume"| node_parser
node_api -->|"stores session"| node_sessions
node_dashboard -.->|"requests jobs"| node_api
node_api -->|"reads resume"| node_sessions
node_api -->|"starts search"| node_search
node_search -.->|"queries"| node_adzuna
node_search -.->|"queries"| node_remotive
node_search -.->|"queries"| node_jobicy
node_adzuna -->|"fetches listings"| node_boards
node_remotive -->|"fetches listings"| node_boards
node_jobicy -->|"fetches listings"| node_boards
node_search -->|"checks and saves"| node_cache
node_search -->|"scores listings"| node_matching
node_search -->|"filters results"| node_filtering
node_api -->|"stores jobs"| node_sessions
node_api -.->|"returns ranked results"| node_dashboard
node_dashboard -.->|"requests spreadsheet"| node_api
node_api -->|"generates workbook"| node_export
node_export -.->|"streams workbook"| node_dashboard

click node_app "https://github.com/thakshil/jobradar-ai/blob/main/frontend/src/App.jsx"
click node_upload "https://github.com/thakshil/jobradar-ai/blob/main/frontend/src/pages/Upload.jsx"
click node_dashboard "https://github.com/thakshil/jobradar-ai/blob/main/frontend/src/pages/Dashboard.jsx"
click node_api "https://github.com/thakshil/jobradar-ai/blob/main/backend/main.py"
click node_sessions "https://github.com/thakshil/jobradar-ai/blob/main/backend/main.py"
click node_parser "https://github.com/thakshil/jobradar-ai/blob/main/backend/resume_parser.py"
click node_search "https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py"
click node_adzuna "https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py"
click node_remotive "https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py"
click node_jobicy "https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py"
click node_cache "https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py"
click node_matching "https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py"
click node_filtering "https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py"
click node_export "https://github.com/thakshil/jobradar-ai/blob/main/backend/excel_export.py"

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_app,node_upload,node_dashboard toneBlue
class node_api,node_sessions toneAmber
class node_parser,node_matching toneMint
class node_search,node_adzuna,node_remotive,node_jobicy,node_cache,node_filtering toneRose
class node_export,node_candidate,node_boards toneIndigo
```

## Components

### Web client

- [SPA routes](https://github.com/thakshil/jobradar-ai/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Resume upload](https://github.com/thakshil/jobradar-ai/blob/main/frontend/src/pages/Upload.jsx): `frontend/src/pages/Upload.jsx`
- [Match dashboard](https://github.com/thakshil/jobradar-ai/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`

### API and session

- [FastAPI endpoints](https://github.com/thakshil/jobradar-ai/blob/main/backend/main.py): `backend/main.py`
- [Session state](https://github.com/thakshil/jobradar-ai/blob/main/backend/main.py): `backend/main.py`

### Resume and matching

- [Resume parser](https://github.com/thakshil/jobradar-ai/blob/main/backend/resume_parser.py): `backend/resume_parser.py`
- [Match scoring](https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py): `backend/job_search.py`

### Job discovery

- [Search orchestration](https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py): `backend/job_search.py`
- [Adzuna search](https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py): `backend/job_search.py`
- [Remotive search](https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py): `backend/job_search.py`
- [Jobicy search](https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py): `backend/job_search.py`
- [Result cache](https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py): `backend/job_search.py`
- [Search filters](https://github.com/thakshil/jobradar-ai/blob/main/backend/job_search.py): `backend/job_search.py`

### Results delivery

- [Excel export](https://github.com/thakshil/jobradar-ai/blob/main/backend/excel_export.py): `backend/excel_export.py`

### Other components

- **Candidate**
- **Job boards**

## Connections

- Candidate → Resume upload: selects resume (evidence: `frontend/src/pages/Upload.jsx`)
- SPA routes → Resume upload: routes to (evidence: `frontend/src/App.jsx`)
- SPA routes → Match dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Resume upload → FastAPI endpoints: uploads file (evidence: `README.md`)
- FastAPI endpoints → Resume parser: parses resume (evidence: `backend/main.py`)
- FastAPI endpoints → Session state: stores session (evidence: `backend/main.py`)
- Match dashboard → FastAPI endpoints: requests jobs (evidence: `README.md`)
- FastAPI endpoints → Session state: reads resume (evidence: `backend/main.py`)
- FastAPI endpoints → Search orchestration: starts search (evidence: `backend/main.py`)
- Search orchestration → Adzuna search: queries (evidence: `README.md`)
- Search orchestration → Remotive search: queries (evidence: `README.md`)
- Search orchestration → Jobicy search: queries (evidence: `README.md`)
- Adzuna search → Job boards: fetches listings (evidence: `backend/job_search.py`)
- Remotive search → Job boards: fetches listings (evidence: `backend/job_search.py`)
- Jobicy search → Job boards: fetches listings (evidence: `backend/job_search.py`)
- Search orchestration → Result cache: checks and saves (evidence: `README.md`)
- Search orchestration → Match scoring: scores listings (evidence: `backend/job_search.py`)
- Search orchestration → Search filters: filters results (evidence: `backend/job_search.py`)
- FastAPI endpoints → Session state: stores jobs (evidence: `backend/main.py`)
- FastAPI endpoints → Match dashboard: returns ranked results (evidence: `README.md`)
- Match dashboard → FastAPI endpoints: requests spreadsheet (evidence: `README.md`)
- FastAPI endpoints → Excel export: generates workbook (evidence: `backend/main.py`)
- Excel export → Match dashboard: streams workbook (evidence: `README.md`)
