# ashishtiwari03/work-in-germany architecture

> Architecture diagram of the GitHub repository ashishtiwari03/work-in-germany, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ashishtiwari03/work-in-germany
- Repository: https://github.com/ashishtiwari03/work-in-germany

## Overview

This repository is an automated Germany-focused job board: a scraper gathers postings from several job platforms, filters and enriches them, and the README presents categorized listings alongside practical guides and a company directory. The sampled source shows provider-specific scraping and classification, but not the complete orchestration or persistence logic; connections to generated data artifacts are therefore limited to what the README documents.

Main entry points: [`scripts/scraper.py`](https://github.com/ashishtiwari03/work-in-germany/blob/main/scripts/scraper.py) (Job filtering and enrichment), [`README.md`](https://github.com/ashishtiwari03/work-in-germany/blob/main/README.md) (Categorized job listings), [`data/jobs.json`](https://github.com/ashishtiwari03/work-in-germany/blob/main/data/jobs.json) (Full job dataset), [`docs/COMPANIES.md`](https://github.com/ashishtiwari03/work-in-germany/blob/main/docs/COMPANIES.md) (Company directory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Job collection"]
  node_greenhouse["Greenhouse scraper<br/>[scraper.py]"]
  node_lever["Lever scraper<br/>[scraper.py]"]
  node_other_sources["Other source scrapers<br/>[scraper.py]"]
  node_job_enrichment["Job filtering and enrichment<br/>[scraper.py]"]
end

subgraph group_catalog["Job catalog"]
  node_category_catalog["Categorized job listings<br/>[README.md]"]
  node_job_data[("Full job dataset<br/>[jobs.json]")]
  node_job_stats[("Job statistics<br/>[stats.json]")]
end

subgraph group_resources["Career resources"]
  node_company_guide["Company directory<br/>[COMPANIES.md]"]
  node_cv_guide["CV guide<br/>[CV_GUIDE.md]"]
  node_visa_guide["Visa guide<br/>[VISA_GUIDE.md]"]
  node_salary_guide["Salary guide<br/>[SALARY_GUIDE.md]"]
  node_culture_guide["Work culture guide<br/>[CULTURE_GUIDE.md]"]
end

node_jobseeker(("Job seeker"))
node_greenhouse_api{{"Greenhouse API"}}
node_lever_api{{"Lever API"}}
node_jobspy{{"JobSpy source"}}

node_greenhouse -->|"fetches postings"| node_greenhouse_api
node_lever -->|"fetches postings"| node_lever_api
node_greenhouse -->|"filters and classifies"| node_job_enrichment
node_lever -->|"filters and classifies"| node_job_enrichment
node_other_sources -.->|"enriches postings"| node_job_enrichment
node_job_enrichment -->|"categorizes jobs"| node_category_catalog
node_jobseeker -->|"browses listings"| node_category_catalog
node_jobseeker -->|"browses full dataset"| node_job_data
node_jobseeker -->|"consults"| node_company_guide
node_jobseeker -->|"consults"| node_cv_guide
node_jobseeker -->|"consults"| node_visa_guide
node_jobseeker -->|"consults"| node_salary_guide
node_jobseeker -->|"consults"| node_culture_guide

click node_greenhouse "https://github.com/ashishtiwari03/work-in-germany/blob/main/scripts/scraper.py"
click node_lever "https://github.com/ashishtiwari03/work-in-germany/blob/main/scripts/scraper.py"
click node_other_sources "https://github.com/ashishtiwari03/work-in-germany/blob/main/scripts/scraper.py"
click node_job_enrichment "https://github.com/ashishtiwari03/work-in-germany/blob/main/scripts/scraper.py"
click node_category_catalog "https://github.com/ashishtiwari03/work-in-germany/blob/main/README.md"
click node_job_data "https://github.com/ashishtiwari03/work-in-germany/blob/main/data/jobs.json"
click node_job_stats "https://github.com/ashishtiwari03/work-in-germany/blob/main/data/stats.json"
click node_company_guide "https://github.com/ashishtiwari03/work-in-germany/blob/main/docs/COMPANIES.md"
click node_cv_guide "https://github.com/ashishtiwari03/work-in-germany/blob/main/docs/CV_GUIDE.md"
click node_visa_guide "https://github.com/ashishtiwari03/work-in-germany/blob/main/docs/VISA_GUIDE.md"
click node_salary_guide "https://github.com/ashishtiwari03/work-in-germany/blob/main/docs/SALARY_GUIDE.md"
click node_culture_guide "https://github.com/ashishtiwari03/work-in-germany/blob/main/docs/CULTURE_GUIDE.md"

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_greenhouse,node_lever,node_other_sources,node_job_enrichment toneBlue
class node_category_catalog,node_job_data,node_job_stats toneAmber
class node_company_guide,node_cv_guide,node_visa_guide,node_salary_guide,node_culture_guide,node_greenhouse_api,node_lever_api toneMint
class node_jobseeker,node_jobspy toneIndigo
```

## Components

### Job collection

- [Greenhouse scraper](https://github.com/ashishtiwari03/work-in-germany/blob/main/scripts/scraper.py): `scripts/scraper.py`
- [Lever scraper](https://github.com/ashishtiwari03/work-in-germany/blob/main/scripts/scraper.py): `scripts/scraper.py`
- [Other source scrapers](https://github.com/ashishtiwari03/work-in-germany/blob/main/scripts/scraper.py): `scripts/scraper.py`
- [Job filtering and enrichment](https://github.com/ashishtiwari03/work-in-germany/blob/main/scripts/scraper.py): `scripts/scraper.py`

### Job catalog

- [Categorized job listings](https://github.com/ashishtiwari03/work-in-germany/blob/main/README.md): `README.md`
- [Full job dataset](https://github.com/ashishtiwari03/work-in-germany/blob/main/data/jobs.json): `data/jobs.json`
- [Job statistics](https://github.com/ashishtiwari03/work-in-germany/blob/main/data/stats.json): `data/stats.json`

### Career resources

- [Company directory](https://github.com/ashishtiwari03/work-in-germany/blob/main/docs/COMPANIES.md): `docs/COMPANIES.md`
- [CV guide](https://github.com/ashishtiwari03/work-in-germany/blob/main/docs/CV_GUIDE.md): `docs/CV_GUIDE.md`
- [Visa guide](https://github.com/ashishtiwari03/work-in-germany/blob/main/docs/VISA_GUIDE.md): `docs/VISA_GUIDE.md`
- [Salary guide](https://github.com/ashishtiwari03/work-in-germany/blob/main/docs/SALARY_GUIDE.md): `docs/SALARY_GUIDE.md`
- [Work culture guide](https://github.com/ashishtiwari03/work-in-germany/blob/main/docs/CULTURE_GUIDE.md): `docs/CULTURE_GUIDE.md`

### Other components

- **Job seeker**
- **Greenhouse API**
- **Lever API**
- **JobSpy source**

## Connections

- Greenhouse scraper → Greenhouse API: fetches postings (evidence: `scripts/scraper.py`)
- Lever scraper → Lever API: fetches postings (evidence: `scripts/scraper.py`)
- Greenhouse scraper → Job filtering and enrichment: filters and classifies (evidence: `scripts/scraper.py`)
- Lever scraper → Job filtering and enrichment: filters and classifies (evidence: `scripts/scraper.py`)
- Other source scrapers → Job filtering and enrichment: enriches postings (evidence: `scripts/scraper.py`)
- Job filtering and enrichment → Categorized job listings: categorizes jobs (evidence: `scripts/scraper.py`)
- Job seeker → Categorized job listings: browses listings (evidence: `README.md`)
- Job seeker → Full job dataset: browses full dataset (evidence: `README.md`)
- Job seeker → Company directory: consults (evidence: `README.md`)
- Job seeker → CV guide: consults (evidence: `README.md`)
- Job seeker → Visa guide: consults (evidence: `README.md`)
- Job seeker → Salary guide: consults (evidence: `README.md`)
- Job seeker → Work culture guide: consults (evidence: `README.md`)
