# tejaswinikannan/job-search-platform architecture

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

- Interactive diagram: https://gitdiagram.com/tejaswinikannan/job-search-platform
- Repository: https://github.com/tejaswinikannan/job-search-platform

## Overview

Job Board is a React frontend backed by a FastAPI CRUD and search API. Users browse listings, open details, and employers create, edit, or delete jobs. Natural-language search parses a query, retrieves semantic candidates, reranks them, and applies structured filters. The API persists jobs and company records in SQLite; semantic search also uses a persisted Chroma index and external LLM services. Edges reflect the sampled calls and README-documented capabilities; unsampled page-to-API details are not inferred beyond those documented.

Main entry points: [`frontend/src/App.jsx`](https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/App.jsx) (Routes & mutations), [`api/app/routes/jobs.py`](https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/routes/jobs.py) (Job endpoints), [`frontend/src/pages/JobsPage.jsx`](https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/pages/JobsPage.jsx) (Browse & search), [`frontend/src/components/JobListings.jsx`](https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/components/JobListings.jsx) (Listing cards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["Routes &amp; mutations<br/>[App.jsx]"]
  node_home["Home page<br/>[HomePage.jsx]"]
  node_browse["Browse &amp; search<br/>[JobsPage.jsx]"]
  node_listingview["Listing cards<br/>[JobListings.jsx]"]
  node_detail["Job details<br/>[JobPage.jsx]"]
  node_add["Create listing<br/>[AddJobPage.jsx]"]
  node_edit["Edit listing<br/>[EditJobPage.jsx]"]
  node_layout["Shared layout<br/>[MainLayout.jsx]"]
end

subgraph group_api["Job API"]
  node_apiapp["FastAPI application<br/>[main.py]"]
  node_jobsapi["Job endpoints<br/>[jobs.py]"]
  node_schemas["API schemas<br/>[schemas.py]"]
end

subgraph group_search["Search services"]
  node_nlp["Query parsing<br/>[nlp_search.py]"]
  node_vector["Semantic retrieval<br/>[vector_search.py]"]
  node_rerank["Result reranking<br/>[rerank.py]"]
  node_chroma[("Chroma vector index<br/>[vector_search.py]")]
end

subgraph group_data["Persistence"]
  node_database["DB sessions<br/>[database.py]"]
  node_models["Job &amp; company models<br/>[models.py]"]
  node_sqlite[("SQLite job store<br/>[jobs.json]")]
end

node_user(("Job seekers &amp; employers"))
node_openai["OpenAI LLM"]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_browse
node_app -->|"routes to"| node_detail
node_app -->|"routes to"| node_add
node_app -->|"routes to"| node_edit
node_app -->|"wraps routes"| node_layout
node_browse -->|"renders"| node_listingview
node_home -->|"renders"| node_listingview
node_listingview -->|"fetches listings"| node_jobsapi
node_app -->|"submits mutations"| node_jobsapi
node_detail -->|"loads listing"| node_jobsapi
node_add -.->|"submits listing"| node_app
node_edit -->|"submits changes"| node_app
node_apiapp -->|"mounts router"| node_jobsapi
node_jobsapi -->|"requests session"| node_database
node_jobsapi -->|"queries records"| node_models
node_models -->|"uses base"| node_database
node_jobsapi -->|"validates payloads"| node_schemas
node_jobsapi -->|"parses query"| node_nlp
node_jobsapi -->|"retrieves candidates"| node_vector
node_jobsapi -->|"reranks candidates"| node_rerank
node_nlp -->|"invokes LLM"| node_openai
node_rerank -.->|"judges relevance"| node_openai
node_vector -->|"queries index"| node_chroma
node_database -->|"stores records"| node_sqlite
node_user -->|"searches listings"| node_browse

click node_app "https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/pages/HomePage.jsx"
click node_browse "https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/pages/JobsPage.jsx"
click node_listingview "https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/components/JobListings.jsx"
click node_detail "https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/pages/JobPage.jsx"
click node_add "https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/pages/AddJobPage.jsx"
click node_edit "https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/pages/EditJobPage.jsx"
click node_layout "https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/layouts/MainLayout.jsx"
click node_apiapp "https://github.com/tejaswinikannan/job-search-platform/blob/main/api/main.py"
click node_jobsapi "https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/routes/jobs.py"
click node_schemas "https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/schemas.py"
click node_nlp "https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/nlp_search.py"
click node_vector "https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/vector_search.py"
click node_rerank "https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/rerank.py"
click node_database "https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/database.py"
click node_models "https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/models.py"
click node_sqlite "https://github.com/tejaswinikannan/job-search-platform/blob/main/api/data/jobs.json"
click node_chroma "https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/vector_search.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_app,node_home,node_browse,node_listingview,node_detail,node_add,node_edit,node_layout toneBlue
class node_apiapp,node_jobsapi,node_schemas toneAmber
class node_nlp,node_vector,node_rerank,node_chroma toneMint
class node_database,node_models,node_sqlite toneRose
class node_user,node_openai toneIndigo
```

## Components

### Web experience

- [Routes & mutations](https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Home page](https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/pages/HomePage.jsx): `frontend/src/pages/HomePage.jsx`
- [Browse & search](https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/pages/JobsPage.jsx): `frontend/src/pages/JobsPage.jsx`
- [Listing cards](https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/components/JobListings.jsx): `frontend/src/components/JobListings.jsx`
- [Job details](https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/pages/JobPage.jsx): `frontend/src/pages/JobPage.jsx`
- [Create listing](https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/pages/AddJobPage.jsx): `frontend/src/pages/AddJobPage.jsx`
- [Edit listing](https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/pages/EditJobPage.jsx): `frontend/src/pages/EditJobPage.jsx`
- [Shared layout](https://github.com/tejaswinikannan/job-search-platform/blob/main/frontend/src/layouts/MainLayout.jsx): `frontend/src/layouts/MainLayout.jsx`

### Job API

- [FastAPI application](https://github.com/tejaswinikannan/job-search-platform/blob/main/api/main.py): `api/main.py`
- [Job endpoints](https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/routes/jobs.py): `api/app/routes/jobs.py`
- [API schemas](https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/schemas.py): `api/app/schemas.py`

### Search services

- [Query parsing](https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/nlp_search.py): `api/app/nlp_search.py`
- [Semantic retrieval](https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/vector_search.py): `api/app/vector_search.py`
- [Result reranking](https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/rerank.py): `api/app/rerank.py`
- [Chroma vector index](https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/vector_search.py): `api/app/vector_search.py`

### Persistence

- [DB sessions](https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/database.py): `api/app/database.py`
- [Job & company models](https://github.com/tejaswinikannan/job-search-platform/blob/main/api/app/models.py): `api/app/models.py`
- [SQLite job store](https://github.com/tejaswinikannan/job-search-platform/blob/main/api/data/jobs.json): `api/data/jobs.json`

### Other components

- **Job seekers & employers**
- **OpenAI LLM**

## Connections

- Job seekers & employers → Routes & mutations: uses (evidence: `README.md`)
- Routes & mutations → Home page: routes to (evidence: `frontend/src/App.jsx`)
- Routes & mutations → Browse & search: routes to (evidence: `frontend/src/App.jsx`)
- Routes & mutations → Job details: routes to (evidence: `frontend/src/App.jsx`)
- Routes & mutations → Create listing: routes to (evidence: `frontend/src/App.jsx`)
- Routes & mutations → Edit listing: routes to (evidence: `frontend/src/App.jsx`)
- Routes & mutations → Shared layout: wraps routes (evidence: `frontend/src/App.jsx`)
- Browse & search → Listing cards: renders (evidence: `frontend/src/pages/JobsPage.jsx`)
- Home page → Listing cards: renders (evidence: `frontend/src/pages/HomePage.jsx`)
- Listing cards → Job endpoints: fetches listings (evidence: `frontend/src/components/JobListings.jsx`)
- Routes & mutations → Job endpoints: submits mutations (evidence: `frontend/src/App.jsx`)
- Job details → Job endpoints: loads listing (evidence: `README.md`)
- Create listing → Routes & mutations: submits listing (evidence: `frontend/src/App.jsx`)
- Edit listing → Routes & mutations: submits changes (evidence: `frontend/src/App.jsx`)
- FastAPI application → Job endpoints: mounts router (evidence: `api/main.py`)
- Job endpoints → DB sessions: requests session (evidence: `api/app/routes/jobs.py`)
- Job endpoints → Job & company models: queries records (evidence: `api/app/routes/jobs.py`)
- Job & company models → DB sessions: uses base (evidence: `api/app/models.py`)
- Job endpoints → API schemas: validates payloads (evidence: `api/app/routes/jobs.py`)
- Job endpoints → Query parsing: parses query (evidence: `api/app/routes/jobs.py`)
- Job endpoints → Semantic retrieval: retrieves candidates (evidence: `api/app/routes/jobs.py`)
- Job endpoints → Result reranking: reranks candidates (evidence: `api/app/routes/jobs.py`)
- Query parsing → OpenAI LLM: invokes LLM (evidence: `api/app/nlp_search.py`)
- Result reranking → OpenAI LLM: judges relevance
- Semantic retrieval → Chroma vector index: queries index (evidence: `api/app/vector_search.py`)
- DB sessions → SQLite job store: stores records (evidence: `README.md`)
- Job seekers & employers → Browse & search: searches listings (evidence: `README.md`)
