Panel Administratora

Panel administratora to zaawansowany widok dostępny wyłącznie dla deweloperów bota. Zapewnia pełny wgląd w działanie bota na wszystkich serwerach, logi systemowe, statystyki użycia i system broadcastów.

Dostęp

Ograniczony dostęp

Panel administratora jest dostępny tylko dla użytkowników zdefiniowanych jako deweloperzy:

• Użytkownik z ID ustawionym w zmiennej środowiskowej DEVELOPER_USER_ID
• Użytkownicy dodani do tabeli developers w bazie danych

Zwykli administratorzy serwerów nie mają dostępu do tego panelu.

Statystyki globalne

Główna sekcja panelu wyświetla aktualne statystyki bota:

Metryka	Opis
Total Guilds	Liczba aktywnych serwerów z botem
Total Users	Liczba unikalnych użytkowników (z command_stats)
Commands (24h)	Komendy wykonane w ostatnich 24 godzinach
Command Breakdown	Ranking komend wg częstotliwości użycia (24h)
Uptime	Czas działania procesu API od ostatniego restartu
Last Restart	Timestamp ostatniego restartu

Health systemu

Panel wyświetla metryki zdrowia infrastruktury:

Metryka	Opis
Bot Status	Online/Offline (sprawdzany via health check port 8080)
DB Size	Rozmiar bazy danych PostgreSQL
DB Connections	Użyte/maksymalne połączenia w puli
Process Memory	RAM używany przez proces API
System Memory	RAM systemu (used/total)
CPU	Obciążenie procesora
Disk	Zajęte/całkowite miejsce na dysku
Python Version	Wersja Pythona na VPS
OS Info	System operacyjny VPS

Lista serwerów (szczegółowa)

Tabela wszystkich aktywnych serwerów z informacjami:

• Nazwa serwera (pobierana z Discord API)
• Ikona serwera
• Liczba członków
• Język
• Kolor embedu
• Włączone moduły
• Data instalacji

Kliknięcie serwera otwiera pełną konfigurację (cog_settings, dashboard_users, broadcast_channel itd.).

Statystyki komend

Wykresy i dane o użyciu komend:

• Dzienne statystyki — wykres użycia komend w wybranym okresie (do 90 dni)
• Filtr po komendzie — podgląd użycia konkretnej komendy
• Cog Usage — ile serwerów ma włączony dany moduł

Logi operacyjne

Tabela logów systemowych z filtrowaniem:

Filtr	Opcje
Severity	info, warning, error
Event Type	Typ zdarzenia (np. guild_join, config_update, error)
Limit	Maksymalnie 500 wpisów

Każdy wpis zawiera: timestamp, severity, event_type, guild_id, message.

System broadcastów

Broadcasty to wiadomości wysyłane przez dewelopera do wszystkich serwerów z botem (na ich broadcast channel).

Tworzenie broadcastu

1. Wybierz kategorię:
   • changelog — informacje o aktualizacjach
   • announcement — ogłoszenia
   • maintenance — planowane przerwy/prace
2. Wpisz tytuł (max 256 znaków)
3. Opcjonalnie: dodaj treść (max 4000 znaków)
4. Opcjonalnie: użyj wizualnego edytora embedów
5. Opcjonalnie: zaplanuj na konkretny czas (scheduled_at)
6. Wyślij — bot dostarcza broadcast w ciągu 30 sekund

Historia broadcastów

Tabela wysłanych broadcastów z raportami dostarczenia:

Pole	Opis
Title	Tytuł broadcastu
Category	changelog / announcement / maintenance
Sent At	Kiedy został wysłany
Success Rate	% serwerów, do których dotarł
Targeted	Ile serwerów było celem
Successful	Ile dostaw się powiodło
Skipped	Ile pominięto (brak kanału)
Failed	Ile się nie udało (błędy)

Raport dostarczenia

Kliknięcie broadcastu pokazuje szczegóły:

• Ile serwerów było targetowanych
• Ile dostaw się powiodło
• Ile zostało pominiętych (np. brak broadcast channel)
• Ile się nie powiodło + szczegóły błędów

Zarządzanie deweloperami

Panel umożliwia zarządzanie listą deweloperów bota:

• Lista — wszyscy deweloperzy (z bazy + env var)
• Dodaj — nowy deweloper po Discord User ID
• Usuń — usunięcie dewelopera (nie można usunąć siebie ani primary developera z env var)

wskazówka

Primary developer (z DEVELOPER_USER_ID) nie może zostać usunięty — jest to zabezpieczenie przed utratą dostępu.