# نشر ZoneCRM على tawseelab2b.egyapps.net

الاستضافة: Namecheap مشتركة بلوحة cPanel. الخطوات من داخل cPanel.

## 1. إنشاء النطاق الفرعي وتفعيل HTTPS

1. **Domains** ← **Create A New Domain**: اكتب `tawseelab2b.egyapps.net` واترك مجلده الافتراضي.
2. **SSL/TLS Status** ← حدّد النطاق الجديد ← **Run AutoSSL**. انتظر حتى تظهر الشهادة. تسجيل الدخول لن يعمل بدون HTTPS.

## 2. إنشاء تطبيق بايثون

**Setup Python App** ← **Create Application**:

| الحقل | القيمة |
|---|---|
| Python version | أحدث إصدار متاح (3.9 أو أعلى، ويُفضَّل 3.11) |
| Application root | `tawseelab2b` |
| Application URL | `tawseelab2b.egyapps.net` |
| Application startup file | `passenger_wsgi.py` |
| Application Entry point | `application` |

اضغط **Create**، ثم انسخ أمر `source ...` الظاهر أعلى الصفحة لاستخدامه في الطرفية.

## 3. رفع الملفات

1. **File Manager** ← افتح المجلد `tawseelab2b` (في مجلد المنزل، وليس داخل `public_html`).
2. احذف ملف `passenger_wsgi.py` الذي أنشأته cPanel.
3. **Upload** ملف `tawseelab2b-....zip` ثم **Extract** داخل نفس المجلد.

يجب أن ترى: `zonecrm/` و `data/` و `passenger_wsgi.py` و `requirements.txt`.

## 4. تثبيت المتطلبات

في صفحة التطبيق داخل **Setup Python App**: في خانة **Configuration files** اكتب `requirements.txt` ← **Add** ← **Run Pip Install**.

## 5. متغيرات البيئة

في نفس الصفحة ← **Environment variables** ← أضف:

| الاسم | القيمة |
|---|---|
| `ZONECRM_ALLOWED_HOSTS` | `tawseelab2b.egyapps.net` |
| `ZONECRM_SECURE_COOKIES` | `1` |
| `ZONECRM_ADMIN_USER` | اسم المستخدم الذي تريده |
| `ZONECRM_ADMIN_PASSWORD` | كلمة سر قوية (8 أحرف على الأقل) |
| `ZONECRM_DUCKDB_MEMORY` | `512MB` |
| `ZONECRM_DUCKDB_THREADS` | `2` |

اضغط **Save** ثم **Restart**.

يُنشأ المستخدم عند أول تشغيل فقط. بعد أن تسجل الدخول بنجاح يمكنك حذف `ZONECRM_ADMIN_PASSWORD` من الإعدادات.

## 6. التجربة

افتح https://tawseelab2b.egyapps.net وسجّل الدخول.

## تحديث النسخة لاحقًا

ابنِ حزمة الكود فقط حتى لا تستبدل بيانات السيرفر:

```bash
.venv/bin/python scripts/build_deploy.py --no-data
```

ارفعها وفك ضغطها فوق الملفات القديمة، ثم **Restart**.

## مستخدم إضافي أو تغيير كلمة السر

من **Terminal** في cPanel بعد تنفيذ أمر `source` الخاص بالتطبيق:

```bash
cd ~/tawseelab2b && python scripts/set_password.py اسم_المستخدم
```

## ملاحظات

- قاعدة البيانات في `~/tawseelab2b/data/crm.db`. نزّل نسخة منها من File Manager بشكل دوري.
- مسح المناطق يحتاج اتصالًا خارجيًا من السيرفر بخوادم OpenStreetMap وOverture. إذا فشل المسح على السيرفر وتعمل باقي المنصة، فالسبب غالبًا قيود الاستضافة المشتركة على الذاكرة أو الاتصال.
