Panel sterowania kontami Telegram

## 1. System ról i autoryzacja

### 1.1 Role użytkowników

- Administrator

- Użytkownik

### 1.2 Funkcje administratora

- Moderacja kont użytkowników

- Potwierdzanie nowych rejestracji

- Usuwanie kont

- Zarządzanie statystyką:

  - Tabela wszystkich kont w systemie z następującymi kolumnami:

    - ID konta

    - Numer telefonu

    - Właściciel konta (użytkownik)

    - Liczba utworzonych wiadomości opóźnionych

    - Data ostatniej aktywności

    - Przycisk usunięcia konta

  - Paginacja:

    - 50 rekordów na stronę

    - Nawigacja po stronach

    - Sortowanie według dowolnej kolumny

  - Filtrowanie danych:

    - Według użytkownika

    - Według daty

    - Według liczby wiadomości

### 1.3 Rejestracja użytkowników

- Pola do rejestracji:

  - Login

  - Hasło

  - Nick Telegram

- Status: oczekiwanie na potwierdzenie przez administratora

- Dostęp do panelu tylko po potwierdzeniu

### 2. Funkcjonalność panelu użytkownika

2.1 Zarządzanie kontami

Przycisk "Dodaj konto"

Tabela kont z następującymi elementami:

Lp.

Numer telefonu konta

Przycisk "Włącz wysyłkę"

Przycisk "Usuń konto"

Checkbox do wyboru konta

Przycisk "Włącz wysyłkę dla wybranych"

### 3.3 Algorytm wysyłki

1. Zbieranie kontaktów:

   - Otrzymywanie wszystkich kontaktów

   - Filtrowanie wzajemnych kontaktów

   - Sortowanie według czasu ostatniego online:

     - Online teraz

     - Niedawno w sieci

     - Mniej niż godzinę temu

     - Mniej niż dwie godziny temu

     - I tak dalej

2. Mechanizm opóźnionej wysyłki:

   - Grupowanie kontaktów po 5

   - Szybkie tworzenie wiadomości opóźnionych:

     - Minimalne opóźnienie między zapytaniami, aby uniknąć ograniczeń API

     - Dla pierwszej grupy: opóźniona wysyłka po 5 minutach od aktualnego czasu

     - Dla każdej następnej grupy: +15 minut do czasu wysyłki

     - Przykład dla 100 kontaktów:

       - 20 grup po 5 kontaktów

       - Tworzenie wszystkich wiadomości opóźnionych odbywa się sekwencyjnie z minimalnym opóźnieniem

       - Czas tworzenia wszystkich wiadomości opóźnionych: kilka sekund

       - Faktyczna wysyłka wiadomości będzie odbywać się przez 5 godzin

   - Po utworzeniu wszystkich wiadomości opóźnionych:

     - Natychmiastowe odłączenie od konta

     - Zwolnienie zasobów

     - Aktualizacja statystyk w bazie danych

## 4. Wymagania techniczne

- Asynchroniczne wykonywanie wszystkich operacji

- Wsparcie do 50 równoległych wątków

- Przechowywanie plików sesji i konfiguracji w osobnym folderze projektu

- Praca przez proxy

- Obsługa błędów i wyjątków

- Logowanie procesów

- Optymalizacja pracy z API Telegram:

  - Minimalne opóźnienia między zapytaniami

  - Efektywne zarządzanie połączeniami

  - Obsługa ograniczeń API

## 5. Struktura plików

- Plik proxy.txt z proxy

- Folder do przechowywania sesji

- Folder do konfiguracji JSON kont

- Baza danych do przechowywania statystyk:

  - Tabela kont

  - Tabela użytkowników

  - Tabela statystyk wysłanych wiadomości