About the Project
A fully dockerized Telegram bot that periodically checks Wilaya-level quota availability from a REST API and notifies subscribed users when quota opens.
Features
- Quota Monitoring: Periodically checks Wilaya-level quota availability.
- Interactive UI: Navigate easily using persistent bottom menus and hierarchical inline keyboards instead of memorizing commands.
- Multi-language Support: Fully localized interface in Arabic 🇩🇿, French 🇫🇷, and English 🇬🇧.
- Notifications: Alerts subscribed users when quota becomes available in their chosen Wilaya.
- Concurrent Auto-Registration: Automatically registers multiple users simultaneously, handles OTPs, and creates orders the moment quotas open without blocking.
- CAPTCHA Solving: Built-in support for local OCR and third-party API.
- Order Management: Tracks profile lifecycle and sends 12-hour reminders for OTP verification.
- Admin Dashboard: Includes a hidden admin dashboard with a toggleable restricted mode.
Technical Details
The bot is containerized using Docker + Docker Compose and uses SQLite for local storage. Configured via `.env` file, it supports multiple payment selection workflows and long-polling integration.
À propos du projet
Un bot Telegram entièrement dockerisé qui vérifie périodiquement la disponibilité des quotas au niveau de la Wilaya à partir d'une API REST et notifie les utilisateurs abonnés lors de l'ouverture des quotas.
Fonctionnalités
- Surveillance des quotas : Vérifie périodiquement la disponibilité des quotas au niveau des Wilayas.
- Interface interactive : Navigation facile via des menus inférieurs et des claviers en ligne hiérarchiques.
- Multilingue : Interface entièrement localisée en Arabe, Français et Anglais.
- Notifications : Alerte les utilisateurs abonnés lorsque le quota devient disponible dans leur Wilaya choisie.
- Inscription automatique simultanée : Inscrit automatiquement plusieurs utilisateurs en même temps, gère les codes OTP et crée des commandes sans blocage.
- Résolution CAPTCHA : Prise en charge intégrée de la reconnaissance optique de caractères (OCR) et d'API tierces.
- Gestion des commandes : Suit le cycle de vie des profils et envoie des rappels pour la vérification OTP.
- Tableau de bord administrateur : Inclut un tableau de bord caché avec un mode restreint activable.
Détails techniques
Le bot est conteneurisé avec Docker + Docker Compose et utilise SQLite pour le stockage local. Configuré via un fichier `.env`, il prend en charge l'intégration par long-polling et le paiement multiforme.
حول المشروع
بوت تيليجرام متكامل يعمل عبر Docker، يقوم بالتحقق دورياً من توفر الحصص على مستوى الولاية ويعلم المستخدمين المشتركين فور توفرها.
المميزات
- مراقبة الحصص: التحقق الدوري من توفر الحصص لكل ولاية.
- واجهة تفاعلية: تصفح سلس باستخدام قوائم تفاعلية سفلية بدلاً من حفظ الأوامر.
- دعم اللغات: واجهة مترجمة بالكامل إلى العربية والفرنسية والإنجليزية.
- الإشعارات: تنبيه المشتركين فور توفر الحصص في ولاياتهم المختارة.
- التسجيل التلقائي المتزامن: تسجيل مستخدمين متعددين في نفس الوقت، وإدارة رموز OTP، وإنشاء الطلبات فوراً.
- حل الكابتشا: دعم مدمج للتعرف البصري (OCR) المحلي وتكامل مع واجهات خارجية.
- إدارة الطلبات: تتبع حالة الحسابات وإرسال تذكيرات لتأكيد OTP.
- لوحة تحكم إدارية: لوحة مخفية للمشرفين مع خاصية "الوضع المقيد".
التفاصيل التقنية
يعمل البوت بالكامل عبر Docker ويستخدم SQLite لحفظ البيانات. يتم ضبطه من خلال ملف `.env` ويدعم تقنيات ربط مستقرة.