# استقرار جداگانه پنل و FastAPI عمومی Arcopet Bot

در نسخه 3.0 یک بسته روی دو Python App نصب می‌شود. نقش هر نصب با `ARCO_APP_MODE` مشخص می‌شود.

| بخش | آدرس پیشنهادی | حالت | Folder Protection |
|---|---|---|---|
| پنل مدیریت | `https://cdn.arcopet.com/bot` | `admin` | روشن |
| API و Runtime ویجت | `https://chat.arcopet.com` | `widget` | خاموش |

در حالت `widget` مسیرهای پنل، Import، Publish، تنظیمات مدیریت، Swagger و OpenAPI در دسترس نیستند و پاسخ 404 می‌دهند.

برای مراحل ساخت کلید Read-only و فعال‌سازی Journey پیگیری سفارش، فایل `PHASE3_WOOCOMMERCE_FA.md` را بخوانید.

## ۱. توقف برنامه فعلی و پشتیبان‌گیری

در Setup Python App برنامه فعلی را Stop کنید. سپس از این فایل نسخه پشتیبان بگیرید:

```text
data/arcopet_bot.sqlite3
```

## ۲. ساخت محل مشترک دیتابیس

در File Manager و خارج از `public_html` یک پوشه بسازید:

```text
/home/CPANEL_USERNAME/arcopet_bot_data/
```

`CPANEL_USERNAME` را با نام کاربری واقعی cPanel جایگزین کنید. دیتابیس فعلی را به این مسیر منتقل کنید:

```text
/home/CPANEL_USERNAME/arcopet_bot_data/arcopet_bot.sqlite3
```

هر دو Python App با همان کاربر cPanel اجرا می‌شوند و به این فایل دسترسی خواهند داشت. پوشه و فایل باید برای Owner قابل‌خواندن و نوشتن باشند.

## ۳. تنظیم برنامه مدیریت

فایل ZIP را روی Application Root برنامه فعلی Extract و Overwrite کنید. تنظیمات Startup:

```text
Application URL: https://cdn.arcopet.com/bot
Startup file: cpanel_app.py
Entry point: application
```

Environment Variables:

```text
ARCO_APP_MODE=admin
ARCO_BOT_BASE_PATH=/bot
ARCO_BOT_DB=/home/CPANEL_USERNAME/arcopet_bot_data/arcopet_bot.sqlite3
ARCO_PUBLIC_BASE_URL=https://chat.arcopet.com
ARCO_BOT_ALLOWED_ORIGINS=https://arcopet.com,https://www.arcopet.com
ARCO_ADMIN_PASSWORD=یک-رمز-قوی
ARCO_SECRET_KEY=یک-رشته-تصادفی-طولانی
ARCO_WC_BASE_URL=https://arcopet.com
ARCO_WC_CONSUMER_KEY=ck_READ_ONLY_KEY
ARCO_WC_CONSUMER_SECRET=cs_READ_ONLY_SECRET
ARCO_WC_TIMEOUT=10
```

Folder Protection روی همین بخش مدیریت باقی بماند.

## ۴. ساخت Subdomain عمومی

در cPanel بخش Domains، زیردامنه زیر را ایجاد و SSL آن را فعال کنید:

```text
chat.arcopet.com
```

اگر DNS روی آروان مدیریت می‌شود، رکورد زیردامنه را نیز به Origin همین هاست متصل کنید. قبل از ادامه باید HTTPS زیردامنه معتبر باشد.

## ۵. ساخت Python App عمومی

در Setup Python App یک برنامه جدید بسازید:

```text
Python version: 3.11 یا جدیدتر
Application root: arcopet_bot_widget
Application URL: https://chat.arcopet.com
Startup file: cpanel_app.py
Entry point: application
```

همان ZIP را مستقیماً در `arcopet_bot_widget` Extract کنید و Environment Variables زیر را قرار دهید:

```text
ARCO_APP_MODE=widget
ARCO_BOT_BASE_PATH=/
ARCO_BOT_DB=/home/CPANEL_USERNAME/arcopet_bot_data/arcopet_bot.sqlite3
ARCO_PUBLIC_BASE_URL=https://chat.arcopet.com
ARCO_BOT_ALLOWED_ORIGINS=https://arcopet.com,https://www.arcopet.com
ARCO_SECRET_KEY=یک-رشته-تصادفی-طولانی
ARCO_TRUST_PROXY=1
ARCO_CLIENT_IP_HEADER=X-Forwarded-For
ARCO_WIDGET_RATE_LIMIT=60
ARCO_WIDGET_MAX_BODY_BYTES=32768
ARCO_WC_BASE_URL=https://arcopet.com
ARCO_WC_CONSUMER_KEY=ck_READ_ONLY_KEY
ARCO_WC_CONSUMER_SECRET=cs_READ_ONLY_SECRET
ARCO_WC_TIMEOUT=10
```

روی `chat.arcopet.com` نباید Folder Protection فعال باشد؛ این برنامه فقط مسیرهای عمومی محدود را ارائه می‌دهد.

اگر پراکسی شما IP واقعی را در Header دیگری می‌فرستد، مقدار `ARCO_CLIENT_IP_HEADER` را مطابق تنظیم پراکسی تغییر دهید. فقط وقتی درخواست‌ها از پراکسی قابل‌اعتماد عبور می‌کنند `ARCO_TRUST_PROXY=1` باشد.

## ۶. نصب و راه‌اندازی

در هر دو Python App، `requirements.txt` را نصب کنید. سپس ابتدا برنامه مدیریت و بعد برنامه عمومی را Start کنید.

Health پنل پس از ورود:

```text
https://cdn.arcopet.com/bot/api/health
```

باید شامل این مقدار باشد:

```json
{"version":"3.1.0","mode":"admin"}
```

Health عمومی:

```text
https://chat.arcopet.com/api/health
```

باید فقط اطلاعات محدود عمومی را نشان دهد:

```json
{"ok":true,"phase":3,"version":"3.1.0","mode":"widget"}
```

این آدرس در حالت عمومی باید 404 بدهد:

```text
https://chat.arcopet.com/api/journeys
```

## ۷. نصب فایل JavaScript روی سایت

### روش ساده

```html
<script src="https://chat.arcopet.com/widget.js?v=3.1.0" defer></script>
```

### روش پیشنهادی با فایل JS روی دامنه اصلی

فایل `static/widget.js` را در Child Theme قرار دهید و Backend عمومی را با `data-base` مشخص کنید:

```html
<script
  src="https://arcopet.com/wp-content/themes/AP-child-theme/assets/js/arcopet-chat-widget.js?v=3.1.0"
  data-base="https://chat.arcopet.com"
  defer>
</script>
```

بعد از تغییر فایل، کش LiteSpeed و CDN را پاک کنید.

## ۸. بررسی نهایی

1. پنل مدیریت همچنان دو مرحله رمز Folder Protection و Login داخلی دارد.
2. `chat.arcopet.com/docs` و `/api/journeys` باید 404 باشند.
3. `chat.arcopet.com/api/widget/config` باید JSON تنظیمات ویجت را برگرداند.
4. تغییر تنظیمات یا Publish در پنل باید بلافاصله در برنامه عمومی قابل مشاهده باشد.
5. در WordPress، Console نباید خطای CORS یا 401 نشان دهد.
6. در پنل «اتصال فروشگاه»، وضعیت تنظیمات باید سبز و تست اتصال موفق باشد.
7. Journey پیگیری سفارش را به‌صورت Draft نصب، Preview و سپس Publish کنید.

## نکته دیتابیس مشترک

SQLite در این نسخه با WAL و زمان انتظار بیشتر تنظیم شده تا دو Passenger App روی یک هاست بتوانند هم‌زمان از دیتابیس استفاده کنند. دیتابیس مشترک باید روی فایل‌سیستم محلی همان هاست باشد؛ آن را روی FTP یا فضای شبکه‌ای جدا قرار ندهید.
