How jacobbhatt12/ops-dashboard works
This repository is an unattended agency back office with two principal workflows: monthly client site-health reports and lead discovery followed by scheduled outreach. Lead Finder imports and crawls businesses, queues them for review, then the outreach bot applies contact and bounce safeguards before sending. The dashboard exposes operational pages for these workflows and other agency records. Relationships are limited to calls visible in excerpts or the source index and workflows explicitly described in the README; unsampled integrations are not inferred.
Main entry points: run_daily.py Daily send orchestrator · monthly_agent.py Monthly report agent · run.py Finder job runner · api.py Lead Finder API
Components 25
Client reporting
- Monthly report agent
monthly_agent.py - Report send log
send_log.py - GitHub deploy status
- Hostinger site status
- GA4 traffic
- PageSpeed scores
- Client contacts
Lead discovery
- Overture import
leadfinder/overture.py - Website crawler
leadfinder/crawler.py - Finder settings
leadfinder/settings.py - Finder job runner
leadfinder/run.py - Lead Finder API
leadfinder/api.py
Outreach sending
- Gmail service
- Lead email template
leadfinder/template.py - Daily send orchestrator
bot/run_daily.py - Contact eligibility
bot/contacts.py - Batch selection
bot/selector.py - Opt-out and bounce scan
bot/scanner.py - Outreach message
bot/message.py
Operations dashboard
- Dashboard server
ops_dashboard.py - Dashboard pages
dashboard - Agency records pages
dashboard
Persistent state
- Lead lifecycle store
leadfinder/store.py - Send and block store
bot/store.py
Other components
- Agency operator
Connections 35
- Agency operator → Dashboard pages: operates
README.md - Dashboard pages → Dashboard server: uses
README.md - Dashboard server → Lead Finder API: serves
ops_dashboard.py - Dashboard server → Monthly report agent: exposes
ops_dashboard.py - Dashboard server → Agency records pages: serves
README.md - Agency operator → Lead Finder API: reviews leads
README.md - Lead Finder API → Lead lifecycle store: reads and updates
leadfinder/api.py - Lead Finder API → Lead email template: renders preview
leadfinder/api.py - Lead Finder API → Finder job runner: starts jobs
leadfinder/api.py - Finder job runner → Finder settings: loads settings
leadfinder/run.py - Finder job runner → Overture import: imports places
leadfinder/run.py - Finder job runner → Website crawler: crawls sites
leadfinder/run.py - Finder job runner → Lead lifecycle store: stores leads
leadfinder/run.py - Finder job runner → Lead email template: uses template
leadfinder/run.py - Overture import → Lead lifecycle store: supplies businesses
README.md - Website crawler → Lead lifecycle store: updates checks
README.md - Finder settings → Finder job runner: configures jobs
README.md - Daily send orchestrator → Send and block store: loads send state
bot/run_daily.py - Daily send orchestrator → Contact eligibility: loads contacts
bot/run_daily.py - Daily send orchestrator → Opt-out and bounce scan: scans replies
bot/run_daily.py - Daily send orchestrator → Batch selection: selects batch
bot/run_daily.py - Daily send orchestrator → Gmail service: sends messages
README.md - Daily send orchestrator → Outreach message: renders outreach
bot/run_daily.py - Daily send orchestrator → Lead lifecycle store: uses approved leads
README.md - Opt-out and bounce scan → Gmail service: reads replies
README.md - Opt-out and bounce scan → Send and block store: blocks addresses
README.md - Batch selection → Send and block store: checks history
README.md - Daily send orchestrator → Lead email template: renders lead emails
README.md - Monthly report agent → GitHub deploy status: checks deployments
monthly_agent.py - Monthly report agent → Hostinger site status: collects site status
README.md - Monthly report agent → PageSpeed scores: collects scores
README.md - Monthly report agent → GA4 traffic: gets traffic
monthly_agent.py - Monthly report agent → Client contacts: reports to clients
README.md - Monthly report agent → Gmail service: sends reports
README.md - Monthly report agent → Report send log: records sends
monthly_agent.py