# ronit-roy-0007/cold-email-outreach_by_ori9in.io architecture

> Architecture diagram of the GitHub repository ronit-roy-0007/cold-email-outreach_by_ori9in.io, 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/ronit-roy-0007/cold-email-outreach_by_ori9in.io
- Repository: https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io

## Overview

IntentLead AI is a self-hosted B2B lead discovery, qualification, and outreach platform. Operators initiate campaigns through the dashboard or Telegram; the campaign pipeline discovers businesses, audits websites, scores leads, and prepares drafts for human approval before compliant, paced dispatch. Replies are ingested into conversations and can cancel scheduled follow-ups. The graph preserves documented AI, mailbox, compliance, and operator-control capabilities. Some implementation paths are represented by their exact source directories because their files were not sampled; edges without direct evidence are omitted.

Main entry points: [`apps/intelligence-api/app/services/pipeline.py`](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/pipeline.py) (Campaign pipeline), [`apps/intelligence-api/app/services/telegram_bot.py`](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/telegram_bot.py) (Telegram command center), [`apps/intelligence-api/app/services/inbound_service.py`](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/inbound_service.py) (Inbound reply handling), [`apps/intelligence-api/app/services/email_dispatcher.py`](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/email_dispatcher.py) (Compliant email dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operator["Operator interfaces"]
  node_dashboard["Web dashboard<br/>[routes.py]"]
  node_telegram["Telegram command center<br/>[telegram_bot.py]"]
  node_api["API application<br/>[main.py]"]
  node_campaign_api["Campaign endpoints<br/>[campaigns.py]"]
  node_orchestrator_api["Orchestration endpoints<br/>[orchestrator.py]"]
end

subgraph group_discovery["Discovery and qualification"]
  node_discovery_pipeline["Campaign pipeline<br/>[pipeline.py]"]
  node_scraping["Business discovery"]
  node_scraper_backends["Scraper backends<br/>[scraper_client.py]"]
  node_recon["Website reconnaissance<br/>[audit.py]"]
  node_scoring["Evidence scoring<br/>[engine.py]"]
end

subgraph group_outreach["Outreach and conversations"]
  node_drafts["Draft studio and AI"]
  node_campaigns["Campaign management<br/>[campaigns.py]"]
  node_subcampaigns["Sub-campaign control"]
  node_mailboxes["Mailbox rotation<br/>[mailbox_pool.py]"]
  node_dispatch["Compliant email dispatch"]
  node_followups["Follow-up scheduler<br/>[followup_engine.py]"]
  node_inbound["Inbound reply handling<br/>[inbound_service.py]"]
  node_webhook["Webhook protection"]
end

subgraph group_platform["Platform services"]
  node_database[("Application database<br/>[models.py]")]
  node_db_access["Database access<br/>[db.py]"]
  node_auth["Operator authentication<br/>[auth.py]"]
  node_security["Request security<br/>[security.py]"]
  node_settings["Runtime configuration<br/>[config.py]"]
  node_crypto["Field encryption<br/>[crypto.py]"]
end

node_operator(("Campaign operator"))
node_email_provider["Email transport"]
node_gemini["Google Gemini"]
node_telegram_service["Telegram service"]

node_operator -->|"uses"| node_dashboard
node_operator -->|"controls"| node_telegram
node_dashboard -->|"submits requests"| node_api
node_telegram -->|"starts discovery"| node_discovery_pipeline
node_telegram -->|"manages campaigns"| node_campaigns
node_telegram -->|"approves outreach"| node_dispatch
node_orchestrator_api -->|"runs pipeline"| node_discovery_pipeline
node_campaign_api -.->|"manages campaigns"| node_campaigns
node_discovery_pipeline -->|"requests prospects"| node_scraper_backends
node_discovery_pipeline -->|"selects provider"| node_scraping
node_discovery_pipeline -->|"audits prospects"| node_recon
node_discovery_pipeline -->|"scores evidence"| node_scoring
node_discovery_pipeline -->|"creates drafts"| node_drafts
node_drafts -->|"generates pitches"| node_gemini
node_telegram -->|"requests personalization"| node_gemini
node_dispatch -.->|"selects mailbox"| node_mailboxes
node_subcampaigns -->|"dispatches approved leads"| node_dispatch
node_dispatch -->|"sends messages"| node_email_provider
node_email_provider -.->|"delivers replies"| node_inbound
node_webhook -->|"verifies requests"| node_inbound
node_inbound -->|"cancels on reply"| node_followups
node_inbound -->|"sends reply alert"| node_telegram_service
node_followups -.->|"sends scheduled touches"| node_dispatch
node_api -->|"registers routes"| node_campaign_api
node_api -->|"registers routes"| node_orchestrator_api
node_api -->|"registers routes"| node_dashboard
node_db_access -->|"creates schema"| node_database
node_discovery_pipeline -->|"persists leads"| node_database
node_inbound -->|"stores replies"| node_database
node_security -->|"validates sessions"| node_auth
node_dashboard -->|"authenticates operators"| node_auth
node_db_access -->|"loads database config"| node_settings
node_database -->|"encrypts fields"| node_crypto

click node_dashboard "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/web/routes.py"
click node_telegram "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/telegram_bot.py"
click node_api "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/main.py"
click node_campaign_api "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/api/campaigns.py"
click node_orchestrator_api "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/api/orchestrator.py"
click node_discovery_pipeline "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/pipeline.py"
click node_scraping "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/providers/scrapling_client.py"
click node_scraper_backends "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/providers/scraper_client.py"
click node_recon "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/audit.py"
click node_scoring "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/scoring/engine.py"
click node_drafts "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/gemini_personalizer.py"
click node_campaigns "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/campaigns.py"
click node_subcampaigns "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/sub_campaign_service.py"
click node_mailboxes "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/mailbox_pool.py"
click node_dispatch "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/email_dispatcher.py"
click node_followups "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/followup_engine.py"
click node_inbound "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/inbound_service.py"
click node_webhook "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/webhook_security.py"
click node_database "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/models.py"
click node_db_access "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/db.py"
click node_auth "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/auth.py"
click node_security "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/security.py"
click node_settings "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/config.py"
click node_crypto "https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/crypto.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_dashboard,node_telegram,node_api,node_campaign_api,node_orchestrator_api toneBlue
class node_discovery_pipeline,node_scraping,node_scraper_backends,node_recon,node_scoring toneAmber
class node_drafts,node_campaigns,node_subcampaigns,node_mailboxes,node_dispatch,node_followups,node_inbound,node_webhook toneMint
class node_database,node_db_access,node_auth,node_security,node_settings,node_crypto toneRose
class node_operator,node_email_provider,node_gemini,node_telegram_service toneIndigo
```

## Components

### Operator interfaces

- [Web dashboard](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/web/routes.py): `apps/intelligence-api/app/web/routes.py`
- [Telegram command center](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/telegram_bot.py): `apps/intelligence-api/app/services/telegram_bot.py`
- [API application](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/main.py): `apps/intelligence-api/app/main.py`
- [Campaign endpoints](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/api/campaigns.py): `apps/intelligence-api/app/api/campaigns.py`
- [Orchestration endpoints](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/api/orchestrator.py): `apps/intelligence-api/app/api/orchestrator.py`

### Discovery and qualification

- [Campaign pipeline](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/pipeline.py): `apps/intelligence-api/app/services/pipeline.py`
- [Business discovery](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/providers/scrapling_client.py): `apps/intelligence-api/app/providers/scrapling_client.py`
- [Scraper backends](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/providers/scraper_client.py): `apps/intelligence-api/app/providers/scraper_client.py`
- [Website reconnaissance](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/audit.py): `apps/intelligence-api/app/services/audit.py`
- [Evidence scoring](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/scoring/engine.py): `apps/intelligence-api/app/scoring/engine.py`

### Outreach and conversations

- [Draft studio and AI](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/gemini_personalizer.py): `apps/intelligence-api/app/services/gemini_personalizer.py`
- [Campaign management](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/campaigns.py): `apps/intelligence-api/app/services/campaigns.py`
- [Sub-campaign control](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/sub_campaign_service.py): `apps/intelligence-api/app/services/sub_campaign_service.py`
- [Mailbox rotation](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/mailbox_pool.py): `apps/intelligence-api/app/services/mailbox_pool.py`
- [Compliant email dispatch](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/email_dispatcher.py): `apps/intelligence-api/app/services/email_dispatcher.py`
- [Follow-up scheduler](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/followup_engine.py): `apps/intelligence-api/app/services/followup_engine.py`
- [Inbound reply handling](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/inbound_service.py): `apps/intelligence-api/app/services/inbound_service.py`
- [Webhook protection](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/webhook_security.py): `apps/intelligence-api/app/services/webhook_security.py`

### Platform services

- [Application database](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/models.py): `apps/intelligence-api/app/models.py`
- [Database access](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/db.py): `apps/intelligence-api/app/db.py`
- [Operator authentication](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/auth.py): `apps/intelligence-api/app/services/auth.py`
- [Request security](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/security.py): `apps/intelligence-api/app/security.py`
- [Runtime configuration](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/config.py): `apps/intelligence-api/app/config.py`
- [Field encryption](https://github.com/ronit-roy-0007/cold-email-outreach_by_ori9in.io/blob/main/apps/intelligence-api/app/services/crypto.py): `apps/intelligence-api/app/services/crypto.py`

### Other components

- **Campaign operator**
- **Email transport**
- **Google Gemini**
- **Telegram service**

## Connections

- Campaign operator → Web dashboard: uses
- Campaign operator → Telegram command center: controls
- Web dashboard → API application: submits requests (evidence: `apps/intelligence-api/app/main.py`)
- Telegram command center → Campaign pipeline: starts discovery (evidence: `apps/intelligence-api/app/services/telegram_bot.py`)
- Telegram command center → Campaign management: manages campaigns (evidence: `apps/intelligence-api/app/services/telegram_bot.py`)
- Telegram command center → Compliant email dispatch: approves outreach (evidence: `apps/intelligence-api/app/services/telegram_bot.py`)
- Orchestration endpoints → Campaign pipeline: runs pipeline (evidence: `apps/intelligence-api/app/api/orchestrator.py`)
- Campaign endpoints → Campaign management: manages campaigns (evidence: `apps/intelligence-api/app/api/campaigns.py`)
- Campaign pipeline → Scraper backends: requests prospects (evidence: `apps/intelligence-api/app/services/pipeline.py`)
- Campaign pipeline → Business discovery: selects provider (evidence: `apps/intelligence-api/app/services/pipeline.py`)
- Campaign pipeline → Website reconnaissance: audits prospects (evidence: `apps/intelligence-api/app/services/pipeline.py`)
- Campaign pipeline → Evidence scoring: scores evidence (evidence: `apps/intelligence-api/app/services/pipeline.py`)
- Campaign pipeline → Draft studio and AI: creates drafts (evidence: `apps/intelligence-api/app/services/pipeline.py`)
- Draft studio and AI → Google Gemini: generates pitches
- Telegram command center → Google Gemini: requests personalization (evidence: `apps/intelligence-api/app/services/telegram_bot.py`)
- Compliant email dispatch → Mailbox rotation: selects mailbox (evidence: `apps/intelligence-api/app/services/email_dispatcher.py`)
- Sub-campaign control → Compliant email dispatch: dispatches approved leads (evidence: `apps/intelligence-api/app/services/sub_campaign_service.py`)
- Compliant email dispatch → Email transport: sends messages (evidence: `apps/intelligence-api/app/services/email_dispatcher.py`)
- Email transport → Inbound reply handling: delivers replies
- Webhook protection → Inbound reply handling: verifies requests (evidence: `apps/intelligence-api/app/api/inbound.py`)
- Inbound reply handling → Follow-up scheduler: cancels on reply (evidence: `apps/intelligence-api/app/services/inbound_service.py`)
- Inbound reply handling → Telegram service: sends reply alert (evidence: `apps/intelligence-api/app/services/inbound_service.py`)
- Follow-up scheduler → Compliant email dispatch: sends scheduled touches (evidence: `apps/intelligence-api/app/services/email_dispatcher.py`)
- API application → Campaign endpoints: registers routes (evidence: `apps/intelligence-api/app/main.py`)
- API application → Orchestration endpoints: registers routes (evidence: `apps/intelligence-api/app/main.py`)
- API application → Web dashboard: registers routes (evidence: `apps/intelligence-api/app/main.py`)
- Database access → Application database: creates schema (evidence: `apps/intelligence-api/app/db.py`)
- Campaign pipeline → Application database: persists leads (evidence: `apps/intelligence-api/app/services/pipeline.py`)
- Inbound reply handling → Application database: stores replies (evidence: `apps/intelligence-api/app/services/inbound_service.py`)
- Request security → Operator authentication: validates sessions (evidence: `apps/intelligence-api/app/security.py`)
- Web dashboard → Operator authentication: authenticates operators (evidence: `apps/intelligence-api/app/web/routes.py`)
- Database access → Runtime configuration: loads database config (evidence: `apps/intelligence-api/app/db.py`)
- Application database → Field encryption: encrypts fields (evidence: `apps/intelligence-api/app/models.py`)
