# hraghuwa/job-autoapplier-ai-latest architecture

> Architecture diagram of the GitHub repository hraghuwa/job-autoapplier-ai-latest, 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/hraghuwa/job-autoapplier-ai-latest
- Repository: https://github.com/hraghuwa/job-autoapplier-ai-latest

## Overview

Job Auto-Applier combines a web app and a standalone browser-based runner to discover roles and automate applications across job boards and company ATS forms. The web backend also documents career operations, application tracking, resume tools, analytics/graph views, onboarding, and payments. The principal workflow is user configuration → job discovery → platform-specific application → persisted application state. Edges are limited to README statements and source-index references; several larger subsystems are represented by their exact enclosing directories because their implementation was not sampled.

Main entry points: [`backend/routers`](https://github.com/hraghuwa/job-autoapplier-ai-latest/tree/main/backend/routers) (Product API Routes), [`agents/orchestrator.py`](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/agents/orchestrator.py) (Run Orchestration), [`main.py`](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/main.py) (Standalone Runner), [`web_search_applier.py`](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/web_search_applier.py) (ATS Web Apply)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_web_ui["Web Workspace"]
end

subgraph group_backend["Web Backend"]
  node_api["API and WebSockets<br/>[main.py]"]
  node_routers["Product API Routes"]
  node_task_worker["Agent Task Worker<br/>[agent_tasks.py]"]
  node_career_features["Career Operations<br/>[career_ops.py]"]
  node_analytics["Graph and Analytics<br/>[graph.py]"]
  node_billing["Plans and Payments<br/>[payments.py]"]
end

subgraph group_automation["Application Automation"]
  node_runner["Standalone Runner<br/>[main.py]"]
  node_orchestrator["Run Orchestration<br/>[orchestrator.py]"]
  node_job_search["Job Discovery<br/>[job_finder.py]"]
  node_linkedin["LinkedIn Apply"]
  node_web_apply["ATS Web Apply"]
  node_other_apply["Other Platforms<br/>[other_platforms.py]"]
end

subgraph group_intelligence["AI and Resumes"]
  node_form_fill["Application Form Fill"]
  node_llm{{"LLM Routing<br/>[llm_router.py]"}}
  node_resume_services["Resume Services"]
end

subgraph group_state["Persistence and Tracking"]
  node_database[("Application Database<br/>[database.py]")]
  node_application_records["Application Records<br/>[application.py]"]
end

node_user(("Job Seeker"))
node_job_sites["Job Sites and ATS"]
node_llm_providers{{"LLM Providers"}}

node_user -->|"starts run"| node_runner
node_runner -->|"discovers jobs"| node_job_search
node_runner -->|"runs applications"| node_linkedin
node_runner -->|"runs applications"| node_web_apply
node_job_search -->|"searches listings"| node_job_sites
node_web_apply -->|"applies on ATS"| node_job_sites
node_linkedin -->|"fills forms"| node_form_fill
node_web_apply -->|"uses form filler"| node_form_fill
node_form_fill -->|"resolves resume"| node_resume_services
node_user -.->|"configures job hunt"| node_web_ui
node_api -->|"registers routes"| node_routers
node_routers -->|"queues applications"| node_task_worker
node_task_worker -->|"invokes agents"| node_orchestrator
node_orchestrator -->|"invokes discovery"| node_job_search
node_orchestrator -->|"invokes platform agent"| node_linkedin
node_orchestrator -->|"invokes web agent"| node_web_apply
node_orchestrator -->|"invokes platform agent"| node_other_apply
node_form_fill -.->|"requests generation"| node_llm
node_llm -->|"calls providers"| node_llm_providers
node_api -->|"initializes schema"| node_database
node_database -->|"backs records"| node_application_records
node_routers -.->|"exposes career operations"| node_career_features
node_routers -.->|"exposes graph views"| node_analytics
node_routers -.->|"exposes payments"| node_billing

click node_web_ui "https://github.com/hraghuwa/job-autoapplier-ai-latest/tree/main/frontend/app"
click node_runner "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/main.py"
click node_api "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/main.py"
click node_routers "https://github.com/hraghuwa/job-autoapplier-ai-latest/tree/main/backend/routers"
click node_task_worker "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/workers/agent_tasks.py"
click node_orchestrator "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/agents/orchestrator.py"
click node_job_search "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/job_finder.py"
click node_linkedin "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/linkedin_applier.py"
click node_web_apply "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/web_search_applier.py"
click node_other_apply "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/other_platforms.py"
click node_form_fill "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/google_form_filler.py"
click node_llm "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/llm_router.py"
click node_resume_services "https://github.com/hraghuwa/job-autoapplier-ai-latest/tree/main/backend/services"
click node_career_features "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/routers/career_ops.py"
click node_analytics "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/routers/graph.py"
click node_billing "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/routers/payments.py"
click node_database "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/database.py"
click node_application_records "https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/models/application.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 toneBlue
class node_api,node_routers,node_task_worker,node_career_features,node_analytics,node_billing toneAmber
class node_runner,node_orchestrator,node_job_search,node_linkedin,node_web_apply,node_other_apply toneMint
class node_form_fill,node_llm,node_resume_services toneRose
class node_database,node_application_records,node_user,node_job_sites,node_llm_providers toneIndigo
```

## Components

### User Experience

- [Web Workspace](https://github.com/hraghuwa/job-autoapplier-ai-latest/tree/main/frontend/app): `frontend/app`

### Web Backend

- [API and WebSockets](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/main.py): `backend/main.py`
- [Product API Routes](https://github.com/hraghuwa/job-autoapplier-ai-latest/tree/main/backend/routers): `backend/routers`
- [Agent Task Worker](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/workers/agent_tasks.py): `backend/workers/agent_tasks.py`
- [Career Operations](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/routers/career_ops.py): `backend/routers/career_ops.py`
- [Graph and Analytics](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/routers/graph.py): `backend/routers/graph.py`
- [Plans and Payments](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/routers/payments.py): `backend/routers/payments.py`

### Application Automation

- [Standalone Runner](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/main.py): `main.py`
- [Run Orchestration](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/agents/orchestrator.py): `agents/orchestrator.py`
- [Job Discovery](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/job_finder.py): `job_finder.py`
- [LinkedIn Apply](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/linkedin_applier.py): `linkedin_applier.py`
- [ATS Web Apply](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/web_search_applier.py): `web_search_applier.py`
- [Other Platforms](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/other_platforms.py): `other_platforms.py`

### AI and Resumes

- [Application Form Fill](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/google_form_filler.py): `google_form_filler.py`
- [LLM Routing](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/llm_router.py): `llm_router.py`
- [Resume Services](https://github.com/hraghuwa/job-autoapplier-ai-latest/tree/main/backend/services): `backend/services`

### Persistence and Tracking

- [Application Database](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/database.py): `backend/database.py`
- [Application Records](https://github.com/hraghuwa/job-autoapplier-ai-latest/blob/main/backend/models/application.py): `backend/models/application.py`

### Other components

- **Job Seeker**
- **Job Sites and ATS**
- **LLM Providers**

## Connections

- Job Seeker → Standalone Runner: starts run (evidence: `README.md`)
- Standalone Runner → Job Discovery: discovers jobs (evidence: `main.py`)
- Standalone Runner → LinkedIn Apply: runs applications (evidence: `main.py`)
- Standalone Runner → ATS Web Apply: runs applications (evidence: `main.py`)
- Job Discovery → Job Sites and ATS: searches listings (evidence: `job_finder.py`)
- ATS Web Apply → Job Sites and ATS: applies on ATS (evidence: `web_search_applier.py`)
- LinkedIn Apply → Application Form Fill: fills forms (evidence: `linkedin_applier.py`)
- ATS Web Apply → Application Form Fill: uses form filler (evidence: `web_search_applier.py`)
- Application Form Fill → Resume Services: resolves resume (evidence: `google_form_filler.py`)
- Job Seeker → Web Workspace: configures job hunt (evidence: `README.md`)
- API and WebSockets → Product API Routes: registers routes (evidence: `backend/main.py`)
- Product API Routes → Agent Task Worker: queues applications (evidence: `backend/routers/applications.py`)
- Agent Task Worker → Run Orchestration: invokes agents (evidence: `backend/workers/agent_tasks.py`)
- Run Orchestration → Job Discovery: invokes discovery (evidence: `agents/orchestrator.py`)
- Run Orchestration → LinkedIn Apply: invokes platform agent (evidence: `agents/orchestrator.py`)
- Run Orchestration → ATS Web Apply: invokes web agent (evidence: `agents/orchestrator.py`)
- Run Orchestration → Other Platforms: invokes platform agent (evidence: `agents/orchestrator.py`)
- Application Form Fill → LLM Routing: requests generation
- LLM Routing → LLM Providers: calls providers (evidence: `llm_router.py`)
- API and WebSockets → Application Database: initializes schema (evidence: `backend/main.py`)
- Application Database → Application Records: backs records (evidence: `backend/models/application.py`)
- Product API Routes → Career Operations: exposes career operations
- Product API Routes → Graph and Analytics: exposes graph views
- Product API Routes → Plans and Payments: exposes payments
