# رفع Ele API على razan.bcite.org

**الرابط النهائي للـ API:** `https://razan.bcite.org/api/v1`  (اختبار: `https://razan.bcite.org/api/v1/ping`)

> ملاحظة: خطوات الاستضافة هنا عامة لـ cPanel. أسماء القوائم قد تختلف قليلًا حسب الاستضافة.

## المتطلبات
- PHP **8.2 أو أعلى** (cPanel → MultiPHP Manager → اختاري 8.2/8.3 للدومين الفرعي). امتدادات: `pdo_mysql, mbstring, openssl, tokenizer, xml, ctype, json, fileinfo`.
- MySQL 5.7+ أو MariaDB 10.3+.

## 0) جهّزي الحزمة من جهازك
1. تأكدي أن المشروع يعمل محليًا (`run.bat`).
2. احذفي ملفات الكاش المحلية: كل ما داخل `bootstrap/cache/` عدا `.gitignore`.
3. اضغطي المجلد `ele-api` إلى zip **مع مجلد `vendor`** (حتى لا تحتاجي Composer على السيرفر)، و**استثني**:
   `.env` · `.git` · `node_modules` · `storage/logs/*` · `public/storage` (رابط محلي) · أي ملفات `*.zip` · `setup-and-run.bat` و`run.bat`.
   (إن كانت استضافتكم فيها Composer يمكنك استثناء `vendor` وتشغيل `composer install --no-dev --optimize-autoloader` على السيرفر.)

## 1) الدومين الفرعي
cPanel → Domains (أو Subdomains) → أنشئي **razan.bcite.org** وحددي الـ Document Root = `ele-api/public` (مثلًا `/home/USER/ele-api/public`).
- إن لم تستطيعي تحديد مجلد `public` كجذر، ضعي المشروع خارج الجذر العام وانسخي محتويات `public/` للجذر مع تعديل مسارين في `index.php` (`../vendor/autoload.php` و`../bootstrap/app.php`) ليشيرا لمجلد المشروع.
- فعّلي **SSL** (AutoSSL / Let's Encrypt) للدومين الفرعي. التطبيق يستخدم `https` فقط.

## 2) رفع الملفات
File Manager → ارفعي zip إلى `/home/USER/` وافتحيه (Extract) ليظهر مجلد `ele-api`.

## 3) قاعدة البيانات
1. cPanel → MySQL® Databases: أنشئي قاعدة (مثلًا `USER_ele_api`) ومستخدمًا وأضيفيه للقاعدة بكل الصلاحيات.
2. phpMyAdmin → اختاري القاعدة → Import بالترتيب:
   1. `database/sql/schema.production.sql`  ← (وليس `schema.sql`، فذاك للتطوير المحلي ويحتوي `DROP`)
   2. `database/sql/seed.sql`
3. يحتوي `seed.sql` على بيانات تجريبية (مستخدمان بكلمة السر `password123`). مناسب للتدريب والعرض؛ **لا تتركيه** إن صار التطبيق حقيقيًا (احذفي المستخدمين التجريبيين من phpMyAdmin).

## 4) ملف `.env`
انسخي `.env.production.example` إلى `.env` داخل مجلد المشروع، واملئي `DB_DATABASE / DB_USERNAME / DB_PASSWORD`. تأكدي من `APP_URL=https://razan.bcite.org` و`APP_DEBUG=false`.

ثم `APP_KEY`:
- **SSH:** `php artisan key:generate`
- **بدون SSH:** ولّديه على جهازك `php artisan key:generate --show` وضعي القيمة (تبدأ بـ `base64:`) في `.env`.

## 5) الصلاحيات
`storage/` و`bootstrap/cache/` قابلة للكتابة (755 أو 775 مع المالك الصحيح). الخطأ 500 غالبًا بسببها.

## الفحص بعد الرفع
1. `https://razan.bcite.org/api/v1/ping` ← `{"status":"ok", ...}`
2. `https://razan.bcite.org/api/v1/categories` ← قائمة التصنيفات
3. سجّلي حسابًا جديدًا من Postman (غيّري `base_url` إلى `https://razan.bcite.org/api/v1`) وجرّبي endpoint محمي.
4. جرّبي من التطبيق بعد وضع `baseUrl = 'https://razan.bcite.org/api/v1'`.

## أخطاء شائعة
| العرض | الحل |
|---|---|
| 500 / صفحة بيضاء | صلاحيات `storage` و`bootstrap/cache`، أو `APP_KEY` فارغ. السبب بالتفصيل في `storage/logs/laravel-*.log` (للتشخيص فقط: `APP_DEBUG=true` ثم أعيديها `false`) |
| 404 لكل مسارات `/api/...` | الـ Document Root ليس `public` أو `.htaccess` غير مفعّل |
| `Class ... not found` / `vendor/autoload.php` | لم يُرفع `vendor` أو لم يُشغَّل `composer install` |
| `Table ... doesn't exist` | لم يُستورد `schema.production.sql` |
| `Access denied for user` | بيانات القاعدة في `.env`؛ بعد تعديلها: `php artisan config:clear` (أو احذفي `bootstrap/cache/config.php`) |
| 401 رغم إرسال التوكن | تأكدي من وجود `.htaccess` في `public/` (يمرّر هيدر Authorization) |
| الصور لا تظهر (للتبرعات) | رابط storage غير موجود (الخطوة 6) أو `APP_URL` خاطئ |
| التطبيق يرفض الاتصال | تأكدي أن الرابط `https://` وأن SSL مفعّل وصالح |

## تحديث لاحق
ارفعي الملفات المتغيرة فقط (لا تستبدلي `.env` ولا `storage/`). بعد أي تغيير في `.env`: `php artisan config:clear`. لا تشغّلي `php artisan migrate` أبدًا، والتعديلات على الجداول تتم بـ SQL.
