# ربط Veedon.ai بالأجهزة القابلة للارتداء (صحة الطلاب)

> كيف تصل قياسات ساعة/سوار الطالب إلى Veedon Health Gateway
> (`POST /api/health/alert`) — بصدق تقني كامل حول ما يعمل مباشرة وما يحتاج جسراً.

---

## 0. الحقيقة التقنية أولاً (اقرأ هذا)

**Apple Health لا يوفّر واجهة برمجية على الويب.** بيانات HealthKit تعيش على جهاز
المستخدم ولا تغادره إلا عبر **تطبيق iOS** يقرأها ويرفعها. لا يوجد REST endpoint
ولا OAuth من Apple مباشرة. لذلك أي ربط مع Apple Watch يمرّ عبر **جسر** (تطبيق
وسيط). هذا ليس قصوراً في Veedon — هو قيد Apple على الجميع.

**بوابة Veedon جاهزة ومحايدة:** تستقبل أي مصدر يرسل JSON بسيطاً:
```json
POST /api/health/alert
{ "wearable_id": "watch-001", "metric": "glucose", "value": 55 }
{ "wearable_id": "watch-001", "metric": "hr", "value": 165 }
{ "wearable_id": "watch-001", "metric": "seizure", "flag": true }
{ "wearable_id": "watch-001", "metric": "spo2", "value": 88 }
```
العتبات مبنية: سكر <70 هبوط / >250 ارتفاع، نبض >150 أو <40، أكسجين <92، صرع flag.
`wearable_id` يطابق الطالب المسجّل في شاشة «صحة الطلاب».

---

## 1. المسارات الثلاثة للربط (الأبسط أولاً)

### المسار أ — تطبيق جسر جاهز (بلا تطوير) ✅ الأسرع للـ Pilot
**Health Auto Export** (تطبيق iOS): يقرأ HealthKit تلقائياً ويرسل POST JSON إلى أي
REST URL بترويسات مخصّصة. توجّهه إلى `https://<سحابة-Veedon>/api/health/alert`،
وتضبط تحويل الحقول → صيغة Veedon. **لا كود، يعمل خلال ساعة.** مثالي لإثبات المفهوم.
- تطبيق: https://apps.apple.com/app/health-auto-export-json-csv/id1115567069
- توثيق REST: https://help.healthyapps.dev/en/health-auto-export/automations/rest-api/

### المسار ب — مُجمّع API (تغطية 500+ جهازاً) ✅ للتوسّع
**Terra API** أو **Open Wearables**: يربط Apple Health / Garmin / Fitbit / Polar…
عبر SDK واحد، و**Terra يرسل webhook منظّماً إلى بوابتنا** كلما توفّر قياس جديد.
جهاز واحد أو خمسمئة — نفس الويب-هوك.
- Terra: https://tryterra.co/integrations/apple-health
- Open Wearables: https://openwearables.io/integrations/apple-health

### المسار ج — تطبيق ولي أمر خاص بنا (لاحقاً)
تطبيق iOS/Android بعلامة Veedon: HealthKit + Health Connect مع background delivery.
أفضل تجربة وتحكّم، لكنه بند تطوير مستقبلي (خارج نطاق MVP).

---

## 2. أي جهاز أشتري؟ (توصيات حقيقية حسب الحالة)

> **مهم وصريح:** لا يوجد سوار «مربوط مسبقاً بـ Veedon». أي جهاز أدناه يعمل مع النظام
> **عبر أحد الجسور في القسم 1** (غالباً Health Auto Export أو Terra). اخترنا أجهزة
> بواجهات برمجية مفتوحة أو تكامل HealthKit موثّق.

| الحالة | الجهاز الموصى به | لماذا | الشراء |
|---|---|---|---|
| **عام (نبض/أكسجين/سقوط)** | Apple Watch SE/الأحدث | كشف السقوط + نبض + أكسجين + HealthKit | https://www.apple.com/apple-watch-se/ |
| **اقتصادي (نبض/أكسجين)** | Amazfit Band / سلسلة Zepp OS | رخيص، Zepp OS يرسل للويب سيرفر، نبض+SpO2 | https://us.amazfit.com/collections/smartwatches-bands — أمازون: https://www.amazon.com/dp/B09Z6CRHJ6 |
| **السكري (جلوكوز مستمر)** | Dexcom G7 / Abbott FreeStyle Libre 3 | CGM لحظي + تنبيه هبوط/ارتفاع + يظهر في HealthKit | https://www.dexcom.com/ · https://www.freestyle.abbott/ |
| **الصرع** | Empatica (Embrace/سلسلتها) | معتمد FDA لكشف النوبات + تنبيه فوري | https://www.empatica.com/ |
| **متعدد الأجهزة (مدرسة كبيرة)** | أي مزيج + **Terra API** | واجهة واحدة لكل الأجهزة → بوابتنا | https://tryterra.co/ |

**توصية الـ Pilot العملية:** ابدأ بـ **Apple Watch SE** (أو **Amazfit** للتكلفة) +
تطبيق **Health Auto Export** يوجّه إلى بوابة Veedon. للطلاب السكريين أضِف
**FreeStyle Libre 3** (يغذّي HealthKit فيلتقطه نفس الجسر). هذا يثبت الوحدة كاملة
بأقل تكلفة وبلا تطوير.

---

## 3. خطوات الربط عملياً (Apple Watch + Health Auto Export)

1. في لوحة Veedon → «صحة الطلاب» → أضف الطالب واكتب `wearable_id` (مثلاً `watch-salem-01`).
2. على آيفون الطالب/ولي الأمر: ثبّت **Health Auto Export**، امنحه صلاحية HealthKit.
3. أنشئ Automation → REST API → URL: `https://<سحابة-Veedon>/api/health/alert`،
   الطريقة POST، وصيغة JSON تحوّل الحقول:
   `wearable_id` = `watch-salem-01`، `metric` = نوع القياس، `value` = القيمة.
4. اختر القياسات (Heart Rate، Blood Oxygen، Blood Glucose) وفترة الإرسال.
5. أي قياس يتجاوز العتبة → Veedon يُنشئ تنبيهاً + واتساب للعيادة وولي الأمر +
   يظهر لحظياً في شاشة «صحة الطلاب» ولوحة العميل.

**اختبار سريع بلا جهاز** (مُثبت):
```bash
curl -X POST https://<سحابة-Veedon>/api/health/alert \
  -H "Content-Type: application/json" \
  -d '{"wearable_id":"watch-salem-01","metric":"glucose","value":55}'
```

---

## 4. الخصوصية والامتثال (PDPL + صحة القُصّر)

- **موافقة ولي الأمر مكتوبة** إلزامية قبل ربط أي طالب.
- بيانات الصحة تُعالج بأقل قدر (عتبة/تنبيه فقط) — لا نخزّن سجلاً طبياً مفصّلاً.
- **إخلاء مسؤولية صريح:** Veedon طبقة تنبيه وربط، **ليست جهازاً طبياً ولا تشخّص**.
  القرار الطبي لعيادة المدرسة/الطبيب.
- خيار المعالجة المحلية للفيديو يبقى؛ بيانات الجهاز تمرّ مشفّرة (HTTPS).

## المصادر
- HealthKit — developer.apple.com/documentation/healthkit
- Terra API — tryterra.co · Open Wearables — openwearables.io
- Health Auto Export — healthyapps.dev