# garvbhalla12/job-market-analyst architecture

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

- Interactive diagram: https://gitdiagram.com/garvbhalla12/job-market-analyst
- Repository: https://github.com/garvbhalla12/job-market-analyst

## Overview

The repository combines a FastAPI job-market API, whose implemented runtime workflow is authentication and refresh-token management, with a separate file-based job-data preparation workflow. The latter converts job JSON to CSV, cleans records, and extracts and counts technical skills. The supplied excerpts show those workflows but no connection between the analytics files and API. The graph therefore keeps them separate; it does not infer analytics endpoints or unseen integrations.

Main entry points: [`backend/routes/auth.py`](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/routes/auth.py) (Auth routes), [`backend/dependencies.py`](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/dependencies.py) (User dependency), [`backend/skill_extraction.py`](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/skill_extraction.py) (Skill extraction), [`backend/models.py`](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/models.py) (User and token models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Authentication API"]
  node_app["FastAPI app<br/>[main.py]"]
  node_authroutes["Auth routes<br/>[auth.py]"]
end

subgraph group_authcore["Auth Internals"]
  node_schemas["Auth schemas<br/>[schemas.py]"]
  node_security["Token security<br/>[security.py]"]
  node_dependencies["User dependency<br/>[dependencies.py]"]
  node_models["User and token models<br/>[models.py]"]
  node_database[("SQLite database<br/>[database.py]")]
end

subgraph group_analytics["Job Data Analytics"]
  node_convert["JSON conversion<br/>[convert_dataset.py]"]
  node_clean["Job data cleaning<br/>[data_cleaning.py]"]
  node_extract["Skill extraction"]
end

subgraph group_data["Dataset Files"]
  node_jobsjson["Jobs JSON<br/>[jobs.json]"]
  node_jobscsv["Jobs CSV<br/>[jobs.csv]"]
  node_cleaned["Cleaned jobs<br/>[jobs_cleaned.csv]"]
  node_withskills["Jobs with skills"]
  node_demand["Skill demand<br/>[skill_demand.csv]"]
end

node_user(("API client"))

node_user -->|"calls API"| node_app
node_app -->|"registers routes"| node_authroutes
node_authroutes -->|"uses request models"| node_schemas
node_authroutes -->|"hashes and issues tokens"| node_security
node_authroutes -->|"queries and updates"| node_models
node_authroutes -->|"gets DB session"| node_database
node_dependencies -->|"gets DB session"| node_database
node_dependencies -->|"loads user"| node_models
node_dependencies -->|"reads JWT settings"| node_security
node_models -->|"uses declarative base"| node_database
node_jobsjson -->|"read by"| node_convert
node_convert -->|"writes"| node_jobscsv
node_jobscsv -->|"read by"| node_clean
node_clean -->|"writes"| node_cleaned
node_cleaned -->|"read by"| node_extract
node_extract -->|"writes counts"| node_demand
node_extract -->|"writes annotations"| node_withskills

click node_app "https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/main.py"
click node_authroutes "https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/routes/auth.py"
click node_schemas "https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/schemas.py"
click node_security "https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/security.py"
click node_dependencies "https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/dependencies.py"
click node_models "https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/models.py"
click node_database "https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/database.py"
click node_convert "https://github.com/garvbhalla12/job-market-analyst/blob/main/convert_dataset.py"
click node_clean "https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/data_cleaning.py"
click node_extract "https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/skill_extraction.py"
click node_jobsjson "https://github.com/garvbhalla12/job-market-analyst/blob/main/dataset/jobs.json"
click node_jobscsv "https://github.com/garvbhalla12/job-market-analyst/blob/main/dataset/jobs.csv"
click node_cleaned "https://github.com/garvbhalla12/job-market-analyst/blob/main/dataset/jobs_cleaned.csv"
click node_withskills "https://github.com/garvbhalla12/job-market-analyst/blob/main/dataset/jobs_with_skills.csv"
click node_demand "https://github.com/garvbhalla12/job-market-analyst/blob/main/dataset/skill_demand.csv"

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_app,node_authroutes,node_user toneBlue
class node_schemas,node_security,node_dependencies,node_models,node_database toneAmber
class node_convert,node_clean,node_extract toneMint
class node_jobsjson,node_jobscsv,node_cleaned,node_withskills,node_demand toneRose
```

## Components

### Authentication API

- [FastAPI app](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/main.py): `backend/main.py`
- [Auth routes](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/routes/auth.py): `backend/routes/auth.py`

### Auth Internals

- [Auth schemas](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/schemas.py): `backend/schemas.py`
- [Token security](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/security.py): `backend/security.py`
- [User dependency](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/dependencies.py): `backend/dependencies.py`
- [User and token models](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/models.py): `backend/models.py`
- [SQLite database](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/database.py): `backend/database.py`

### Job Data Analytics

- [JSON conversion](https://github.com/garvbhalla12/job-market-analyst/blob/main/convert_dataset.py): `convert_dataset.py`
- [Job data cleaning](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/data_cleaning.py): `backend/data_cleaning.py`
- [Skill extraction](https://github.com/garvbhalla12/job-market-analyst/blob/main/backend/skill_extraction.py): `backend/skill_extraction.py`

### Dataset Files

- [Jobs JSON](https://github.com/garvbhalla12/job-market-analyst/blob/main/dataset/jobs.json): `dataset/jobs.json`
- [Jobs CSV](https://github.com/garvbhalla12/job-market-analyst/blob/main/dataset/jobs.csv): `dataset/jobs.csv`
- [Cleaned jobs](https://github.com/garvbhalla12/job-market-analyst/blob/main/dataset/jobs_cleaned.csv): `dataset/jobs_cleaned.csv`
- [Jobs with skills](https://github.com/garvbhalla12/job-market-analyst/blob/main/dataset/jobs_with_skills.csv): `dataset/jobs_with_skills.csv`
- [Skill demand](https://github.com/garvbhalla12/job-market-analyst/blob/main/dataset/skill_demand.csv): `dataset/skill_demand.csv`

### Other components

- **API client**

## Connections

- API client → FastAPI app: calls API
- FastAPI app → Auth routes: registers routes (evidence: `backend/main.py`)
- Auth routes → Auth schemas: uses request models (evidence: `backend/routes/auth.py`)
- Auth routes → Token security: hashes and issues tokens (evidence: `backend/routes/auth.py`)
- Auth routes → User and token models: queries and updates (evidence: `backend/routes/auth.py`)
- Auth routes → SQLite database: gets DB session (evidence: `backend/routes/auth.py`)
- User dependency → SQLite database: gets DB session (evidence: `backend/dependencies.py`)
- User dependency → User and token models: loads user (evidence: `backend/dependencies.py`)
- User dependency → Token security: reads JWT settings (evidence: `backend/dependencies.py`)
- User and token models → SQLite database: uses declarative base (evidence: `backend/models.py`)
- Jobs JSON → JSON conversion: read by (evidence: `convert_dataset.py`)
- JSON conversion → Jobs CSV: writes (evidence: `convert_dataset.py`)
- Jobs CSV → Job data cleaning: read by (evidence: `backend/data_cleaning.py`)
- Job data cleaning → Cleaned jobs: writes (evidence: `backend/data_cleaning.py`)
- Cleaned jobs → Skill extraction: read by (evidence: `backend/skill_extraction.py`)
- Skill extraction → Skill demand: writes counts (evidence: `backend/skill_extraction.py`)
- Skill extraction → Jobs with skills: writes annotations (evidence: `backend/skill_extraction.py`)
