# bedaant/job architecture

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

- Interactive diagram: https://gitdiagram.com/bedaant/job
- Repository: https://github.com/bedaant/job

## Overview

Apply Scout is a personal job-search automation product: users build a fact-checked profile and campaign, the service discovers and ranks jobs, prepares truthful ATS-tailored documents, and the ApplyScout extension fills and submits applications in the user's browser. The web app and API also support application review/tracking, saved answers, live events and digests. Referral outreach is explicitly planned but not built, so it is shown as a documented future capability. Source excerpts establish selected calls; other links cite README-described relationships, not unsampled implementation details.

Main entry points: [`apps/api/main.py`](https://github.com/bedaant/job/blob/main/apps/api/main.py) (REST API), [`apps/web/app`](https://github.com/bedaant/job/tree/main/apps/web/app) (Web workspace), [`apps/extension/src/background/driver.ts`](https://github.com/bedaant/job/blob/main/apps/extension/src/background/driver.ts) (ApplyScout extension), [`apps/api/workers/jobs.py`](https://github.com/bedaant/job/blob/main/apps/api/workers/jobs.py) (Background jobs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Profile &amp; campaign"]
  node_web["Web workspace"]
  node_profile["Resume facts"]
  node_campaign["Search campaign<br/>[campaigns.py]"]
end

subgraph group_discovery["Job discovery &amp; match"]
  node_connectors["Job connectors"]
  node_jobstore["Job ingestion<br/>[pipeline.py]"]
  node_matching["Job matching<br/>[service.py]"]
end

subgraph group_apply["Preparation &amp; apply"]
  node_tailoring["Resume tailoring<br/>[engine.py]"]
  node_documents["ATS documents"]
  node_formplan["Form planning<br/>[formplans.py]"]
  node_answers["Saved answers<br/>[answer_bank.py]"]
  node_extension["ApplyScout extension<br/>[driver.ts]"]
  node_referral["Referral outreach"]
end

subgraph group_platform["API &amp; operations"]
  node_api["REST API<br/>[main.py]"]
  node_auth["Authentication<br/>[router.py]"]
  node_db[("Application database<br/>[models.py]")]
  node_events["Live events<br/>[outbox.py]"]
  node_digest["Daily digest<br/>[digest.py]"]
  node_worker["Background jobs<br/>[jobs.py]"]
end

node_user(("Job seeker"))
node_employer(("Employer application"))

node_user -->|"uses"| node_web
node_web -->|"calls REST"| node_api
node_user -->|"submits resume"| node_web
node_api -.->|"parses resume"| node_profile
node_web -.->|"edits facts"| node_api
node_web -.->|"configures campaign"| node_api
node_api -->|"routes auth"| node_auth
node_api -->|"reads/writes"| node_db
node_worker -->|"fetches jobs"| node_connectors
node_worker -->|"upserts jobs"| node_jobstore
node_jobstore -.->|"stores jobs"| node_db
node_worker -.->|"builds matches"| node_matching
node_matching -->|"reads/writes matches"| node_db
node_matching -->|"announces matches"| node_events
node_web -.->|"reviews matches"| node_api
node_api -->|"requests tailoring"| node_tailoring
node_tailoring -.->|"creates ATS resume"| node_documents
node_tailoring -.->|"stores tailored output"| node_db
node_worker -->|"plans forms"| node_formplan
node_extension -->|"gets apply queue"| node_api
node_extension -.->|"uses plan"| node_formplan
node_extension -.->|"uses saved answers"| node_answers
node_extension -->|"fills and submits"| node_employer
node_employer -.->|"confirms submission"| node_api
node_web -.->|"tracks applications"| node_api
node_api -.->|"writes events"| node_events
node_api -.->|"supports digest"| node_digest
node_api -.->|"planned after apply"| node_referral

click node_web "https://github.com/bedaant/job/tree/main/apps/web/app"
click node_profile "https://github.com/bedaant/job/tree/main/apps/api/parsing"
click node_campaign "https://github.com/bedaant/job/blob/main/apps/api/campaigns.py"
click node_api "https://github.com/bedaant/job/blob/main/apps/api/main.py"
click node_auth "https://github.com/bedaant/job/blob/main/apps/api/auth/router.py"
click node_db "https://github.com/bedaant/job/blob/main/apps/api/models.py"
click node_events "https://github.com/bedaant/job/blob/main/apps/api/events/outbox.py"
click node_digest "https://github.com/bedaant/job/blob/main/apps/api/digest.py"
click node_worker "https://github.com/bedaant/job/blob/main/apps/api/workers/jobs.py"
click node_connectors "https://github.com/bedaant/job/tree/main/apps/api/connectors"
click node_jobstore "https://github.com/bedaant/job/blob/main/apps/api/connectors/pipeline.py"
click node_matching "https://github.com/bedaant/job/blob/main/apps/api/matching/service.py"
click node_tailoring "https://github.com/bedaant/job/blob/main/apps/api/tailoring/engine.py"
click node_documents "https://github.com/bedaant/job/tree/main/apps/api/documents"
click node_formplan "https://github.com/bedaant/job/blob/main/apps/api/formplans.py"
click node_answers "https://github.com/bedaant/job/blob/main/apps/api/answer_bank.py"
click node_extension "https://github.com/bedaant/job/blob/main/apps/extension/src/background/driver.ts"

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,node_profile,node_campaign toneBlue
class node_connectors,node_jobstore,node_matching toneAmber
class node_tailoring,node_documents,node_formplan,node_answers,node_extension,node_referral toneMint
class node_api,node_auth,node_db,node_events,node_digest,node_worker toneRose
class node_user,node_employer toneIndigo
```

## Components

### Profile & campaign

- [Web workspace](https://github.com/bedaant/job/tree/main/apps/web/app): `apps/web/app`
- [Resume facts](https://github.com/bedaant/job/tree/main/apps/api/parsing): `apps/api/parsing`
- [Search campaign](https://github.com/bedaant/job/blob/main/apps/api/campaigns.py): `apps/api/campaigns.py`

### Job discovery & match

- [Job connectors](https://github.com/bedaant/job/tree/main/apps/api/connectors): `apps/api/connectors`
- [Job ingestion](https://github.com/bedaant/job/blob/main/apps/api/connectors/pipeline.py): `apps/api/connectors/pipeline.py`
- [Job matching](https://github.com/bedaant/job/blob/main/apps/api/matching/service.py): `apps/api/matching/service.py`

### Preparation & apply

- [Resume tailoring](https://github.com/bedaant/job/blob/main/apps/api/tailoring/engine.py): `apps/api/tailoring/engine.py`
- [ATS documents](https://github.com/bedaant/job/tree/main/apps/api/documents): `apps/api/documents`
- [Form planning](https://github.com/bedaant/job/blob/main/apps/api/formplans.py): `apps/api/formplans.py`
- [Saved answers](https://github.com/bedaant/job/blob/main/apps/api/answer_bank.py): `apps/api/answer_bank.py`
- [ApplyScout extension](https://github.com/bedaant/job/blob/main/apps/extension/src/background/driver.ts): `apps/extension/src/background/driver.ts`
- **Referral outreach**

### API & operations

- [REST API](https://github.com/bedaant/job/blob/main/apps/api/main.py): `apps/api/main.py`
- [Authentication](https://github.com/bedaant/job/blob/main/apps/api/auth/router.py): `apps/api/auth/router.py`
- [Application database](https://github.com/bedaant/job/blob/main/apps/api/models.py): `apps/api/models.py`
- [Live events](https://github.com/bedaant/job/blob/main/apps/api/events/outbox.py): `apps/api/events/outbox.py`
- [Daily digest](https://github.com/bedaant/job/blob/main/apps/api/digest.py): `apps/api/digest.py`
- [Background jobs](https://github.com/bedaant/job/blob/main/apps/api/workers/jobs.py): `apps/api/workers/jobs.py`

### Other components

- **Job seeker**
- **Employer application**

## Connections

- Job seeker → Web workspace: uses
- Web workspace → REST API: calls REST
- Job seeker → Web workspace: submits resume
- REST API → Resume facts: parses resume (evidence: `apps/api/main.py`)
- Web workspace → REST API: edits facts
- Web workspace → REST API: configures campaign
- REST API → Authentication: routes auth (evidence: `apps/api/main.py`)
- REST API → Application database: reads/writes (evidence: `apps/api/main.py`)
- Background jobs → Job connectors: fetches jobs (evidence: `apps/api/workers/jobs.py`)
- Background jobs → Job ingestion: upserts jobs (evidence: `apps/api/workers/jobs.py`)
- Job ingestion → Application database: stores jobs (evidence: `apps/api/connectors/pipeline.py`)
- Background jobs → Job matching: builds matches (evidence: `apps/api/workers/jobs.py`)
- Job matching → Application database: reads/writes matches (evidence: `apps/api/matching/service.py`)
- Job matching → Live events: announces matches (evidence: `apps/api/matching/service.py`)
- Web workspace → REST API: reviews matches
- REST API → Resume tailoring: requests tailoring (evidence: `apps/api/main.py`)
- Resume tailoring → ATS documents: creates ATS resume
- Resume tailoring → Application database: stores tailored output
- Background jobs → Form planning: plans forms (evidence: `apps/api/workers/jobs.py`)
- ApplyScout extension → REST API: gets apply queue
- ApplyScout extension → Form planning: uses plan
- ApplyScout extension → Saved answers: uses saved answers
- ApplyScout extension → Employer application: fills and submits
- Employer application → REST API: confirms submission
- Web workspace → REST API: tracks applications
- REST API → Live events: writes events (evidence: `apps/api/events/outbox.py`)
- REST API → Daily digest: supports digest (evidence: `apps/api/main.py`)
- REST API → Referral outreach: planned after apply
