بوت حارس القناة - Telegram Channel Guard Bot

بوت تليجرام متطور لحماية القنوات من إساءة استخدام صلاحيات الأدمن مع دعم اللغة العربية.

🔥 الميزات الأساسية

🛡️ حماية القنوات

• مراقبة تلقائية لأنشطة الأدمن
• إزالة الأدمن المخالفين تلقائياً
• حماية من حظر الأعضاء العاديين

👨‍💼 إدارة الأدمن

• إضافة وإزالة أدمن القنوات
• التحقق من صلاحيات الأدمن
• نظام إشعارات متقدم

📊 المراقبة والتحليل

• نظام لوجات شامل
• تتبع الأنشطة المشبوهة
• تقارير دورية عن حالة القنوات

🌐 دعم متعدد اللغات

• واجهة باللغة العربية
• رسائل خطأ واضحة
• دليل استخدام مفصل

🚀 التثبيت والإعداد

1. تثبيت المتطلبات

# تثبيت المكتبات المطلوبة
pip install -r requirements.txt

2. إعداد متغيرات البيئة

# إضافة توكن البوت
TELEGRAM_BOT_TOKEN=your_bot_token_here

3. تشغيل البوت

# تشغيل البوت
python3 run_bot.py

3. التشغيل التلقائي

# للتشغيل مع إعادة التشغيل التلقائي
python3 keep_alive.py

# أو للمراقبة المتقدمة
./startup.sh

📱 أوامر البوت

الأوامر الأساسية

• /start - بدء استخدام البوت
• /help - عرض المساعدة
• /status - حالة البوت الحالية

أوامر الإدارة

• /add_channel - إضافة قناة للمراقبة
• /add_admin - إضافة أدمن جديد
• /remove_admin - إزالة أدمن
• /list_admins - عرض قائمة الأدمن

أوامر المراقبة

• /logs - عرض آخر الأنشطة
• /config - إعدادات البوت

🏗️ الهيكل التقني

الملفات الأساسية

• run_bot.py - النقطة الرئيسية لتشغيل البوت
• bot_handler.py - معالج الأوامر والرسائل
• admin_manager.py - إدارة صلاحيات الأدمن
• channel_monitor.py - مراقبة أنشطة القنوات
• messages.py - النصوص والرسائل

ملفات الإعداد

• config.json - إعدادات البوت والقنوات
• keep_alive.py - نظام التشغيل المستمر
• startup.sh - سكريبت التشغيل التلقائي

🔧 خيارات التشغيل

1. التشغيل العادي

python3 run_bot.py

2. التشغيل مع Keep-Alive

python3 keep_alive.py

3. التشغيل المراقب

./startup.sh

4. التشغيل في الخلفية

nohup python3 run_bot.py > bot.log 2>&1 &

🌐 Health Check Endpoints

للمراقبة الخارجية والـ uptime monitoring:

• GET / - "Bot is running!"
• GET /health - JSON status
• GET /status - تفاصيل حالة البوت

📋 المتطلبات التقنية

Python Packages

• python-telegram-bot - مكتبة تليجرام
• flask - خادم HTTP للمراقبة
• asyncio - العمليات غير المتزامنة

النظام

• Python 3.11+
• اتصال إنترنت مستقر
• توكن بوت تليجرام صالح

🛠️ التطوير والصيانة

إضافة ميزات جديدة

• تحديث bot_handler.py للأوامر الجديدة
• إضافة النصوص في messages.py
• تحديث config.json للإعدادات

حل المشاكل

• مراجعة ملفات الـ logs في مجلد logs/
• التحقق من صلاحيات البوت في القنوات
• التأكد من صحة توكن البوت

📞 الدعم والمساعدة

لأي استفسارات أو مشاكل:

1. راجع ملف admin_promotion_guide.md
2. تحقق من لوجات البوت
3. تأكد من الإعدادات في config.json

📄 الترخيص

هذا المشروع مفتوح المصدر لأغراض التعليم والتطوير.

---

ملاحظة: تأكد من إعداد متغيرات البيئة بشكل صحيح قبل التشغيل.