Skip to content

Directory Guide

Directory Purpose
app/core/models/ Database models, enums, and query functions
app/methods/ Business logic (controllers) — campaign ops, attribution, proofing, billing
app/routes/ API endpoints — request handling, serialization, route-to-method dispatch
app/celery/ Background workers — Celery Beat periodic tasks
app/core/integrations/ External service clients — Klaviyo, Shopify, printers, etc.
app/scripts/ Admin scripts and one-off operations
app/tests/ Test suite (pytest + factoryboy)
docs/ This documentation
docs/models/ Per-model documentation with state machines
docs/data_flow/ Data flow diagrams for key pipelines