# swaraj-work/job-intel architecture

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

- Interactive diagram: https://gitdiagram.com/swaraj-work/job-intel
- Repository: https://github.com/swaraj-work/job-intel

## Overview

JobIntel discovers jobs and funding signals, turns them into scored company opportunities, enriches them with technology and decision-maker information, and supports outreach and application tracking. The graph preserves the documented product branches; some modules and UI wiring were not sampled, so uncertain connections are omitted.

Main entry points: [`server/pipeline/processor.js`](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/processor.js) (Signal Processor), [`server/routes.js`](https://github.com/swaraj-work/job-intel/blob/main/server/routes.js) (HTTP Routes), [`server/scheduler.js`](https://github.com/swaraj-work/job-intel/blob/main/server/scheduler.js) (Source Scheduler), [`server/pipeline/people.js`](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/people.js) (Founder Discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Signal Discovery"]
  node_sourcecatalog["Source Catalog<br/>[index.js]"]
  node_jobboards["Job Boards<br/>[jobs.js]"]
  node_scheduler["Source Scheduler<br/>[scheduler.js]"]
  node_agent["Query Agent<br/>[agent.js]"]
end

subgraph group_processing["Opportunity Processing"]
  node_processor["Signal Processor<br/>[processor.js]"]
  node_prefilter["Signal Triage<br/>[prefilter.js]"]
  node_extract["Entity Extraction<br/>[extract.js]"]
  node_resolve["Company Resolution<br/>[resolve.js]"]
  node_scoring["Opportunity Scoring<br/>[score.js]"]
end

subgraph group_intelligence["Company Intelligence"]
  node_intel["Funding Signals<br/>[intel.js]"]
  node_enrich["Tech &amp; ATS Enrichment<br/>[enrich.js]"]
  node_people["Founder Discovery<br/>[people.js]"]
end

subgraph group_outreach["Outreach Workflow"]
  node_email["Email Verification<br/>[email-finders.js]"]
  node_drafts["Personalized Drafts<br/>[llm.js]"]
  node_pipeline["Applications &amp; Outreach<br/>[routes.js]"]
end

subgraph group_platform["Application Platform"]
  node_webapp["Discovery Inbox<br/>[app.js]"]
  node_api["HTTP Routes<br/>[routes.js]"]
  node_engine["Server Startup<br/>[index.js]"]
  node_store[("SQLite Store<br/>[db.js]")]
  node_profile["Profile &amp; Config<br/>[config.js]"]
  node_events["Activity Events<br/>[bus.js]"]
  node_http["HTTP Fetch Utilities<br/>[http.js]"]
end

node_candidate(("Candidate"))

node_candidate -->|"uses inbox"| node_webapp
node_webapp -.->|"requests data"| node_api
node_engine -->|"registers routes"| node_api
node_engine -->|"starts scheduling"| node_scheduler
node_engine -->|"wires processing"| node_processor
node_api -->|"reads and writes"| node_store
node_api -->|"runs scans"| node_scheduler
node_api -->|"requests enrichment"| node_enrich
node_api -->|"finds email"| node_email
node_api -->|"saves contacts"| node_people
node_api -->|"rescores leads"| node_scoring
node_scheduler -->|"fetches sources"| node_sourcecatalog
node_sourcecatalog -->|"uses job sources"| node_jobboards
node_sourcecatalog -->|"fetches feeds"| node_http
node_agent -->|"runs queries"| node_scheduler
node_processor -->|"filters signals"| node_prefilter
node_processor -->|"extracts entities"| node_extract
node_processor -->|"resolves companies"| node_resolve
node_processor -->|"scores opportunities"| node_scoring
node_processor -->|"enriches companies"| node_enrich
node_processor -->|"discovers contacts"| node_people
node_processor -->|"finds emails"| node_email
node_prefilter -->|"triages funding"| node_intel
node_extract -->|"extracts people"| node_people
node_people -->|"fetches company pages"| node_http
node_enrich -->|"fetches websites"| node_http
node_email -->|"uses contact data"| node_people
node_candidate -->|"tracks applications"| node_pipeline
node_candidate -->|"personalizes outreach"| node_drafts
node_scoring -.->|"ranks draft targets"| node_drafts
node_candidate -->|"configures profile"| node_profile
node_processor -.->|"persists leads"| node_store
node_scheduler -.->|"records source runs"| node_store

click node_webapp "https://github.com/swaraj-work/job-intel/blob/main/public/app.js"
click node_api "https://github.com/swaraj-work/job-intel/blob/main/server/routes.js"
click node_engine "https://github.com/swaraj-work/job-intel/blob/main/server/index.js"
click node_store "https://github.com/swaraj-work/job-intel/blob/main/server/db.js"
click node_profile "https://github.com/swaraj-work/job-intel/blob/main/server/config.js"
click node_events "https://github.com/swaraj-work/job-intel/blob/main/server/bus.js"
click node_sourcecatalog "https://github.com/swaraj-work/job-intel/blob/main/server/sources/index.js"
click node_jobboards "https://github.com/swaraj-work/job-intel/blob/main/server/sources/jobs.js"
click node_scheduler "https://github.com/swaraj-work/job-intel/blob/main/server/scheduler.js"
click node_agent "https://github.com/swaraj-work/job-intel/blob/main/server/agent.js"
click node_processor "https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/processor.js"
click node_prefilter "https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/prefilter.js"
click node_extract "https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/extract.js"
click node_resolve "https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/resolve.js"
click node_scoring "https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/score.js"
click node_intel "https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/intel.js"
click node_enrich "https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/enrich.js"
click node_people "https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/people.js"
click node_email "https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/email-finders.js"
click node_drafts "https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/llm.js"
click node_pipeline "https://github.com/swaraj-work/job-intel/blob/main/server/routes.js"
click node_http "https://github.com/swaraj-work/job-intel/blob/main/server/util/http.js"

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_sourcecatalog,node_jobboards,node_scheduler,node_agent toneBlue
class node_processor,node_prefilter,node_extract,node_resolve,node_scoring toneAmber
class node_intel,node_enrich,node_people toneMint
class node_email,node_drafts,node_pipeline toneRose
class node_webapp,node_api,node_engine,node_store,node_profile,node_events,node_http,node_candidate toneIndigo
```

## Components

### Signal Discovery

- [Source Catalog](https://github.com/swaraj-work/job-intel/blob/main/server/sources/index.js): `server/sources/index.js`
- [Job Boards](https://github.com/swaraj-work/job-intel/blob/main/server/sources/jobs.js): `server/sources/jobs.js`
- [Source Scheduler](https://github.com/swaraj-work/job-intel/blob/main/server/scheduler.js): `server/scheduler.js`
- [Query Agent](https://github.com/swaraj-work/job-intel/blob/main/server/agent.js): `server/agent.js`

### Opportunity Processing

- [Signal Processor](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/processor.js): `server/pipeline/processor.js`
- [Signal Triage](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/prefilter.js): `server/pipeline/prefilter.js`
- [Entity Extraction](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/extract.js): `server/pipeline/extract.js`
- [Company Resolution](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/resolve.js): `server/pipeline/resolve.js`
- [Opportunity Scoring](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/score.js): `server/pipeline/score.js`

### Company Intelligence

- [Funding Signals](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/intel.js): `server/pipeline/intel.js`
- [Tech & ATS Enrichment](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/enrich.js): `server/pipeline/enrich.js`
- [Founder Discovery](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/people.js): `server/pipeline/people.js`

### Outreach Workflow

- [Email Verification](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/email-finders.js): `server/pipeline/email-finders.js`
- [Personalized Drafts](https://github.com/swaraj-work/job-intel/blob/main/server/pipeline/llm.js): `server/pipeline/llm.js`
- [Applications & Outreach](https://github.com/swaraj-work/job-intel/blob/main/server/routes.js): `server/routes.js`

### Application Platform

- [Discovery Inbox](https://github.com/swaraj-work/job-intel/blob/main/public/app.js): `public/app.js`
- [HTTP Routes](https://github.com/swaraj-work/job-intel/blob/main/server/routes.js): `server/routes.js`
- [Server Startup](https://github.com/swaraj-work/job-intel/blob/main/server/index.js): `server/index.js`
- [SQLite Store](https://github.com/swaraj-work/job-intel/blob/main/server/db.js): `server/db.js`
- [Profile & Config](https://github.com/swaraj-work/job-intel/blob/main/server/config.js): `server/config.js`
- [Activity Events](https://github.com/swaraj-work/job-intel/blob/main/server/bus.js): `server/bus.js`
- [HTTP Fetch Utilities](https://github.com/swaraj-work/job-intel/blob/main/server/util/http.js): `server/util/http.js`

### Other components

- **Candidate**

## Connections

- Candidate → Discovery Inbox: uses inbox (evidence: `README.md`)
- Discovery Inbox → HTTP Routes: requests data
- Server Startup → HTTP Routes: registers routes (evidence: `server/index.js`)
- Server Startup → Source Scheduler: starts scheduling (evidence: `server/index.js`)
- Server Startup → Signal Processor: wires processing (evidence: `server/index.js`)
- HTTP Routes → SQLite Store: reads and writes (evidence: `server/routes.js`)
- HTTP Routes → Source Scheduler: runs scans (evidence: `server/routes.js`)
- HTTP Routes → Tech & ATS Enrichment: requests enrichment (evidence: `server/routes.js`)
- HTTP Routes → Email Verification: finds email (evidence: `server/routes.js`)
- HTTP Routes → Founder Discovery: saves contacts (evidence: `server/routes.js`)
- HTTP Routes → Opportunity Scoring: rescores leads (evidence: `server/routes.js`)
- Source Scheduler → Source Catalog: fetches sources (evidence: `server/scheduler.js`)
- Source Catalog → Job Boards: uses job sources (evidence: `server/sources/index.js`)
- Source Catalog → HTTP Fetch Utilities: fetches feeds (evidence: `server/sources/index.js`)
- Query Agent → Source Scheduler: runs queries (evidence: `server/agent.js`)
- Signal Processor → Signal Triage: filters signals (evidence: `server/pipeline/processor.js`)
- Signal Processor → Entity Extraction: extracts entities (evidence: `server/pipeline/processor.js`)
- Signal Processor → Company Resolution: resolves companies (evidence: `server/pipeline/processor.js`)
- Signal Processor → Opportunity Scoring: scores opportunities (evidence: `server/pipeline/processor.js`)
- Signal Processor → Tech & ATS Enrichment: enriches companies (evidence: `server/pipeline/processor.js`)
- Signal Processor → Founder Discovery: discovers contacts (evidence: `server/pipeline/processor.js`)
- Signal Processor → Email Verification: finds emails (evidence: `server/pipeline/processor.js`)
- Signal Triage → Funding Signals: triages funding (evidence: `server/pipeline/prefilter.js`)
- Entity Extraction → Founder Discovery: extracts people (evidence: `server/pipeline/extract.js`)
- Founder Discovery → HTTP Fetch Utilities: fetches company pages (evidence: `server/pipeline/people.js`)
- Tech & ATS Enrichment → HTTP Fetch Utilities: fetches websites (evidence: `server/pipeline/enrich.js`)
- Email Verification → Founder Discovery: uses contact data (evidence: `server/pipeline/email-finders.js`)
- Candidate → Applications & Outreach: tracks applications (evidence: `README.md`)
- Candidate → Personalized Drafts: personalizes outreach (evidence: `README.md`)
- Opportunity Scoring → Personalized Drafts: ranks draft targets
- Candidate → Profile & Config: configures profile (evidence: `README.md`)
- Signal Processor → SQLite Store: persists leads (evidence: `server/pipeline/processor.js`)
- Source Scheduler → SQLite Store: records source runs (evidence: `server/scheduler.js`)
