# anantsharma-da/jobhunt architecture

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

- Interactive diagram: https://gitdiagram.com/anantsharma-da/jobhunt
- Repository: https://github.com/anantsharma-da/jobhunt

## Overview

JobHunt is a local-first India-focused job-search and application-tracking app. The main workflow is to search selected job sources, normalize and score results, store them for filtering, then save or track applications; users open the real application page and apply themselves. Separate branches support resume tailoring and PDF export, interview preparation and practice, reminders, and local insights. The README documents these capabilities; some implementation details and links for unsampled modules are therefore shown only at the level supported by the README or source index.

Main entry points: [`app/main.py`](https://github.com/anantsharma-da/jobhunt/blob/main/app/main.py) (Web API), [`app/search.py`](https://github.com/anantsharma-da/jobhunt/blob/main/app/search.py) (Search orchestration), [`app/insights.py`](https://github.com/anantsharma-da/jobhunt/blob/main/app/insights.py) (Search and application insights), [`app/db.py`](https://github.com/anantsharma-da/jobhunt/blob/main/app/db.py) (Local SQLite data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_search["Job discovery"]
  node_searchrun["Search orchestration<br/>[search.py]"]
  node_boards["LinkedIn and Indeed<br/>[boards.py]"]
  node_naukri["Naukri source<br/>[naukri.py]"]
  node_companyfeeds["Company career feeds<br/>[ats.py]"]
  node_companysearch["Company fallback search<br/>[company_boards.py]"]
  node_companyimport["Company imports<br/>[company_import.py]"]
  node_applicant["Applicant updates"]
end

subgraph group_core["Search and records"]
  node_api["Web API<br/>[main.py]"]
  node_normalize["Job normalization<br/>[normalize.py]"]
  node_matching["Job matching<br/>[matching.py]"]
  node_warnings["Job warnings<br/>[job_warnings.py]"]
  node_store[("Local SQLite data<br/>[db.py]")]
end

subgraph group_apply["Application support"]
  node_resume["Resume tailoring<br/>[resume.py]"]
  node_tailorrun["Tailoring workflow<br/>[tailor_run.py]"]
  node_pdf["Resume PDF export<br/>[resume_pdf.py]"]
  node_outreach["Referral and recruiter messages<br/>[outreach.py]"]
  node_interview["Interview question search<br/>[interview.py]"]
  node_practice["Mock interview practice<br/>[practice.py]"]
  node_ai["AI provider client<br/>[ai.py]"]
end

subgraph group_insights["Tracking and insights"]
  node_tracker["Application tracker<br/>[tracker.py]"]
  node_scheduler["Scheduled searches<br/>[scheduler.py]"]
  node_notify["Reminders and notices<br/>[notify.py]"]
  node_insights["Search and application insights<br/>[insights.py]"]
end

node_user(("Job seeker"))
node_webapp["Web interface<br/>[index.html]"]
node_ai_service["AI providers"]
node_question_search["Web question search"]
node_job_sites["Job sites"]
node_windows["Windows notifications"]

node_user -->|"uses"| node_webapp
node_webapp -->|"requests actions"| node_api
node_api -->|"starts searches"| node_searchrun
node_searchrun -->|"searches"| node_boards
node_searchrun -->|"searches"| node_naukri
node_searchrun -->|"fetches feeds"| node_companyfeeds
node_searchrun -->|"falls back to"| node_companysearch
node_api -->|"imports lists"| node_companyimport
node_searchrun -->|"normalizes results"| node_normalize
node_searchrun -->|"scores jobs"| node_matching
node_searchrun -->|"stores results"| node_store
node_api -->|"checks adverts"| node_warnings
node_api -->|"starts updates"| node_applicant
node_applicant -->|"reads and updates"| node_store
node_api -->|"serves applications"| node_tracker
node_tracker -->|"reads records"| node_store
node_api -->|"runs tailoring"| node_tailorrun
node_tailorrun -->|"delegates tailoring"| node_resume
node_resume -->|"requests rewrites"| node_ai
node_api -->|"exports resumes"| node_pdf
node_api -->|"drafts messages"| node_outreach
node_api -->|"finds questions"| node_interview
node_api -->|"runs practice"| node_practice
node_interview -->|"searches web"| node_question_search
node_practice -->|"requests feedback"| node_ai
node_ai -->|"sends prompts"| node_ai_service
node_api -->|"configures schedules"| node_scheduler
node_scheduler -->|"runs searches"| node_searchrun
node_scheduler -->|"sends reminders"| node_notify
node_notify -->|"notifies"| node_windows
node_api -->|"serves insights"| node_insights
node_insights -->|"reads records"| node_store
node_insights -->|"uses match logic"| node_matching
node_insights -->|"uses application data"| node_tracker
node_job_sites -.->|"provides listings"| node_boards
node_job_sites -.->|"provides listings"| node_naukri
node_job_sites -.->|"provides listings"| node_companyfeeds

click node_webapp "https://github.com/anantsharma-da/jobhunt/blob/main/static/index.html"
click node_api "https://github.com/anantsharma-da/jobhunt/blob/main/app/main.py"
click node_searchrun "https://github.com/anantsharma-da/jobhunt/blob/main/app/search.py"
click node_boards "https://github.com/anantsharma-da/jobhunt/blob/main/app/sources/boards.py"
click node_naukri "https://github.com/anantsharma-da/jobhunt/blob/main/app/sources/naukri.py"
click node_companyfeeds "https://github.com/anantsharma-da/jobhunt/blob/main/app/sources/ats.py"
click node_companysearch "https://github.com/anantsharma-da/jobhunt/blob/main/app/sources/company_boards.py"
click node_companyimport "https://github.com/anantsharma-da/jobhunt/blob/main/app/company_import.py"
click node_normalize "https://github.com/anantsharma-da/jobhunt/blob/main/app/normalize.py"
click node_matching "https://github.com/anantsharma-da/jobhunt/blob/main/app/matching.py"
click node_warnings "https://github.com/anantsharma-da/jobhunt/blob/main/app/job_warnings.py"
click node_store "https://github.com/anantsharma-da/jobhunt/blob/main/app/db.py"
click node_applicant "https://github.com/anantsharma-da/jobhunt/blob/main/app/applicant_update.py"
click node_tracker "https://github.com/anantsharma-da/jobhunt/blob/main/app/tracker.py"
click node_scheduler "https://github.com/anantsharma-da/jobhunt/blob/main/app/scheduler.py"
click node_notify "https://github.com/anantsharma-da/jobhunt/blob/main/app/notify.py"
click node_insights "https://github.com/anantsharma-da/jobhunt/blob/main/app/insights.py"
click node_resume "https://github.com/anantsharma-da/jobhunt/blob/main/app/resume.py"
click node_tailorrun "https://github.com/anantsharma-da/jobhunt/blob/main/app/tailor_run.py"
click node_pdf "https://github.com/anantsharma-da/jobhunt/blob/main/app/resume_pdf.py"
click node_outreach "https://github.com/anantsharma-da/jobhunt/blob/main/app/outreach.py"
click node_interview "https://github.com/anantsharma-da/jobhunt/blob/main/app/interview.py"
click node_practice "https://github.com/anantsharma-da/jobhunt/blob/main/app/practice.py"
click node_ai "https://github.com/anantsharma-da/jobhunt/blob/main/app/ai.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_searchrun,node_boards,node_naukri,node_companyfeeds,node_companysearch,node_companyimport,node_applicant toneBlue
class node_api,node_normalize,node_matching,node_warnings,node_store toneAmber
class node_resume,node_tailorrun,node_pdf,node_outreach,node_interview,node_practice,node_ai toneMint
class node_tracker,node_scheduler,node_notify,node_insights toneRose
class node_user,node_ai_service,node_question_search,node_job_sites,node_windows toneIndigo
class node_webapp toneTeal
```

## Components

### Job discovery

- [Search orchestration](https://github.com/anantsharma-da/jobhunt/blob/main/app/search.py): `app/search.py`
- [LinkedIn and Indeed](https://github.com/anantsharma-da/jobhunt/blob/main/app/sources/boards.py): `app/sources/boards.py`
- [Naukri source](https://github.com/anantsharma-da/jobhunt/blob/main/app/sources/naukri.py): `app/sources/naukri.py`
- [Company career feeds](https://github.com/anantsharma-da/jobhunt/blob/main/app/sources/ats.py): `app/sources/ats.py`
- [Company fallback search](https://github.com/anantsharma-da/jobhunt/blob/main/app/sources/company_boards.py): `app/sources/company_boards.py`
- [Company imports](https://github.com/anantsharma-da/jobhunt/blob/main/app/company_import.py): `app/company_import.py`
- [Applicant updates](https://github.com/anantsharma-da/jobhunt/blob/main/app/applicant_update.py): `app/applicant_update.py`

### Search and records

- [Web API](https://github.com/anantsharma-da/jobhunt/blob/main/app/main.py): `app/main.py`
- [Job normalization](https://github.com/anantsharma-da/jobhunt/blob/main/app/normalize.py): `app/normalize.py`
- [Job matching](https://github.com/anantsharma-da/jobhunt/blob/main/app/matching.py): `app/matching.py`
- [Job warnings](https://github.com/anantsharma-da/jobhunt/blob/main/app/job_warnings.py): `app/job_warnings.py`
- [Local SQLite data](https://github.com/anantsharma-da/jobhunt/blob/main/app/db.py): `app/db.py`

### Application support

- [Resume tailoring](https://github.com/anantsharma-da/jobhunt/blob/main/app/resume.py): `app/resume.py`
- [Tailoring workflow](https://github.com/anantsharma-da/jobhunt/blob/main/app/tailor_run.py): `app/tailor_run.py`
- [Resume PDF export](https://github.com/anantsharma-da/jobhunt/blob/main/app/resume_pdf.py): `app/resume_pdf.py`
- [Referral and recruiter messages](https://github.com/anantsharma-da/jobhunt/blob/main/app/outreach.py): `app/outreach.py`
- [Interview question search](https://github.com/anantsharma-da/jobhunt/blob/main/app/interview.py): `app/interview.py`
- [Mock interview practice](https://github.com/anantsharma-da/jobhunt/blob/main/app/practice.py): `app/practice.py`
- [AI provider client](https://github.com/anantsharma-da/jobhunt/blob/main/app/ai.py): `app/ai.py`

### Tracking and insights

- [Application tracker](https://github.com/anantsharma-da/jobhunt/blob/main/app/tracker.py): `app/tracker.py`
- [Scheduled searches](https://github.com/anantsharma-da/jobhunt/blob/main/app/scheduler.py): `app/scheduler.py`
- [Reminders and notices](https://github.com/anantsharma-da/jobhunt/blob/main/app/notify.py): `app/notify.py`
- [Search and application insights](https://github.com/anantsharma-da/jobhunt/blob/main/app/insights.py): `app/insights.py`

### Other components

- **Job seeker**
- [Web interface](https://github.com/anantsharma-da/jobhunt/blob/main/static/index.html): `static/index.html`
- **AI providers**
- **Web question search**
- **Job sites**
- **Windows notifications**

## Connections

- Job seeker → Web interface: uses (evidence: `README.md`)
- Web interface → Web API: requests actions (evidence: `README.md`)
- Web API → Search orchestration: starts searches (evidence: `app/main.py`)
- Search orchestration → LinkedIn and Indeed: searches (evidence: `app/search.py`)
- Search orchestration → Naukri source: searches (evidence: `app/search.py`)
- Search orchestration → Company career feeds: fetches feeds (evidence: `app/search.py`)
- Search orchestration → Company fallback search: falls back to (evidence: `app/search.py`)
- Web API → Company imports: imports lists (evidence: `app/main.py`)
- Search orchestration → Job normalization: normalizes results (evidence: `app/search.py`)
- Search orchestration → Job matching: scores jobs (evidence: `app/search.py`)
- Search orchestration → Local SQLite data: stores results (evidence: `app/search.py`)
- Web API → Job warnings: checks adverts (evidence: `app/main.py`)
- Web API → Applicant updates: starts updates (evidence: `app/main.py`)
- Applicant updates → Local SQLite data: reads and updates (evidence: `app/applicant_update.py`)
- Web API → Application tracker: serves applications (evidence: `app/main.py`)
- Application tracker → Local SQLite data: reads records (evidence: `app/tracker.py`)
- Web API → Tailoring workflow: runs tailoring (evidence: `app/main.py`)
- Tailoring workflow → Resume tailoring: delegates tailoring (evidence: `app/tailor_run.py`)
- Resume tailoring → AI provider client: requests rewrites (evidence: `app/resume.py`)
- Web API → Resume PDF export: exports resumes (evidence: `app/main.py`)
- Web API → Referral and recruiter messages: drafts messages (evidence: `app/main.py`)
- Web API → Interview question search: finds questions (evidence: `app/main.py`)
- Web API → Mock interview practice: runs practice (evidence: `app/main.py`)
- Interview question search → Web question search: searches web (evidence: `README.md`)
- Mock interview practice → AI provider client: requests feedback (evidence: `app/practice.py`)
- AI provider client → AI providers: sends prompts (evidence: `app/ai.py`)
- Web API → Scheduled searches: configures schedules (evidence: `README.md`)
- Scheduled searches → Search orchestration: runs searches (evidence: `app/scheduler.py`)
- Scheduled searches → Reminders and notices: sends reminders (evidence: `app/scheduler.py`)
- Reminders and notices → Windows notifications: notifies (evidence: `README.md`)
- Web API → Search and application insights: serves insights (evidence: `app/main.py`)
- Search and application insights → Local SQLite data: reads records (evidence: `app/insights.py`)
- Search and application insights → Job matching: uses match logic (evidence: `app/insights.py`)
- Search and application insights → Application tracker: uses application data (evidence: `app/insights.py`)
- Job sites → LinkedIn and Indeed: provides listings (evidence: `README.md`)
- Job sites → Naukri source: provides listings (evidence: `README.md`)
- Job sites → Company career feeds: provides listings (evidence: `README.md`)
