# joshkumar50/autojob-ai- architecture

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

- Interactive diagram: https://gitdiagram.com/joshkumar50/autojob-ai-
- Repository: https://github.com/joshkumar50/autojob-ai-

## Overview

AutoJob AI supports job discovery, profile and skill grounding, resume tailoring or direct-resume selection, and human-supervised application automation. The documented workflow starts with scraping and matching jobs, then queues a selected resume for optimization or direct dispatch before a browser agent fills the portal application and pauses for human authorization. Evidence is limited to the README and sampled/indexed files; unsampled subsystem connections are omitted where not shown.

Main entry points: [`backend/routers`](https://github.com/joshkumar50/autojob-ai-/tree/main/backend/routers) (API Routers), [`backend/database.py`](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/database.py) (SQLite Database), [`backend/modules/profile_manager.py`](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/profile_manager.py) (Profile Manager), [`backend/routers/jobs.py`](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/routers/jobs.py) (Job Feed)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User Experience"]
  node_web["Web App"]
end

subgraph group_workflow["Job Workflow"]
  node_jobs["Job Feed<br/>[jobs.py]"]
  node_scraper["Portal Scraper<br/>[scraper_engine.py]"]
  node_matcher["Job Matcher<br/>[job_matcher.py]"]
  node_pipeline["Application Pipeline"]
  node_agent["Browser Agent<br/>[browser_agent.py]"]
end

subgraph group_intelligence["Resume Intelligence"]
  node_profile["Profile Manager<br/>[profile_manager.py]"]
  node_skills["Skill Corpus<br/>[skill_corpus.py]"]
  node_optimizer["ATS Optimizer<br/>[ats_optimizer.py]"]
  node_coverletter["Cover Letter<br/>[cover_letter.py]"]
  node_llm["LLM Client<br/>[llm.py]"]
end

subgraph group_platform["Application Platform"]
  node_api["API Routers"]
  node_security["Credential Security<br/>[security.py]"]
  node_db[("SQLite Database<br/>[database.py]")]
  node_jobmodel["Job Records<br/>[job.py]"]
  node_applicationmodel["Application Records<br/>[application.py]"]
  node_resumemodel["Resume Versions<br/>[resume.py]"]
  node_skillmodel["Verified Skills<br/>[skill.py]"]
  node_usermodel["User Profile<br/>[user.py]"]
  node_covermodel["Cover Letters<br/>[cover_letter.py]"]
end

node_user(("Job Seeker"))
node_portals["Job Portals"]
node_github["GitHub Repositories"]
node_llmservice["Gemini / Ollama"]

node_user -->|"uses"| node_web
node_web -->|"calls API"| node_api
node_api -->|"routes requests"| node_jobs
node_jobs -->|"starts scraping"| node_scraper
node_scraper -->|"fetches listings"| node_portals
node_jobs -->|"scores listings"| node_matcher
node_jobs -->|"queues applications"| node_pipeline
node_pipeline -->|"updates state"| node_applicationmodel
node_api -->|"controls session"| node_agent
node_agent -->|"fills application"| node_portals
node_api -->|"requests tailoring"| node_optimizer
node_optimizer -->|"generates revisions"| node_llm
node_llm -->|"sends prompts"| node_llmservice
node_optimizer -->|"grounds edits"| node_skills
node_api -->|"manages profile"| node_profile
node_profile -->|"extracts skills"| node_llm
node_profile -->|"fetches repositories"| node_github
node_profile -->|"stores credentials"| node_security
node_api -->|"generates letters"| node_coverletter
node_coverletter -->|"drafts content"| node_llm
node_coverletter -->|"persists letters"| node_covermodel
node_scraper -->|"persists listings"| node_jobmodel
node_db -->|"maps records"| node_jobmodel
node_db -->|"maps records"| node_applicationmodel
node_db -->|"maps records"| node_resumemodel
node_db -->|"maps records"| node_skillmodel
node_db -->|"maps records"| node_usermodel
node_pipeline -.->|"stores state"| node_db
node_optimizer -.->|"saves versions"| node_resumemodel
node_profile -->|"stores skills"| node_skillmodel

click node_web "https://github.com/joshkumar50/autojob-ai-/tree/main/frontend/src/app"
click node_api "https://github.com/joshkumar50/autojob-ai-/tree/main/backend/routers"
click node_jobs "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/routers/jobs.py"
click node_scraper "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/scraper_engine.py"
click node_matcher "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/job_matcher.py"
click node_pipeline "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/pipeline_manager.py"
click node_agent "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/browser_agent.py"
click node_profile "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/profile_manager.py"
click node_skills "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/skill_corpus.py"
click node_optimizer "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/ats_optimizer.py"
click node_coverletter "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/cover_letter.py"
click node_llm "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/core/llm.py"
click node_security "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/core/security.py"
click node_db "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/database.py"
click node_jobmodel "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/job.py"
click node_applicationmodel "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/application.py"
click node_resumemodel "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/resume.py"
click node_skillmodel "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/skill.py"
click node_usermodel "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/user.py"
click node_covermodel "https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/cover_letter.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 toneBlue
class node_jobs,node_scraper,node_matcher,node_pipeline,node_agent toneAmber
class node_profile,node_skills,node_optimizer,node_coverletter,node_llm toneMint
class node_api,node_security,node_db,node_jobmodel,node_applicationmodel,node_resumemodel,node_skillmodel,node_usermodel,node_covermodel toneRose
class node_user,node_portals,node_github,node_llmservice toneIndigo
```

## Components

### User Experience

- [Web App](https://github.com/joshkumar50/autojob-ai-/tree/main/frontend/src/app): `frontend/src/app`

### Job Workflow

- [Job Feed](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/routers/jobs.py): `backend/routers/jobs.py`
- [Portal Scraper](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/scraper_engine.py): `backend/modules/scraper_engine.py`
- [Job Matcher](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/job_matcher.py): `backend/modules/job_matcher.py`
- [Application Pipeline](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/pipeline_manager.py): `backend/modules/pipeline_manager.py`
- [Browser Agent](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/browser_agent.py): `backend/modules/browser_agent.py`

### Resume Intelligence

- [Profile Manager](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/profile_manager.py): `backend/modules/profile_manager.py`
- [Skill Corpus](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/skill_corpus.py): `backend/modules/skill_corpus.py`
- [ATS Optimizer](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/ats_optimizer.py): `backend/modules/ats_optimizer.py`
- [Cover Letter](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/modules/cover_letter.py): `backend/modules/cover_letter.py`
- [LLM Client](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/core/llm.py): `backend/core/llm.py`

### Application Platform

- [API Routers](https://github.com/joshkumar50/autojob-ai-/tree/main/backend/routers): `backend/routers`
- [Credential Security](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/core/security.py): `backend/core/security.py`
- [SQLite Database](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/database.py): `backend/database.py`
- [Job Records](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/job.py): `backend/models/job.py`
- [Application Records](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/application.py): `backend/models/application.py`
- [Resume Versions](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/resume.py): `backend/models/resume.py`
- [Verified Skills](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/skill.py): `backend/models/skill.py`
- [User Profile](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/user.py): `backend/models/user.py`
- [Cover Letters](https://github.com/joshkumar50/autojob-ai-/blob/main/backend/models/cover_letter.py): `backend/models/cover_letter.py`

### Other components

- **Job Seeker**
- **Job Portals**
- **GitHub Repositories**
- **Gemini / Ollama**

## Connections

- Job Seeker → Web App: uses
- Web App → API Routers: calls API
- API Routers → Job Feed: routes requests (evidence: `backend/main.py`)
- Job Feed → Portal Scraper: starts scraping (evidence: `backend/routers/jobs.py`)
- Portal Scraper → Job Portals: fetches listings
- Job Feed → Job Matcher: scores listings (evidence: `backend/routers/jobs.py`)
- Job Feed → Application Pipeline: queues applications (evidence: `backend/routers/jobs.py`)
- Application Pipeline → Application Records: updates state (evidence: `backend/modules/pipeline_manager.py`)
- API Routers → Browser Agent: controls session (evidence: `backend/routers/agent.py`)
- Browser Agent → Job Portals: fills application
- API Routers → ATS Optimizer: requests tailoring (evidence: `backend/routers/jobs.py`)
- ATS Optimizer → LLM Client: generates revisions (evidence: `backend/modules/ats_optimizer.py`)
- LLM Client → Gemini / Ollama: sends prompts (evidence: `backend/core/llm.py`)
- ATS Optimizer → Skill Corpus: grounds edits (evidence: `backend/modules/ats_optimizer.py`)
- API Routers → Profile Manager: manages profile (evidence: `backend/routers/onboarding.py`)
- Profile Manager → LLM Client: extracts skills (evidence: `backend/modules/profile_manager.py`)
- Profile Manager → GitHub Repositories: fetches repositories
- Profile Manager → Credential Security: stores credentials (evidence: `backend/modules/profile_manager.py`)
- API Routers → Cover Letter: generates letters (evidence: `backend/routers/resume.py`)
- Cover Letter → LLM Client: drafts content (evidence: `backend/modules/cover_letter.py`)
- Cover Letter → Cover Letters: persists letters (evidence: `backend/modules/cover_letter.py`)
- Portal Scraper → Job Records: persists listings (evidence: `backend/modules/scraper_engine.py`)
- SQLite Database → Job Records: maps records (evidence: `backend/database.py`)
- SQLite Database → Application Records: maps records (evidence: `backend/database.py`)
- SQLite Database → Resume Versions: maps records (evidence: `backend/database.py`)
- SQLite Database → Verified Skills: maps records (evidence: `backend/database.py`)
- SQLite Database → User Profile: maps records (evidence: `backend/database.py`)
- Application Pipeline → SQLite Database: stores state
- ATS Optimizer → Resume Versions: saves versions (evidence: `backend/modules/ats_optimizer.py`)
- Profile Manager → Verified Skills: stores skills (evidence: `backend/modules/profile_manager.py`)
