Real-time Tracking & Campaign Reports Flow
Understand the core mechanics, queues, and logic routines running on our servers when processing this module.
System Execution Pipeline
Below is the step-by-step sequence of events executed by our background workers.
Pixel Loaded
A recipient opens the email. Their mail client downloads the tracking pixel.
Redirect Clicked
Recipient clicks a link. The browser visits our server, which registers the click and redirects them.
Geo IP Lookups
The server resolves the recipient's IP to identify their country and city.
Dashboard Update
Metrics are compiled, and Socket.io pushes updates to active browser dashboards.
PDF Export
User requests a report. Puppeteer renders the charts and saves a PDF download.
Developer & Architect Notes
Technical Architecture
This module operates as a stateless service hosted across horizontally scalable server nodes. Distributed state coordinates through highly optimized Redis transactions to ensure consistency without deadlocks.
Edge Fail-Safe Rules
Critical protocols (like connection failure retries, cool-down timers, and data limits) are verified before outbound dispatches. Failures degrade gracefully, prioritizing list health and preventing blacklisting.