# چک‌لیست استقرار Update Hub

دامنه هدف: `https://update.farafamandish.com`

مسیر بعدی (ریوکاتونی روی فروشگاه): [`RIOKATOONI_UPDATE_PLAYBOOK.md`](./RIOKATOONI_UPDATE_PLAYBOOK.md)

## پیش‌نیاز سرور

- PHP 8.2+ با extensions: `pdo_mysql` یا sqlite، `mbstring`، `openssl`، `tokenizer`، `xml`، `ctype`، `json`، `bcmath`، `zip`
- `ext-sodium` یا `paragonie/sodium_compat` (Composer)
- MySQL 8 / MariaDB 10.5+ (یا SQLite فقط برای staging)
- SSL معتبر روی ساب‌دامین
- Document root → `services/update-hub/public`
- `storage/` و `.env` خارج از دسترسی وب

## استقرار

```bash
cd services/update-hub
cp .env.example .env
# APP_ENV=production
# APP_DEBUG=false
# APP_URL=https://update.farafamandish.com
php artisan key:generate
php artisan migrate --force
php artisan db:seed --class=UpdateHubSeeder
npm ci && npm run build
php artisan config:cache
php artisan route:cache
php artisan view:cache
```

لوکال با PHP built-in:

```bash
php -S 127.0.0.1:8090 -t public public/router.php
```

نه `public/index.php` به‌عنوان router — وگرنه `/build/*.css` استایل نمی‌آورد.

## Cron / Queue

```
* * * * * cd /path/to/update-hub && php artisan schedule:run >> /dev/null 2>&1
```

در صورت اعلان تلگرام/ایمیل: worker صف (`queue:work`) یا `database` sync.

## امنیت مسیرها

| مسیر | عمومی؟ |
|------|--------|
| `public/` | بله (docroot) |
| `storage/app/artifacts` | خیر |
| `storage/app/keys` | خیر |
| `storage/app/backups` | خیر |
| `.env` | خیر |

## تأیید پس از دیپلوی

1. `GET /` → 200
2. `GET /up` → 200
3. `GET /ops/health` → `{"ok":true,...}`
4. از پنل تنظیمات، `rate_limit_per_minute` را عوض کنید؛ بدون redeploy باید روی API اثر بگذارد
5. یک‌بار `php artisan hub:backup` و بررسی `storage/app/backups`
6. تست restore خشک: کپی DB از بکاپ روی staging

## اضطراری

- قطع انتشار: مسدود کردن ریلیز از ادمین
- لو رفتن کلید امضا: چرخش dual-key از پنل امنیت و `retire_at` کلید قبلی
- بازیابی: restore DB + بازگردانی `storage/app/artifacts` از zip بکاپ
