# mirza1272/career-pulse architecture

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

## Overview

Career Pulse combines a human-approved job-application workflow with Radar, a separate job-discovery engine. Users submit job text or screenshots, the app extracts job details, drafts and tailors application materials, and only dispatches email after approval. Radar searches and crawls postings, extracts and validates jobs, then shares eligible jobs through the common persistence/API boundary. Relationships among unsampled features follow README documentation; Radar-to-app ingestion is documented, but the implementation excerpt does not show that HTTP transfer.

Main entry points: [`app/main.py`](https://github.com/mirza1272/career-pulse/blob/main/app/main.py) (Web app and API), [`radar/pipeline.py`](https://github.com/mirza1272/career-pulse/blob/main/radar/pipeline.py) (Discovery pipeline), [`app/intake.py`](https://github.com/mirza1272/career-pulse/blob/main/app/intake.py) (Job intake), [`app/tailor.py`](https://github.com/mirza1272/career-pulse/blob/main/app/tailor.py) (Resume tailoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_career["Career Pulse app"]
  node_web["Web app and API<br/>[main.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_intake["Job intake<br/>[intake.py]"]
  node_ocr["Screenshot OCR<br/>[ocr.py]"]
  node_jobparse["Job extraction<br/>[roles.py]"]
  node_approval["Human approval<br/>[main.py]"]
  node_outbound["Email dispatch<br/>[outbound.py]"]
  node_gmail["Gmail integration<br/>[gmail.py]"]
end

subgraph group_tailoring["Application preparation"]
  node_llm["LLM services<br/>[llm.py]"]
  node_knowledge["Candidate profile<br/>[knowledge.py]"]
  node_matching["Skill matching<br/>[matching.py]"]
  node_ats["ATS scoring<br/>[ats.py]"]
  node_tailor["Resume tailoring<br/>[tailor.py]"]
  node_resume["Resume generation<br/>[resume_builder.py]"]
  node_resumeparse["Resume parsing<br/>[resume_parse.py]"]
  node_readiness["Application readiness<br/>[readiness.py]"]
end

subgraph group_radar["Radar discovery"]
  node_radarsearch["Job search<br/>[search.py]"]
  node_crawler["Company crawling<br/>[company_crawler.py]"]
  node_extractor["Posting extraction<br/>[extractor.py]"]
  node_validator["Job validation<br/>[validator.py]"]
  node_pipeline["Discovery pipeline<br/>[pipeline.py]"]
  node_expiry["Job expiry<br/>[expiry.py]"]
end

subgraph group_persistence["Shared persistence"]
  node_models["Shared data models<br/>[models.py]"]
  node_db[("Application database<br/>[db.py]")]
  node_radardb["Radar database access<br/>[db.py]"]
  node_supabase[("Supabase store<br/>[supabase_client.py]")]
end

node_applicant(("Applicant"))
node_smtp["SMTP service"]
node_careerapi["Career Pulse API<br/>[index.py]"]

node_applicant -->|"submits jobs"| node_web
node_applicant -->|"signs in"| node_auth
node_web -->|"authenticates"| node_auth
node_web -->|"processes intake"| node_intake
node_intake -->|"reads images"| node_ocr
node_intake -->|"extracts details"| node_jobparse
node_intake -->|"requests extraction"| node_llm
node_web -->|"loads profile"| node_knowledge
node_web -->|"requests analysis"| node_matching
node_matching -->|"uses language model"| node_llm
node_web -->|"tailors application"| node_tailor
node_tailor -->|"scores resume"| node_ats
node_tailor -->|"requests tailoring"| node_llm
node_tailor -->|"generates resume"| node_resume
node_resumeparse -->|"parses resume"| node_resume
node_web -->|"checks readiness"| node_readiness
node_web -->|"manages approval"| node_approval
node_approval -->|"dispatches approved"| node_outbound
node_outbound -->|"uses Gmail"| node_gmail
node_outbound -->|"sends email"| node_smtp
node_pipeline -->|"searches jobs"| node_radarsearch
node_radarsearch -->|"uses company crawl"| node_crawler
node_pipeline -->|"extracts postings"| node_extractor
node_pipeline -->|"validates jobs"| node_validator
node_pipeline -->|"persists jobs"| node_radardb
node_expiry -->|"updates expiry"| node_radardb
node_radardb -->|"uses cloud store"| node_supabase
node_db -->|"syncs cloud data"| node_supabase
node_web -->|"reads and writes"| node_db
node_db -->|"stores records"| node_models
node_radardb -->|"uses shared schema"| node_models
node_pipeline -.->|"pushes fresh jobs"| node_careerapi
node_careerapi -->|"routes to app"| node_web

click node_web "https://github.com/mirza1272/career-pulse/blob/main/app/main.py"
click node_auth "https://github.com/mirza1272/career-pulse/blob/main/app/auth.py"
click node_intake "https://github.com/mirza1272/career-pulse/blob/main/app/intake.py"
click node_ocr "https://github.com/mirza1272/career-pulse/blob/main/app/ocr.py"
click node_jobparse "https://github.com/mirza1272/career-pulse/blob/main/app/roles.py"
click node_llm "https://github.com/mirza1272/career-pulse/blob/main/app/llm.py"
click node_knowledge "https://github.com/mirza1272/career-pulse/blob/main/app/knowledge.py"
click node_matching "https://github.com/mirza1272/career-pulse/blob/main/app/matching.py"
click node_ats "https://github.com/mirza1272/career-pulse/blob/main/app/ats.py"
click node_tailor "https://github.com/mirza1272/career-pulse/blob/main/app/tailor.py"
click node_resume "https://github.com/mirza1272/career-pulse/blob/main/app/resume_builder.py"
click node_resumeparse "https://github.com/mirza1272/career-pulse/blob/main/app/resume_parse.py"
click node_readiness "https://github.com/mirza1272/career-pulse/blob/main/app/readiness.py"
click node_approval "https://github.com/mirza1272/career-pulse/blob/main/app/main.py"
click node_outbound "https://github.com/mirza1272/career-pulse/blob/main/app/outbound.py"
click node_gmail "https://github.com/mirza1272/career-pulse/blob/main/app/gmail.py"
click node_radarsearch "https://github.com/mirza1272/career-pulse/blob/main/radar/search.py"
click node_crawler "https://github.com/mirza1272/career-pulse/blob/main/radar/company_crawler.py"
click node_extractor "https://github.com/mirza1272/career-pulse/blob/main/radar/extractor.py"
click node_validator "https://github.com/mirza1272/career-pulse/blob/main/radar/validator.py"
click node_pipeline "https://github.com/mirza1272/career-pulse/blob/main/radar/pipeline.py"
click node_expiry "https://github.com/mirza1272/career-pulse/blob/main/radar/expiry.py"
click node_models "https://github.com/mirza1272/career-pulse/blob/main/app/models.py"
click node_db "https://github.com/mirza1272/career-pulse/blob/main/app/db.py"
click node_radardb "https://github.com/mirza1272/career-pulse/blob/main/radar/db.py"
click node_supabase "https://github.com/mirza1272/career-pulse/blob/main/radar/supabase_client.py"
click node_careerapi "https://github.com/mirza1272/career-pulse/blob/main/api/index.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,node_auth,node_intake,node_ocr,node_jobparse,node_approval,node_outbound,node_gmail toneBlue
class node_llm,node_knowledge,node_matching,node_ats,node_tailor,node_resume,node_resumeparse,node_readiness toneAmber
class node_radarsearch,node_crawler,node_extractor,node_validator,node_pipeline,node_expiry,node_careerapi toneMint
class node_models,node_db,node_radardb,node_supabase toneRose
class node_applicant,node_smtp toneIndigo
```

## Components

### Career Pulse app

- [Web app and API](https://github.com/mirza1272/career-pulse/blob/main/app/main.py): `app/main.py`
- [Authentication](https://github.com/mirza1272/career-pulse/blob/main/app/auth.py): `app/auth.py`
- [Job intake](https://github.com/mirza1272/career-pulse/blob/main/app/intake.py): `app/intake.py`
- [Screenshot OCR](https://github.com/mirza1272/career-pulse/blob/main/app/ocr.py): `app/ocr.py`
- [Job extraction](https://github.com/mirza1272/career-pulse/blob/main/app/roles.py): `app/roles.py`
- [Human approval](https://github.com/mirza1272/career-pulse/blob/main/app/main.py): `app/main.py`
- [Email dispatch](https://github.com/mirza1272/career-pulse/blob/main/app/outbound.py): `app/outbound.py`
- [Gmail integration](https://github.com/mirza1272/career-pulse/blob/main/app/gmail.py): `app/gmail.py`

### Application preparation

- [LLM services](https://github.com/mirza1272/career-pulse/blob/main/app/llm.py): `app/llm.py`
- [Candidate profile](https://github.com/mirza1272/career-pulse/blob/main/app/knowledge.py): `app/knowledge.py`
- [Skill matching](https://github.com/mirza1272/career-pulse/blob/main/app/matching.py): `app/matching.py`
- [ATS scoring](https://github.com/mirza1272/career-pulse/blob/main/app/ats.py): `app/ats.py`
- [Resume tailoring](https://github.com/mirza1272/career-pulse/blob/main/app/tailor.py): `app/tailor.py`
- [Resume generation](https://github.com/mirza1272/career-pulse/blob/main/app/resume_builder.py): `app/resume_builder.py`
- [Resume parsing](https://github.com/mirza1272/career-pulse/blob/main/app/resume_parse.py): `app/resume_parse.py`
- [Application readiness](https://github.com/mirza1272/career-pulse/blob/main/app/readiness.py): `app/readiness.py`

### Radar discovery

- [Job search](https://github.com/mirza1272/career-pulse/blob/main/radar/search.py): `radar/search.py`
- [Company crawling](https://github.com/mirza1272/career-pulse/blob/main/radar/company_crawler.py): `radar/company_crawler.py`
- [Posting extraction](https://github.com/mirza1272/career-pulse/blob/main/radar/extractor.py): `radar/extractor.py`
- [Job validation](https://github.com/mirza1272/career-pulse/blob/main/radar/validator.py): `radar/validator.py`
- [Discovery pipeline](https://github.com/mirza1272/career-pulse/blob/main/radar/pipeline.py): `radar/pipeline.py`
- [Job expiry](https://github.com/mirza1272/career-pulse/blob/main/radar/expiry.py): `radar/expiry.py`

### Shared persistence

- [Shared data models](https://github.com/mirza1272/career-pulse/blob/main/app/models.py): `app/models.py`
- [Application database](https://github.com/mirza1272/career-pulse/blob/main/app/db.py): `app/db.py`
- [Radar database access](https://github.com/mirza1272/career-pulse/blob/main/radar/db.py): `radar/db.py`
- [Supabase store](https://github.com/mirza1272/career-pulse/blob/main/radar/supabase_client.py): `radar/supabase_client.py`

### Other components

- **Applicant**
- **SMTP service**
- [Career Pulse API](https://github.com/mirza1272/career-pulse/blob/main/api/index.py): `api/index.py`

## Connections

- Applicant → Web app and API: submits jobs
- Applicant → Authentication: signs in
- Web app and API → Authentication: authenticates (evidence: `app/main.py`)
- Web app and API → Job intake: processes intake (evidence: `app/main.py`)
- Job intake → Screenshot OCR: reads images (evidence: `app/intake.py`)
- Job intake → Job extraction: extracts details (evidence: `app/intake.py`)
- Job intake → LLM services: requests extraction (evidence: `app/intake.py`)
- Web app and API → Candidate profile: loads profile (evidence: `app/main.py`)
- Web app and API → Skill matching: requests analysis (evidence: `app/main.py`)
- Skill matching → LLM services: uses language model (evidence: `app/matching.py`)
- Web app and API → Resume tailoring: tailors application (evidence: `app/main.py`)
- Resume tailoring → ATS scoring: scores resume (evidence: `app/tailor.py`)
- Resume tailoring → LLM services: requests tailoring (evidence: `app/tailor.py`)
- Resume tailoring → Resume generation: generates resume (evidence: `app/tailor.py`)
- Resume parsing → Resume generation: parses resume (evidence: `app/resume_parse.py`)
- Web app and API → Application readiness: checks readiness (evidence: `app/main.py`)
- Web app and API → Human approval: manages approval (evidence: `app/main.py`)
- Human approval → Email dispatch: dispatches approved (evidence: `app/main.py`)
- Email dispatch → Gmail integration: uses Gmail (evidence: `app/outbound.py`)
- Email dispatch → SMTP service: sends email
- Discovery pipeline → Job search: searches jobs (evidence: `radar/pipeline.py`)
- Job search → Company crawling: uses company crawl (evidence: `radar/search.py`)
- Discovery pipeline → Posting extraction: extracts postings (evidence: `radar/pipeline.py`)
- Discovery pipeline → Job validation: validates jobs (evidence: `radar/pipeline.py`)
- Discovery pipeline → Radar database access: persists jobs (evidence: `radar/pipeline.py`)
- Job expiry → Radar database access: updates expiry (evidence: `radar/expiry.py`)
- Radar database access → Supabase store: uses cloud store (evidence: `radar/db.py`)
- Application database → Supabase store: syncs cloud data (evidence: `app/db.py`)
- Web app and API → Application database: reads and writes (evidence: `app/main.py`)
- Application database → Shared data models: stores records (evidence: `app/db.py`)
- Radar database access → Shared data models: uses shared schema
- Discovery pipeline → Career Pulse API: pushes fresh jobs
- Career Pulse API → Web app and API: routes to app (evidence: `api/index.py`)
