Platforma subskrypcyjna jest używana ponownie w nowym projekcie. Do 20 lutego 2026 roku strona generowała ruch dla Projektu LEGACY. Od 21 lutego 2026 roku strona została przekazana innej drużynie i działa jako Projekt NEW.
Specyfika platformy: subskrybenci zaangażowani podczas pierwszego projektu nadal generują przychody (powtarzające się obciążenia, zakupy treści, datki) przez kolejne 3–6 miesięcy po przekazaniu. Dlatego przy podziale przychodów krytycznie ważne jest uwzględnienie daty pierwszej subskrypcji subskrybenta, a nie daty transakcji — w przeciwnym razie efektywność nowego projektu będzie zniekształcona.
Podstawowa zasada
Projekt subskrybenta jest określany raz — według daty pierwszej subskrypcji:
- do 20.02.2026 włącznie → LEGACY
- od 21.02.2026 → NEW
Po przypisaniu projekt nie zmienia się. Wszystkie transakcje subskrybenta zawsze odnoszą się do jego projektu.
Co liczyć
Tylko NET przychody według typów: subskrypcje, powtarzające się obciążenia (rebills), zakupy treści (PPV), datki (tips). Zwroty/chargebacki — osobnym miesięcznym raportem, bez przeliczenia wcześniejszych raportów.
Źródło danych
Parsowanie strony statystyk platformy subskrypcyjnej (web, strona z zestawieniami). Parser uzyskuje transakcje oraz datę pierwszej subskrypcji każdego subskrybenta. Uruchomienie — na serwerze Windows z stabilną sesją.
Struktura bazy danych
Tabela fans: fan_id, username, join_date, project (LEGACY/NEW), first_seen_at.
Tabela transactions: tx_datetime, tx_date, fan_id/username, project, type (subscription/rebill/ppv/tip/refund), net_amount.
Wymagania: bez duplikatów, ponowne uruchomienie nie zmienia historii, dodawane są tylko nowe transakcje.
Raporty w Telegramie (uruchomienie co godzinę)
Dwa osobne kanały: reports_channel oraz logs_channel.
Raporty dla każdego projektu osobno:
- Codziennie: subskrypcje / rebills / PPV / tips / łączna / liczba transakcji
- Co tydzień: tydzień kalendarzowy (Pn–Nd) z wyświetleniem zakresu dat
- Co miesiąc: podział według typów + łączna
- Na całe życie: ogólne podsumowania z podziałem
- Zwroty: osobny miesięczny raport
Dzienniki: potwierdzenie uruchomienia, liczba nowych transakcji, błędy, alerty (nie udało się uzyskać net_amount, join_date, zmienił się układ).
Edge cases
Jeśli join_date nie jest określona → project = UNKNOWN, transakcje nie są uwzględniane w raportach, system podejmuje ponowną próbę przy następnym uruchomieniu.
Bezpieczeństwo
Wszystkie dane uwierzytelniające są przechowywane tylko na serwerze. W Telegramie przesyłane są wyłącznie agregaty.
Kryteria akceptacji
- Wszyscy subskrybenci do 20.02.2026 → LEGACY na zawsze
- Wszyscy subskrybenci od 21.02.2026 → NEW na zawsze
- Transakcje są przypisywane do projektu subskrybenta, a nie według daty transakcji
- Używane jest NET, a nie gross
- Co tydzień = Pn–Nd z zakresem dat
- Bez duplikatów transakcji
- Zwroty osobno raz w miesiącu
- Dzienniki i alerty działają
