# إعداد السكوتر للاتصال بسيرفر BEEB BEEB

> استخدم هذه القيم في تطبيق **BEEP** (أو أي أداة OMNI) لربط IoT module بالسيرفر.

---

## 1) Modify IP — اتصال MQTT بالسيرفر

| الحقل | القيمة |
|--------|--------|
| **Mode** | IP |
| **IP** | `65.109.35.85` |
| **Port** | `1883` |

**بديل (Domain):**

| الحقل | القيمة |
|--------|--------|
| **Mode** | Domain |
| **Domain** | `beebbeeb.sa.com` |
| **Port** | `1883` |

---

## 2) Account / MQTT Login — اسم المستخدم وكلمة المرور

| الحقل | القيمة |
|--------|--------|
| **Username (loginName)** | `beeb_iot` |
| **Password (loginPswd)** | `WoYMwZuFejSJZTmo1nmo` |
| **Account password status** | **Effective** ✅ |

> هذه بيانات **MQTT** وليست APN.  
> بعد إدخالها، اختر **Effective** في حالة Account password.

---

## 3) Modify APN — شبكة شريحة SIM (حسب المزود)

| الحقل | القيمة |
|--------|--------|
| **APN** | حسب مزود الشريحة (انظر الجدول) |
| **USER** | غالبًا فاضي |
| **PWD** | غالبًا فاضي |

### أمثلة APN — السعودية

| المزود | APN |
|--------|-----|
| STC | `jawalnet.com.sa` |
| Mobily | `web2` |
| Zain | `zain` |

> **لا تستخدم** `mobile.three.com.hk` إلا إذا الشريحة Hong Kong Three.

---

## 4) في لوحة Admin — BEEB BEEB

| الحقل | القيمة |
|--------|--------|
| **Serial number** | **IMEI** الجهاز (15 رقم) |
| **Code** | كود السكوتر للرiders (مثل `SCT-0001`) |

**مثال:**

```
IMEI (serial_number): 864475045545158
Code: SCT-0001
```

---

## 5) بروتوكول OMNI — Topics (للمرجع)

| الاتجاه | Topic |
|---------|--------|
| السكوتر → السيرفر | `om/client/data/location/{IMEI}` |
| السكوتر → السيرفر | `om/client/req/register/{IMEI}` |
| السكوتر → السيرفر | `om/client/req/heartbeat/{IMEI}` |
| السيرفر → السكوتر | `om/server/req/send-rto/{IMEI}` |

`{IMEI}` = رقم IMEI للجهاز.

---

## 6) التحقق من الاتصال

### على السيرفر

```bash
curl -s http://127.0.0.1:5055/mqtt/health
# connected: true
```

### بعد تشغيل السكوتر

- يظهر في logs: `[MQTT] Registered device {IMEI}`
- يتحدّث `scooters.lat`, `lng`, `battery_percent` في Admin

---

## ملخص سريع (Copy-Paste)

```
── Modify IP ──
IP:     65.109.35.85
Port:   1883

── MQTT Login ──
User:   beeb_iot
Pass:   WoYMwZuFejSJZTmo1nmo
Status: Effective

── Admin ──
serial_number = IMEI (15 digit)
```

---

## ⚠️ أمان

- غيّر `MQTT_DEVICE_PASSWORD` و `MQTT_API_TOKEN` في `.env` قبل الإنتاج النهائي.
- لا تشارك كلمات المرور علنًا.