Okres próbny bota

Bot Okresu Próbnego
Telegram-bot do zarządzania okresem próbnym (8 dni) w czacie roboczym i grupie szkoleniowej.

Możliwości
• Śledzenie okresu próbnego od momentu dołączenia
• Kontrola dwóch czatów jednocześnie
• Powiadomienia dla administratorów o wygaśnięciu okresu próbnego i opuszczeniu użytkowników
• Sprawdzanie obecności w obu czatach
• Panel administracyjny w Telegramie
• Baza danych SQLite
• Harmonogram regularnych kontroli

Instalacja
git clone https://github.com/yourusername/trial-period-bot.git
cd trial-period-bot
pip install -r requirements.txt

Utwórz .env:
BOT_TOKEN=your_bot_token
WORK_CHAT_ID=-100xxxxxxxxxx
STUDY_GROUP_ID=-100yyyyyyyyyy
TRIAL_MINUTES=11520

Dodaj pierwszego administratora:
python add_admin.py YOUR_TELEGRAM_ID

Uruchomienie
python main.py

Jak uzyskać dane
• Token: @BotFather → /newbot
• ID czatów: dodaj @userinfobot do czatu, przekaż wiadomość
• Twój ID: napisz @userinfobot → /start

Panel administracyjny
Użytkownicy:
• Eksport listy
• Lista na okresie próbnym
• Sprawdzanie obecności
• Usuń uczestnika
• Pomiń okres próbny (przedwczesna akceptacja)

Administratorzy:
• Dodaj / usuń
• Lista administratorów

Funkcje automatyczne
Przy dołączeniu:
• Automatyczna akceptacja zgłoszenia
• Dodanie do bazy danych
• Uruchomienie 8-dniowego okresu próbnego

Monitorowanie:
• 24 godziny przed — powiadomienie dla administratorów
• Po zakończeniu — powiadomienie z przyciskami „Zostawić / Wyrzucić”

Przy opuszczeniu:
• Aktualizacja statusu
• Powiadomienie dla administratorów
• Automatyczne usunięcie z grupy szkoleniowej po opuszczeniu czatu roboczego

Struktura projektu
trial-period-bot/
├── main.py # Punkt wejścia
├── config.py # Konfiguracja
├── database.py # Praca z bazą danych
├── scheduler.py # Harmonogram zadań
├── keyboards.py # Klawiatury bota
├── utils.py # Funkcje pomocnicze
├── add_admin.py # Skrypt dodawania administratora
├── handlers/
│ ├── chat_events.py # Obsługa zdarzeń czatu
│ ├── menu_handlers.py # Obsługa przycisków menu
│ ├── admin_handlers.py # Operacje administracyjne
│ └── callback_handlers.py # Przycisk inline
├── .env # Zmienne środowiskowe
├── bot.db # Baza danych (tworzona automatycznie)
└── requirements.txt # Zależności

Baza danych
users: telegram_id, name, username, join_date, trial_end_date, status (trial/approved), in_work_chat, in_study_group, notified_one_day
admins: telegram_id

Wymagania dla bota
Bot — administrator w obu czatach z uprawnieniami:
• zapraszać użytkowników
• banować/wywalać
• przeglądać uczestników

Rozwój
Systemd:
Utwórz /etc/systemd/system/trial-bot.service z ExecStart na main.py, Restart=always
sudo systemctl enable --now trial-bot

Docker:
docker-compose up -d

Rozwiązywanie problemów
• Bot nie odpowiada → token, blokada, internet
• Zgłoszenia nie są akceptowane → uprawnienia bota, czy zgłoszenia są w czacie
• Brak powiadomień → sprawdź listę administratorów i logi

Technologie
Python 3.8+, aiogram 3.15.0, APScheduler 3.10.4, SQLite

Licencja
GNU GPL v3.0

GitHub: https://github.com/yourusername/trial-period-bot
Jeśli to przydatne — gwiazdka mile widziana.