# ==============================================================================
# 🚀 الدليل الشامل لتشغيل ورفع لوحة التحكم الذكية على استضافة هوستينجر (Hostinger)
# ==============================================================================

لماذا لم تكن تعمل سابقاً؟
1. الملف المضغوط القديم لم يكن يحتوي على ملف التشغيل الرئيسي (index.php) وملف الإعدادات (.htaccess) في الجذر الرئيسي، مما جعل خادم هوستينجر يعطي صفحة فارغة أو خطأ 403.
2. الآن تم تجهيز اللوحة بنظام هجين ذكي (Hybrid System) يضمن تشغيلها فورياً سواء على استضافة الويب العادية (PHP) أو استضافة بايثون (Python App).

==============================================================================
الطريقة الأولى (الأسرع والأسهل بنسبة 100%): استضافة هوستينجر العادية (PHP Shared Hosting)
==============================================================================
هذه الطريقة تعمل فوراً بدون الحاجة لأي أوامر برمجية أو إعداد بايثون:
1. ادخل إلى لوحة تحكم هوستينجر (hPanel).
2. افتح مدير الملفات (File Manager).
3. ادخل إلى المجلد الرئيسي لموقعك: `public_html`
4. ارفع ملف `لوحة_التحكم_الذكية.zip` داخل `public_html`.
5. اضغط بزر الفأرة الأيمن على الملف واختر (Extract / استخراج) في نفس المجلد.
6. افتح موقعك مباشرة في المتصفح:
   `https://yourdomain.com/`
   ستظهر لك اللوحة فوراً بتصميمها الأبيض النظيف والأنيق!

ملاحظة هامة:
- ملف `.env` مرفق مسبقاً ومضبوط بمفتاح Gemini الخاص بك.
- يمكنك فحص الاتصال بالذكاء الاصطناعي بنقرة واحدة من اللوحة عبر الشارة الخضراء في الأعلى.

==============================================================================
الطريقة الثانية: استضافة بايثون في هوستينجر (Setup Python App في hPanel)
==============================================================================
إذا أردت تشغيل محرك بايثون بالكامل على هوستينجر:
1. افتح لوحة التحكم hPanel.
2. اذهب إلى قسم (Advanced) واختر: [Setup Python App] أو [Python Manager].
3. اضغط على "Create Application":
   - Python Version: اختر 3.10 أو 3.11 أو 3.12.
   - Application root: حدد مجلد التطبيق (مثلاً: `public_html`).
   - Application URL: حدد الدومين الخاص بك.
   - Application startup file: اكتب `passenger_wsgi.py`
   - Application Entry point: اكتب `application`
4. ارفع ملفات الحزمة واستخرجها داخل نفس المجلد.
5. في صفحة إعداد بايثون، اضغط على زر [Run Pip Install] لتثبيت مكتبات requirements.txt.
6. اضغط على زر [Restart Application].
7. اللوحة ستعمل الآن مباشرة عبر محرك Python / Passenger.

==============================================================================
الطريقة الثالثة: خوادم هوستينجر الافتراضية (Hostinger VPS)
==============================================================================
إذا كان لديك سيرفر خاص (Ubuntu / Debian VPS):
1. ارفع الملفات إلى المجلد: `/var/www/pitch-studio`
2. ثبّت المتطلبات:
   pip install -r requirements.txt
3. شغّل اللوحة في الخلفية:
   pm2 start dashboard.py --name pitch-studio --interpreter python3
   أو مباشرة:
   PORT=80 python3 dashboard.py &

==============================================================================
التحقق من اكتمال الملفات:
==============================================================================
تأكد دائماً أن المجلد يحتوي على:
- index.php (واجهة التشغيل الفورية)
- .htaccess (قواعد التوجيه وترميز UTF-8)
- .env (مفتاح الربط بـ Gemini AI)
- dashboard.py (محرك لوحة التحكم)
- passenger_wsgi.py (ملف ربط استضافة بايثون)
- run.py (محرك بناء وتوليد العروض)
- modules/ (وحدات الذكاء الاصطناعي والتحليل)
- templates/ (قوالب العرض الفاخر ومكتبة الأيقونات)
