# munal0803/jobdehunt architecture

> Architecture diagram of the GitHub repository munal0803/jobdehunt, 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/munal0803/jobdehunt
- Repository: https://github.com/munal0803/jobdehunt

## Overview

JobDeHunt collects recent job postings matching configured role and India-location filters, stores them, and presents them in a dashboard where users can track applications. The primary workflow is explicit in main.py; the sampled excerpts also show the dashboard and SQLite operations. Company-list discovery and validation are supporting data-maintenance tools. The README gives no further capability detail, and some listed modules (including notifier.py and scheduler.py) were not sampled, so their behavior and connections are omitted.

Main entry points: [`fetchers.py`](https://github.com/munal0803/jobdehunt/blob/main/fetchers.py) (Job Fetchers), [`filters.py`](https://github.com/munal0803/jobdehunt/blob/main/filters.py) (Job Filters), [`main.py`](https://github.com/munal0803/jobdehunt/blob/main/main.py) (Scan Runner), [`app.py`](https://github.com/munal0803/jobdehunt/blob/main/app.py) (Web Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Job Collection"]
  node_runner["Scan Runner<br/>[main.py]"]
  node_companies["Company Sources<br/>[companies.py]"]
  node_fetchers["Job Fetchers<br/>[fetchers.py]"]
end

subgraph group_matching["Job Matching"]
  node_filters["Job Filters<br/>[filters.py]"]
end

subgraph group_tracking["Dashboard &amp; Storage"]
  node_dashboard["Web Dashboard<br/>[app.py]"]
  node_template["Job Views<br/>[index.html]"]
  node_database[("Job Store<br/>[database.py]")]
end

subgraph group_catalog["Company Catalog"]
  node_candidates["Candidate Lists"]
  node_companybuilder["Company Builder<br/>[build_companies.py]"]
  node_validatedbuilder["Validated Builder"]
  node_slugdiscovery["Slug Discovery<br/>[discover_slugs.py]"]
  node_workdaydiscovery["Workday Discovery"]
end

node_jobboards{{"Job Boards"}}
node_visitor(("Dashboard User"))
node_sqlite[("SQLite Database")]

node_runner -->|"iterates"| node_companies
node_runner -->|"dispatches"| node_fetchers
node_runner -->|"filters jobs"| node_filters
node_runner -->|"saves jobs"| node_database
node_fetchers -->|"requests postings"| node_jobboards
node_fetchers -->|"uses search settings"| node_filters
node_dashboard -->|"reads and updates"| node_database
node_dashboard -->|"sorts and excludes"| node_filters
node_dashboard -->|"renders"| node_template
node_visitor -.->|"views and updates"| node_dashboard
node_database -->|"reads and writes"| node_sqlite
node_companybuilder -->|"loads candidates"| node_candidates
node_validatedbuilder -->|"uses fetchers"| node_fetchers
node_slugdiscovery -->|"uses headers"| node_fetchers
node_slugdiscovery -->|"uses search text"| node_filters
node_workdaydiscovery -->|"uses fetchers"| node_fetchers
node_workdaydiscovery -->|"uses search text"| node_filters

click node_runner "https://github.com/munal0803/jobdehunt/blob/main/main.py"
click node_companies "https://github.com/munal0803/jobdehunt/blob/main/companies.py"
click node_fetchers "https://github.com/munal0803/jobdehunt/blob/main/fetchers.py"
click node_filters "https://github.com/munal0803/jobdehunt/blob/main/filters.py"
click node_dashboard "https://github.com/munal0803/jobdehunt/blob/main/app.py"
click node_template "https://github.com/munal0803/jobdehunt/blob/main/templates/index.html"
click node_database "https://github.com/munal0803/jobdehunt/blob/main/database.py"
click node_candidates "https://github.com/munal0803/jobdehunt/blob/main/build_candidates.py"
click node_companybuilder "https://github.com/munal0803/jobdehunt/blob/main/build_companies.py"
click node_validatedbuilder "https://github.com/munal0803/jobdehunt/blob/main/build_validated_companies.py"
click node_slugdiscovery "https://github.com/munal0803/jobdehunt/blob/main/discover_slugs.py"
click node_workdaydiscovery "https://github.com/munal0803/jobdehunt/blob/main/discover_workday.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_runner,node_companies,node_fetchers,node_visitor toneBlue
class node_filters,node_sqlite toneAmber
class node_dashboard,node_template,node_database toneMint
class node_candidates,node_companybuilder,node_validatedbuilder,node_slugdiscovery,node_workdaydiscovery toneRose
class node_jobboards toneIndigo
```

## Components

### Job Collection

- [Scan Runner](https://github.com/munal0803/jobdehunt/blob/main/main.py): `main.py`
- [Company Sources](https://github.com/munal0803/jobdehunt/blob/main/companies.py): `companies.py`
- [Job Fetchers](https://github.com/munal0803/jobdehunt/blob/main/fetchers.py): `fetchers.py`

### Job Matching

- [Job Filters](https://github.com/munal0803/jobdehunt/blob/main/filters.py): `filters.py`

### Dashboard & Storage

- [Web Dashboard](https://github.com/munal0803/jobdehunt/blob/main/app.py): `app.py`
- [Job Views](https://github.com/munal0803/jobdehunt/blob/main/templates/index.html): `templates/index.html`
- [Job Store](https://github.com/munal0803/jobdehunt/blob/main/database.py): `database.py`

### Company Catalog

- [Candidate Lists](https://github.com/munal0803/jobdehunt/blob/main/build_candidates.py): `build_candidates.py`
- [Company Builder](https://github.com/munal0803/jobdehunt/blob/main/build_companies.py): `build_companies.py`
- [Validated Builder](https://github.com/munal0803/jobdehunt/blob/main/build_validated_companies.py): `build_validated_companies.py`
- [Slug Discovery](https://github.com/munal0803/jobdehunt/blob/main/discover_slugs.py): `discover_slugs.py`
- [Workday Discovery](https://github.com/munal0803/jobdehunt/blob/main/discover_workday.py): `discover_workday.py`

### Other components

- **Job Boards**
- **Dashboard User**
- **SQLite Database**

## Connections

- Scan Runner → Company Sources: iterates (evidence: `main.py`)
- Scan Runner → Job Fetchers: dispatches (evidence: `main.py`)
- Scan Runner → Job Filters: filters jobs (evidence: `main.py`)
- Scan Runner → Job Store: saves jobs (evidence: `main.py`)
- Job Fetchers → Job Boards: requests postings (evidence: `fetchers.py`)
- Job Fetchers → Job Filters: uses search settings (evidence: `fetchers.py`)
- Web Dashboard → Job Store: reads and updates (evidence: `app.py`)
- Web Dashboard → Job Filters: sorts and excludes (evidence: `app.py`)
- Web Dashboard → Job Views: renders (evidence: `app.py`)
- Dashboard User → Web Dashboard: views and updates
- Job Store → SQLite Database: reads and writes (evidence: `database.py`)
- Company Builder → Candidate Lists: loads candidates (evidence: `build_companies.py`)
- Validated Builder → Job Fetchers: uses fetchers (evidence: `build_validated_companies.py`)
- Slug Discovery → Job Fetchers: uses headers (evidence: `discover_slugs.py`)
- Slug Discovery → Job Filters: uses search text (evidence: `discover_slugs.py`)
- Workday Discovery → Job Fetchers: uses fetchers (evidence: `discover_workday.py`)
- Workday Discovery → Job Filters: uses search text (evidence: `discover_workday.py`)
