This document outlines the system design for the project hosted in the cookie-cutter codebase. This is a web application with backend services, integrations, and data processing capabilities. It is designed to handle various tasks such as user tracking, data mapping, and API integrations. The system runs on t.makehook.ws - Due to legacy domain name, it was originally hosted, it's still stuck with this domain. All third party cookies are using this, it's not changable.
The system is built using a modular architecture, with clear separation of concerns across different components. The main components include:
The backend is implemented using Python and Flask. It provides RESTful APIs for various functionalities, including user tracking, data mapping, and integrations with external services.
The system includes several helper libraries for data processing:
The system integrates with external services such as Shopify, Slack, and Google Sheets. These integrations are managed through dedicated helper libraries.
The application serves both static and dynamic content:
static/ directory.render_template function, with templates stored in the templates/ directory.The system tracks user activity using cookies and fingerprints. It maps user data such as phone numbers and emails to unique identifiers.
/p/<cookie_id>/<org>/<caller>: Serves iframe markup for tracking./m.png: Maps phone numbers and emails to cookies.The system maps various identifiers to user data, enabling seamless integration across services.
mapping: Stores mappings between cookies, organizations, and hosts.emails: Stores email mappings.msisdn: Stores phone number mappings.The system integrates with external services to enhance functionality:
The system is containerized using Docker, with deployment configurations managed through Kubernetes.
deployment.yml: Defines deployment specifications.hpa.yml: Configures horizontal pod autoscaling.The system is designed to scale horizontally:
The system includes several security measures:
Secure and SameSite=None attributes.Expand integrations to include more services like Salesforce and HubSpot.