=========================================================
خطوات لازم تسويها بعد تركيب السكربت
=========================================================

هذا الملف يلخّص كل خطوة يدوية لازم تسويها أنت (مو الكود) عشان
كل الميزات تشتغل بشكل كامل، خصوصاً ميزة التوليد التلقائي للمقالات.

---------------------------------------------------------
1) مفتاح Pexels (لجلب صور خالية من الحقوق تلقائياً)
---------------------------------------------------------
- روح لـ: https://www.pexels.com/api/
- سجّل حساب مجاني (بدون أي دفع)
- خذ الـ API Key من لوحة حسابك
- افتح ملف .env بمشروعك، ودوّر عن السطر:
      PEXELS_API_KEY=
- الصق المفتاح بعده مباشرة، مثال:
      PEXELS_API_KEY=abcdef123456

هذا مفتاح واحد للمنصة كاملة — يخدم كل مواقع عملائك، مو لكل موقع لحاله.

---------------------------------------------------------
2) مفتاح الذكاء الاصطناعي (لكل موقع يفعّل "التوليد التلقائي")
---------------------------------------------------------
كل صاحب موقع يبي يفعّل ميزة توليد المقالات آلياً، لازم يسوي:

أ) يفتح حساب عند واحد من هذولاء:
   - Anthropic (Claude): https://console.anthropic.com
   - OpenAI (GPT):        https://platform.openai.com

ب) يولّد مفتاح API من لوحة حسابه هناك

ج) يدخل من لوحة تحكم موقعه هو (زينة) → الإعدادات → قسم
   "🤖 التوليد التلقائي للمقالات بالذكاء الاصطناعي"
   ويحط المفتاح هناك، ويختار المزوّد (Anthropic أو OpenAI)

ملاحظة: كل مقال يتولّد له تكلفة بسيطة (سنتات) تُخصم من حساب
صاحب الموقع نفسه عند المزوّد، مو منك أنت كمالك للمنصة.

---------------------------------------------------------
3) تشغيل قاعدة البيانات (الهجرات الجديدة)
---------------------------------------------------------
بعد ما تفك ضغط الأرشيف الجديد وتسوي composer install، افتح:
      http://localhost/[اسم-مجلدك]/public/install/index.php

وامشِ بخطوات المثبّت العادية (يشغّل الهجرات تلقائياً).

لو تفضّل التحديث بدون إعادة تثبيت كامل، شغّل بدلها:
      php artisan migrate --force

---------------------------------------------------------
4) Cron Jobs على الاستضافة الحقيقية (إلزامي لما ترفع فعلياً)
---------------------------------------------------------
راجع القسم الكامل بملف README.md بعنوان:
      "32. Cron Jobs المطلوبة على السيرفر"

باختصار، تحتاج تضيف بلوحة cPanel → Cron Jobs، هذا السطر
يشتغل كل دقيقة:
      * * * * * cd /home/username/public_html && php artisan schedule:run >> /dev/null 2>&1

وسطر ثاني منفصل لطابور البريد:
      * * * * * cd /home/username/public_html && php artisan queue:work --stop-when-empty >> /dev/null 2>&1

بدون هذا، لا التوليد التلقائي ولا جدولة المقالات ولا الإيميلات
(ترحيب، دعوات فريق، نسيان كلمة المرور، النشرة البريدية) تشتغل.

---------------------------------------------------------
5) نصيحة مهمة قبل تفعيل النشر التلقائي الكامل
---------------------------------------------------------
لما تفعّل "التوليد التلقائي" لأي موقع لأول مرة، اترك خيار
"نشر المقالات تلقائياً فور إنشائها" مطفّي بالبداية. خلّه يحفظ
كـ"مسودة" وراجع أول 5-10 مقالات يدوياً قبل ما تفعّل النشر
التلقائي الكامل — تأكد من جودة المحتوى ودقته أول.

تقدر تجرّب الميزة فوراً (بدل انتظار الجدولة) بزر
"🧪 جرّب التوليد الآن" بنفس صفحة الإعدادات.

---------------------------------------------------------
6) رفع المشروع لاستضافة بدون SSH/Terminal
---------------------------------------------------------
لو استضافتك ما فيها خيار SSH أو Terminal بلوحة cPanel، اتبع
هذي الخطوات بالضبط (الترتيب مهم):

أ) على جهازك (مو على السيرفر)، افتح Command Prompt بمجلد
   مشروعك المحلي (نفسه اللي شغّال على XAMPP)، وشغّل:

      composer install --no-dev --optimize-autoloader

   - "--no-dev" يستبعد أدوات التطوير (PHPUnit وغيرها) غير
     اللازمة بموقع حي، ويخلي الحجم أصغر
   - بعد هذا الأمر، بيظهر مجلد "vendor" فعلياً جوا مشروعك

ب) اضغط المشروع كامل (بما فيه مجلد vendor الجديد) كملف zip
   واحد. الحجم بيصير كبير (١٠٠-٣٠٠ ميجا تقريباً حسب الحزم) —
   تأكد استضافتك تسمح برفع ملف بهذا الحجم.

ج) ارفع ملف الـ zip عبر File Manager بلوحة cPanel (أو FTP
   ببرنامج مثل FileZilla)، وفكّه من داخل File Manager نفسه
   (أسرع بكثير من رفع آلاف الملفات مفرقة واحد واحد).

د) تأكد المحتويات انفكّت مباشرة جوا public_html (أو المجلد
   الفرعي اللي تبيه)، مو جوا مجلد إضافي بالغلط بداخله.

هـ) أنشئ قاعدة بيانات فارغة من "MySQL Databases" بلوحة
   cPanel، وعدّل ملف .env ببيانات هذي القاعدة الحقيقية.

و) افتح رابط المثبّت: https://دومينك.com/install/index.php
   وامشِ بخطوات المثبّت العادية.

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