# jpeterson96/job_application_assistant architecture

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

## Overview

AI_Slop is a Django job-application assistant: a user submits job criteria and a resume, the web view extracts resume text, and a registered analysis agent asks a local Ollama model to assess the match. The repository also defines reusable and job-posting-filtering agents, plus a direct prompt endpoint. The sampled source shows these paths, but no persistent application data store; the PDF in static/ is not part of the demonstrated workflow.

Main entry points: [`frontend/views.py`](https://github.com/jpeterson96/job_application_assistant/blob/main/frontend/views.py) (Request handlers), [`AI_Slop/orchestrator.py`](https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/orchestrator.py) (Workflow orchestrator), [`AI_Slop/ollama_client.py`](https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/ollama_client.py) (Ollama client), [`AI_Slop/urls.py`](https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/urls.py) (Project routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_project_routes["Project routes<br/>[urls.py]"]
  node_app_routes["Frontend routes<br/>[urls.py]"]
  node_views["Request handlers<br/>[views.py]"]
  node_resume_extract["Resume extraction<br/>[views.py]"]
  node_page["Application form<br/>[index.html]"]
end

subgraph group_workflow["Agent workflow"]
  node_orchestrator["Workflow orchestrator<br/>[orchestrator.py]"]
  node_job_agent["Job analysis agent<br/>[agents.py]"]
  node_generic_agent["Generic agent<br/>[agents.py]"]
  node_posting_agent["Posting filter agent<br/>[agents.py]"]
end

subgraph group_inference["LLM integration"]
  node_ollama_client["Ollama client<br/>[ollama_client.py]"]
  node_ollama["Ollama service"]
end

node_user(("Applicant"))

node_user -->|"submits request"| node_project_routes
node_project_routes -->|"includes routes"| node_app_routes
node_app_routes -->|"routes requests"| node_views
node_views -->|"renders form"| node_page
node_views -->|"extracts resume"| node_resume_extract
node_views -->|"executes workflow"| node_orchestrator
node_orchestrator -->|"dispatches agent"| node_job_agent
node_job_agent -->|"queries model"| node_orchestrator
node_orchestrator -->|"calls client"| node_ollama_client
node_views -->|"queries directly"| node_ollama_client
node_ollama_client -->|"sends prompt"| node_ollama
node_ollama -->|"returns response"| node_ollama_client
node_ollama_client -->|"returns response"| node_orchestrator
node_orchestrator -->|"returns results"| node_views

click node_project_routes "https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/urls.py"
click node_app_routes "https://github.com/jpeterson96/job_application_assistant/blob/main/frontend/urls.py"
click node_views "https://github.com/jpeterson96/job_application_assistant/blob/main/frontend/views.py"
click node_resume_extract "https://github.com/jpeterson96/job_application_assistant/blob/main/frontend/views.py"
click node_page "https://github.com/jpeterson96/job_application_assistant/blob/main/templates/index.html"
click node_orchestrator "https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/orchestrator.py"
click node_job_agent "https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/agents.py"
click node_generic_agent "https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/agents.py"
click node_posting_agent "https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/agents.py"
click node_ollama_client "https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/ollama_client.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_project_routes,node_app_routes,node_views,node_resume_extract,node_page toneBlue
class node_orchestrator,node_job_agent,node_generic_agent,node_posting_agent toneAmber
class node_ollama_client,node_ollama toneMint
class node_user toneIndigo
```

## Components

### Web interface

- [Project routes](https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/urls.py): `AI_Slop/urls.py`
- [Frontend routes](https://github.com/jpeterson96/job_application_assistant/blob/main/frontend/urls.py): `frontend/urls.py`
- [Request handlers](https://github.com/jpeterson96/job_application_assistant/blob/main/frontend/views.py): `frontend/views.py`
- [Resume extraction](https://github.com/jpeterson96/job_application_assistant/blob/main/frontend/views.py): `frontend/views.py`
- [Application form](https://github.com/jpeterson96/job_application_assistant/blob/main/templates/index.html): `templates/index.html`

### Agent workflow

- [Workflow orchestrator](https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/orchestrator.py): `AI_Slop/orchestrator.py`
- [Job analysis agent](https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/agents.py): `AI_Slop/agents.py`
- [Generic agent](https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/agents.py): `AI_Slop/agents.py`
- [Posting filter agent](https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/agents.py): `AI_Slop/agents.py`

### LLM integration

- [Ollama client](https://github.com/jpeterson96/job_application_assistant/blob/main/AI_Slop/ollama_client.py): `AI_Slop/ollama_client.py`
- **Ollama service**

### Other components

- **Applicant**

## Connections

- Applicant → Project routes: submits request (evidence: `AI_Slop/urls.py`)
- Project routes → Frontend routes: includes routes (evidence: `AI_Slop/urls.py`)
- Frontend routes → Request handlers: routes requests (evidence: `frontend/urls.py`)
- Request handlers → Application form: renders form (evidence: `frontend/views.py`)
- Request handlers → Resume extraction: extracts resume (evidence: `frontend/views.py`)
- Request handlers → Workflow orchestrator: executes workflow (evidence: `frontend/views.py`)
- Workflow orchestrator → Job analysis agent: dispatches agent (evidence: `AI_Slop/orchestrator.py`)
- Job analysis agent → Workflow orchestrator: queries model (evidence: `AI_Slop/agents.py`)
- Workflow orchestrator → Ollama client: calls client (evidence: `AI_Slop/orchestrator.py`)
- Request handlers → Ollama client: queries directly (evidence: `frontend/views.py`)
- Ollama client → Ollama service: sends prompt (evidence: `AI_Slop/ollama_client.py`)
- Ollama service → Ollama client: returns response (evidence: `AI_Slop/ollama_client.py`)
- Ollama client → Workflow orchestrator: returns response (evidence: `AI_Slop/orchestrator.py`)
- Workflow orchestrator → Request handlers: returns results (evidence: `frontend/views.py`)
