# itsvats/get-a-job architecture

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

- Interactive diagram: https://gitdiagram.com/itsvats/get-a-job
- Repository: https://github.com/itsvats/get-a-job

## Overview

Get A Job guides a candidate from resume/profile setup to internship discovery and matching, then through assisted application preparation and explicit review before submission. The frontend calls the FastAPI backend through its proxy; backend services coordinate profile, job, and application workflows. README documents PDF resume parsing, local-model analysis, external job sources, and supported-form browser assistance. Some edges are omitted because relevant route and service implementations were not excerpted.

Main entry points: [`backend/app/main.py`](https://github.com/itsvats/get-a-job/blob/main/backend/app/main.py) (FastAPI routes), [`backend/app/api/jobs.py`](https://github.com/itsvats/get-a-job/blob/main/backend/app/api/jobs.py) (Job API), [`backend/app/services/applications.py`](https://github.com/itsvats/get-a-job/blob/main/backend/app/services/applications.py) (Application workflow), [`frontend/lib/api.ts`](https://github.com/itsvats/get-a-job/blob/main/frontend/lib/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Candidate interface"]
  node_web_ui["Web pages<br/>[page.tsx]"]
  node_job_browser["Job browser<br/>[job-browser.tsx]"]
  node_job_detail["Job detail<br/>[job-detail.tsx]"]
  node_apply_ui["Application assistant"]
  node_profile_ui["Profile editor<br/>[page.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_backend_proxy["Backend proxy<br/>[route.ts]"]
end

subgraph group_api["API and identity"]
  node_api_routes["FastAPI routes<br/>[main.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_database[("Application database<br/>[entities.py]")]
end

subgraph group_candidate["Candidate profile"]
  node_profile_routes["Profile and resume APIs<br/>[profile.py]"]
  node_resume_pipeline["Resume parsing<br/>[parser.py]"]
  node_profile_service["Profile service<br/>[profile.py]"]
  node_profile_types["Profile data model<br/>[profile.py]"]
end

subgraph group_discovery["Job discovery"]
  node_jobs_api["Job API<br/>[jobs.py]"]
  node_discovery_service["Job discovery<br/>[job_discovery.py]"]
  node_job_sources["Job sources<br/>[firecrawl.py]"]
  node_job_extract["Requirement extraction<br/>[job_extraction.py]"]
  node_job_match["Profile matching<br/>[job_matching.py]"]
  node_job_service["Job records<br/>[jobs.py]"]
end

subgraph group_apply["Application assistance"]
  node_applications_api["Application API<br/>[applications.py]"]
  node_application_service["Application workflow<br/>[applications.py]"]
  node_browser_service["Form automation<br/>[session.py]"]
  node_ai_provider["Local AI provider<br/>[ollama.py]"]
end

node_candidate_user(("Candidate"))
node_ollama["Ollama model"]
node_job_sites["Job listing sites"]

node_candidate_user -->|"uses"| node_web_ui
node_web_ui -.->|"renders"| node_job_browser
node_job_browser -.->|"requests jobs"| node_api_client
node_job_detail -->|"starts application"| node_apply_ui
node_apply_ui -.->|"prepares application"| node_api_client
node_profile_ui -.->|"updates profile"| node_api_client
node_api_client -.->|"sends requests"| node_backend_proxy
node_backend_proxy -.->|"forwards requests"| node_api_routes
node_api_routes -->|"requires identity"| node_auth
node_api_routes -->|"routes profile"| node_profile_routes
node_api_routes -->|"routes jobs"| node_jobs_api
node_api_routes -->|"routes applications"| node_applications_api
node_profile_routes -.->|"delegates profile"| node_profile_service
node_profile_routes -.->|"parses resume"| node_resume_pipeline
node_profile_service -.->|"reads/writes profile"| node_database
node_resume_pipeline -.->|"produces profile data"| node_profile_types
node_jobs_api -->|"starts discovery"| node_discovery_service
node_discovery_service -.->|"queries sources"| node_job_sources
node_job_sources -.->|"fetches listings"| node_job_sites
node_discovery_service -.->|"extracts requirements"| node_job_extract
node_jobs_api -->|"requests matching"| node_job_match
node_jobs_api -->|"serves job records"| node_job_service
node_applications_api -->|"delegates actions"| node_application_service
node_application_service -->|"controls form session"| node_browser_service
node_application_service -->|"drafts answers"| node_ai_provider
node_ai_provider -.->|"requests generation"| node_ollama
node_application_service -->|"reads/writes applications"| node_database

click node_web_ui "https://github.com/itsvats/get-a-job/blob/main/frontend/app/jobs/page.tsx"
click node_job_browser "https://github.com/itsvats/get-a-job/blob/main/frontend/components/job-browser.tsx"
click node_job_detail "https://github.com/itsvats/get-a-job/blob/main/frontend/components/job-detail.tsx"
click node_apply_ui "https://github.com/itsvats/get-a-job/blob/main/frontend/components/application-assistant.tsx"
click node_profile_ui "https://github.com/itsvats/get-a-job/blob/main/frontend/app/profile/page.tsx"
click node_api_client "https://github.com/itsvats/get-a-job/blob/main/frontend/lib/api.ts"
click node_backend_proxy "https://github.com/itsvats/get-a-job/blob/main/frontend/app/api/backend/%5B...path%5D/route.ts"
click node_api_routes "https://github.com/itsvats/get-a-job/blob/main/backend/app/main.py"
click node_auth "https://github.com/itsvats/get-a-job/blob/main/backend/app/core/auth.py"
click node_database "https://github.com/itsvats/get-a-job/blob/main/backend/app/models/entities.py"
click node_profile_routes "https://github.com/itsvats/get-a-job/blob/main/backend/app/api/profile.py"
click node_resume_pipeline "https://github.com/itsvats/get-a-job/blob/main/backend/app/resume/parser.py"
click node_profile_service "https://github.com/itsvats/get-a-job/blob/main/backend/app/services/profile.py"
click node_profile_types "https://github.com/itsvats/get-a-job/blob/main/backend/app/schemas/profile.py"
click node_jobs_api "https://github.com/itsvats/get-a-job/blob/main/backend/app/api/jobs.py"
click node_discovery_service "https://github.com/itsvats/get-a-job/blob/main/backend/app/services/job_discovery.py"
click node_job_sources "https://github.com/itsvats/get-a-job/blob/main/backend/app/jobs/firecrawl.py"
click node_job_extract "https://github.com/itsvats/get-a-job/blob/main/backend/app/services/job_extraction.py"
click node_job_match "https://github.com/itsvats/get-a-job/blob/main/backend/app/services/job_matching.py"
click node_job_service "https://github.com/itsvats/get-a-job/blob/main/backend/app/services/jobs.py"
click node_applications_api "https://github.com/itsvats/get-a-job/blob/main/backend/app/api/applications.py"
click node_application_service "https://github.com/itsvats/get-a-job/blob/main/backend/app/services/applications.py"
click node_browser_service "https://github.com/itsvats/get-a-job/blob/main/backend/app/browser/session.py"
click node_ai_provider "https://github.com/itsvats/get-a-job/blob/main/backend/app/ai/ollama.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_web_ui,node_job_browser,node_job_detail,node_apply_ui,node_profile_ui,node_api_client,node_backend_proxy toneBlue
class node_api_routes,node_auth,node_database toneAmber
class node_profile_routes,node_resume_pipeline,node_profile_service,node_profile_types toneMint
class node_jobs_api,node_discovery_service,node_job_sources,node_job_extract,node_job_match,node_job_service toneRose
class node_applications_api,node_application_service,node_browser_service,node_ai_provider,node_candidate_user,node_ollama,node_job_sites toneIndigo
```

## Components

### Candidate interface

- [Web pages](https://github.com/itsvats/get-a-job/blob/main/frontend/app/jobs/page.tsx): `frontend/app/jobs/page.tsx`
- [Job browser](https://github.com/itsvats/get-a-job/blob/main/frontend/components/job-browser.tsx): `frontend/components/job-browser.tsx`
- [Job detail](https://github.com/itsvats/get-a-job/blob/main/frontend/components/job-detail.tsx): `frontend/components/job-detail.tsx`
- [Application assistant](https://github.com/itsvats/get-a-job/blob/main/frontend/components/application-assistant.tsx): `frontend/components/application-assistant.tsx`
- [Profile editor](https://github.com/itsvats/get-a-job/blob/main/frontend/app/profile/page.tsx): `frontend/app/profile/page.tsx`
- [API client](https://github.com/itsvats/get-a-job/blob/main/frontend/lib/api.ts): `frontend/lib/api.ts`
- [Backend proxy](https://github.com/itsvats/get-a-job/blob/main/frontend/app/api/backend/%5B...path%5D/route.ts): `frontend/app/api/backend/[...path]/route.ts`

### API and identity

- [FastAPI routes](https://github.com/itsvats/get-a-job/blob/main/backend/app/main.py): `backend/app/main.py`
- [Authentication](https://github.com/itsvats/get-a-job/blob/main/backend/app/core/auth.py): `backend/app/core/auth.py`
- [Application database](https://github.com/itsvats/get-a-job/blob/main/backend/app/models/entities.py): `backend/app/models/entities.py`

### Candidate profile

- [Profile and resume APIs](https://github.com/itsvats/get-a-job/blob/main/backend/app/api/profile.py): `backend/app/api/profile.py`
- [Resume parsing](https://github.com/itsvats/get-a-job/blob/main/backend/app/resume/parser.py): `backend/app/resume/parser.py`
- [Profile service](https://github.com/itsvats/get-a-job/blob/main/backend/app/services/profile.py): `backend/app/services/profile.py`
- [Profile data model](https://github.com/itsvats/get-a-job/blob/main/backend/app/schemas/profile.py): `backend/app/schemas/profile.py`

### Job discovery

- [Job API](https://github.com/itsvats/get-a-job/blob/main/backend/app/api/jobs.py): `backend/app/api/jobs.py`
- [Job discovery](https://github.com/itsvats/get-a-job/blob/main/backend/app/services/job_discovery.py): `backend/app/services/job_discovery.py`
- [Job sources](https://github.com/itsvats/get-a-job/blob/main/backend/app/jobs/firecrawl.py): `backend/app/jobs/firecrawl.py`
- [Requirement extraction](https://github.com/itsvats/get-a-job/blob/main/backend/app/services/job_extraction.py): `backend/app/services/job_extraction.py`
- [Profile matching](https://github.com/itsvats/get-a-job/blob/main/backend/app/services/job_matching.py): `backend/app/services/job_matching.py`
- [Job records](https://github.com/itsvats/get-a-job/blob/main/backend/app/services/jobs.py): `backend/app/services/jobs.py`

### Application assistance

- [Application API](https://github.com/itsvats/get-a-job/blob/main/backend/app/api/applications.py): `backend/app/api/applications.py`
- [Application workflow](https://github.com/itsvats/get-a-job/blob/main/backend/app/services/applications.py): `backend/app/services/applications.py`
- [Form automation](https://github.com/itsvats/get-a-job/blob/main/backend/app/browser/session.py): `backend/app/browser/session.py`
- [Local AI provider](https://github.com/itsvats/get-a-job/blob/main/backend/app/ai/ollama.py): `backend/app/ai/ollama.py`

### Other components

- **Candidate**
- **Ollama model**
- **Job listing sites**

## Connections

- Candidate → Web pages: uses (evidence: `README.md`)
- Web pages → Job browser: renders
- Job browser → API client: requests jobs
- Job detail → Application assistant: starts application
- Application assistant → API client: prepares application
- Profile editor → API client: updates profile
- API client → Backend proxy: sends requests
- Backend proxy → FastAPI routes: forwards requests
- FastAPI routes → Authentication: requires identity
- FastAPI routes → Profile and resume APIs: routes profile (evidence: `backend/app/main.py`)
- FastAPI routes → Job API: routes jobs (evidence: `backend/app/main.py`)
- FastAPI routes → Application API: routes applications (evidence: `backend/app/main.py`)
- Profile and resume APIs → Profile service: delegates profile
- Profile and resume APIs → Resume parsing: parses resume
- Profile service → Application database: reads/writes profile
- Resume parsing → Profile data model: produces profile data
- Job API → Job discovery: starts discovery (evidence: `backend/app/api/jobs.py`)
- Job discovery → Job sources: queries sources
- Job sources → Job listing sites: fetches listings
- Job discovery → Requirement extraction: extracts requirements
- Job API → Profile matching: requests matching (evidence: `backend/app/api/jobs.py`)
- Job API → Job records: serves job records (evidence: `backend/app/api/jobs.py`)
- Application API → Application workflow: delegates actions (evidence: `backend/app/api/applications.py`)
- Application workflow → Form automation: controls form session (evidence: `backend/app/services/applications.py`)
- Application workflow → Local AI provider: drafts answers (evidence: `backend/app/services/applications.py`)
- Local AI provider → Ollama model: requests generation
- Application workflow → Application database: reads/writes applications (evidence: `backend/app/services/applications.py`)
