---

🎥 RanchBot 🤖

🎥 Zobacz RanchBot w akcji:

RanchBot to wysoce konfigurowalny bot Telegram, stworzony do zarządzania i przetwarzania klipów wideo z popularnego serialu "Ranczo". 🎬 Bot umożliwia użytkownikom wyszukiwanie konkretnych cytatów, zarządzanie własnymi klipami wideo oraz wykonywanie różnych zadań administracyjnych związanych z zarządzaniem użytkownikami i moderacją treści.

🇬🇧 English Version

For the English version of this README, please refer to README.md.

🌟 Funkcje

1. 🎞️ Zarządzanie Klipami Wideo

• 🔍 Wyszukiwanie Cytatów: Użytkownicy mogą wyszukiwać konkretne cytaty z serialu za pomocą komend takich jak /klip <cytat> i /szukaj <cytat>. Bot zwróci pasujące fragmenty wideo.
• 🎛️ Kompilacja Klipów: Użytkownicy mogą kompilować wiele klipów w jeden plik wideo za pomocą komend takich jak /kompiluj <numery_klipów> lub /kompiluj wszystko.
• ⏱️ Dopasowanie Klipów: Bot umożliwia dopasowanie klipów poprzez regulację czasu rozpoczęcia i zakończenia za pomocą komendy /dostosuj <numer_klipu> <dostosowanie_przed> <dostosowanie_po>.
• 💾 Zarządzanie Zapisanymi Klipami: Użytkownicy mogą zapisywać, wyświetlać listę i usuwać swoje klipy za pomocą komend takich jak /zapisz, /mojeklipy i /usuńklip.

2. 🛠️ Zarządzanie Użytkownikami i Rolami

• 👮‍♂️ Role Administratora i Moderatora: Administratorzy i moderatorzy mają dostęp do specjalnych funkcji. Komendy takie jak /listadmins i /listmoderators pomagają wyświetlić te role.
• 👥 Zarządzanie Listą Dozwolonych Użytkowników: Użytkownicy mogą być dodawani do lub usuwani z listy dozwolonych, co daje im dostęp do określonych funkcji. Użyj komend /addwhitelist <user_id> lub /removewhitelist <user_id> w tym celu.
• 📝 Notatki o Użytkownikach: Administratorzy mogą dodawać notatki do profili użytkowników za pomocą komendy /note <user_id> <note>.

3. 🔒 Moderacja Treści

• ⚠️ Zgłaszanie Problemów: Użytkownicy mogą zgłaszać problemy bezpośrednio do administratorów za pomocą komendy /report <issue_description>.
• ⏳ Ograniczenia i Limity: Aby zapobiec spamowaniu, dla użytkowników niebędących administratorami wprowadzono okresy karencji i limity, co zapewnia zrównoważone korzystanie z bota.

4. 📈 Integracja z Elasticsearch

• Bot jest zintegrowany z Elasticsearch, co umożliwia efektywne zarządzanie i przeszukiwanie transkrypcji serialu. Ta integracja pozwala na szybkie i dokładne wyszukiwanie segmentów wideo na podstawie zapytań tekstowych.

5. 💽 Zarządzanie Bazą Danych

• Bot używa PostgreSQL do przechowywania danych użytkowników, klipów wideo, historii wyszukiwań i logów. Operacje na bazie danych, takie jak inicjalizacja schematu i zarządzanie danymi użytkowników, są obsługiwane przez zestaw solidnych funkcji asynchronicznych.

6. 🐳 Dockerized dla Łatwego Wdrożenia

• Bot jest w pełni konteneryzowany za pomocą Docker, co ułatwia jego wdrożenie i uruchomienie na dowolnym systemie. Konfiguracja Docker zapewnia bezproblemowe zarządzanie zależnościami i konfiguracjami.

🔑 Kluczowe Komendy

Podstawowe Komendy Użytkownika

• /start: Wyświetla wiadomość powitalną z podstawowymi komendami.
• /klip <cytat>: Wyszukuje konkretny cytat i zwraca pasujący klip wideo.
• /mojeklipy: Wyświetla listę wszystkich klipów zapisanych przez użytkownika.
• /kompiluj <numery_klipów>: Kompiluje wybrane klipy w jedno wideo.

Komendy Administracyjne

• /admin: Wyświetla komendy administratora.
• /listadmins: Wyświetla listę wszystkich administratorów.
• /listmoderators: Wyświetla listę wszystkich moderatorów.
• /addwhitelist <user_id>: Dodaje użytkownika do listy dozwolonych.
• /removewhitelist <user_id>: Usuwa użytkownika z listy dozwolonych.
• /note <user_id> <note>: Dodaje lub aktualizuje notatkę dla użytkownika.
• /report <treść_zgłoszenia>: Zgłasza problem do administratorów.

Pełna lista komend znajduje się w 📚 Dokumentacji Komend.

📋 Wymagania

• Python 3.12
• Baza danych PostgreSQL
• Elasticsearch
• FFmpeg

📦 Wymagane Biblioteki Python

• ffmpeg
• elasticsearch
• urllib3
• python-dotenv
• requests
• tabulate
• Retry
• psycopg2-binary
• aiogram
• asyncpg
• pydantic-settings
• pydantic

🤝 Wkład w Projekt

Wkład w projekt jest zawsze mile widziany! Jeśli chciałbyś pomóc w jego udoskonaleniu, śmiało współpracuj poprzez zgłaszanie pull requestów lub sugerowanie zmian.

📄 Licencja

Ten projekt NIE JEST projektem Open Source w klasycznym rozumieniu. Kod jest udostępniony w modelu Source Available z zastrzeżeniem wszelkich praw (All Rights Reserved).

Zasady użytkowania:

• ✅ Użytek Osobisty: Możesz pobrać i uruchomić bota na własnym serwerze dla własnych potrzeb prywatnych.
• 🤝 Wkład (Pull Requests): Zachęcam do ulepszania kodu! Możesz stworzyć fork tylko po to, aby przygotować poprawki i wysłać Pull Request do tego repozytorium.
• ❌ ZAKAZ ROZPOWSZECHNIANIA: Nie wolno Ci publikować, hostować ani utrzymywać publicznych kopii (forków) tego projektu jako osobnych bytów.
• ❌ ZAKAZ KOMERCJI: Bezwzględny zakaz zarabiania na tym oprogramowaniu w jakikolwiek sposób.

Jeśli chcesz wprowadzić zmiany, zrób to poprzez oficjalny Pull Request tutaj. Nie chcemy fragmentacji – rozwijajmy jednego, wspólnego bota!

Szczegóły licencji znajdują się w pliku LICENSE.

🚀 Uzyskaj Dostęp do Bota

Jeśli jesteś zainteresowany dostępem do RanchBot, proszę skontaktuj się ze mną na Telegramie: @dam2452.

☕ Wesprzyj Projekt

Jeśli podoba Ci się ten projekt i chciałbyś wesprzeć jego rozwój, rozważ postawienie mi kawy:

---