# workdaysux/greenhouse-export architecture

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

- Interactive diagram: https://gitdiagram.com/workdaysux/greenhouse-export
- Repository: https://github.com/workdaysux/greenhouse-export

## Overview

Greenhouse Export Tool is a local command-line exporter. A user runs the launcher, supplies Greenhouse credentials once, and the launcher invokes the export workflow. That workflow authenticates with Greenhouse, retrieves candidate, application, and job data, prepares application records and resume downloads, then writes CSV reports and organized resume files. The README also documents parallel downloads, retries, and checkpoint-based recovery. Internal stages share greenhouse_export.py; the sampled excerpts show only parts of its implementation, so some documented capabilities are represented without inferring their internal call structure.

Main entry points: [`greenhouse_export.py`](https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py) (Export orchestrator), [`launcher.py`](https://github.com/workdaysux/greenhouse-export/blob/main/launcher.py) (Credential setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup"]
  node_launcher["Credential setup<br/>[launcher.py]"]
end

subgraph group_export["Export workflow"]
  node_export_main["Export orchestrator"]
  node_auth["OAuth token"]
  node_api_fetch["Paginated API fetch"]
  node_record_prep["Application preparation"]
  node_resume_download["Resume downloads"]
end

subgraph group_recovery["Progress and recovery"]
  node_progress["Progress tracker"]
  node_checkpoint[("Resume checkpoint")]
end

subgraph group_outputs["Export outputs"]
  node_csv_output["CSV reports"]
  node_resume_files["Organized resumes"]
end

node_user(("User"))
node_greenhouse["Greenhouse API"]

node_user -->|"runs"| node_launcher
node_launcher -->|"invokes"| node_export_main
node_export_main -->|"requests token"| node_auth
node_auth -->|"authenticates"| node_greenhouse
node_export_main -->|"fetches records"| node_api_fetch
node_api_fetch -->|"requests pages"| node_greenhouse
node_export_main -->|"prepares applications"| node_record_prep
node_export_main -->|"queues downloads"| node_resume_download
node_resume_download -.->|"downloads resumes"| node_greenhouse
node_export_main -->|"writes reports"| node_csv_output
node_resume_download -.->|"saves files"| node_resume_files
node_export_main -->|"tracks progress"| node_progress
node_progress -->|"loads and saves"| node_checkpoint
node_progress -.->|"records failures"| node_csv_output

click node_launcher "https://github.com/workdaysux/greenhouse-export/blob/main/launcher.py"
click node_export_main "https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py"
click node_auth "https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py"
click node_api_fetch "https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py"
click node_record_prep "https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py"
click node_resume_download "https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py"
click node_progress "https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py"
click node_checkpoint "https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py"
click node_csv_output "https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py"
click node_resume_files "https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_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_launcher,node_user toneBlue
class node_export_main,node_auth,node_api_fetch,node_record_prep,node_resume_download toneAmber
class node_progress,node_checkpoint,node_greenhouse toneMint
class node_csv_output,node_resume_files toneRose
```

## Components

### Setup

- [Credential setup](https://github.com/workdaysux/greenhouse-export/blob/main/launcher.py): `launcher.py`

### Export workflow

- [Export orchestrator](https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py): `greenhouse_export.py`
- [OAuth token](https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py): `greenhouse_export.py`
- [Paginated API fetch](https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py): `greenhouse_export.py`
- [Application preparation](https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py): `greenhouse_export.py`
- [Resume downloads](https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py): `greenhouse_export.py`

### Progress and recovery

- [Progress tracker](https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py): `greenhouse_export.py`
- [Resume checkpoint](https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py): `greenhouse_export.py`

### Export outputs

- [CSV reports](https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py): `greenhouse_export.py`
- [Organized resumes](https://github.com/workdaysux/greenhouse-export/blob/main/greenhouse_export.py): `greenhouse_export.py`

### Other components

- **User**
- **Greenhouse API**

## Connections

- User → Credential setup: runs (evidence: `README.md`)
- Credential setup → Export orchestrator: invokes (evidence: `launcher.py`)
- Export orchestrator → OAuth token: requests token (evidence: `greenhouse_export.py`)
- OAuth token → Greenhouse API: authenticates (evidence: `greenhouse_export.py`)
- Export orchestrator → Paginated API fetch: fetches records (evidence: `greenhouse_export.py`)
- Paginated API fetch → Greenhouse API: requests pages (evidence: `greenhouse_export.py`)
- Export orchestrator → Application preparation: prepares applications (evidence: `greenhouse_export.py`)
- Export orchestrator → Resume downloads: queues downloads (evidence: `greenhouse_export.py`)
- Resume downloads → Greenhouse API: downloads resumes (evidence: `README.md`)
- Export orchestrator → CSV reports: writes reports (evidence: `README.md`)
- Resume downloads → Organized resumes: saves files (evidence: `README.md`)
- Export orchestrator → Progress tracker: tracks progress (evidence: `greenhouse_export.py`)
- Progress tracker → Resume checkpoint: loads and saves (evidence: `greenhouse_export.py`)
- Progress tracker → CSV reports: records failures (evidence: `README.md`)
