# blesszaglago-cmd/zagjobsearch architecture

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

- Interactive diagram: https://gitdiagram.com/blesszaglago-cmd/zagjobsearch
- Repository: https://github.com/blesszaglago-cmd/zagjobsearch

## Overview

ZAGJobSearch is a job-search aggregator with signup and login. Job seekers enter keywords and filters in the web app; the search page calls the FastAPI search endpoint, which queries Himalayas and, for eligible country/remote settings, Adzuna, then returns listings for display and direct application at the original posting. Signup and login are separate API flows backed by Supabase. The graph reflects sampled source and the SOURCE INDEX; Fuzu is excluded because the API explicitly marks it removed. The README is empty, so unsampled capabilities cannot be confirmed.

Main entry points: [`backend/main.py`](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/backend/main.py) (FastAPI routes), [`frontend/app/search/page.tsx`](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/app/search/page.tsx) (Job search UI), [`frontend/app/login/page.tsx`](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/app/login/page.tsx) (Login and signup), [`frontend/app/signup/page.tsx`](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/app/signup/page.tsx) (Signup form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_home["Landing page<br/>[page.tsx]"]
  node_search_ui["Job search UI<br/>[page.tsx]"]
  node_auth_ui["Login and signup<br/>[page.tsx]"]
  node_signup_ui["Signup form<br/>[page.tsx]"]
  node_api_config["API endpoint config<br/>[api.ts]"]
end

subgraph group_api["API orchestration"]
  node_fastapi["FastAPI routes<br/>[main.py]"]
end

subgraph group_sources["Job providers"]
  node_adzuna_client["Adzuna client<br/>[adzuna.py]"]
  node_himalayas_client["Himalayas client<br/>[himalayas.py]"]
end

subgraph group_identity["Identity and storage"]
  node_auth_logic["Signup and login logic<br/>[auth.py]"]
  node_supabase_client["Supabase client<br/>[supabase_client.py]"]
  node_profiles[("User profiles")]
end

node_seeker(("Job seeker"))
node_adzuna{{"Adzuna jobs API"}}
node_himalayas{{"Himalayas jobs API"}}
node_job_listing["Job posting"]
node_supabase{{"Supabase"}}

node_seeker -->|"visits"| node_home
node_home -->|"opens search"| node_search_ui
node_seeker -->|"sets filters"| node_search_ui
node_search_ui -->|"gets API URL"| node_api_config
node_search_ui -->|"requests jobs"| node_fastapi
node_fastapi -->|"searches always"| node_himalayas_client
node_fastapi -->|"searches conditionally"| node_adzuna_client
node_himalayas_client -->|"queries"| node_himalayas
node_adzuna_client -->|"queries"| node_adzuna
node_fastapi -->|"returns listings"| node_search_ui
node_search_ui -->|"links to apply"| node_job_listing
node_seeker -->|"enters credentials"| node_auth_ui
node_seeker -->|"submits signup"| node_signup_ui
node_auth_ui -->|"gets API URL"| node_api_config
node_signup_ui -->|"gets API URL"| node_api_config
node_auth_ui -->|"posts login"| node_fastapi
node_signup_ui -->|"posts signup"| node_fastapi
node_fastapi -->|"invokes auth"| node_auth_logic
node_auth_logic -->|"imports client"| node_supabase_client
node_auth_logic -->|"reads and writes"| node_profiles
node_supabase_client -->|"creates connection"| node_supabase
node_profiles -.->|"stored in"| node_supabase

click node_home "https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/app/page.tsx"
click node_search_ui "https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/app/search/page.tsx"
click node_auth_ui "https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/app/login/page.tsx"
click node_signup_ui "https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/app/signup/page.tsx"
click node_api_config "https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/lib/api.ts"
click node_fastapi "https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/backend/main.py"
click node_adzuna_client "https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/backend/job_sources/adzuna.py"
click node_himalayas_client "https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/backend/job_sources/himalayas.py"
click node_auth_logic "https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/backend/auth.py"
click node_supabase_client "https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/backend/database/supabase_client.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_home,node_search_ui,node_auth_ui,node_signup_ui,node_api_config toneBlue
class node_fastapi toneAmber
class node_adzuna_client,node_himalayas_client,node_adzuna,node_himalayas toneMint
class node_auth_logic,node_supabase_client,node_profiles toneRose
class node_seeker,node_job_listing,node_supabase toneIndigo
```

## Components

### Web experience

- [Landing page](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/app/page.tsx): `frontend/app/page.tsx`
- [Job search UI](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/app/search/page.tsx): `frontend/app/search/page.tsx`
- [Login and signup](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/app/login/page.tsx): `frontend/app/login/page.tsx`
- [Signup form](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/app/signup/page.tsx): `frontend/app/signup/page.tsx`
- [API endpoint config](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/frontend/lib/api.ts): `frontend/lib/api.ts`

### API orchestration

- [FastAPI routes](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/backend/main.py): `backend/main.py`

### Job providers

- [Adzuna client](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/backend/job_sources/adzuna.py): `backend/job_sources/adzuna.py`
- [Himalayas client](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/backend/job_sources/himalayas.py): `backend/job_sources/himalayas.py`

### Identity and storage

- [Signup and login logic](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/backend/auth.py): `backend/auth.py`
- [Supabase client](https://github.com/blesszaglago-cmd/zagjobsearch/blob/main/backend/database/supabase_client.py): `backend/database/supabase_client.py`
- **User profiles**

### Other components

- **Job seeker**
- **Adzuna jobs API**
- **Himalayas jobs API**
- **Job posting**
- **Supabase**

## Connections

- Job seeker → Landing page: visits
- Landing page → Job search UI: opens search (evidence: `frontend/app/page.tsx`)
- Job seeker → Job search UI: sets filters
- Job search UI → API endpoint config: gets API URL (evidence: `frontend/app/search/page.tsx`)
- Job search UI → FastAPI routes: requests jobs (evidence: `frontend/app/search/page.tsx`)
- FastAPI routes → Himalayas client: searches always (evidence: `backend/main.py`)
- FastAPI routes → Adzuna client: searches conditionally (evidence: `backend/main.py`)
- Himalayas client → Himalayas jobs API: queries (evidence: `backend/job_sources/himalayas.py`)
- Adzuna client → Adzuna jobs API: queries (evidence: `backend/job_sources/adzuna.py`)
- FastAPI routes → Job search UI: returns listings (evidence: `frontend/app/search/page.tsx`)
- Job search UI → Job posting: links to apply (evidence: `frontend/app/search/page.tsx`)
- Job seeker → Login and signup: enters credentials
- Job seeker → Signup form: submits signup
- Login and signup → API endpoint config: gets API URL (evidence: `frontend/app/login/page.tsx`)
- Signup form → API endpoint config: gets API URL (evidence: `frontend/app/signup/page.tsx`)
- Login and signup → FastAPI routes: posts login (evidence: `frontend/app/login/page.tsx`)
- Signup form → FastAPI routes: posts signup (evidence: `frontend/app/signup/page.tsx`)
- FastAPI routes → Signup and login logic: invokes auth (evidence: `backend/main.py`)
- Signup and login logic → Supabase client: imports client (evidence: `backend/auth.py`)
- Signup and login logic → User profiles: reads and writes (evidence: `backend/auth.py`)
- Supabase client → Supabase: creates connection (evidence: `backend/database/supabase_client.py`)
- User profiles → Supabase: stored in
