# Qoodz — Production deploy (qoodz.rest)

نسخة إنتاج جاهزة من تطبيق Qoodz (Laravel 12 / PHP 8.2+).
الدومين: `https://qoodz.rest`

## 1. رفع الملفات
ارفع محتويات هذا المجلد إلى السيرفر، واجعل **DocumentRoot** يشير إلى مجلد `public/`:

```apache
<VirtualHost *:443>
    ServerName qoodz.rest
    ServerAlias www.qoodz.rest
    DocumentRoot /var/www/qoodz.rest/public
    <Directory /var/www/qoodz.rest/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>
```

## 2. قاعدة البيانات
أنشئ قاعدة بيانات MySQL بترميز `utf8mb4`، ثم عدّل `.env`:

```
DB_DATABASE=qoodz
DB_USERNAME=<user>
DB_PASSWORD=<password>     ← حالياً CHANGE_ME
```

ثم شغّل (محتوى الموقع — المقالات والخطط ودراسات الحالة — يُزرع من الـ seeders):

```bash
php artisan migrate --force --seed
```

## 3. التخزين المؤقت والأداء
```bash
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan storage:link   # اختياري — ملفات public/storage منسوخة مسبقاً
```

## 4. الأذونات (Linux)
```bash
chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache
```

## 5. Queue (إشعارات البريد لطلبات الديمو)
`QUEUE_CONNECTION=database` — شغّل عامل قائمة دائم:

```bash
php artisan queue:work --sleep=3 --tries=3
```

(عبر supervisor أو cron: `* * * * * cd /var/www/qoodz.rest && php artisan schedule:run`)

## 6. إعدادات اختيارية في `.env`
- `MAIL_*` — بيانات SMTP الحقيقية لإرسال البريد (حالياً placeholders).
- `ANALYTICS_ID` — معرّف Google Analytics 4.
- `QOODZ_ADMIN_EMAIL` — البريد المستلم لإشعارات طلبات الديمو.

## ملاحظات
- `APP_DEBUG=false` و `APP_ENV=production` مضبوطان مسبقاً.
- `APP_KEY` مولّد وجاهز — لا تعيد توليده بعد بدء استخدام البيانات.
- بعد أي تعديل على `.env` أعد تشغيل `php artisan config:cache`.
- فعّل HTTPS (شهادة SSL) قبل الإطلاق — `SESSION_SECURE_COOKIE=true` يتطلبه.