================================================================
            نظام بوتات Telegram - ملفات العمل
================================================================

📌 هذا المشروع بعد التنظيف
  يحتوي فقط على الملفات الضرورية للعمل

================================================================

📁 هيكل المشروع:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

bott111/
│
├── 🤖 الملفات الرئيسية (4 ملفات)
│   ├── control_bot.php              # بوت التحكم الرئيسي
│   ├── sub_bot.php                  # بوت التوزيع
│   ├── .env.php                     # إعدادات البيئة
│   └── cron_limits_maintenance.php  # صيانة الحدود (Cron)
│
├── 📚 lib/ - المكتبات (5 ملفات)
│   ├── telegram.php                 # Telegram API
│   ├── steam.php                    # Steam Guard Generator
│   ├── limits.php                   # نظام الحدود
│   ├── limits_core.php              # منطق الحدود
│   └── help_content.php             # محتوى المساعدة
│
├── 🗄️ sql/ - قاعدة البيانات
│   ├── base sql/                    # القاعدة الأساسية
│   ├── messegatemp/                 # قوالب الرسائل
│   ├── new sql/
│   │   └── supehgku_test0.sql      # النسخة النهائية ⭐
│   └── supehgku_test0.sql          # نسخة احتياطية
│
└── 📦 ARCHIVE_DOCS/ - الأرشيف
    ├── (التوثيق الكامل)
    ├── testing/ (ملفات الاختبار)
    ├── sql_updates/ (التحديثات)
    └── old_migrations/ (الترحيل)

================================================================

⚙️ الإعداد السريع:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  1. تحرير .env.php
     - ضع بيانات قاعدة البيانات
     - ضع توكنات البوتات
     - ضع معرف المالك

  2. رفع قاعدة البيانات
     - استورد: sql/new sql/supehgku_test0.sql

  3. رفع الملفات للسيرفر
     - ارفع جميع الملفات والمجلدات
     - تأكد من رفع lib/ و sql/

  4. إعداد Webhooks
     - control_bot.php
     - sub_bot.php (لكل بوت)

  5. إعداد Cron Job
     - */5 * * * * php /path/cron_limits_maintenance.php

================================================================

🚀 الأوامر المتاحة:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  📱 control_bot.php (52+ أمر)
  
  إدارة البوتات:
  • /addbots - إضافة بوتات
  • /listbots - عرض البوتات
  • /pausebot - إيقاف بوت
  • /unpausebot - تشغيل بوت
  • /removebot - حذف بوت
  
  إدارة المستخدمين:
  • /adduser - إضافة مستخدم
  • /removeuser - حذف مستخدم
  • /listusers - عرض المستخدمين
  
  إدارة الحسابات:
  • /addaccount - إضافة حساب Steam
  • /enableaccount - تفعيل حساب
  • /disableaccount - تعطيل حساب
  
  المجموعات (جديد):
  • /group_details <name> - تفاصيل المجموعة
  • /bot_details <label> - تفاصيل البوت
  • /account_details <name|id> - تفاصيل الحساب
  • /bot_rename <old> <new> - تعديل اسم البوت
  
  نظام الحدود:
  • /limits - عرض الحدود
  • /setlimits - تعديل الحدود العامة
  • /setbotlimits - حدود خاصة بالبوت
  • /setaccountlimits - حدود خاصة بالحساب
  
  أدوات:
  • /stats - الإحصائيات
  • /cleanup - تنظيف البيانات
  • /help - المساعدة

  📱 sub_bot.php (للمستخدمين)
  
  • /start - البدء
  • /code - الحصول على كود Steam
  • /help - المساعدة

================================================================

📊 قاعدة البيانات:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  23 جدول رئيسي:
  • sub_bots - البوتات
  • account_groups - المجموعات
  • steam_accounts - حسابات Steam
  • bot_groups - ربط البوتات بالمجموعات
  • group_accounts - ربط الحسابات بالمجموعات
  • limits_global - الحدود العامة
  • limits_bot - حدود البوتات
  • limits_override - حدود الحسابات
  • limit_counters - العدادات
  • limit_bans - الحظر
  • message_templates - قوالب الرسائل
  • + 12 جدول آخر

  2 Views:
  • active_bans
  • current_usage

  2 Stored Procedures:
  • cleanup_expired_bans()
  • reset_expired_counters()

================================================================

🔒 الأمان:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✅ تم تطبيق:
  • htmlspecialchars على جميع المخرجات
  • Prepared Statements للاستعلامات
  • التحقق من المالك فقط
  • Foreign Keys للسلامة
  • Triggers للتحديثات التلقائية

  ⚠️ يُنصح بإضافة .htaccess:
  
  # حماية .env.php
  <Files ".env.php">
      Order allow,deny
      Deny from all
  </Files>
  
  # منع عرض المجلدات
  Options -Indexes

================================================================

📞 للحصول على التوثيق الكامل:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  راجع مجلد ARCHIVE_DOCS/:
  
  • PROJECT_ANALYSIS.md - تحليل شامل
  • COMMANDS_REFERENCE.md - مرجع الأوامر
  • PROJECT_ORGANIZATION.md - دليل التنظيم
  • CHANGELOG.md - سجل التغييرات
  • README.md - الوثائق الكاملة

================================================================

✅ الحالة: جاهز للإنتاج 100%
📅 الإصدار: v1.2.0
📆 التاريخ: 25 أكتوبر 2025

================================================================
