# odeliyach/careeros architecture

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

- Interactive diagram: https://gitdiagram.com/odeliyach/careeros
- Repository: https://github.com/odeliyach/careeros

## Overview

CareerOS automates job-search work through n8n workflows, with a static sample-data dashboard as a separate demo. The main workflow accepts a job description, prepares it, runs analysis and content-generation tiers in sequence, then saves application files and sends a notification. Separate workflows scan for jobs, classify Gmail replies, draft follow-ups, and label inbox messages. The README documents these capabilities and integrations, but no workflow source was excerpted; edges below reflect documented relationships only.

Main entry points: [`n8n-workflows/job-scanner-workflow.json`](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/job-scanner-workflow.json) (Job scanner), [`n8n-workflows/workflow-followup-scheduler.json`](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-followup-scheduler.json) (Follow-up drafts), [`n8n-workflows/workflow-all-tiers.json`](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json) (Tier 1 analysis), [`n8n-workflows/workflow-email-listener.json`](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-email-listener.json) (Reply classifier)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pipeline["Application pipeline"]
  node_job_input["Job input"]
  node_job_parse["Extract fields"]
  node_tier1["Tier 1 analysis"]
  node_tier2["Tier 2 outreach"]
  node_tier3["Tier 3 preparation"]
  node_tier4["Tier 4 portfolio match"]
  node_tier5["Tier 5 follow-up tracking"]
  node_tier6["Tier 6 tailored resume"]
  node_merge["Merge results"]
end

subgraph group_automation["Job and email automations"]
  node_scanner["Job scanner"]
  node_email_listener["Reply classifier"]
  node_followup["Follow-up drafts"]
  node_labeler["Inbox labeler"]
  node_label_helper["Label ID lookup"]
end

subgraph group_services["External services and state"]
  node_groq{{"Groq API"}}
  node_github[("Private GitHub repo")]
  node_gmail{{"Gmail"}}
  node_smtp{{"SMTP email"}}
  node_apify{{"Apify LinkedIn scraper"}}
  node_sheets[("Google Sheets cache")]
end

subgraph group_demo["Static demo"]
  node_dashboard["Static dashboard<br/>[index.html]"]
end

node_user(("Job seeker"))
node_reviewer(("Human reviewer"))
node_demo_user(("Demo visitor"))

node_user -->|"submits job"| node_job_input
node_job_input -->|"passes description"| node_job_parse
node_job_parse -->|"passes fields"| node_tier1
node_tier1 -->|"then runs"| node_tier2
node_tier2 -->|"then runs"| node_tier3
node_tier3 -->|"then runs"| node_tier4
node_tier4 -->|"then runs"| node_tier5
node_tier5 -->|"then runs"| node_tier6
node_tier1 -->|"requests analysis"| node_groq
node_tier2 -->|"requests content"| node_groq
node_tier3 -->|"requests content"| node_groq
node_tier4 -->|"requests matching"| node_groq
node_tier5 -->|"requests schedule"| node_groq
node_tier6 -->|"requests resume"| node_groq
node_tier6 -->|"provides results"| node_merge
node_merge -->|"writes applications"| node_github
node_merge -->|"sends notification"| node_smtp
node_scanner -->|"fetches postings"| node_apify
node_scanner -->|"checks duplicates"| node_sheets
node_scanner -->|"scores new jobs"| node_groq
node_scanner -->|"saves matches"| node_github
node_gmail -->|"triggers on message"| node_email_listener
node_email_listener -->|"updates status"| node_github
node_followup -->|"drafts emails"| node_groq
node_followup -->|"requests review"| node_reviewer
node_followup -->|"prepares drafts"| node_gmail
node_labeler -->|"labels messages"| node_gmail
node_label_helper -->|"looks up labels"| node_gmail
node_demo_user -->|"views demo"| node_dashboard
node_github -.->|"browses locally"| node_dashboard

click node_job_input "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json"
click node_job_parse "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json"
click node_tier1 "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json"
click node_tier2 "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json"
click node_tier3 "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json"
click node_tier4 "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json"
click node_tier5 "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json"
click node_tier6 "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json"
click node_merge "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json"
click node_scanner "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/job-scanner-workflow.json"
click node_email_listener "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-email-listener.json"
click node_followup "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-followup-scheduler.json"
click node_labeler "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-gmail-labeler.json"
click node_label_helper "https://github.com/odeliyach/careeros/blob/main/n8n-workflows/helper-get-label-ids.json"
click node_dashboard "https://github.com/odeliyach/careeros/blob/main/index.html"

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_job_input,node_job_parse,node_tier1,node_tier2,node_tier3,node_tier4,node_tier5,node_tier6,node_merge,node_reviewer toneBlue
class node_scanner,node_email_listener,node_followup,node_labeler,node_label_helper toneAmber
class node_groq,node_github,node_gmail,node_smtp,node_apify,node_sheets toneMint
class node_dashboard toneRose
class node_user,node_demo_user toneIndigo
```

## Components

### Application pipeline

- [Job input](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json): `n8n-workflows/workflow-all-tiers.json`
- [Extract fields](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json): `n8n-workflows/workflow-all-tiers.json`
- [Tier 1 analysis](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json): `n8n-workflows/workflow-all-tiers.json`
- [Tier 2 outreach](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json): `n8n-workflows/workflow-all-tiers.json`
- [Tier 3 preparation](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json): `n8n-workflows/workflow-all-tiers.json`
- [Tier 4 portfolio match](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json): `n8n-workflows/workflow-all-tiers.json`
- [Tier 5 follow-up tracking](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json): `n8n-workflows/workflow-all-tiers.json`
- [Tier 6 tailored resume](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json): `n8n-workflows/workflow-all-tiers.json`
- [Merge results](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-all-tiers.json): `n8n-workflows/workflow-all-tiers.json`

### Job and email automations

- [Job scanner](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/job-scanner-workflow.json): `n8n-workflows/job-scanner-workflow.json`
- [Reply classifier](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-email-listener.json): `n8n-workflows/workflow-email-listener.json`
- [Follow-up drafts](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-followup-scheduler.json): `n8n-workflows/workflow-followup-scheduler.json`
- [Inbox labeler](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/workflow-gmail-labeler.json): `n8n-workflows/workflow-gmail-labeler.json`
- [Label ID lookup](https://github.com/odeliyach/careeros/blob/main/n8n-workflows/helper-get-label-ids.json): `n8n-workflows/helper-get-label-ids.json`

### External services and state

- **Groq API**
- **Private GitHub repo**
- **Gmail**
- **SMTP email**
- **Apify LinkedIn scraper**
- **Google Sheets cache**

### Static demo

- [Static dashboard](https://github.com/odeliyach/careeros/blob/main/index.html): `index.html`

### Other components

- **Job seeker**
- **Human reviewer**
- **Demo visitor**

## Connections

- Job seeker → Job input: submits job (evidence: `README.md`)
- Job input → Extract fields: passes description (evidence: `README.md`)
- Extract fields → Tier 1 analysis: passes fields (evidence: `README.md`)
- Tier 1 analysis → Tier 2 outreach: then runs (evidence: `README.md`)
- Tier 2 outreach → Tier 3 preparation: then runs (evidence: `README.md`)
- Tier 3 preparation → Tier 4 portfolio match: then runs (evidence: `README.md`)
- Tier 4 portfolio match → Tier 5 follow-up tracking: then runs (evidence: `README.md`)
- Tier 5 follow-up tracking → Tier 6 tailored resume: then runs (evidence: `README.md`)
- Tier 1 analysis → Groq API: requests analysis (evidence: `README.md`)
- Tier 2 outreach → Groq API: requests content (evidence: `README.md`)
- Tier 3 preparation → Groq API: requests content (evidence: `README.md`)
- Tier 4 portfolio match → Groq API: requests matching (evidence: `README.md`)
- Tier 5 follow-up tracking → Groq API: requests schedule (evidence: `README.md`)
- Tier 6 tailored resume → Groq API: requests resume (evidence: `README.md`)
- Tier 6 tailored resume → Merge results: provides results (evidence: `README.md`)
- Merge results → Private GitHub repo: writes applications (evidence: `README.md`)
- Merge results → SMTP email: sends notification (evidence: `README.md`)
- Job scanner → Apify LinkedIn scraper: fetches postings (evidence: `README.md`)
- Job scanner → Google Sheets cache: checks duplicates (evidence: `README.md`)
- Job scanner → Groq API: scores new jobs (evidence: `README.md`)
- Job scanner → Private GitHub repo: saves matches (evidence: `README.md`)
- Gmail → Reply classifier: triggers on message (evidence: `README.md`)
- Reply classifier → Private GitHub repo: updates status (evidence: `README.md`)
- Follow-up drafts → Groq API: drafts emails (evidence: `README.md`)
- Follow-up drafts → Human reviewer: requests review (evidence: `README.md`)
- Follow-up drafts → Gmail: prepares drafts (evidence: `README.md`)
- Inbox labeler → Gmail: labels messages (evidence: `README.md`)
- Label ID lookup → Gmail: looks up labels (evidence: `README.md`)
- Demo visitor → Static dashboard: views demo (evidence: `README.md`)
- Private GitHub repo → Static dashboard: browses locally (evidence: `README.md`)
