# shujaullah-dev/autonomous-job-application-agent architecture

> Architecture diagram of the GitHub repository shujaullah-dev/autonomous-job-application-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shujaullah-dev/autonomous-job-application-agent
- Repository: https://github.com/shujaullah-dev/autonomous-job-application-agent

## Overview

AI Job Agent is a FastAPI backend for candidate profiles and job discovery, with additional resume review, matching, and application-management routes. The main user journey is to maintain a profile, preview and explicitly approve resume-derived records, then discover and compare jobs; job ingestion also runs through provider-specific import tooling. Further routes support drafting and tracking applications, interviews, and follow-ups. The README documents the core profile, resume, and Greenhouse/Lever capabilities; several newer subsystems are represented from the source index, so their internal behavior is not inferred beyond cited references.

Main entry points: [`backend/app/main.py`](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/api/routes/job_matches.py`](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/job_matches.py) (Job matching), [`backend/app/api/routes/job_recommendations.py`](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/job_recommendations.py) (Recommendations), [`backend/app/services/application_tracking.py`](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/services/application_tracking.py) (Tracking service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API entry and profiles"]
  node_app["FastAPI application<br/>[main.py]"]
  node_profile_routes["Profile management"]
end

subgraph group_resume["Resume processing"]
  node_resume_routes["Resume endpoints<br/>[resumes.py]"]
  node_import_routes["Resume import<br/>[resume_imports.py]"]
  node_resume_processing["Resume parsing"]
end

subgraph group_jobs["Job discovery and matching"]
  node_job_routes["Job search<br/>[jobs.py]"]
  node_job_sources["Provider adapters"]
  node_ingestion["Job ingestion<br/>[job_ingestion.py]"]
  node_matching_routes["Job matching<br/>[job_matches.py]"]
  node_recommendation_routes["Recommendations"]
  node_matching["Match scoring<br/>[job_matching.py]"]
  node_match_queries["Candidate and job queries"]
  node_vector_store["Semantic similarity<br/>[vector_store.py]"]
end

subgraph group_applications["Application lifecycle"]
  node_workflow_routes["Job workflows<br/>[job_workflows.py]"]
  node_material_routes["Application materials"]
  node_tracking_routes["Application tracking"]
  node_followup_routes["Follow-ups"]
  node_interview_routes["Interviews<br/>[interviews.py]"]
  node_application_service["Tracking service"]
end

subgraph group_persistence["Persistence"]
  node_application_store[("Application records<br/>[application.py]")]
  node_job_store[("Job records<br/>[job.py]")]
  node_candidate_store[("Candidate records<br/>[candidate.py]")]
  node_database[("SQL database")]
end

node_user(("API user"))

node_user -->|"sends requests"| node_app
node_app -->|"registers routes"| node_profile_routes
node_app -->|"registers routes"| node_resume_routes
node_app -->|"registers routes"| node_import_routes
node_app -->|"registers routes"| node_job_routes
node_app -->|"registers routes"| node_matching_routes
node_app -->|"registers routes"| node_recommendation_routes
node_app -->|"registers routes"| node_workflow_routes
node_app -->|"registers routes"| node_material_routes
node_app -->|"registers routes"| node_tracking_routes
node_app -->|"registers routes"| node_followup_routes
node_app -->|"registers routes"| node_interview_routes
node_resume_routes -.->|"uses services"| node_resume_processing
node_import_routes -.->|"uses services"| node_resume_processing
node_job_sources -->|"supplies listings"| node_ingestion
node_ingestion -->|"writes jobs"| node_job_store
node_matching_routes -->|"calls scoring"| node_matching
node_matching_routes -->|"loads match data"| node_match_queries
node_matching_routes -->|"queries similarity"| node_vector_store
node_recommendation_routes -->|"ranks jobs"| node_matching
node_recommendation_routes -->|"loads job pool"| node_match_queries
node_recommendation_routes -->|"queries similarity"| node_vector_store
node_workflow_routes -.->|"coordinates drafts"| node_material_routes
node_tracking_routes -->|"calls tracking"| node_application_service
node_followup_routes -->|"uses tracking"| node_application_service
node_interview_routes -->|"uses tracking"| node_application_service
node_application_service -->|"reads and writes"| node_application_store
node_application_store -.->|"persists records"| node_database
node_job_store -.->|"persists records"| node_database
node_candidate_store -.->|"persists records"| node_database

click node_app "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/main.py"
click node_profile_routes "https://github.com/shujaullah-dev/autonomous-job-application-agent/tree/main/backend/app/api/routes"
click node_resume_routes "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/resumes.py"
click node_import_routes "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/resume_imports.py"
click node_resume_processing "https://github.com/shujaullah-dev/autonomous-job-application-agent/tree/main/backend/app/services"
click node_job_routes "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/jobs.py"
click node_job_sources "https://github.com/shujaullah-dev/autonomous-job-application-agent/tree/main/backend/app/services/job_sources"
click node_ingestion "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/services/job_ingestion.py"
click node_matching_routes "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/job_matches.py"
click node_recommendation_routes "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/job_recommendations.py"
click node_matching "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/services/job_matching.py"
click node_match_queries "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/services/matching_queries.py"
click node_vector_store "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/services/vector_store.py"
click node_workflow_routes "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/job_workflows.py"
click node_material_routes "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/application_materials.py"
click node_tracking_routes "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/application_tracking.py"
click node_followup_routes "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/application_follow_ups.py"
click node_interview_routes "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/interviews.py"
click node_application_service "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/services/application_tracking.py"
click node_application_store "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/models/application.py"
click node_job_store "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/models/job.py"
click node_candidate_store "https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/models/candidate.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_profile_routes,node_user toneBlue
class node_resume_routes,node_import_routes,node_resume_processing toneAmber
class node_job_routes,node_job_sources,node_ingestion,node_matching_routes,node_recommendation_routes,node_matching,node_match_queries,node_vector_store toneMint
class node_workflow_routes,node_material_routes,node_tracking_routes,node_followup_routes,node_interview_routes,node_application_service toneRose
class node_application_store,node_job_store,node_candidate_store,node_database toneIndigo
```

## Components

### API entry and profiles

- [FastAPI application](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/main.py): `backend/app/main.py`
- [Profile management](https://github.com/shujaullah-dev/autonomous-job-application-agent/tree/main/backend/app/api/routes): `backend/app/api/routes`

### Resume processing

- [Resume endpoints](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/resumes.py): `backend/app/api/routes/resumes.py`
- [Resume import](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/resume_imports.py): `backend/app/api/routes/resume_imports.py`
- [Resume parsing](https://github.com/shujaullah-dev/autonomous-job-application-agent/tree/main/backend/app/services): `backend/app/services`

### Job discovery and matching

- [Job search](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/jobs.py): `backend/app/api/routes/jobs.py`
- [Provider adapters](https://github.com/shujaullah-dev/autonomous-job-application-agent/tree/main/backend/app/services/job_sources): `backend/app/services/job_sources`
- [Job ingestion](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/services/job_ingestion.py): `backend/app/services/job_ingestion.py`
- [Job matching](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/job_matches.py): `backend/app/api/routes/job_matches.py`
- [Recommendations](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/job_recommendations.py): `backend/app/api/routes/job_recommendations.py`
- [Match scoring](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/services/job_matching.py): `backend/app/services/job_matching.py`
- [Candidate and job queries](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/services/matching_queries.py): `backend/app/services/matching_queries.py`
- [Semantic similarity](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/services/vector_store.py): `backend/app/services/vector_store.py`

### Application lifecycle

- [Job workflows](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/job_workflows.py): `backend/app/api/routes/job_workflows.py`
- [Application materials](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/application_materials.py): `backend/app/api/routes/application_materials.py`
- [Application tracking](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/application_tracking.py): `backend/app/api/routes/application_tracking.py`
- [Follow-ups](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/application_follow_ups.py): `backend/app/api/routes/application_follow_ups.py`
- [Interviews](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/api/routes/interviews.py): `backend/app/api/routes/interviews.py`
- [Tracking service](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/services/application_tracking.py): `backend/app/services/application_tracking.py`

### Persistence

- [Application records](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/models/application.py): `backend/app/models/application.py`
- [Job records](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/models/job.py): `backend/app/models/job.py`
- [Candidate records](https://github.com/shujaullah-dev/autonomous-job-application-agent/blob/main/backend/app/models/candidate.py): `backend/app/models/candidate.py`
- **SQL database**

### Other components

- **API user**

## Connections

- API user → FastAPI application: sends requests (evidence: `backend/app/main.py`)
- FastAPI application → Profile management: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Resume endpoints: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Resume import: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Job search: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Job matching: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Recommendations: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Job workflows: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Application materials: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Application tracking: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Follow-ups: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Interviews: registers routes (evidence: `backend/app/main.py`)
- Resume endpoints → Resume parsing: uses services
- Resume import → Resume parsing: uses services
- Provider adapters → Job ingestion: supplies listings (evidence: `README.md`)
- Job ingestion → Job records: writes jobs (evidence: `backend/app/services/job_ingestion.py`)
- Job matching → Match scoring: calls scoring (evidence: `backend/app/api/routes/job_matches.py`)
- Job matching → Candidate and job queries: loads match data (evidence: `backend/app/api/routes/job_matches.py`)
- Job matching → Semantic similarity: queries similarity (evidence: `backend/app/api/routes/job_matches.py`)
- Recommendations → Match scoring: ranks jobs (evidence: `backend/app/api/routes/job_recommendations.py`)
- Recommendations → Candidate and job queries: loads job pool (evidence: `backend/app/api/routes/job_recommendations.py`)
- Recommendations → Semantic similarity: queries similarity (evidence: `backend/app/api/routes/job_recommendations.py`)
- Job workflows → Application materials: coordinates drafts (evidence: `backend/app/api/routes/application_materials.py`)
- Application tracking → Tracking service: calls tracking (evidence: `backend/app/api/routes/application_tracking.py`)
- Follow-ups → Tracking service: uses tracking (evidence: `backend/app/api/routes/application_follow_ups.py`)
- Interviews → Tracking service: uses tracking (evidence: `backend/app/api/routes/interviews.py`)
- Tracking service → Application records: reads and writes (evidence: `backend/app/services/application_tracking.py`)
- Application records → SQL database: persists records
- Job records → SQL database: persists records
- Candidate records → SQL database: persists records
