===============================================================================
📱 دليل إعداد XCIPTV مع السيرفر المحلي - الحل النهائي
===============================================================================

التاريخ: 2 ديسمبر 2025
السيرفر المحلي: https://chatti.tmaxhosting.com
السيرفر الخارجي: https://flix-panel.xyz:2087

===============================================================================
✅ الملفات المُنشأة:
===============================================================================

1. /var/www/html/xciptv.php
   - Portal API للتواصل مع السيرفر الخارجي
   - يتحقق من username/password على flix-panel.xyz
   - يعيد البيانات مع تحويل الروابط للسيرفر المحلي

2. /var/www/html/live.php
   - Proxy للبث المباشر
   - يوجه الطلبات للسيرفر الخارجي
   - يعمل بشفافية تامة

3. /var/www/html/.htaccess
   - قواعد التوجيه التلقائي
   - يدعم جميع صيغ الروابط

===============================================================================
🎯 طريقة الإعداد في XCIPTV:
===============================================================================

الطريقة 1: استخدام Portal URL (الطريقة الموصى بها)
═══════════════════════════════════════════════════════

افتح XCIPTV → Add Playlist → Xtream Codes API:

╔══════════════════════════════════════════════════════════╗
║ Portal URL                                               ║
║ https://chatti.tmaxhosting.com/xciptv.php                ║
╠══════════════════════════════════════════════════════════╣
║ Username                                                 ║
║ 1231231                                                  ║
╠══════════════════════════════════════════════════════════╣
║ Password                                                 ║
║ 1231231                                                  ║
╚══════════════════════════════════════════════════════════╝

ملاحظة: استخدم أي username/password من السيرفر الخارجي
         (flix-panel.xyz:2087)


الطريقة 2: استخدام Server URL
═══════════════════════════════

╔══════════════════════════════════════════════════════════╗
║ Server URL                                               ║
║ https://chatti.tmaxhosting.com                           ║
╠══════════════════════════════════════════════════════════╣
║ Port                                                     ║
║ 443                                                      ║
╠══════════════════════════════════════════════════════════╣
║ Username                                                 ║
║ 1231231                                                  ║
╠══════════════════════════════════════════════════════════╣
║ Password                                                 ║
║ 1231231                                                  ║
╚══════════════════════════════════════════════════════════╝

===============================================================================
🔄 آلية العمل الكاملة:
===============================================================================

┌─────────────────────────────────────────────────────────────────┐
│ خطوة 1: المستخدم يفتح XCIPTV                                   │
└─────────────────────────────────────────────────────────────────┘
  ↓
  يدخل Portal URL: https://chatti.tmaxhosting.com/xciptv.php
  يدخل Username: 1231231
  يدخل Password: 1231231


┌─────────────────────────────────────────────────────────────────┐
│ خطوة 2: XCIPTV يطلب Authentication                             │
└─────────────────────────────────────────────────────────────────┘
  ↓
  GET https://chatti.tmaxhosting.com/xciptv.php?username=1231231&password=1231231


┌─────────────────────────────────────────────────────────────────┐
│ خطوة 3: xciptv.php يتحقق من السيرفر الخارجي                   │
└─────────────────────────────────────────────────────────────────┘
  ↓
  xciptv.php يرسل طلب إلى:
  https://flix-panel.xyz:2087/player_api.php?username=1231231&password=1231231
  ↓
  السيرفر الخارجي يتحقق من البيانات
  ↓
  يعيد: auth=1 (تم التحقق بنجاح) ✓


┌─────────────────────────────────────────────────────────────────┐
│ خطوة 4: xciptv.php يعيد البيانات لـ XCIPTV                     │
└─────────────────────────────────────────────────────────────────┘
  ↓
  يعيد بيانات المستخدم:
  {
    "user_info": {
      "username": "1231231",
      "password": "1231231",
      "auth": 1,
      "status": "Active"
    },
    "server_info": {
      "url": "chatti.tmaxhosting.com",
      "port": "443",
      "server_protocol": "https"
    }
  }


┌─────────────────────────────────────────────────────────────────┐
│ خطوة 5: XCIPTV يطلب قائمة القنوات                              │
└─────────────────────────────────────────────────────────────────┘
  ↓
  GET https://chatti.tmaxhosting.com/xciptv.php?username=1231231&password=1231231&action=get_live_streams
  ↓
  xciptv.php يجلب القنوات من السيرفر الخارجي
  ↓
  يحول الروابط من:
    https://flix-panel.xyz:2087/live/1231231/1231231/148720.ts
  إلى:
    https://chatti.tmaxhosting.com/live/1231231/1231231/148720.ts


┌─────────────────────────────────────────────────────────────────┐
│ خطوة 6: المستخدم يختار قناة                                    │
└─────────────────────────────────────────────────────────────────┘
  ↓
  XCIPTV يطلب:
  GET https://chatti.tmaxhosting.com/live/1231231/1231231/148720.ts
  ↓
  .htaccess يوجه الطلب إلى:
  /live.php/1231231/1231231/148720.ts


┌─────────────────────────────────────────────────────────────────┐
│ خطوة 7: live.php يعمل كـ Proxy                                 │
└─────────────────────────────────────────────────────────────────┘
  ↓
  live.php يطلب من السيرفر الخارجي:
  https://flix-panel.xyz:2087/live/1231231/1231231/148720.ts
  ↓
  يوجه البث مباشرة للمستخدم
  ↓
  ✅ القناة تعمل!


===============================================================================
📊 مثال عملي كامل:
===============================================================================

السيناريو: المستخدم يريد مشاهدة قناة ABC News

1. إعداد XCIPTV:
   Portal: https://chatti.tmaxhosting.com/xciptv.php
   User: 1231231
   Pass: 1231231

2. XCIPTV Authentication:
   → https://chatti.tmaxhosting.com/xciptv.php?username=1231231&password=1231231
   ← Response: auth=1 ✓

3. طلب القنوات:
   → https://chatti.tmaxhosting.com/xciptv.php?action=get_live_streams&username=1231231&password=1231231
   ← Response:
   {
     "live_streams": [
       {
         "stream_id": 148720,
         "name": "ABC News",
         "stream_url": "https://chatti.tmaxhosting.com/live/1231231/1231231/148720.ts"
       }
     ]
   }

4. تشغيل القناة:
   → https://chatti.tmaxhosting.com/live/1231231/1231231/148720.ts
   ↓ (.htaccess redirect)
   → /live.php/1231231/1231231/148720.ts
   ↓ (live.php proxy)
   → https://flix-panel.xyz:2087/live/1231231/1231231/148720.ts
   ↓
   ✅ البث يعمل!

===============================================================================
🎯 المميزات:
===============================================================================

✅ يعمل مع أي username/password من السيرفر الخارجي
✅ لا حاجة لإضافة مستخدمين في قاعدة البيانات المحلية
✅ يتحقق من الصلاحيات على السيرفر الخارجي
✅ يحول الروابط تلقائياً للسيرفر المحلي
✅ يعمل كـ Proxy شفاف للبث
✅ يدعم Live TV, VOD, Series
✅ يدعم EPG
✅ سريع وموثوق

===============================================================================
🔧 إعدادات XCIPTV الموصى بها:
===============================================================================

Player Settings:
├─ Live TV Player: EXO
├─ VOD Player: VLC
├─ Series Player: VLC
├─ Hardware Acceleration: ON
├─ Buffer Size: 30000ms
└─ Stream Type: TS

Connection Settings:
├─ Connection Timeout: 30 seconds
├─ Read Timeout: 30 seconds
└─ Use HTTPS: YES

EPG Settings:
├─ Enable EPG: YES
├─ Auto Update: YES
└─ Update Interval: 6 hours

===============================================================================
🐛 استكشاف الأخطاء:
===============================================================================

مشكلة: "Authentication failed"
──────────────────────────────
✅ الحل:
   1. تأكد من صحة username/password على السيرفر الخارجي
      (جرب تسجيل الدخول على flix-panel.xyz:2087 مباشرة)

   2. تحقق من أن xciptv.php يعمل:
      افتح في المتصفح:
      https://chatti.tmaxhosting.com/xciptv.php?username=1231231&password=1231231

   3. راجع Apache logs:
      tail -f /var/log/apache2/error.log


مشكلة: "Stream not loading"
────────────────────────────
✅ الحل:
   1. اختبر live.php:
      curl -I https://chatti.tmaxhosting.com/live/1231231/1231231/148720.ts

   2. تحقق من .htaccess:
      cat /var/www/html/.htaccess

   3. تأكد من mod_rewrite:
      sudo a2enmod rewrite
      sudo systemctl restart apache2


مشكلة: "No channels showing"
─────────────────────────────
✅ الحل:
   1. اختبر get_live_streams:
      https://chatti.tmaxhosting.com/xciptv.php?username=1231231&password=1231231&action=get_live_streams

   2. تحقق من أن السيرفر الخارجي يعمل:
      https://flix-panel.xyz:2087/player_api.php?username=1231231&password=1231231


===============================================================================
🔐 الأمان:
===============================================================================

النظام آمن لأنه:

✓ لا يخزن passwords في قاعدة البيانات المحلية
✓ يتحقق من الصلاحيات على السيرفر الخارجي
✓ يدعم HTTPS
✓ يخفي بيانات السيرفر الخارجي عن المستخدم النهائي
✓ يمنع الوصول المباشر للسيرفر الخارجي

===============================================================================
📱 اختبار سريع:
===============================================================================

1. افتح XCIPTV
2. أضف Portal: https://chatti.tmaxhosting.com/xciptv.php
3. أدخل Username: 1231231
4. أدخل Password: 1231231
5. اضغط Login
6. ✅ يجب أن تظهر جميع القنوات!

===============================================================================
🎉 الآن XCIPTV جاهز للعمل!
===============================================================================

استخدم أي username/password من السيرفر الخارجي (flix-panel.xyz:2087)
وسيعمل كل شيء تلقائياً! 🚀

═══════════════════════════════════════════════════════════════════════════════
تم إنشاء هذا الحل بواسطة Claude Code
التاريخ: 2 ديسمبر 2025
═══════════════════════════════════════════════════════════════════════════════