TDX Traffic Tracker

Self-hosted MVP

Личный трекер трафика без подписок

Минимальный стек для campaign routing, direct redirects, landing-to-offer сценариев, postback-конверсий и оперативного dashboard на своем сервере.

Campaign click
Flow + filters
Direct offer
Landing → Offer
Clicks Postbacks ROI
23 автотеста
PostgreSQL schema + seed
Docker VPS-ready
Auth session-based admin

MVP surface

Что уже входит

Campaign routing

Public endpoint принимает клики, выбирает flow и сохраняет click context с subid.

Flows and filters

Поддержаны forced, regular и default flows, country/IP/user-agent style фильтры.

Postbacks

Conversion endpoint связывает payout/status с исходным click по subid.

Operational dashboard

Clicks, unique clicks, conversions, cost, revenue, profit, ROI, CR и EPC.

Architecture

Небольшие модули вместо монолита

Доменная логика живет отдельно от HTTP-слоя. Storage идет через repository boundary: memory mode удобен для demo, PostgreSQL mode готов для persistent запуска.

src/core/*
src/http/app.js
src/storage/*
migrations/001_initial_schema.sql
seed/demo.sql

Deploy

Локально и на VPS

Backend не работает на GitHub Pages: Pages используется только для статической страницы проекта. Реальный трекер запускается локально или на VPS через Docker.

npm test
make dev
docker build -t traffic-tracker-app .
docker run -p 127.0.0.1:3000:3000 traffic-tracker-app