# رفع الموقع على دومينك

الخطوات هاي بتاخد حوالي **20 دقيقة** أول مرة. بتحتاج:
- الدومين تبعك.
- سيرفر VPS بنظام Ubuntu.
- كمبيوتر Windows (أو أي جهاز فيه Terminal).

---

## 1. استأجر سيرفر VPS

أي شركة بتنفع. خيارات رخيصة ومجربة: **Hetzner Cloud** و **Contabo** و **DigitalOcean**.

- اختار أصغر سيرفر (1 أو 2 CPU و 2GB رام)، وسعره تقريباً **4 إلى 6 دولار بالشهر**. هاد بيكفي لمئات الزبائن.
- نظام التشغيل: **Ubuntu 24.04**.
- بعد ما تعمله، بيعطوك **IP** (مثلاً `203.0.113.10`) و**كلمة سر root** (أو بيبعتوها على الإيميل).

## 2. وجّه الدومين على السيرفر

ادخل على لوحة الشركة اللي شاريت منها الدومين (Namecheap أو GoDaddy أو غيرها)، وروح على **DNS**، وضيف سجل:

| Type | Name | Value |
|---|---|---|
| `A` | `@` (للدومين الأساسي) أو `sms` (لدومين فرعي مثل sms.yourdomain.com) | IP السيرفر |

استنى 5 إلى 30 دقيقة لحد ما يشتغل.

## 3. ادخل على السيرفر

على Windows افتح **PowerShell** (من قائمة ابدأ اكتب PowerShell)، واكتب (بالـ IP تبعك):

```
ssh root@203.0.113.10
```

أول مرة بيسألك `Are you sure...?` فاكتب `yes`، وبعدين حط كلمة السر. ملاحظة: كلمة السر ما بتظهر وإنت بتكتبها، وهاد طبيعي.

## 4. نصّب الموقع

انسخ هاي الأوامر والصقها بالشاشة السودا، **وغيّر `sms.yourdomain.com` لدومينك**:

```bash
apt-get update && apt-get install -y git
git clone https://github.com/hashashahed/ahed2-sms-gateway /opt/sms-gateway-src
cd /opt/sms-gateway-src
bash deploy/install.sh sms.yourdomain.com
```

السكربت بينصّب كل إشي لحاله: Node.js، وشهادة HTTPS المجانية، والجدار الناري، وتشغيل الموقع تلقائياً مع إعادة تشغيل السيرفر. لما يخلص بيكتب:

```
Done. Open https://sms.yourdomain.com and register: the first account becomes the admin.
```

## 5. جهّز الموقع

1. افتح `https://دومينك` وسجّل حساب. **أول حساب بيصير الأدمن**، فسجّل إنت أول واحد.
2. من لوحة التحكم، قسم **الإدارة**:
   - **إعدادات الموقع:** اسم الموقع، و**تعليمات الدفع** (رقم المحفظة أو الحساب البنكي أو جوال باي…)، ورقم واتساب.
   - **الباقات:** عدّل الأسعار وعدد الرسائل حسب ما بدك. الباقات اللي بتحطها هون بتظهر بالصفحة الرئيسية تلقائياً.
   - **الإحصائيات:** ارفع ملف الـ APK تبع التطبيق، عشان الزبائن ينزّلوه من لوحتهم.

## 6. شو بيصير لما زبون يشترك

1. بيسجّل وبياخد الباقة المجانية تلقائياً (50 رسالة بالشهر وجهاز واحد).
2. بينزّل التطبيق، وبيربط جواله بكود QR، وبيعمل مفتاح API.
3. لما بدو يطوّر، بيختار الباقة من **الباقة والدفع**، وبيحوّلك المبلغ، وبيكتب رقم العملية.
4. إنت بتشوف الطلب بـ **الإدارة ◂ طلبات الدفع**. بتتأكد إن المبلغ وصل، وبتضغط **قبول وتفعيل**، والباقة بتتفعّل فوراً.
5. لما تخلص المدة، بيرجع تلقائياً للمجانية لحد ما يجدد.

## نسخ احتياطي يومي (مهم)

مرة وحدة بس، شغّل هاد الأمر على السيرفر:

```bash
echo "0 3 * * * root bash /opt/sms-gateway-src/deploy/backup.sh" > /etc/cron.d/sms-gateway-backup
```

هيك كل يوم الساعة 3 الفجر بتنحفظ نسخة من قاعدة البيانات في `/var/backups/sms-gateway`، وبتضل آخر 14 نسخة. الأفضل كمان تنزّل نسخة على جهازك من وقت لوقت.

## تحديث الموقع لما أعدّل الكود

```bash
cd /opt/sms-gateway-src
bash deploy/update.sh
```

بياخد آخر نسخة من GitHub وبيعيد التشغيل، وما بتنمسح أي بيانات.

## إذا صار مشكلة

| المشكلة | الحل |
|---|---|
| الموقع ما بيفتح أو في خطأ HTTPS | تأكد إن سجل الـ DNS بيأشر على IP السيرفر (الخطوة 2)، واستنى شوي، وبعدين `systemctl restart caddy` |
| بدك تشوف سجل الأخطاء | `journalctl -u sms-gateway -n 100` |
| إعادة تشغيل الموقع | `systemctl restart sms-gateway` |
| نسيت كلمة سر الأدمن | `cd /opt/sms-gateway && sudo -u smsgw env DATA_DIR=/var/lib/sms-gateway node --no-warnings src/reset-password.js you@email.com NewPass123 --admin` |
| الجوال ما بيتصل | تأكد إن الزبون ربطه برابط من الموقع الجديد (`https://دومينك/pair#...`)، وإن الجوال فيه نت |

**ملاحظة عن التطبيق:** نفس الـ APK بيشتغل مع أي دومين، لأن رابط الربط اللي بيمسحه الزبون فيه عنوان الموقع. ما بدك تعيد بناءه.
