How harishchand83077/outreach-automation works
Outreach-automation is a multi-tenant cold-outreach system: operators import leads, research companies, prepare drafts for human review, schedule approved mail, and process replies and opt-outs. The API and browser dashboard provide the user surface; a separate worker handles background work. The README documents the end-to-end workflow and safety controls. Source excerpts and the index support several internal links; unsampled route and worker behavior is represented only where the README establishes the relationship.
Main entry points: handlers.py Background worker · routers API capabilities · service.py Reply handling · App.jsx Web dashboard
Components 21
User surfaces
- Web dashboard
frontend/src/App.jsx - FastAPI application
app/api/app.py - API capabilities
app/api/routers - Browser extension
extension/src/panel.ts
Outreach workflow
- Lead import
app/services/importer/service.py - Company research
app/services/research/service.py - Web search
app/services/research/search.py - Email drafting
app/services/drafting/generator.py - Draft review
app/db/drafts.py - Reply handling
app/services/reply/service.py - Research search chain
app/services/research/chain.py
Runtime operations
- Background worker
app/worker/handlers.py - Mail transport
app/services/mail/smtp.py - Mailbox monitoring
app/services/mail/imap.py - LLM routing
app/services/llm/router.py
Data and foundations
- Postgres data
app/db/models.py - Scoped data access
app/db/repo.py - Job queue
app/db/queue.py - Lead state machine
app/domain/state.py - Validated settings
app/core/settings.py
Other components
- Campaign operator
Connections 25
- Campaign operator → Web dashboard: uses
README.md - Web dashboard → FastAPI application: calls
frontend/src/App.jsx - Browser extension → FastAPI application: submits leads
- FastAPI application → API capabilities: routes requests
app/api/app.py - API capabilities → Lead import: imports leads
- API capabilities → Company research: requests research
- API capabilities → Draft review: approves drafts
app/api/routers/review.py - Background worker → Company research: runs research
app/worker/handlers.py - Company research → Research search chain: uses search chain
app/services/research/service.py - Research search chain → Web search: searches web
app/services/research/chain.py - Background worker → Email drafting: creates drafts
app/worker/handlers.py - Email drafting → LLM routing: generates with
- Draft review → Background worker: queues approved sends
app/worker/handlers.py - Background worker → Mail transport: sends approved mail
- Mailbox monitoring → Reply handling: ingests replies
app/services/reply/ingest.py - Reply handling → Job queue: cancels follow-ups
app/services/reply/service.py - Reply handling → Lead state machine: updates lead state
app/services/reply/service.py - Scoped data access → Postgres data: reads and writes
app/db/repo.py - Job queue → Postgres data: stores jobs
app/db/queue.py - Background worker → Job queue: processes jobs
app/worker/handlers.py - Validated settings → LLM routing: configures providers
- Validated settings → Mail transport: controls sending
README.md - Campaign operator → Draft review: reviews drafts
README.md - Campaign operator → Web dashboard: manages campaigns
README.md - Reply handling → Campaign operator: reports outcomes