# shashwat023/resume-automate architecture

> Architecture diagram of the GitHub repository shashwat023/resume-automate, 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/shashwat023/resume-automate
- Repository: https://github.com/shashwat023/resume-automate

## Overview

Career-Ops automates job applications: candidates maintain a profile and resume, discover postings, select jobs for a queue, and have a browser-driven engine fill and optionally submit applications. Its resolver escalates from deterministic field matching to LLM answers and custom-widget actions, pausing for human input when needed. The product also includes tracked-company discovery, CAPTCHA handling, queue controls, and live browser/log views. Relationships for unsampled API and engine internals are limited to documented README behavior; the graph does not imply unverified call sequences.

Main entry points: [`frontend/src/app/router.tsx`](https://github.com/shashwat023/resume-automate/blob/main/frontend/src/app/router.tsx) (Web application), [`backend/app/services/engine/runner.py`](https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/engine/runner.py) (Application engine), [`backend/app/main.py`](https://github.com/shashwat023/resume-automate/blob/main/backend/app/main.py) (Backend application), [`backend/app/services/apply_service.py`](https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/apply_service.py) (Application lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_candidate["Candidate data"]
  node_profileapi["Profile API<br/>[profile.py]"]
  node_resumeapi["Resume API<br/>[resume.py]"]
  node_resumeprocessing["Resume processing<br/>[resume_service.py]"]
  node_database[("Application database<br/>[db_models.py]")]
end

subgraph group_discovery["Job discovery"]
  node_jobsearch["Job search service"]
  node_scraper["Job scraper<br/>[sync_service.py]"]
  node_bulksync["Tracked-company sync"]
end

subgraph group_applications["Application workflow"]
  node_applyapi["Application API<br/>[apply.py]"]
  node_applyservice["Application lifecycle<br/>[apply_service.py]"]
  node_worker["Queue worker<br/>[queue_runner.py]"]
  node_backend["Backend application<br/>[main.py]"]
end

subgraph group_automation["Browser automation"]
  node_engine["Application engine<br/>[runner.py]"]
  node_chrome["Chrome launcher<br/>[chrome_launcher.py]"]
  node_llm["LLM resolver<br/>[llm_client.py]"]
  node_captcha["CAPTCHA service<br/>[service.py]"]
end

subgraph group_interface["Candidate interface"]
  node_frontend["Web application<br/>[router.tsx]"]
  node_profileui["Profile editor"]
  node_resumeui["Resume manager<br/>[resume.queries.ts]"]
  node_searchui["Job search<br/>[SearchPage.tsx]"]
  node_queueui["Queue and live view<br/>[LiveView.tsx]"]
end

node_candidate(("Candidate"))

node_candidate -->|"uses"| node_frontend
node_frontend -.->|"edits profile"| node_profileui
node_frontend -.->|"manages resume"| node_resumeui
node_frontend -->|"searches jobs"| node_searchui
node_frontend -.->|"monitors queue"| node_queueui
node_profileui -.->|"saves profile"| node_profileapi
node_resumeui -.->|"uploads resume"| node_resumeapi
node_resumeapi -.->|"processes upload"| node_resumeprocessing
node_searchui -.->|"requests jobs"| node_jobsearch
node_jobsearch -->|"reads jobs"| node_database
node_scraper -->|"upserts postings"| node_database
node_bulksync -->|"syncs companies"| node_scraper
node_applyapi -.->|"delegates lifecycle"| node_applyservice
node_applyservice -->|"stores application"| node_database
node_applyservice -->|"enqueues application"| node_worker
node_worker -->|"runs application"| node_engine
node_engine -.->|"launches browser"| node_chrome
node_engine -.->|"resolves fields"| node_llm
node_engine -.->|"solves challenge"| node_captcha
node_candidate -.->|"provides input"| node_engine
node_backend -->|"mounts routes"| node_applyapi
node_backend -->|"mounts routes"| node_profileapi
node_backend -->|"mounts routes"| node_resumeapi
node_backend -.->|"serves backend"| node_jobsearch

click node_frontend "https://github.com/shashwat023/resume-automate/blob/main/frontend/src/app/router.tsx"
click node_profileui "https://github.com/shashwat023/resume-automate/blob/main/frontend/src/features/profile/hooks/useAutosaveProfile.ts"
click node_resumeui "https://github.com/shashwat023/resume-automate/blob/main/frontend/src/features/resume/services/resume.queries.ts"
click node_searchui "https://github.com/shashwat023/resume-automate/blob/main/frontend/src/pages/SearchPage.tsx"
click node_queueui "https://github.com/shashwat023/resume-automate/blob/main/frontend/src/features/queue/components/LiveView.tsx"
click node_profileapi "https://github.com/shashwat023/resume-automate/blob/main/backend/app/api/profile.py"
click node_resumeapi "https://github.com/shashwat023/resume-automate/blob/main/backend/app/api/resume.py"
click node_resumeprocessing "https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/resume_service.py"
click node_jobsearch "https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/job_search_service.py"
click node_scraper "https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/scraper/sync_service.py"
click node_bulksync "https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/scraper/bulk_sync_service.py"
click node_applyapi "https://github.com/shashwat023/resume-automate/blob/main/backend/app/api/apply.py"
click node_applyservice "https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/apply_service.py"
click node_worker "https://github.com/shashwat023/resume-automate/blob/main/backend/app/worker/queue_runner.py"
click node_engine "https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/engine/runner.py"
click node_chrome "https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/browser/chrome_launcher.py"
click node_llm "https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/engine/llm_client.py"
click node_captcha "https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/captcha/service.py"
click node_database "https://github.com/shashwat023/resume-automate/blob/main/backend/app/models/db_models.py"
click node_backend "https://github.com/shashwat023/resume-automate/blob/main/backend/app/main.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_profileapi,node_resumeapi,node_resumeprocessing,node_database toneBlue
class node_jobsearch,node_scraper,node_bulksync toneAmber
class node_applyapi,node_applyservice,node_worker,node_backend toneMint
class node_engine,node_chrome,node_llm,node_captcha toneRose
class node_frontend,node_profileui,node_resumeui,node_searchui,node_queueui,node_candidate toneIndigo
```

## Components

### Candidate data

- [Profile API](https://github.com/shashwat023/resume-automate/blob/main/backend/app/api/profile.py): `backend/app/api/profile.py`
- [Resume API](https://github.com/shashwat023/resume-automate/blob/main/backend/app/api/resume.py): `backend/app/api/resume.py`
- [Resume processing](https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/resume_service.py): `backend/app/services/resume_service.py`
- [Application database](https://github.com/shashwat023/resume-automate/blob/main/backend/app/models/db_models.py): `backend/app/models/db_models.py`

### Job discovery

- [Job search service](https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/job_search_service.py): `backend/app/services/job_search_service.py`
- [Job scraper](https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/scraper/sync_service.py): `backend/app/services/scraper/sync_service.py`
- [Tracked-company sync](https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/scraper/bulk_sync_service.py): `backend/app/services/scraper/bulk_sync_service.py`

### Application workflow

- [Application API](https://github.com/shashwat023/resume-automate/blob/main/backend/app/api/apply.py): `backend/app/api/apply.py`
- [Application lifecycle](https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/apply_service.py): `backend/app/services/apply_service.py`
- [Queue worker](https://github.com/shashwat023/resume-automate/blob/main/backend/app/worker/queue_runner.py): `backend/app/worker/queue_runner.py`
- [Backend application](https://github.com/shashwat023/resume-automate/blob/main/backend/app/main.py): `backend/app/main.py`

### Browser automation

- [Application engine](https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/engine/runner.py): `backend/app/services/engine/runner.py`
- [Chrome launcher](https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/browser/chrome_launcher.py): `backend/app/services/browser/chrome_launcher.py`
- [LLM resolver](https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/engine/llm_client.py): `backend/app/services/engine/llm_client.py`
- [CAPTCHA service](https://github.com/shashwat023/resume-automate/blob/main/backend/app/services/captcha/service.py): `backend/app/services/captcha/service.py`

### Candidate interface

- [Web application](https://github.com/shashwat023/resume-automate/blob/main/frontend/src/app/router.tsx): `frontend/src/app/router.tsx`
- [Profile editor](https://github.com/shashwat023/resume-automate/blob/main/frontend/src/features/profile/hooks/useAutosaveProfile.ts): `frontend/src/features/profile/hooks/useAutosaveProfile.ts`
- [Resume manager](https://github.com/shashwat023/resume-automate/blob/main/frontend/src/features/resume/services/resume.queries.ts): `frontend/src/features/resume/services/resume.queries.ts`
- [Job search](https://github.com/shashwat023/resume-automate/blob/main/frontend/src/pages/SearchPage.tsx): `frontend/src/pages/SearchPage.tsx`
- [Queue and live view](https://github.com/shashwat023/resume-automate/blob/main/frontend/src/features/queue/components/LiveView.tsx): `frontend/src/features/queue/components/LiveView.tsx`

### Other components

- **Candidate**

## Connections

- Candidate → Web application: uses
- Web application → Profile editor: edits profile
- Web application → Resume manager: manages resume
- Web application → Job search: searches jobs (evidence: `frontend/src/app/router.tsx`)
- Web application → Queue and live view: monitors queue
- Profile editor → Profile API: saves profile
- Resume manager → Resume API: uploads resume
- Resume API → Resume processing: processes upload
- Job search → Job search service: requests jobs
- Job search service → Application database: reads jobs (evidence: `backend/app/services/job_search_service.py`)
- Job scraper → Application database: upserts postings (evidence: `backend/app/services/scraper/sync_service.py`)
- Tracked-company sync → Job scraper: syncs companies (evidence: `backend/app/services/scraper/bulk_sync_service.py`)
- Application API → Application lifecycle: delegates lifecycle (evidence: `backend/app/services/apply_service.py`)
- Application lifecycle → Application database: stores application (evidence: `backend/app/services/apply_service.py`)
- Application lifecycle → Queue worker: enqueues application (evidence: `backend/app/services/apply_service.py`)
- Queue worker → Application engine: runs application (evidence: `backend/app/main.py`)
- Application engine → Chrome launcher: launches browser
- Application engine → LLM resolver: resolves fields (evidence: `backend/app/services/engine/llm_client.py`)
- Application engine → CAPTCHA service: solves challenge
- Candidate → Application engine: provides input
- Backend application → Application API: mounts routes (evidence: `backend/app/main.py`)
- Backend application → Profile API: mounts routes (evidence: `backend/app/main.py`)
- Backend application → Resume API: mounts routes (evidence: `backend/app/main.py`)
- Backend application → Job search service: serves backend
