# Veedon.ai — الخطة التنفيذية والتجارية (النسخة المحسّنة v2)

> منصة SaaS + Edge AI تحوّل كاميرات المراقبة القائمة في المطاعم والفروع والمصانع والمزارع
> إلى "مدير تشغيل ذكي": كشف مخالفات الالتزام والأحداث التشغيلية، تنبيهات فورية، وتقارير التزام.
> **الاسم:** Veedon.ai (استُبدل بـ MenuAI — الاسم القديم كان يوحي بإدارة قوائم الطعام ويحدّ التوسع).
> السوق الأول: السعودية، ثم الخليج.

آخر تحديث: 2026-07-04 — تحلّ هذه الوثيقة محل `D:\work\fable5\menuai\docs\PLAN.md`

---

## 0. ما الجديد في v2 (قرارات هذه النسخة)

1. **الاسم: Veedon.ai** — محايد قطاعياً (مطاعم/تجزئة/مصانع/مزارع)، يلفظ بسهولة عربياً "فيدون". مهام قبل الإطلاق: حجز `veedon.ai` + `veedon.sa`، فحص العلامة لدى SAIP.
2. **صندوق Veedon Edge = نسخة white-label من Frigate NVR:** المحرك يعمل **مخفياً بالكامل** — بدون منافذ منشورة، بدون واجهة، العميل يرى فقط منصة Veedon السحابية. (Frigate و go2rtc رخصتهما MIT — إعادة التسمية قانونية بشرط إبقاء ملف الترخيص داخل التوزيعة؛ لا يظهر للعميل).
3. **إدارة أسطول مركزية (Fleet Management) — جوهر المنتج:** كل شيء يُدار من لوحة مدير النظام دون زيارة الفرع: تفعيل/تعطيل ميزة كشف لأي فرع، تحديث الإعدادات والنماذج OTA، **إيقاف فرع/عميل عن التشغيل عند عدم السداد** (kill switch)، ومراقبة صحة الأجهزة والكاميرات.
4. **كتالوج مزايا قابل للتوسع + LLM Vision:** أي ميزة جديدة (أمراض الدواجن، طوابير، نظافة الطاولات...) تُضاف للكتالوج مرة واحدة وتُفعَّل لأي فرع بضغطة زر. المزايا ثلاثة أنواع:
   - **rule**: قواعد على كشف Frigate الجاهز (مناطق، عدّ، تكدس) — فورية بلا تدريب.
   - **vlm**: تحليل لقطات مجدولة عبر Claude Vision (نظافة، صحة دواجن، فحص إجراءات) — ذكاء فوري بلا تدريب نماذج.
   - **edge_model**: نماذج مخصصة تُنزَّل للجهاز من سجل النماذج (تدخين، جوال، زي) — تُشحن لاحقاً OTA.

---

## 1. الملخص التنفيذي

**الحكم: نفّذ.** الفرصة مدعومة تنظيمياً (نظام كاميرات المراقبة الأمنية 2022 يجعل الكاميرات إلزامية في المنشآت التجارية — Veedon يبيع العقل لا الكاميرا)، الفجوة التنافسية في السعودية حقيقية ونافذتها 18–24 شهراً، الهوامش 70%+، وتكلفة السنة الأولى ~800 ألف ريال.

- **التموضع:** "مدير التشغيل الذكي" — لا "مراقبة ذكية" (تنافس ميزات مجانية وتثير الخصوصية).
- **الشريحة الأولى:** سلاسل مطاعم ومقاهي سعودية 5–50 فرعاً (قرار مركزي، ألم واضح).
- **الرسالة:** "وش يصير في فرعك وأنت مو موجود؟" — المخالفة بصورتها على واتساب لحظتها + درجة التزام أسبوعية لكل فرع.
- **الهندسة:** Edge-first — الفيديو لا يغادر الفرع؛ أحداث وصور فقط للسحابة (يعمل على 4G). PDPL جاهز.
- **القاتل الوحيد:** الإنذارات الكاذبة → تأكيد زمني + معايرة لكل كاميرا + مراجعة بشرية + سقف معلن أقل من 5 إنذارات/فرع/يوم.
- **الخندق:** dataset سعودي يتراكم من كل تنبيه تتم مراجعته + شبكة موزعين (شركات تركيب الكاميرات).
- **التمايز الجوهري (v3):** منصة **امتثال تنظيمي واحدة عبر خمسة قطاعات**، كل قطاع مربوط بجهته الرقابية السعودية (البلدية/SFDA للمطاعم، **وزارة التعليم للمدارس**، **HCIS/SFDA للمصانع**، **وزارة الصحة/CBAHI للصحة**) — أدلة جاهزة للتفتيش بالعربية. **لا منافس عالمي يملك هذه الزاوية** (القسم 8).

(التفاصيل التجارية الكاملة — القطاعات، حالات الاستخدام العشر، سكربت الديمو، رسائل الواتساب، خطة أول 10 عملاء — في الأقسام 9–12 من خطة v1 وما زالت سارية بعد استبدال الاسم. **توسّع القطاعات الجديدة — التعليم والصحة والمصانع — في القسم 8.**)

---

## 1.5 حالة التنفيذ — ما تمّ / ما بقي (محدّث 2026-07-05)

### ✅ مبنيّ ومُختبر حياً (يعمل الآن)

| المكوّن | الحالة |
|---|---|
| بوابة الأجهزة (FastAPI) على قاعدة لوحة Beyond Senses المشتركة | ✅ |
| لوحة الإدارة: عملاء → فروع → كاميرات → مزايا → أحداث | ✅ |
| **كتالوج 78 ميزة عبر 12 قطاعاً** (rule/vlm/edge_model/engine) | ✅ |
| تفعيل ميزة عن بُعد OTA (trigger يرفع config_version، الجهاز يلتقط ≤30ث) | ✅ |
| إيقاف السداد (kill switch) عبر organizations/branches.active | ✅ |
| **حماية الجهاز**: بصمة عتاد + موافقة أدمن + منع الأجهزة الافتراضية | ✅ مُثبت |
| **إعادة تسمية white-label** (`veedon-ai/edge-engine` — لا ذكر لـ frigate) | ✅ مُثبت |
| تكامل Frigate الكامل: 11 صفحة + وحدات محرك OTA (وجوه/لوحات/بحث دلالي/…) | ✅ |
| تحديث نسخة المحرك عن بُعد (سحب الصورة + إعادة إنشاء الحاوية) | ✅ |
| تنبيهات واتساب (Evolution API) بصورة الحدث + أرقام لكل فرع | ✅ |
| **استدلال ONNX محلي على الجهاز** (`analyzer.py`) — كشف person 0.80 حياً | ✅ مُثبت |
| تنزيل النماذج OTA من سجل البوابة (نموذج PPE + عام حقيقيان) | ✅ |
| **مزوّد VLM قابل للتبديل** (claude / ollama / lmstudio) | ✅ مُختبر |
| **تشغيل الفرع الكامل حياً**: وكيل + محرك + استدلال + حدث بصورة للوحة | ✅ مُثبت |
| قطاعات جديدة: تعليم (7 مزايا)، مصانع، صحة + فلتر قطاعات في اللوحة | ✅ |
| **تقارير الامتثال** HTML/PDF لكل جهة رقابية + زر في اللوحة | ✅ مُثبت |
| **Veedon Health Gateway** (صحة الطلاب): طلاب + أجهزة + عتبات + تنبيه واتساب | ✅ مُثبت |
| إصلاح i18n (العلامة = Veedon.ai) + أخطاء TypeScript (0 أخطاء) | ✅ |
| **حلقة المراجعة البشرية**: أحداث الجهاز بالصور + تأكيد/رفض في اللوحة (تغذّي إعادة التدريب) | ✅ مُثبت |
| **محرّر مناطق/قناع بصري** فوق صورة الكاميرا (رسم مضلّع بالنقر → إحداثيات Frigate) | ✅ |
| **كل قواعد القطاعات موصولة** (25 قاعدة: وجود مكاني/كثافة/عدّ دوري + إغلاق طارئ تفاعلي) عبر مصنّف نمط واحد | ✅ فحص ذاتي |
| **نماذج edge مشحونة**: تدخين (MIT) + جوال (COCO) مفعّلان؛ PPE صناعي (MIT) + كمامة (Apache) جاهزان — الأصناف تُقرأ من ONNX metadata ([manifest](cloud/api/models_manifest.md)) | ✅ مُتحقَّق تحميلاً |
| **الكشف السلوكي (VLM) على السيرفر السحابي**: الحافة تلتقط **لقطات متتالية** عند النشاط وترسلها لـ`/api/device/analyze` وتنتظر النتيجة؛ الاستدلال (نموذج مدرب/LM Studio/Ollama/Claude) في السحابة — عراك/تنمّر/سقوط/عدوان/سرقة | ✅ مُختبر (LM Studio متعدد اللقطات) |
| **عدّ الدخول/الخروج** (`entry_exit_count`) — زوّار/إشغال/بوابات (من بحث supervision) | ✅ |
| **شاشة إدارة الطلاب** (`/students`): إضافة/حذف طلاب + أجهزة + تنبيهات صحية لحظية | ✅ مُثبت |
| **لوحة العميل** (`/portal`): فروع + درجة التزام + مخالفات + تنبيهات صحية + تقارير | ✅ مُثبت |
| دليل ربط الأجهزة القابلة للارتداء + حزمة العرض التوضيحي | ✅ (docs/) |
| **سكربت تجهيز جهاز الفرع** (`server/dist/install.sh`) + مجلد توزيع + تحديث تلقائي | ✅ مُثبت على Docker Desktop |
| **سكربت تحضير وتقوية Debian من الصفر** (`prepare-debian.sh`) | ✅ مُختبر في debian:12 |

| **استيعاب كاميرا شبكة حقيقية** (MJPEG/HTTP) + استدلال على بثّها الحي | ✅ مُثبت |
| **محرك VDE المعياري** (`edge/vde/`): موديولات كشف ساخنة (P1–P4)، توقيع Ed25519، OTA، مدموج في الوكيل | ✅ مُختبر (فحوص+MQTT حي) |
| **الدورة الكاملة على Frigate حقيقي**: كشف→MQTT→VDE→ONNX على لقطة حقيقية | ✅ مُثبت (person 0.82) |
| **مزايا 2026** (بحث تنافسي): مركّب + خمول + عبور مركبات (VDE) · ردع صوتي (vlm) · مسرّعات | ✅ مُختبر |
| **قدرات سحابية 2026** (`insights.py`): بحث NL عربي + مساعد Veedon + خط زمني للحوادث | ✅ مُختبر حياً |
| **re-ID عبر الكاميرات** (OSNet MIT، سحابي): تضمين + مطابقة + `/track` + زر «مسار الشخص» باللوحة | ✅ مُثبت بالنقر الحي |
| **صفحات لوحة جديدة**: `/modules` (رفع موديولات موقّعة)، `/insights` (بحث/مساعد)، بحث الفرع | ✅ مُتحقَّق عرضاً |
| **الإنذار المؤكَّد**: درجة إنذار حقيقي (+تعزيز صوتي) + تصعيد SOP لكل فرع + إقرار + حزمة AVS-01 | ✅ مُختبر حياً |
| **تعتيم الخصوصية (PDPL)**: تعتيم الوجوه/الأشخاص في الأدلة + معاينة قبل/بعد | ✅ مُثبت (30 شخص) |
| **الصوت كدليل تصعيد**: `frigate/<cam>/audio` → VDE → حدث + رفع الدرجة + شرط مركّب | ✅ مُختبر |
| **تنبيهات متعددة القنوات**: واتساب + Telegram/Slack/Teams/Webhook | ✅ |
| **`custom_vlm` كشف بالكلمات** + **`tailgating`** دخول تطفّلي | ✅ |
| **الرؤية المحلية** (SmolVLM2-Video/Qwen داخل المنشأة — خصوصية PDPL) | ✅ (دليل+إعداد) |
| **لوحة التحليلات التشغيلية (BI)**: footfall + خريطة حرارية + اتجاهات + إشغال (يحوّل الأمن لإيراد) | ✅ مُثبت عرضاً |
| **خادم MCP** (6 أدوات — وكلاء AI يستعلمون ذكاء الفيديو، معيار 2026) | ✅ مُختبر حياً |

**اكتملت كل بنود الواجهة والكود القابلة للبناء داخل المحرّر. ✅ النظام MVP كامل قابل للعرض.**
**تحقّق ميداني (كاميرا حقيقية بموافقة العميل):** كاميرا شبكة MJPEG لمحل حقيقي —
المحرك استوعبها حياً، وكشف **شخصاً بالحركة** (detection_fps=5.3) داخل المنطقة الممنوعة،
والوكيل حوّل **أحداث «منطقة ممنوعة» (severity high) بصور دليل مؤرّخة** إلى اللوحة عبر
البوابة (HTTP 200). الدورة كاملة مؤكدة على عتاد حقيقي بكاميرا حقيقية وشخص حقيقي.
يبقى فقط تشغيلها على صندوق Mini PC في الموقع (شراء/تركيب، لا كود).

### 🔜 ما بقي (خارج الكود — قرارات ميدانية/تجارية)

- ✅ **VLM محلي عبر LM Studio مُختبر حياً** (موصول بـ `moondream-2b` على 192.168.56.1:45000، صورة حقيقية، رد سليم). moondream **واصف صور** (لا يُصدر حكم JSON) → يُحفظ كملاحظة إعلامية بلا إنذار كاذب. لأحكام flagged حقيقية: حمّل نموذجاً يتبع التعليمات (Qwen2.5-VL / Qwen2-VL) في LM Studio — نفس المسار بلا تغيير كود.
- بديل: مفتاح Claude (`ANTHROPIC_API_KEY`) لأعلى جودة حكم.

**عمق الذكاء:**
- ✅ 4 نماذج ONNX مشحونة (تدخين/PPE/كمامة/re-ID). يبقى تدريب نماذج القطاعات الباقية
  (أسلحة-مسدس/رافعات/سقوط/نظافة اليدين/عيوب/دواجن نافقة) — تحتاج datasets.
- تكامل HealthKit/Google Fit الفعلي (الويب-هوك جاهز؛ ينقص جسر تطبيق ولي الأمر).
- خفض الإنذارات الكاذبة: مراجعة بشرية + إعادة تدريب دورية + معايرة لكل كاميرا.
- ترقية مطابقة re-ID للنطاق الكبير (pgvector) + نموذج رؤية أقوى في LM Studio للأحكام السلوكية.

**الميدان والنشر:**
- ✅ **الدورة الكاملة على Frigate حقيقي مُثبتة** (كشف→MQTT→VDE→ONNX). يبقى تشغيلها على
  **صندوق Mini PC فعلي في الموقع** (شراء/تركيب، لا كود) — أول بند PoC ميداني.
- ✅ **نفق NAT مبني** (frp ذاتي الاستضافة — frpc في compose + frps على السحابة + تبليغ
  tunnel_url) — لصفحات المحرك الحية عبر فروع خلف NAT. يبقى: نشر frps فعلي + DNS +TLS.
- ✅ **تصلّب VDE التشغيلي مكتمل**: OTA الموديولات مدموج + provisioning المفتاح العام
  (`/module_pubkey` + install.sh) + compose مُصلَّب (no-new-privileges + حدود موارد +
  mosquitto). يبقى: docker-socket-proxy + صلابة الوكيل على نطاق واسع (store&forward تحت ضغط).

**تشغيلي/تجاري:**
- قناة واتساب رسمية (Unifonic) للتوسّع بدل Evolution (تجنّب حظر الرقم).
- إصلاح أخطاء TypeScript الموروثة في اللوحة (مهمة خلفية جارية).
- حجز الاسم/النطاق + فحص العلامة لدى SAIP، والأساس القانوني (عقود، PDPL، لافتات).

---

## 2. معمارية Veedon (المخطط النهائي — 2026-07-05)

```
┌────────────────────────────── الفرع (Edge Box) ──────────────────────────────┐
│ كاميرات IP / NVR قائم ──RTSP──► veedon-engine (Frigate white-label + go2rtc)   │
│                                   │ كشف أجسام/مناطق/لقطات    │ MQTT             │
│                          go2rtc ◄─┘ (بثّ موحّد)              ▼ frigate/events   │
│                                   │                    mosquitto (broker محلي)  │
│  ┌──────────── veedon-agent (بايثون) ──────────┐            │                  │
│  │ • OTA config (config/models_version ≤30ث)   │            ▼                  │
│  │ • suspend فوري + heartbeat + store&forward   │  ┌─── VDE (محرك معياري) ───┐  │
│  │ • القواعد: منطقة/كثافة/عدّ (25 قاعدة)        │  │ موديولات ساخنة موقّعة   │  │
│  └──────────────────────────────────────────────┘  │ edge_model(ONNX)+custom  │  │
│                                                     │ مدفوعة MQTT/جدولة/بثّ    │  │
│                                                     └──────────────────────────┘  │
│  frpc (نفق اختياري) ──اتصال صادر──► frps ──► <device>.tunnel.veedon.ai (بث حيّ)   │
└──────────────────│── HTTPS صادر: أحداث + لقطات + لقطات‑متتالية + بصمة + tunnel_url ┘
                   ▼
┌────────────────────────────── سحابة Veedon (KSA) ─────────────────────────────┐
│ Device API: /config /heartbeat /events /models /modules /analyze (Bearer+بصمة)│
│ حماية: بوابة (سداد→بصمة→VM→اعتماد) + توقيع Ed25519 للموديولات                 │
│ ذكاء سحابي: VLM سلوكي (لقطات متتالية، محلي SmolVLM2/Qwen أو Claude) · re-ID    │
│   (OSNet) · تعتيم خصوصية (PDPL) · تقارير امتثال · وصف الأحداث                  │
│ الإنذار المؤكَّد: درجة إنذار حقيقي (+صوت) → تصعيد SOP لكل فرع → إقرار → AVS-01  │
│ insights: بحث NL عربي · مساعد Veedon · خط زمني حوادث · مسار الشخص (/track)     │
│ تحليلات تشغيلية (BI): footfall · خريطة حرارية · اتجاهات · إشغال · ذروة (إيراد) │
│ لوحة Beyond Senses: مزايا(82)/موديولات/بحث‑مساعد/تحليلات/مناطق/SOP/مسار/إقرار  │
│   [kill switch] [OTA] [رفع موديول موقّع] [معاينة تعتيم] [درجة+إقرار الأحداث]   │
│ تنبيهات متعددة القنوات: واتساب + Telegram/Slack/Teams/Webhook (تصعيد+ردع)     │
└───────────────────────────────┬───────────────────────────────────────────────┘
        خادم MCP (6 أدوات) ◄─────┘──► وكلاء AI خارجيون (Claude/Dify) يستعلمون الفيديو
```

**تقسيم المسؤوليات النهائي:** كشف الأشياء/القواعد/الصوت = **على الحافة** (Frigate + ONNX +
قواعد الوكيل + VDE) · التحليل الثقيل (VLM سلوكي + re-ID + تعتيم) = **على السحابة** (يمكن أن
تكون خادماً خاصاً داخل السعودية) · **الإنذار المؤكَّد** (درجة→تصعيد→AVS-01) سحابي · الإدارة
الكاملة = **عن بُعد**. التفاصيل: [محرك VDE](VEEDON-DETECTION-ENGINE.md) · [الرؤية المحلية](LOCAL-VLM.md).

**قرار v2 (ponytail):** الاتصال جهاز↔سحابة يبدأ بـ **HTTP polling كل 30 ثانية** (يعمل خلف أي NAT/جدار ناري، صفر بنية إضافية). ننتقل لـ MQTT/EMQX عندما يتجاوز الأسطول ~200 جهاز أو نحتاج أوامر لحظية.

### آلية white-label (لا يعرف العميل أن المحرك Frigate)

1. المحرك يعمل في حاوية `veedon-engine` **بدون أي منفذ منشور** — واجهته وAPI غير قابلين للوصول من شبكة الفرع.
2. كل تفاعل العميل عبر لوحة Veedon السحابية فقط؛ الجهاز صندوق أسود يوصَّل بالكهرباء والشبكة.
3. صورة Docker تُبنى باسم `veedon/edge-engine` في سجلّنا الخاص (مع الإبقاء على ملف ترخيص MIT داخلها — الالتزام القانوني الوحيد).
4. الوكيل والملفات والسجلات كلها بأسماء Veedon. المعاينة الحية (لاحقاً) تمر عبر بوابة Veedon بـ WebRTC، لا عبر واجهة المحرك.

### آلية "أضِف ميزة دون زيارة الفرع"

1. مدير النظام يفعّل الميزة للفرع من اللوحة → `config_version` يرتفع.
2. الوكيل يلتقط التغيير في أول poll (≤30 ثانية) → يعيد توليد إعدادات المحرك (zones جديدة، كاميرات، نماذج).
3. لو الميزة `edge_model` والنموذج غير موجود محلياً → ينزّله من `GET /api/device/models/{name}` ثم يفعّله.
4. لو `vlm` → الوكيل يبدأ إرسال لقطات مجدولة، والسحابة تحللها بـ Claude — **ميزة جديدة تعمل في كل الفروع خلال دقيقة، بلا أي تدريب أو زيارة**.

### آلية الإيقاف عن السداد (kill switch)

- إيقاف العميل يوقف كل فروعه؛ إيقاف الفرع فردي أيضاً.
- الوكيل يستلم `status: suspended` → يوقف المحرك فوراً (لا تحليل، لا أحداث) ويبقى يستطلع كل دقيقة — **إعادة التفعيل من اللوحة تعيد كل شيء خلال دقيقة** دون زيارة.
- السحابة ترفض أحداث الفروع الموقوفة (طبقة حماية ثانية).

---

## 3. كتالوج المزايا (v2 — موسّع)

| المفتاح | الميزة | النوع | الجاهزية | ملاحظات |
|---|---|---|---|---|
| `restricted_zone` | منطقة ممنوعة (مخزن/كاش/خارج الدوام) | rule | ✅ فوري | zones على كشف الأشخاص |
| `crowding` | تكدس/ازدحام فوق حد | rule | ✅ فوري | عدّ أشخاص لحظي + عتبة |
| `queue_count` | عدد المنتظرين في الطابور | rule | ✅ فوري | عدّ داخل zone الطابور + تقرير دوري — يجيب "كم شخص واقف الآن" |
| `camera_health` | كاميرا معطلة/مفصولة | rule | ✅ فوري | من heartbeat — ميزة Spot AI الأساسية، شبه مجانية عندنا |
| `table_cleanliness` | نظافة الطاولات/المحطات | **vlm** | ✅ فوري | لقطة كل N دقيقة → Claude Vision يقيّم مقابل checklist ويرجع JSON |
| `poultry_health` | مؤشرات صحة الدواجن (خمول، نفوق، تجمّع غير طبيعي) | **vlm** ثم edge_model | ✅ فحص VLM فوري / نموذج مخصص لاحقاً | أبحاث YOLO المنشورة تصنف الطيور (سليم/خامل/مريض) — نبدأ VLM ثم ندرّب نموذجاً عند أول عميل مزارع |
| `smoking` | التدخين | edge_model | 🔜 حزمة نموذج v1 | يتطلب dataset — خطة v1 قسم 4 |
| `phone_usage` | استخدام الجوال أثناء العمل | edge_model | 🔜 | fine-tune إلزامي لزوايا السقف |
| `uniform_ppe` | الزي/القفازات/غطاء الشعر | edge_model | 🔜 | نماذج PPE مفتوحة + تهيئة لكل عميل |
| `fall_detection` | السقوط (مصانع) | edge_model | 🔜 | pose + قواعد |
| `open_close` | التزام مواعيد الفتح/الإغلاق | rule | 🔜 قريب | أول/آخر ظهور شخص مقابل جدول الدوام |

**قوة النموذج:** أي فكرة ميزة جديدة = صف جديد في الكتالوج. النوع `vlm` يجعل إطلاق ميزة جديدة **مسألة كتابة prompt** — نختبر الطلب في السوق بـ VLM (هامش أقل)، وما يثبت طلبه ندرّب له نموذج edge (هامش أعلى). هذا خط أنابيب منتجات كامل.

---

## 4. مزايا مضافة من تحليل المنافسين (بحث يوليو 2026)

| الميزة | مصدر الإلهام | الأولوية عندنا |
|---|---|---|
| **مراقبة صحة الكاميرات** (كاميرا مفصولة/معتمة) | Spot AI | ✅ فورية — في كتالوج v2؛ قيمة عالية بتكلفة صفرية |
| **ربط POS بالفيديو** (استثناءات: refunds/voids/فتح درج بلا فاتورة) | Solink وDTiQ — جوهر عرضهما | Roadmap شهر 9+ — أقوى ميزة loss prevention؛ تكامل مع أنظمة الكاشير السعودية (Foodics أولاً) |
| **تدقيق بشري كخدمة (Smart Audits)** | DTiQ (تدقيق بشري + AI على 37 ألف موقع) | خدمة مدفوعة إضافية: "تدقيق شهري بعين خبير" — إيراد إضافي وهي أصلاً عملية المراجعة البشرية التي نديرها لتحسين النماذج |
| **AI Agents / أدوار آلية** (وكيل سلامة، وكيل التزام يلخص ويوصي) | Solink AI Agents (فبراير 2026) | شهر 10+: "مساعد Veedon" — Claude يلخص أسبوع الفرع ويقترح إجراءات |
| **مشاركة مقاطع/حالات (Cases)** | Spot AI case management | مشاركة حدث بصورته/مقطعه برابط واتساب — بسيطة ومبكرة |
| **توقيت خدمة الدرايف ثرو** | DTiQ drive-thru | مهمة جداً لسلاسل QSR السعودية — بعد `queue_count` مباشرة |
| **لوحة مقارنة الفروع (leaderboard)** | ممارسة القطاع | درجة التزام لكل فرع + ترتيب — محرك التجديد السنوي |
| **كشف غسل اليدين** (التزام صحي) | PathSpot وأمثالها | edge_model لاحق — قيمة عالية للمصانع الغذائية وHACCP |

**خلاصة تنافسية:** Solink/DTiQ/Spot AI كلها cloud-video بالإنجليزية وبأسعار أمريكية ولا وجود لها خليجياً — تفوقنا: edge-first (نت ضعيف)، عربي/واتساب أولاً، اشتراطات بلدية وSFDA، وتسعير بالريال لكل فرع.

---

## 5. ما بُني فعلاً (الحالة الحالية — بعد التكامل مع لوحة Beyond Senses)

**قرار معماري (2026-07-04):** الواجهة الإدارية أصبحت لوحة **Beyond Senses** القائمة
(`local-db-version`: React + Vite + shadcn + Supabase محلي) بدل لوحة Jinja الأولى (حُذفت).
**نمط التكامل: قاعدة بيانات واحدة مشتركة** — بوابة الأجهزة (FastAPI) تقرأ وتكتب في
Supabase Postgres نفسه الذي تستخدمه اللوحة. لا API وسيط ولا مزامنة.

```
veedon/
├── local-db-version/                  ← اللوحة الإدارية (Beyond Senses)
│   ├── supabase/migrations/20260704120000_veedon_edge_devices.sql
│   │     حقول الجهاز على branches (device_token, config_version, last_seen,
│   │     agent_info, alert_numbers) + كتالوج المزايا على event_types
│   │     (feature_key, kind, default_config, available) + config على
│   │     camera_event_assignments + triggers ترفع config_version تلقائياً
│   │     + تعديل restrict_events_update ليسمح للبوابة بصفوفها + realtime لـ events
│   └── src/components/branches/EdgeDevicePanel.tsx  ← داخل صفحة تعديل الفرع:
│         حالة الجهاز (متصل/لا + إصدار الإعدادات)، كتلة تجهيز .env بزر نسخ،
│         أرقام واتساب، ومفاتيح المزايا لكل كاميرا (+ إعدادات JSON لكل ميزة)
├── cloud/api/                          ← بوابة الأجهزة (headless — بلا واجهة)
│   └── app/: device.py (config/heartbeat/events/models) + vlm.py (Claude Vision)
│        + notifier.py (واتساب Evolution API) + models.py (خريطة جداول اللوحة)
└── edge/                               ← صندوق الفرع (بلا أي تغيير — العقد نفسه)
```

**تدفق الربط (مُثبت بالاختبار على القاعدة الحية):**
1. مفتاح تفعيل ميزة في اللوحة → صف في `camera_event_assignments` → trigger يرفع
   `branches.config_version` → الوكيل يلتقطه خلال ≤30 ث ويعيد تهيئة المحرك. ✅
2. مفتاح "حالة النشاط" الموجود أصلاً في اللوحة (`organizations.active` /
   `branches.active`) هو نفسه kill switch السداد — البوابة ترجع suspended فوراً. ✅
3. حدث من الجهاز → INSERT في `events` (بصورة عبر `snapshot_url`) → يظهر لحظياً في
   اللوحة (أُضيف `events` لمنشور realtime — لم يكن مشمولاً أصلاً). ✅
4. أحداث AI Vision: التحليل يكتب حكمه في `metadata.ai_note` ويضبط severity
   (high → إشعار متصفح من hook اللوحة + واتساب). ✅

**كتالوج المزايا** انتقل إلى جدول `event_types` القائم (صفوف feature_key) —
إضافة ميزة جديدة = صف واحد، وتظهر تلقائياً في لوحة كل فرع.

**✅ تشغيل الفرع الكامل حياً (2026-07-05) — مُثبت end-to-end بمكوّنات حقيقية:**
وكيل الفرع (`edge/dev/docker-compose.agent.yml`) نفّذ الدورة كاملة: بصمة عتاد →
تسجيل → اعتماد الأدمن → **تنزيل نموذج PPE حقيقي عبر OTA** (5.4MB، MIT، من HuggingFace)
→ توليد إعدادات المحرك من قاعدة اللوحة → إعادة تشغيل المحرك → **كشف أشخاص حقيقيين**
(فيديو Intel) → **حدث "منطقة ممنوعة" بصورته وصل لجدول events في اللوحة** (source=veedon-edge).
وتفعيل "البحث الدلالي" عن بُعد جعل المحرك ينزّل نماذج **jina-clip-v1 ONNX** تلقائياً.
تحميل النماذج يعمل من مصدرين: سجل Veedon (نماذج مخصصة) + تنزيل المحرك الذاتي (وحداته).

**التالي مباشرة:** تشغيل استدلال نموذج PPE فعلياً داخل الـanalyzer (يُنزَّل للجهاز الآن،
لكن الفحص ما زال بالقواعد/VLM لا باستدلال محلي)؛ توصيل صفحات الأحداث في اللوحة بأحداث
الجهاز (فلترة `metadata->>'source'`)؛ تقرير أسبوعي PDF؛ بقية نماذج edge (تدخين/أسلحة/رافعات
— تحتاج datasets)؛ إصلاح أخطاء TypeScript الموروثة (مهمة منفصلة).

---

## 6. مصفوفة خصائص المحرك (Frigate 0.17) وحالة ربطها باللوحة

> اللوحة تملك 11 صفحة Frigate جاهزة تمر كلها عبر `frigate-proxy` (edge function)
> الذي يحلّ `host_url` من جدول `frigate_instances` **المربوط بالفرع والمؤسسة أصلاً**
> (branch_id إلزامي + صلاحيات RLS حسب مؤسسة العميل) — أي أن العزل حسب العميل/الفرع مبني في الأساس.

| الخاصية | في اللوحة | التفعيل عن بُعد |
|---|---|---|
| كشف الأجسام + التتبع | ✅ صفحات الأحداث + المزامنة | دائماً مفعّل |
| المناطق (Zones) | ✅ عبر إعدادات المزايا (إحداثيات) | ✅ كتالوج: منطقة ممنوعة/طابور |
| قناع الحركة (Motion Mask) | ✅ جديد | ✅ كتالوج: `motion_mask` لكل كاميرا |
| المراجعة (Review: Alerts/Detections) | ✅ صفحة Review + `frigate_reviews` | دائماً |
| شريط الأحداث (Timeline) | ✅ جدول `frigate_timeline` + الصفحة | دائماً |
| لقطات التنبيهات (Snapshots) | ✅ في الأحداث والمراجعة | دائماً |
| التسجيلات (Recordings) | ✅ صفحة Recordings + `frigate_recordings` | ✅ كتالوج: `recording` (أيام الاحتفاظ) |
| التصدير (Exports) | ✅ صفحة Exports | دائماً |
| **البحث عن الوجوه** (Face Recognition) | ✅ صفحة Faces (رفع/تسمية/حذف عبر البروكسي) | ✅ كتالوج: `face_recognition` |
| **قراءة اللوحات** (LPR) | ✅ صفحة License Plates + قوائم مراقبة | ✅ كتالوج: `lpr` |
| **البحث الدلالي** (Semantic Search) | ✅ صفحة Smart Search | ✅ كتالوج: `semantic_search` |
| عين الطائر (Birdseye) | ✅ صفحة Birdseye | ✅ كتالوج: `birdseye` |
| كشف الأصوات (Audio) | ⚠️ الأحداث تظهر؛ لا صفحة مخصصة | ✅ كتالوج: `audio_detection` |
| المحفزات الذكية (Triggers) | ✅ صفحة Smart Triggers | دائماً (يتطلب semantic_search) |
| وصف الأحداث GenAI | ❌ بعد | 🔜 كتالوج: `genai` (يتطلب مفتاح مزود) |
| البث الحي (WebRTC/MSE) | ✅ Live View + go2rtc | دائماً |
| الإعدادات/السجلات/إعادة التشغيل | ✅ صفحات Config/Logs + زر Restart | عبر البروكسي |
| نشر نماذج مخصصة | ✅ Model Hub + `frigate_model_deployments` | ✅ + سجل نماذج البوابة |
| **تحديث نسخة المحرك** | ✅ حقل `branches.engine_image` | ✅ الوكيل يسحب الصورة ويعيد إنشاء الحاوية تلقائياً (نمط watchtower) |
| PTZ Autotracking | ❌ بعد | 🔜 عند أول عميل بكاميرات PTZ |

### حماية الجهاز (anti-piracy + منع الأجهزة الافتراضية + موافقة الأدمن)

**السقف الصريح:** لا حماية برمجية على جهاز يملكه العميل فيزيائياً غير قابلة للكسر
من مهاجم بصلاحية root. لذلك الحماية طبقتان: (أ) الجهاز **appliance نملكه** ضمن
الاشتراك، (ب) **البوابة السحابية تحرس كل شيء** فالنسخة غير المعتمدة لا تحصل على
الإعدادات ولا النماذج ولا تُدرج أحداثاً — عديمة القيمة.

- **بصمة عتاد** (`edge/agent/fingerprint.py`): sha256 لـ machine-id + product_uuid +
  board_serial + المعالج (تُقرأ من مسارات المضيف read-only). تُرسل في هيدر
  `X-Device-Fingerprint` مع كل طلب، وتُثبّت مرة واحدة عند أول تسجيل.
- **موافقة إلزامية**: `branches.device_status` (pending→approved). الجهاز الجديد يظهر
  في لوحة الفرع ببيانات عتاده (المصنّع/الطراز/المعالج/المضيف) **بانتظار موافقتك**؛
  لا يعمل قبلها.
- **منع النسخ/VMware**: نسخة على جهاز آخر = بصمة مختلفة بنفس الـ token →
  `fingerprint_mismatch`، لا تستبدل البصمة المعتمدة، وتُسجَّل المحاولة وتظهر تحذيراً
  للأدمن. كشف الأجهزة الافتراضية (علم hypervisor + بصمات VMware/VBox/KVM/Hyper-V…)
  → `vm_blocked` ما لم يفعّل الأدمن `allow_vm` (لأجهزتنا الاختبارية فقط).
- **دالة `gate()`** في البوابة تطبّق الترتيب: سداد → تسجيل → تطابق بصمة → VM →
  اعتماد، وتحرس `/config` و`/heartbeat` و`/events` و`/models`. **مُثبت بالاختبار الحي**:
  الأصلي active، النسخة mismatch + 403 على الأحداث والنماذج.
- **إعادة تعيين الارتباط**: زر في اللوحة يمسح البصمة (عند استبدال عتاد الفرع فعلياً).
- **مسار تعزيز لاحق**: TPM 2.0 / Secure Boot attestation عند التوسع لرفع السقف.

### إعادة التسمية (white-label كامل)

صورة `veedon-ai/edge-engine:stable` (تُبنى من الأساس عبر `edge/engine/Dockerfile`) —
`docker images` و`docker ps` يظهران **Veedon.AI فقط، لا ذكر لـ frigate** (مُثبت).
الحاويات `veedon-engine`/`veedon-agent`، بلا منافذ منشورة، ونص ترخيص MIT يبقى داخل
الصورة (الشرط القانوني الوحيد) وغير مرئي للعميل في نمط الـ appliance.

**نمطا التشغيل:**
- **محلي/HQ LAN (نمط local-db-version):** اللوحة تصل للمحرك مباشرة عبر `frigate_instances.host_url` — كل الصفحات أعلاه حية. هذا ما يعمل الآن.
- **سحابي مع فروع خلف NAT (white-label):** ✅ **مبني** — نفق **frp ذاتي الاستضافة** (داخل
  السعودية، لا طرف ثالث): `frpc` في compose الحافة (profile اختياري) يفتح اتصالاً صادراً
  لـ`frps` على veedon.ai ويعرض المحرك (5000) عبر `<device>.tunnel.veedon.ai` **دون أي منفذ
  منشور في الفرع**. الوكيل يبلّغ `tunnel_url` في heartbeat → يُخزَّن في `agent_info` (اللوحة
  تستخدمه host_url). `install.sh` يجهّزه تلقائياً عند تزويد `VEEDON_FRPS_ADDR/TOKEN`.
  **مُثبت محلياً:** frps سجّل التوجيه (`new proxy type http success`, `http proxy listen for host`).
  ملفات: `server/dist/frp/frps.toml` + `veedonai/frpc.toml.tmpl`.

---

## 7. ثوابت من خطة v1 (سارية كما هي بعد تغيير الاسم)

- **التسعير:** Basic 499 / **Pro 899** ⭐ / Enterprise من 1,400 ريال لكل فرع شهرياً + تركيب 1,500–4,000 لمرة واحدة، خصم سنوي 15%، الجهاز ملك Veedon ضمن الاشتراك. الدفع نحو Pro سنوي (~9,200 ريال/فرع/سنة).
- **الأجهزة:** اقتصادي N100 (900–1,300 ريال، 4–6 كاميرات) / **متوسط i5 افتراضي** (2,200–3,200، 8–12) / احترافي Jetson Orin NX أو RTX (5,000–8,000، 16+). Coral مرفوض.
- **خارطة 12 شهراً:** PoC (شهر 1) → MVP (2–3) → Pilot مدفوع 3 عملاء (4–6) → إطلاق 10 عملاء (7–9) → Scale 25 عميلاً/75 فرعاً (10–12). الميزانية ~700–900 ألف ريال.
- **قنوات البيع:** شركات تركيب الكاميرات كموزعين (20% من الاشتراك) أولاً، ثم مباشر للسلاسل، معارض Saudi HORECA وFoodex.
- **المخاطر وحلولها:** الإنذارات الكاذبة (الخطر #1)، الخصوصية/PDPL (لا تعرف على وجوه)، ترخيص Ultralytics AGPL (البديل RT-DETR Apache أو ترخيص مدفوع)، ضعف النت (edge-first + store&forward).

---

## 8. التوسّع القطاعي والتمايز التنافسي (v3 — بحث يوليو 2026)

> **الأطروحة:** Veedon ليست "منتج مطاعم" — بل **محرك امتثال تشغيلي أفقي** يُفعّل قطاعاً
> جديداً بكتالوج مزايا + قالب تقارير مربوط بجهته الرقابية السعودية، على **نفس المنصة
> ونفس الجهاز ونفس السحابة**. القطاع الجديد = بيانات في الكتالوج، لا منتج جديد.

### 8.1 خريطة القطاعات الخمسة وجهاتها الرقابية (زاوية البيع القاتلة)

| القطاع | الجهة الرقابية السعودية | إلزام الكاميرا | صاحب القرار | حجم العقد |
|---|---|---|---|---|
| مطاعم/مقاهي (الأول) | البلدية + SFDA | ✅ نظام 2022 | مدير العمليات | متوسط |
| **مصانع/مستودعات** | **HCIS** (الأمن الصناعي) + SFDA للغذائية + MIMR | ✅ HCIS يفرض تغطية محددة | مدير السلامة/الجودة | **كبير** |
| **مدارس/جامعات/تعليم** | **وزارة التعليم** + نظام الكاميرات 2022 (إلزام صريح للمدارس) | ✅ إلزامي + احتفاظ 90 يوماً | مدير الأمن/المدير العام | كبير (مجمّعات) |
| **صحة/مستشفيات/مجمعات طبية** | **وزارة الصحة + CBAHI** (الاعتماد) + SFDA | ✅ | مدير الجودة/السلامة | **كبير جداً** |
| تجزئة/سوبرماركت | البلدية | ✅ | مدير التشغيل | متوسط |

**لماذا هذا خندق لا يقلَّد:** المنافس العالمي (Verkada/Spot AI/Voxel) يبيع "كشفاً عاماً"
بالإنجليزية؛ Veedon يبيع **"تقرير امتثال HCIS جاهز للتفتيش"** أو **"سجل التزام اشتراطات
وزارة التعليم"** — بالعربية، بأدلة مصوّرة مؤرّخة. هذا يحوّل المنتج من "تكلفة أمنية"
إلى **"تأمين ضد الغرامة والإغلاق وسحب الاعتماد"** — وهو ما يوقّع عليه صاحب القرار فوراً.

### 8.2 المنافسون العالميون في القطاعات الجديدة ونقاط ضعفهم

| المنافس | قوته | ضعفه في السعودية (فرصتنا) |
|---|---|---|
| **Verkada** | منصة موحدة، AI Deterrence (تحذير صوتي متصاعد)، بروتوكول إغلاق المدارس SRP، كشف الأسلحة | يبيع **كاميراته** (استبدال كامل مكلف)، إنجليزي، سحابي، تسعير مؤسسي، لا امتثال سعودي |
| **Spot AI / Rhombus** | وكلاء AI جاهزون، تكامل كاميرات ONVIF، مدارس | أمريكي، لا عربية/واتساب، لا ربط بوزارة التعليم/HCIS |
| **Voxel / Protex.ai / viAct** | سلامة المصانع (PPE + تقارب الرافعات)، خفض إصابات 50–77% | يستهدف مصانع أمريكا/أوروبا، لا HCIS، لا عربية، سعر عالٍ |
| **IntelliSee / Axis (صحة)** | كشف سقوط المرضى، نظافة اليدين، هروب المرضى | لا CBAHI، لا عربية، حساسية خصوصية سحابية |
| **Omnilert** | كشف الأسلحة للمدارس (نيتش) | نيتش ضيق، لا منصة تشغيل شاملة |

**تفوّق Veedon الموحّد عبر الكل:** يعمل على الكاميرات القائمة (لا استبدال) + edge-first
(نت ضعيف + خصوصية داخل المبنى، حاسم للصحة والمدارس) + عربي/واتساب + **ربط تنظيمي سعودي
لكل قطاع** + تسعير بالريال لكل موقع.

### 8.3 حالات الاستخدام الجديدة لكل قطاع (تُضاف للكتالوج)

**🏭 المصانع والمستودعات (HCIS/SFDA) — أعلى قيمة عقد:**
- **تقارب الرافعات الشوكية بالعمّال** (forklift proximity) — أخطر إصابة صناعية، الميزة الرائدة عالمياً.
- **PPE صناعي**: خوذة + سترة عاكسة + قفازات + نظارات في مناطق الخطر.
- الوضعيات الخاطئة (ergonomic) لمنع إصابات العمود الفقري.
- دخول مناطق الآلات الخطرة أثناء التشغيل + السقوط.
- التزام HACCP/SFDA لمصانع الأغذية (زي، نظافة، تلوث متبادل).

**🏫 التعليم (وزارة التعليم + نظام الكاميرات) — خصوصية القُصّر حاكمة:**
- **كشف الأسلحة/الأدوات الحادة** عند البوابات.
- **التدخين/الفيب** في دورات المياه والأركان (بمستشعرات لا كاميرات في الأماكن الخاصة — كما Verkada).
- **العراك/التنمّر** (كشف العدوانية: أذرع مرفوعة، تجمّع مفاجئ).
- التسكّع/الدخول خارج الدوام + اقتحام السور.
- ازدحام المخارج وقت الطوارئ + عدّ الحضور عند البوابة.
- **صريح: لا تعرّف على وجوه الطلاب إطلاقاً** — تحليل سلوكي فقط داخل المبنى (PDPL + حماية القُصّر).

**🏥 الصحة (وزارة الصحة/CBAHI/SFDA) — الخصوصية = شرط دخول:**
- **سقوط المريض** ومغادرة السرير (bed-exit).
- **هروب المريض** (elopement — وصول مريض مشوّش لمخرج).
- **الالتزام بنظافة اليدين** عند نقاط الدخول (أثبت +18 نقطة في سنغافورة).
- PPE في أجنحة العزل + كشف العنف/العدوانية ضد الطواقم.
- ازدحام الطوارئ وأزمنة الانتظار.
- **معالجة على الجهاز 100%، لا وجوه، تجهيل** — نبيعها كميزة اعتماد CBAHI لا كمراقبة.

### 8.4 مزايا منتج جديدة نتبنّاها من المنافسين (أفقية عبر القطاعات)

1. **الردع الذكي (AI Deterrence)** مستوحى من Verkada: عند تسكّع/اقتحام خارج الدوام →
   إعلان صوتي متصاعد عبر مكبّر الفرع ("أنت في منطقة مراقبة") قبل التنبيه — **رادع فعلي لا مجرد إشعار**.
2. **بروتوكول الطوارئ/الإغلاق** للمدارس والمنشآت: أزرار حالة (تأمين/إغلاق/إخلاء) تبثّ تعليمات موحّدة.
3. **كشف الأسلحة والعدوانية** كنماذج edge مشتركة (مدارس + صحة + بنوك لاحقاً).
4. **تقارب المركبة-الإنسان** (forklift) كنموذج edge — المصانع والمستودعات.
5. **قالب تقرير امتثال لكل جهة** (HCIS / وزارة التعليم / CBAHI / SFDA) — أدلة مصوّرة مؤرّخة، **ميزة البيع رقم 1**.

### 8.5 أثر على خارطة الطريق والتسعير

- **الترتيب لا يتغير:** المطاعم تبقى الشريحة الأولى (أسرع دورة بيع، أقل حساسية). التعليم/الصحة/المصانع
  من **الشهر 7+** (Enterprise، دورة أطول، عقود أكبر) بعد إثبات الدقة في المطاعم.
- **تسعير القطاعات الثقيلة**: باقة **Enterprise / Compliance** لكل موقع، من **1,900 ريال/موقع/شهر**
  (مصانع/صحة/تعليم) + رسوم تكامل تنظيمي لمرة واحدة — لأن القيمة (تجنّب غرامة/سحب اعتماد) أعلى بكثير.
- **الوحدات المطلوبة تدريباً** (أسلحة، تقارب رافعات، سقوط مريض، نظافة اليدين) تدخل خط أنابيب النماذج:
  نبدأ بـ **VLM/قواعد** لإثبات الطلب، ثم نموذج edge مخصّص عند أول عميل دافع في القطاع.

### 8.6 المخاطر الإضافية للقطاعات الجديدة

| الخطر | التخفيف |
|---|---|
| خصوصية القُصّر (تعليم) والمرضى (صحة) — الأعلى حساسية | معالجة على الجهاز 100%، لا تعرّف وجوه، تجهيل تلقائي، بند PDPL صريح، لافتات |
| اعتماد الأسلحة/السقوط يتطلب دقة عالية (خطأ = كارثة سمعة) | لا نطلقها قبل precision ميداني ≥ 90%؛ نبدأ كـ"مساعد إشعار" مع تأكيد بشري إجباري |
| ترخيص HCIS للمنشآت الحرجة قد يتطلب معدات معتمدة | استشارة مبكرة + شراكة مكامل معتمد؛ نبدأ بالمصانع غير الحرجة والأغذية |
| دورة بيع حكومية (تعليم/صحة) طويلة | البدء بالقطاع الخاص (مدارس/مستشفيات/مصانع خاصة) قبل الحكومي |

---

## 9. دراسة قطاع المدارس الكاملة + التكاملات + الاستفادة من المصادر المفتوحة (v4 — 2026-07-05)

> **قرار استراتيجي:** العميل الأساسي = **المدارس + المطاعم**. هذا القسم دراسة معمّقة
> لقطاع التعليم (الأكبر عدداً والأكثر إلزاماً تنظيمياً)، مع تكاملات جديدة (أجهزة قابلة
> للارتداء لصحة الطلاب) ومكتبة مصادر مفتوحة تقوّي النظام دون تكلفة تطوير من الصفر.

### 9.1 حجم السوق التعليمي السعودي (لماذا المدارس رهان رابح)

- **منصة مدرستي:** أكثر من **6 ملايين طالب** و**525 ألف معلم** — أكبر نظام تعليم رقمي في المنطقة.
- عدد المدارس في المملكة **~30 ألف مدرسة** (حكومي + أهلي/عالمي). الأهلي والعالمي = **قرار شرائي خاص سريع** (بلا دورة حكومية).
- **الكاميرات إلزامية بنص النظام (2022)** للمدارس مع احتفاظ 90 يوماً — البنية جاهزة قانونياً.
- **برنامج المدارس الصحية** (وزارة الصحة + معايير WHO) + مؤشرات صحة الطلاب لدى وزارة التعليم = مظلّة تنظيمية لميزة صحة الطلاب.
- محرّكات القرار: سلامة الطلاب (قضايا الرأي العام)، طمأنة أولياء الأمور (ميزة تنافسية للمدرسة الأهلية)، الامتثال لاشتراطات الترخيص.

### 9.2 شخصيات القرار وكيف نبيع لكل منها

| الشخصية | ألمها | رسالتنا |
|---|---|---|
| **مالك/مدير المدرسة الأهلية** | المنافسة على الطلاب + سمعة السلامة + غرامات الترخيص | "ميزة تسويقية لأولياء الأمور: مدرسة تراقب السلامة بالذكاء 24/7 وتبلّغهم فوراً" |
| **مدير الأمن والسلامة** | لا يستطيع مشاهدة عشرات الكاميرات؛ الحوادث تُكتشف متأخرة | "المخالفة/الخطر يصلك لحظته بصورته على واتساب + تقرير التزام أسبوعي" |
| **ولي الأمر (المستفيد النهائي)** | قلق على طفله (خصوصاً المريض المزمن) | "تصلك حالة طفلك الصحية والسلامة لحظياً — طمأنينة" |
| **إدارة التعليم/الترخيص** | التحقق من الاشتراطات | "تقرير امتثال جاهز باشتراطات وزارة التعليم بأدلة مؤرّخة" |

### 9.3 حالات استخدام المدارس (مبنية في الكتالوج + مضافة)

**السلامة والأمن والسلوك (مبنية — 7 مزايا تعليمية، كلها تعمل الآن):**
- كشف الأسلحة/الأدوات الحادة عند البوابات (`weapon_detection`).
- **كشف المشاجرات** (`fight_detection`) — عنف جسدي: دفع/ضرب/تشابك (VLM جاهز).
- **كشف التنمّر** (`bullying`) — استهداف متكرر/عزل/مضايقة، أدقّ من العنف الظاهر (VLM جاهز).
- **السقوط على السلالم** (`stair_fall`) — منطقة إصابات عالية الخطورة (VLM جاهز؛ ترقية pose لاحقاً).
- **نوم الطلبة في الفصل** (`student_sleeping`) — مؤشر انخراط/رعاية (VLM جاهز).
- التسلل/التسكّع خارج الدوام (`after_hours_intrusion`) + عدّ الحضور عند البوابة (`gate_attendance`).
- التدخين/الفيب في دورات المياه — **بمستشعرات كشف بخار لا كاميرات** (خصوصية القُصّر).

**مضافة خاصة بالمدارس (v4 — للكتالوج):**
- **مغادرة الطالب للحرم دون إذن** (استغلال منطقة ممنوعة + بوابة).
- **دخول زائر/غريب** خارج قوائم المصرّح لهم (بلا تعرّف وجوه للطلاب — فقط تنبيه وجود بالغ غير معروف في مناطق الطلاب).
- **مراقبة ساحات اللعب** (سقوط، إصابة، ازدحام خطر).
- **الالتزام بحافلات النقل** (صعود/نزول، عدّ، عدم ترك طفل في الحافلة — قضية حسّاسة عالمياً).

**قاعدة حاكمة صريحة:** **لا تعرّف على وجوه الطلاب إطلاقاً.** كل التحليل سلوكي/مكاني،
معالجة داخل المدرسة، تجهيل تلقائي، بند PDPL + موافقة ولي الأمر. هذا شرط دخول لا تفاوض فيه.

### 9.4 وحدة صحة الطلاب عبر الأجهزة القابلة للارتداء (تكامل جديد — تمايز فريد)

> **الفكرة:** ربط Veedon بأساور/ساعات الطلاب ذوي الأمراض المزمنة (سكري، صرع، قلب، ربو)
> لتنبيه عيادة المدرسة + ولي الأمر **قبل** تفاقم الحالة — ودمجها مع الكاميرات لتحديد
> **موقع الطالب** فوراً عند الطوارئ. لا منافس محلي يقدّم هذا.

**التكامل التقني:**
- **Apple HealthKit / Google Fit** كطبقة تجميع قياسية (تدعمها معظم الساعات).
- **الصرع:** ساعات معتمدة FDA (نمط Empatica Embrace) ترصد النشاط الجلدي الكهربي + الحركة → إنذار نوبة.
- **السكري:** أجهزة قياس الجلوكوز المستمر (Dexcom G7 / Abbott FreeStyle Libre 3) → تنبيه هبوط/ارتفاع خطر.
- **القلب/الإجهاد:** معدّل نبض غير طبيعي (Apple Watch / أساور صحية عامة).
- **التدفق:** الساعة → HealthKit/تطبيق ولي الأمر → **Veedon Health Gateway** (خدمة سحابية جديدة، ويب-هوك) → قاعدة: تجاوز عتبة → **تنبيه واتساب لعيادة المدرسة + ولي الأمر** + **الكاميرا الأقرب تحدّد موقع الطالب** (بمعرّف منطقة لا بوجه).

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

### 9.5 التكاملات المقترحة للنظام (كل القطاعات)

| التكامل | القطاع | القيمة |
|---|---|---|
| **توكلنا / أبشر / نفاذ** | تعليم/الكل | هوية المصرّح لهم، إشعار أولياء الأمور، ثقة حكومية |
| **مدرستي / نور** | تعليم | ربط الحضور بالبوابة، سياق الطالب (دون بيانات حساسة) |
| **HealthKit / Google Fit + CGM/Empatica** | تعليم/صحة | وحدة صحة الطلاب (9.4) |
| **Foodics / POS سعودي** | مطاعم | ربط الفيديو بالمعاملات (استرجاعات/فتح درج بلا فاتورة) |
| **أنظمة النداء/المكبرات (PA)** | الكل | الردع الصوتي الذكي + تعليمات الطوارئ |
| **التحكم بالدخول (بوابات/أبواب)** | الكل | إغلاق تلقائي عند تهديد (بروتوكول SRP) |
| **واتساب (Unifonic رسمي) + Evolution (MVP)** | الكل | التنبيهات — مبني |
| **Slack / Teams / Webhooks** | مؤسسات | تنبيهات فرق العمليات |

### 9.5ب مزوّد الرؤية (VLM) اختياري — سحابي أو محلي (خصوصية كاملة)

مزايا النوع `vlm` (نظافة، تنمّر، سقوط، نوم الطلبة، صحة الدواجن…) تعمل عبر مزوّد
**قابل للتبديل** بمتغيّر بيئة واحد `VEEDON_VLM_PROVIDER` (مبني في `app/vlm.py`):

| المزوّد | متى نستخدمه | الإعداد |
|---|---|---|
| `claude` (افتراضي) | أعلى جودة حكم، سحابي | `ANTHROPIC_API_KEY` |
| `ollama` | **رؤية محلية — الصور لا تغادر المنشأة** (مدارس/صحة/PDPL)، مجاني | `VEEDON_VLM_URL` (افتراضي :11434) + نموذج مثل `llama3.2-vision` / `qwen2-vl` / `moondream` |
| `lmstudio` | رؤية محلية بواجهة سهلة | `VEEDON_VLM_URL` (افتراضي :1234) |

Ollama وLM Studio يوفّران واجهة متوافقة مع OpenAI فيتشاركان مساراً واحداً في الكود.
**قيمة استراتيجية:** خيار الرؤية المحلية يقفل ورقة الخصوصية للمدارس والصحة (لا صور
لطلاب/مرضى تغادر المبنى) — ويمكن تشغيله على خادم الفرع أو صندوق الحافة نفسه، فيبقى
النظام **edge-first حتى في طبقة الذكاء**. المزوّد قابل للترقية لكل عميل حسب حساسيته.

### 9.6 مكتبة المصادر المفتوحة التي تقوّي Veedon (بحث GitHub + HuggingFace)

| المصدر | الترخيص | كيف يخدمنا | الحالة |
|---|---|---|---|
| **Frigate NVR** | MIT | محرك الحافة (كشف/تتبع/تسجيل/وجوه/لوحات/بحث دلالي) | ✅ مبني (white-label) |
| **jina-clip-v1 (ONNX)** | Apache | البحث الدلالي — ينزّله المحرك ذاتياً | ✅ يعمل |
| **Double-Take** | MIT | واجهة/API موحّدة للوجوه فوق Frigate | مرشّح للدمج |
| **ONNX Runtime** | MIT | استدلال محلي خفيف بلا AGPL | ✅ مبني (analyzer.py) |
| **YOLOv8n ONNX (COCO)** | متعدد | نموذج كشف عام (person/جوال/سكين…) — يعمل الآن على الجهاز | ✅ منشور `veedon-detect-v1.onnx` |
| **نماذج PPE/سقوط/أسلحة (HF)** | MIT/AGPL متفاوت | أساس fine-tune للقطاعات — **تُصدَّر إلى ONNX** قبل الشحن | مرشّحة (تجنّب AGPL) |
| **RF-DETR (Roboflow)** ⭐ | Apache-2.0 | **البديل الحاسم لـ YOLO**: NMS-free، أدقّ وأسرع 3× من YOLO11-X، backbone DINOv2 يتقارب بعيّنات أقل (يقلّص حجم dataset السعودي المطلوب)، ICLR 2026 | **الأساس المعتمد للنماذج المخصصة** |
| **D-FINE** | Apache-2.0 | بديل DETR ثانٍ عالي الأداء | احتياطي |
| **Roboflow supervision** | MIT | أدوات CV جاهزة: عدّ داخل zone، عبور خط (line-crossing)، تتبع، توصيفات — **يستبدل منطقنا اليدوي** في analyzer | مرشّح قوي للدمج |
| **Norfair / ByteTrack** | MIT | تتبع متعدد الأجسام (dwell time، طوابير، عدّ دخول/خروج) | مرشّح |
| **VLM حافة مفتوح: SmolVLM (Apache) / moondream / Qwen2.5-VL** | Apache/متعدد | يشغّل مزوّد `ollama` محلياً على صندوق الحافة — **رؤية بلا إنترنت** (خصوصية المدارس/الصحة) | ✅ البنية جاهزة (VEEDON_VLM_PROVIDER) |
| **Double-Take** | MIT | واجهة/API موحّدة للوجوه فوق Frigate (غير الطلاب) | مرشّح للدمج |
| **مسرّعات: Hailo / Coral / OpenVINO / NPU** | — | تسريع الاستدلال على الحافة حسب العتاد | خيارات عتاد |
| **Frigate+ ($50/سنة)** | تجاري | تدريب نماذج على كاميرات العميل | خيار لتسريع بناء datasets |

**سياسة الترخيص (حاسمة):** نماذجنا التجارية المشحونة **ONNX + Apache/MIT فقط**؛
نتجنّب شحن أوزان AGPL (Ultralytics) — نستخدمها للبحث فقط أو نصدّر بدائل Apache. (مطبّق:
نموذج PPE بصيغة .pt رُفض تلقائياً من محرك الاستدلال — يجب تصديره ONNX أولاً.)

### 9.6ب المنافسون الإقليميون (خليج) — تأكيد فجوتنا

بحث 2026: اللاعبون الخليجيون **مؤسسيون/مدني/صناعي وغالبيتهم إماراتيون**، لا أحد يستهدف
شريحتنا (SMB سعودي، مطاعم/مدارس، كاميرات قائمة، عربي/واتساب، تسعير بالريال):

| المنافس | تركيزه | لماذا لا يزاحمنا |
|---|---|---|
| **Presight AI** (أبوظبي، G42) | مدن ومؤسسات ضخمة | enterprise/city-scale، ليس SMB |
| **AIQ** (ADNOC + G42) | النفط والغاز الصناعي | قطاع واحد ثقيل، ليس تجزئة/تعليم |
| **Safe City Group** | مدن ذكية وبنية عامة | حكومي كبير، دورة طويلة |
| **ePm UAE** | تحليلات CCTV (تسكّع، سقوط) | إماراتي، لا امتثال سعودي/عربي/واتساب |
| **viAct / Scylla** | سلامة صناعية عبر الخليج | مصانع، لا مطاعم/مدارس، لا ربط تنظيمي سعودي |

**الخلاصة:** الفجوة السعودية (SMB + الجهات الرقابية المحلية + العربية + الكاميرات القائمة) **ما زالت مفتوحة**؛
لا منافس مباشر. نافذتنا 18–24 شهراً — الأولوية بناء الخندق (dataset + شبكة الموزعين).

### 9.6ج توصيات القيمة المضافة من البحث (قرارات عملية)

1. **اعتمد RF-DETR (Apache) أساساً لكل نماذجنا المخصصة** بدل YOLO — يحسم الترخيص نهائياً،
   وأهم من ذلك: يتقارب بعيّنات أقل، فيقلّص **حجم الـ dataset السعودي المطلوب** لكل ميزة قطاعية
   (تدخين/PPE/أسلحة) — يسرّع بناء الخندق ويخفض كلفته.
2. **ادمج Roboflow supervision في `analyzer.py`** لعدّ الـ zone وعبور الخط والتتبع بدل الكود
   اليدوي — أقل صيانة وميزات جاهزة (عدّ دخول/خروج، dwell time للطوابير).
3. **وفّر VLM حافة محلياً** (SmolVLM/moondream عبر Ollama على صندوق الفرع) كخيار "خصوصية
   قصوى" للمدارس والصحة — الصور لا تغادر المبنى إطلاقاً. البنية جاهزة (القسم 9.5ب).
4. **ميزة جديدة مقترحة — عدّ الدخول/الخروج (line-crossing)**: عبر supervision — قيمة للتجزئة
   (عدد الزوّار)، المطاعم (معدل الإشغال)، المدارس (تدفق البوابات/الحافلات). سهلة وعالية الطلب.
5. **ابقَ على Frigate** (لا Viseron) — نظامنا مبني حوله وناضج؛ Viseron بديل لكن بلا ميزة تبرّر التحويل.

### 9.7 تسعير باقة المدارس

- **Basic School:** 599 ريال/بوابة-منطقة/شهر — السلامة الأساسية (مناطق، اقتحام، حضور).
- **Pro School ⭐:** 1,100 ريال — كل سيناريوهات السلامة + واتساب فوري + تقارير وزارة التعليم.
- **Care School (بالأجهزة):** +400 ريال/طالب مزمن/شهر — وحدة صحة الطلاب (9.4).
- رسوم تكامل تنظيمي/توكلنا لمرة واحدة. **البدء بالمدارس الأهلية/العالمية** (قرار أسرع).

### 9.8 ما نُفّذ من هذا القسم فعلاً (كود)

- ✅ **استدلال ONNX محلي على الجهاز** (`edge/agent/analyzer.py`): YOLOv8-ONNX + NMS، تحميل كسول،
  يعمل حياً — الوكيل حمّل `veedon-detect-v1.onnx` وكشف "person" بثقة 0.80 على لقطة كاميرا حقيقية
  وأنتج حدثاً في اللوحة. مزايا edge_model الآن تُشغّل استدلالاً فعلياً (فحص كل 10ث).
- ✅ النموذج العام منشور في سجل النماذج ويُنزَّل OTA للجهاز.
- ✅ رفض تلقائي للأوزان غير المتوافقة (.pt) — يفرض سياسة ONNX.
- 🔜 **التالي:** نماذج قطاعية مصدّرة ONNX (PPE/سقوط/أسلحة)، وحدة صحة الطلاب (Health Gateway + HealthKit)،
  دمج Double-Take للوجوه (غير الطلاب)، وتقارير الامتثال لكل جهة.

---

## 10. توسّع القطاعات — بحث معمّق (يوليو 2026) + قطاع الفنادق + تقرير وزارة التعليم

> بحث ثانٍ عبر التعليم والفنادق والمصانع أضاف **12 ميزة جديدة** و**قطاعاً جديداً (الفنادق)**.
> الكتالوج الآن **45 ميزة عبر 7 قطاعات** — كلها بيانات في `event_types` (تظهر تلقائياً في اللوحة).

### 10.1 قطاع الفنادق (جديد) — وزارة السياحة + البلدية

**الفرصة السعودية:** رؤية 2030 تستهدف **150 مليون زائر سنوياً**؛ وزارة السياحة تشدّد
الترخيص والرقابة الرقمية على المنشآت الفندقية، ومطابخ الفنادق تخضع لـ SFDA كالمطاعم.
منشأة فندقية = عقود أكبر (غرف + لوبي + مطاعم + مسابح + محيط).

**المزايا المضافة (kind):** أرضية مبتلة/انسكاب (vlm) — مطالبات الانزلاق تتجاوز 30 ألف دولار
للحادثة؛ سلامة المسبح (vlm) — طفل بلا مرافق؛ حقيبة/غرض متروك (vlm) — أمن؛ اقتحام
محيط/مناطق الموظفين (rule). + إعادة استخدام: التدخين، السقوط، التكدس، الطوابير.

### 10.2 مزايا التعليم الجديدة (مستوحاة من Verkada/Omnilert/Spot AI)

- **تفعيل الإغلاق الطارئ** (`emergency_lockdown`): ربط كشف السلاح ببروتوكول إغلاق فوري +
  تنبيه أولوية — الأنظمة الرائدة تنفّذه في أقل من 5 ثوانٍ.
- **زائر غير مصرّح** (`visitor_unknown`): بالغ غير معروف في مناطق الطلاب.
- **اتجاه معاكس/تسلل** (`wrong_direction`): عند البوابات.
- **كشف الفيب** (`vape_detection`): عبر **مستشعرات بخار لا كاميرات** في دورات المياه
  (تُميّز النيكوتين عن THC) — خصوصية القُصّر.

### 10.3 مزايا المصانع الجديدة

- **فحص جودة المنتج/العيوب** (`defect_inspection`): خدوش/شقوق/انحرافات — دقة 95–99%،
  سوق الفحص البصري 1.62 مليار دولار (نمو 13.8%). أعلى قيمة تشغيلية للمصانع.
- **انسكاب/تسرب** (`spill_leak`)، **حرارة/دخان/حريق** (`thermal_fire`)،
  **توقف خط الإنتاج** (`machine_idle` — إنتاجية).

### 10.4 تقرير امتثال وزارة التعليم (مبني)

`app/reports.py` — تقرير الفرع يُنتج تلقائياً لفروع التعليم قسم **«اشتراطات وزارة التعليم
للأمن والسلامة المدرسية»**: مصفوفة تغطية عبر 4 مجالات (الأمن والحماية من التهديدات /
السلوك ومكافحة العنف والتنمّر / الصحة والسلامة الجسدية / تنظيم الدخول والحضور) — لكل مجال
حالة التغطية والمزايا المفعّلة والمخالفات المرصودة. **مُثبت** (HTTP 200، القطاع=education،
الجهة=وزارة التعليم، المجالات الأربعة ظاهرة). دليل جاهز لزيارة المشرف/التقييم الذاتي.

### 10.5 مصفوفة القطاعات النهائية (7 قطاعات)

| القطاع | الجهة الرقابية | أمثلة مزايا |
|---|---|---|
| مطاعم | البلدية + SFDA | تدخين، زي، نظافة، ازدحام |
| **فنادق** (جديد) | **وزارة السياحة + البلدية** | انزلاق، مسبح، حقيبة متروكة، محيط |
| مصانع | HCIS + SFDA | PPE، رافعات، **فحص عيوب**، حريق، تسرب |
| تعليم | وزارة التعليم | أسلحة، **إغلاق طارئ**, تنمّر، سقوط، فيب، زائر |
| صحة | وزارة الصحة + CBAHI | سقوط مريض، نظافة اليدين، هروب |
| تجزئة | البلدية | عدّ زوّار، تكدس، مناطق |
| مزارع | SFDA | صحة الدواجن |

---

## 11. توسّع القطاعات — بحث معمّق ثالث (يوليو 2026): مساجد + مستودعات + تجزئة

> بحث ثالث أضاف **18 ميزة** وقطاعين جديدين عاليي الأهمية للسعودية.
> الكتالوج الآن **63 ميزة عبر 10 قطاعات** — كلها بيانات في `event_types`.

### 11.1 🕌 المساجد والفعاليات (قطاع جديد — الأهمّ سعودياً)

**الفرصة:** الحرمان الشريفان + الحج والعمرة + عشرات آلاف المساجد + الفعاليات الكبرى
(موسم الرياض، ملاعب). **SDAIA تستخدم هذا فعلاً** عبر منصّتي «سواهر» و«بصير» في المسجد
الحرام والمشاعر. سلامة الأرواح = أولوية وطنية، وميزانيات كبيرة، ودعم حكومي.

**المزايا:** كثافة الحشود/خطر التدافع (rule) — حماية من الكوارث؛ اتجاه وتدفق الحشود
(rule)؛ شخص ساقط وسط الزحام (edge_model) — قبل التدافع فوقه؛ طفل تائه (vlm)؛ إشغال
قاعة الصلاة (rule). الجهة: وزارة الشؤون الإسلامية + الحج/العمرة + الدفاع المدني.

### 11.2 📦 المستودعات واللوجستيات (قطاع جديد)

**الفرصة:** توسّع لوجستي هائل (نيوم، الموانئ، مراكز التوزيع، التجارة الإلكترونية).
**المزايا:** نشاط رصيف التحميل (rule)؛ تلف الطرود (vlm)؛ المشي تحت حمل معلّق (rule —
سلامة)؛ عدّ المنصات (vlm). + إعادة استخدام مزايا المصانع (رافعات، PPE، تسرب، حريق).

### 11.3 🛒 التجزئة/السوبرماركت (توسعة — الفاقد سوق ضخم)

الفاقد الأمريكي 47.8 مليار دولار (2025)؛ الدفع الذاتي فاقده **16× أعلى**، والتقنية تخفض
الفاقد حتى 30% أول سنة. **المزايا:** رفوف فارغة/نفاد (vlm)؛ التزام ترتيب العرض (vlm)؛
إخفاء منتج/اشتباه سرقة (edge_model)؛ **احتيال الدفع الذاتي** (rule + ربط POS — أقوى ميزة).

### 11.4 🐔 المزارع/الدواجن + 🏥 الصحة (توسعة)

- **دواجن:** كشف الطيور النافقة (edge_model — نفوق −10%)، عدّ الطيور (vlm)، نمو غير
  متجانس (vlm). الأبحاث: عمالة −30%، تحسّن النفوق ~10%.
- **صحة:** زمن انتظار المرضى (rule)، إشغال الأسرّة/المناطق (rule) — كفاءة تشغيلية.

### 11.5 مصفوفة القطاعات النهائية (10 قطاعات — 63 ميزة)

| القطاع | الجهة الرقابية | مزايا | أبرز جديد |
|---|---|---|---|
| مطاعم | البلدية + SFDA | 4+عام | — |
| فنادق | وزارة السياحة + البلدية | 4+ | انزلاق، مسبح |
| مصانع | HCIS + SFDA | 8 | فحص عيوب، رافعات |
| تعليم | وزارة التعليم | 11 | إغلاق طارئ، تنمّر |
| صحة | وزارة الصحة + CBAHI | 6 | نظافة يدين، انتظار |
| **مساجد/فعاليات** | **الشؤون الإسلامية + الحج + الدفاع المدني** | 5 | **كثافة/تدافع، ساقط في الزحام** |
| **مستودعات** | **الدفاع المدني + النقل** | 4 | **رصيف تحميل، حمل معلّق** |
| تجزئة | البلدية + التجارة | 4 | احتيال الدفع الذاتي |
| مزارع | SFDA | 4 | كشف النافق، عدّ الطيور |
| عام | — | 13 | وحدات محرك + قواعد |

**الأولوية التجارية النهائية:** مطاعم ومدارس (البدء) → مصانع وفنادق (شهر 7+) →
**مساجد/فعاليات** (فرصة حكومية كبرى، شراكة SDAIA محتملة) → مستودعات وتجزئة وصحة (توسّع).

---

## 12. قطاعان مضافان: ألعاب الأطفال + الملاعب الرياضية (يوليو 2026)

الكتالوج الآن **73 ميزة عبر 12 قطاعاً**.

### 12.1 🧸 مناطق ألعاب الأطفال (البلدية + الهيئة العامة للترفيه + الدفاع المدني)

**الفرصة:** ازدهار الترفيه العائلي (مراكز الألعاب الداخلية، مدن الملاهي، الترامبولين،
مناطق الأطفال في المولات والمطاعم) ضمن رؤية 2030. حساسية عالية = ثقة أولياء الأمور.

**المزايا:** طفل بلا مرافق (vlm)؛ سقوط طفل (edge_model)؛ **خروج طفل من المنطقة**
(rule — elopement، الأهم)؛ تكدس منطقة اللعب (rule)؛ لعب عنيف/خطِر (vlm).

### 12.2 ⚽ الملاعب والمنشآت الرياضية (وزارة الرياضة + الدفاع المدني + الأمن العام)

**الفرصة الضخمة:** استثمارات دوري روشن، الأندية الكبرى، **استضافة كأس العالم 2034**،
والفعاليات الرياضية الكبرى. أمن الحشود والمدرجات أولوية وطنية بميزانيات كبيرة.

**المزايا:** اقتحام أرض الملعب (rule)؛ **شعلة/دخان/ألعاب نارية** (vlm)؛ عنف الجماهير
(vlm)؛ شخص ملثّم (edge_model — مرتبط بالمشاغبين)؛ **إشغال المدرجات/كثافة حرجة** (rule —
حماية من التدافع). تتكامل مع قطاع المساجد/الفعاليات في إدارة الحشود.

### 12.3 مصفوفة القطاعات النهائية (12 قطاعاً — 73 ميزة)

مطاعم، فنادق، مصانع، تعليم، صحة، مساجد/فعاليات، مستودعات، تجزئة، مزارع،
**ألعاب أطفال**، **ملاعب رياضية**، عام — كل قطاع مربوط بجهته الرقابية السعودية.

**رافعة تجارية مشتركة:** المساجد + الملاعب + الفعاليات + ألعاب الأطفال = **عائلة "أمن
الحشود وسلامة التجمّعات"** — ميزة موحّدة (كثافة، تدافع، ساقط، ملثّم، شعلة) تخدم أعلى
القطاعات قيمة حكومية وأكثرها حساسية للأرواح، وأقربها لشراكة SDAIA/الدفاع المدني.

---

## 13. بحث تنافسي رابع (2026-07-05) — مزايا 2026 الجديدة وتوصياتها

> مسح لأحدث ما أطلقه المنافسون (ISC West 2026 + إطلاقات مايو–يونيو 2026). الخلاصة:
> صناعة المراقبة انتقلت من "كشف" إلى **"وكلاء يعقلون + بحث بلغة طبيعية + تنبيهات مركّبة"**.
> نافذتنا في السعودية (SMB + عربي + امتثال محلي + كاميرات قائمة) ما زالت مفتوحة، لكن
> يجب أن نلحق بموجة 2026 قبل أن تنزل Presight (G42) إلى شريحتنا.

### 13.1 ماذا أطلق المنافسون في 2026
- **Verkada:** بحث فيديو حرّ (freeform)، خط زمني موحّد للتحقيق، **تنبيهات مركّبة (compound
  alerts)** بشروط متعددة (مثال: عبور خط + بلا خوذة)، **كشف الخمول (inactivity)**، **عبور
  المركبات للخط**، **ردع ذكي (AI Deterrence)** برسائل صوتية تصف المشهد وتتصاعد، ملخّص AI
  لحوادث السقوط/العراك.
- **Coram:** بحث بلغة طبيعية، كشف أسلحة لحظي، LPR، منصّة موحّدة (فيديو + تحكم دخول + طوارئ).
- **Spot AI / Ambient:** **وكلاء AI** يراقبون 24/7 ويعقلون مقابل SOP ويتخذون إجراءات.
- **Conntour** (تمويل $7M، مارس 2026): محرك **بحث بلغة طبيعية عبر آلاف الكاميرات**.
- **محلي (خليجي):** Presight/AIQ (G42) — مدن/شرطة/طاقة، توسّع عدواني في الرياض 2025–2026؛
  Scylla — كشف تهديدات. كلهم enterprise/حكومي، لا أحد في SMB السعودي بالعربية.

### 13.2 فجوات عندهم وليست عندنا (يجب سدّها)
| الميزة | عندهم | عندنا الآن |
|---|---|---|
| **بحث بلغة طبيعية** عبر الأحداث/الكاميرات | Verkada/Coram/Conntour | بحث دلالي Frigate لكل جهاز فقط — لا بحث NL عربي عبر أحداثنا |
| **تنبيهات مركّبة** (عدة شروط) | Verkada compound | قواعد أحادية فقط (`emergency_lockdown` بذرة تفاعلية) |
| **كشف الخمول** (غياب نشاط) | Verkada inactivity | `machine_idle` مؤجّلة فقط |
| **وكيل AI يعقل + يلخّص** | Spot AI/Ambient/Verkada | VLM لكل حدث — لا وكيل مستمر ولا ملخّص تشغيلي سردي |
| **الردع الصوتي الذكي** | Verkada Deterrence | مذكور roadmap، غير مبني |
| **عبور المركبات / مسار المركبات** | Verkada vehicle line-crossing | `entry_exit_count` للأشخاص فقط |
| **خط زمني موحّد للحادثة** (تجميع أحداث) | الكل | أحداث منفردة، لا تجميع في "حادثة" |
| **إعادة تعرّف عبر الكاميرات (re-ID)** | Verkada/Genetec/Ambient | لا (embeddings Frigate بذرة) |

### 13.3 المزايا الجديدة المقترحة (مرتّبة قيمة×جهد، كلها تُبنى على VDE)
1. **تنبيهات مركّبة (`compound_alert`)** — قيمة عالية/جهد منخفض. موديول VDE ميتا: يُطلق فقط
   عند تحقق N شروط ضمن نافذة زمنية (شخص+منطقة+بلا PPE؛ سلاح+حشد). يعمّم `emergency_lockdown`.
2. **كشف الخمول (`inactivity`)** — عالية/منخفض. قاعدة: صفر كشف أشخاص في منطقة لـ N دقيقة →
   تنبيه (حارس ترك موقعه، كاش غير مأهول، خط توقّف). يحلّ `machine_idle` صحيحاً.
3. **بحث الأحداث بلغة طبيعية عربية (`nl_search`)** — تمايز عالٍ/جهد متوسط. صندوق بحث في
   اللوحة: "أرِني كل دخول للمخزن بعد المغرب" → Claude يحوّله لفلتر مُهيكل على `events`
   (feature_key/zone/time) ثم دلالي على اللقطات (embeddings موجودة). **عربي = لا منافس محلي.**
4. **مساعد Veedon — ملخّص تشغيلي سردي (`ops_brief`)** — عالية/متوسط. LLM يلخّص يوم/أسبوع
   الفرع سرداً عربياً + توصيات + مقارنة الفروع (leaderboard). ينافس وكلاء Spot AI/Ambient.
5. **الردع الصوتي الذكي (`ai_deterrence`)** — عالية عرضياً/متوسط. عند تسكّع/اقتحام: VLM يصف
   المشهد ("شخص بجاكيت أسود قرب الباب الخلفي") → رسالة صوتية عربية متصاعدة عبر مكبّر/PA.
6. **عبور المركبات (`vehicle_crossing`)** — متوسطة/منخفض. COCO يكشف car/truck + خط عبور
   (درايف‑ثرو، رصيف تحميل، مواقف). عائلة مركبات جديدة.
7. **خط زمني موحّد للحادثة (`incident_timeline`)** — متوسطة/متوسط. تجميع أحداث متقاربة
   (زمن/كاميرا/شخص) في "حادثة" واحدة بملخّص — أخفّ من re-ID الكامل.
8. **إعادة التعرّف عبر الكاميرات (re-ID)** — عالية/عالٍ. تتبّع شخص عبر كاميرات الفرع
   (embeddings Frigate أساس). **roadmap متأخّر** — ثقيل.
9. **دعم مسرّعات (`accelerator`)** — تشغيلي/منخفض. تهيئة detectors لـ OpenVINO(iGPU)/Hailo/
   Jetson حسب العتاد (stack 2026 الموصى: Hailo بالكاميرا + Orin بالحافة). تهيئة في render.

### 13.4 الأثر على خارطة الطريق
- **المرحلة القريبة (تُبنى على VDE فوراً):** `compound_alert` + `inactivity` + `vehicle_crossing`
  — كلها موديولات/قواعد صغيرة عالية القيمة تسدّ فجوات Verkada 2026 مباشرة.
- **التمايز الاستراتيجي:** `nl_search` عربي + `ops_brief` — هما ورقة "وكيل AI عربي" التي لا
  يملكها منافس محلي؛ أولوية تسويقية قصوى.
- **عرض المبيعات:** `ai_deterrence` (وقاية قبل الحدث) — أقوى عرض حي بعد التنبيه بالصورة.
- **تحذير سوقي:** نزول Presight (G42) للسعودية عدواني — خندقنا يبقى: **SMB + عربي + امتثال
  البلدية/SFDA/التعليم + كاميرات قائمة + تسعير بالريال**. نسرّع بناء dataset + شبكة الموزّعين.

**قرار معماري:** كل مزايا 2026 أعلاه تنزل كموديولات/قواعد في **VDE** (المحرك المعياري) أو
كقدرات سحابية (`nl_search`/`ops_brief`) — لا حاجة لإعادة بناء؛ البنية التي أنجزناها تستوعبها.

### 13.5 ما نُفّذ فعلاً (2026-07-05) — 8 من 9 مبنية ومُختبرة ✅
| الميزة | أين | الحالة |
|---|---|---|
| `compound_alert` تنبيه مركّب | VDE (`Compound` + fan-out في المحرك) | ✅ مُختبر |
| `inactivity` كشف الخمول | VDE (`Inactivity`, always_run + جدولة) | ✅ مُختبر |
| `vehicle_crossing` عبور مركبة | VDE (`VehicleCrossing`) | ✅ مُختبر |
| `nl_search` بحث عربي طبيعي | سحابة (`insights.py`, Claude + بديل قواعدي) | ✅ مُختبر |
| `ops_brief` مساعد Veedon | سحابة (`insights.py`, سرد + توصيات) | ✅ مُختبر |
| `incident_timeline` خط زمني موحّد | سحابة (`group_incidents`) | ✅ مُختبر |
| `ai_deterrence` ردع صوتي ذكي | vlm (قالب توليد رسالة) + كتالوج | ✅ (PA = خطوة عتاد) |
| `accelerator` مسرّعات | `render_engine_config` (`VEEDON_DETECTOR_TYPE`) | ✅ |
| re-ID عبر الكاميرات | — | 🔜 roadmap (ثقيل — يحتاج مطابقة embeddings) |

الكتالوج الآن **77 ميزة**؛ مزايا VDE الجديدة يتخطّاها منطق الوكيل ويستضيفها المحرك
(`vde_runner.VDE_KEYS`). كل الفحوص تمرّ (P1/P2/OTA/2026 + runner + rule_mode + insights).

**دمج اللوحة:** صفحة `/insights` ([Insights.tsx](../local-db-version/src/pages/Insights.tsx)) —
بحث بلغة طبيعية عربية + مساعد Veedon (ملخّص أسبوعي) + منتقي فرع؛ تستدعي بوابة `insights`.
مُتحقَّق: الصفحة تعرض بالمتصفح ببيانات فروع حقيقية، والنقاط الثلاث ترجع من القاعدة الحيّة
(search=200 حدث، brief=سرد عربي، incidents=تجميع). العرض في الشريط الجانبي «بحث ومساعد».

### 13.6 re-ID عبر الكاميرات — مبني ومُختبر ✅ (2026-07-05)
9 من 9 من مقترحات 2026 اكتملت. **إعادة التعرّف عبر الكاميرات** (`cloud/api/app/reid.py`):
- نموذج **OSNet ONNX (MIT)** `veedon-reid-v1` من `anriha/osnet_x0_25_msmt17` (885KB، 512-بُعد).
- الاستدلال على السحابة (كنمط VLM): لقطة الحدث → أكبر قصاصة شخص (YOLO) → متجه OSNet
  مطبَّع L2 → تخزين في `reid_embeddings` (هجرة رسمية) — يُفهرَس خلفياً عند تفعيل ميزة `reid`.
- `GET /api/insights/track/{event_id}` → مطابقة **جيب التمام** عبر كاميرات الفرع ضمن نافذة
  زمنية → **مسار الشخص** (خط زمني بصري موحّد عبر الكاميرات).
- **مُختبر:** متجه 512-بُعد حقيقي من لقطة (norm=1، تشابه ذاتي=1)، و`build_track` طابق
  الكاميرتين لنفس المظهر واستبعد المختلف. الكتالوج الآن **78 ميزة**.
- **مسار الترقية للنطاق الكبير:** pgvector + `vector(512)` + فهرس ivfflat (المطابقة حالياً
  في التطبيق على نافذة محدودة — كافٍ لفرع، موثّق في الهجرة).

**تمّت كل مقترحات بحث 2026 التسعة.** (VDE: مركّب/خمول/مركبات · سحابة: بحث NL/مساعد/حوادث/re-ID · vlm: ردع · تشغيل: مسرّعات.)

---

## 14. بحث تنافسي خامس (أواخر 2026) — الوكيل المستقل + الإنذار المؤكَّد

> مسح ISC West 2026 + إطلاقات Q1–Q2 2026. الموجة الجديدة: **وكيل أمني مستقل يعقل
> مقابل SOP وينفّذ**، و**احتمالية الإنذار الحقيقي (True Alarm)** لخفض الإنذارات الكاذبة
> 90–95%. عندنا معظم اللبنات (VLM/قواعد/ردع/insights/re-ID) — ينقص **طبقة التنسيق والثقة**.

### 14.1 ما الجديد عند المنافسين
- **Hakimo AI Operator** (تمويل $10.5M): يراقب أي بثّ، **يكشف أي شيء يُوصف بالكلمات**،
  يعقل عبر SOP، يُطلق تحذيراً صوتياً ويصعّد، إنسان عند الضرورة فقط؛ **True Alarm Probability**.
- **Motorola 'Operator'/'Inform'**: توحيد فيديو+دخول+مستشعرات لتنسيق استجابة الحوادث.
- **Coram 'Discover'**: نماذج أساس على الجهاز تفهرس **كل إطار** → بحث بثوانٍ عبر مئات الكاميرات.
- **Alpha Vision**: خوارزميات قابلة للتخصيص + استعلام بلغة طبيعية + تقارير آلية.
- **Actuate/Arcadian/EyeQ**: **فلترة الإنذارات الكاذبة 60–95%** + تحقّق بشري (verified alarm)
  + تصعيد متدرّج (voice-down → إرسال بأدلة). السوق كله تحوّل لهذا المقياس.
- **محلي (SDAIA/رؤية 2030)**: **نفاذ** (هوية رقمية عبر 530+ منصة، MFA، كشف احتيال)، أبشر،
  توكلنا — بنية ثقة وطنية لم يربطها منافس بالمراقبة للـSMB.

### 14.2 فجوات عندهم وليست عندنا
| الفجوة | عندهم | عندنا |
|---|---|---|
| **احتمالية الإنذار الحقيقي** (True Alarm score) | Hakimo/Actuate | severity فقط + مراجعة بشرية |
| **تصعيد مؤكَّد + SOP آلي** (tiered escalation) | الكل | تنبيه واحد؛ لا playbook متدرّج |
| **كشف مفتوح المفردات** ("صف أي شيء بالكلمات") | Hakimo/Alpha | قوالب VLM ثابتة لكل ميزة |
| **ربط الهوية الوطنية (نفاذ/توكلنا)** | — (لا أحد للـSMB) | مذكور، غير مبني |
| فهرسة كل إطار (Discover) | Coram | بحث دلالي/أحداث فقط |

### 14.3 المقترحات (مرتّبة قيمة×جهد)
1. **`custom_vlm` — «اكشف أي شيء تصفه بالكلمات»** ⭐ (جهد منخفض): ميزة VLM يكتب الأدمن
   نصّها (مثال «شخص يتسلّق السور»، «سائل مسكوب قرب المدخل») → VLM يراقبها. يعمّم مزايانا
   ويطابق Hakimo/Alpha «detect anything in words». يُبنى على مسار `/analyze` القائم.
2. **درجة الإنذار الحقيقي + تصعيد مؤكَّد (SOP)** ⭐⭐ (جهد متوسط، **يهاجم خطرنا #1**):
   - `true_alarm_score` لكل حدث = حكم VLM + ثقة النموذج/القاعدة + تاريخ المراجعة.
   - **محرك تصعيد** سحابي: كشف → (تحقّق VLM) → تنبيه Tier‑1 واتساب → إن لم يُؤكَّد خلال N
     دقيقة → Tier‑2 + ردع صوتي → إرسال بأدلة. autonomous مع إقرار بشري. يخفض الإنذارات
     الكاذبة ويضاعف سعة المراقبة (نمط Actuate/Hakimo).
3. **مساعد Veedon → «مشغّل Veedon» المستقل** (سرد تجاري): (1)+(2)+`ops_brief`+`ai_deterrence`
   في حلقة وكيل واحدة تعقل مقابل SOP الفرع وتنفّذ — نفس فئة Hakimo/Motorola Operator بالعربية.
4. **ربط نفاذ/توكلنا** (تمايز سعودي، يحتاج onboarding حكومي): تحقّق المصرّح لهم + إشعار أولياء
   الأمور/الجهات عبر منصة وطنية. البنية (ويب-هوك) جاهزة؛ ينقص الوصول الرسمي — شراكة.
5. **فهرسة كل إطار (Discover)** / اتحاد VMS متعدد المناطق — خيارات نطاق كبير (roadmap).

### 14.4 الأثر
- **القريب (يُبنى الآن):** `custom_vlm` + `true_alarm_score` + محرك التصعيد — يسدّان فجوة
  2026 المركزية (الوكيل المستقل + الإنذار المؤكَّد) ويقوّيان أضعف نقطة (الإنذارات الكاذبة).
- **التسويق:** إعادة تأطير المساعد كـ«مشغّل Veedon» — فئة الوكلاء المستقلين، بالعربية، للـSMB.
- **المحلي:** نفاذ/توكلنا خندق سعودي حقيقي — أولوية شراكة حكومية.
- **القرار المعماري:** كلها تنزل على البنية القائمة (VDE + `/analyze` + insights) — لا إعادة بناء.

**التحذير السوقي مستمر:** Presight (G42) وموجة الوكلاء المستقلين تتحرّك بسرعة؛ خندقنا يبقى
**SMB + عربي + امتثال محلي + كاميرات قائمة + تسعير بالريال + إدارة كاملة عن بُعد**.

### 14.5 ما نُفّذ (2026-07-05) — الوكيل المستقل + الإنذار المؤكَّد ✅
- **`custom_vlm` — «اكشف أي شيء تصفه بالكلمات»**: ميزة VLM يكتب الأدمن نصّها في الإعداد؛
  `/api/device/analyze` يقرأ النص من إعداد الكاميرا ويمرّره لـ`analyze_frames(prompt_override)`.
  يطابق Hakimo/Alpha «detect anything in words» — بلا تغيير في الحافة (نفس مسار VDE).
- **درجة الإنذار الحقيقي + محرك التصعيد** (`escalation.py`):
  - `true_alarm_score` (0..1) = 0.45·ثقة الكشف + 0.30·حكم VLM + 0.25·نسبة التأكيد التاريخية؛
    تُحسب لكل حدث high (قاعدة أو VLM) وتُخزَّن في `meta.true_alarm_score`.
  - **SOP متدرّج** (`due_action`): Tier‑1 فوري → Tier‑2 بعد 5د بلا إقرار → Tier‑3 (إرسال بأدلة)؛
    خيط خلفي يفحص كل دقيقة، والإنذارات دون 0.4 **لا تُصعَّد** (خفض الكاذب).
  - **إقرار** `POST /api/insights/ack/{event_id}` يوقف التصعيد (نمط verified alarm).
- **مُختبر:** الدوال النقية (score=0.835، تدرّج المستويات، custom prompt يُستخدم) + استيراد السحابة
  + إقلاع البوابة مع الخيط + `/ack` حيّ (reviewed=true, ack=true). الكتالوج الآن **79 ميزة**.
- **السرد التجاري:** المساعد + custom_vlm + الدرجة + التصعيد + الردع = **«مشغّل Veedon» المستقل**
  (فئة Hakimo/Motorola Operator) بالعربية للـSMB. 🔜 يتبقّى: تخصيص SOP لكل فرع + ربط نفاذ/توكلنا (شراكة).

**دمج اللوحة (2026-07-05):** درجة الإنذار الحقيقي (🎯%) + زر «إقرار» (verified alarm) في
**صفحة الأحداث** و**EdgeDevicePanel** (عرض حيّ على أحداث veedon-edge). **محرّر SOP لكل فرع**
([BranchSopEditor](../local-db-version/src/components/branches/BranchSopEditor.tsx)):
حدّ الثقة الأدنى + مدد Tier‑1/2/3 → `GET/PUT /api/insights/sop/{branch}` (عمود `branches.sop`،
هجرة رسمية). **مُثبت حياً:** المحرّر يُحمّل ويحفظ، والإقرار يوقف التصعيد. الكتالوج 79 ميزة.

---

## 15. بحث سادس (أواخر 2026) — GitHub/HuggingFace + فجوات جديدة

> مسح للمصادر المفتوحة والمنافسين. **مبشّر تنافسياً:** مشاريع open-source تؤكّد صحّة
> معماريتنا (منصّة مهارات + بحث NL). لكن ظهرت **4 فجوات عالية القيمة** أغلبها يقوّي
> ورقة الخصوصية السعودية (PDPL) — أقوى خنادقنا.

### 15.1 المصادر المفتوحة (تأكيد المعمارية + نماذج جديدة)
- **DeepCamera (SharpAI)**: «منصّة مهارات كاميرا AI» — مهارات قابلة للتوصيل، VLM محلي
  (Qwen/SmolVLM/LLaVA)، وكيل **يتذكّر**، تنبيهات **Telegram/Discord/Slack**. = فكرة VDE+insights.
- **OpenNVR**: طبقة محوّلات AI plug-and-play + بحث NL. = VDE.
- **SmolVLM2-Video (Apache, ONNX)** [`HuggingFaceTB/SmolVLM2-500M/256M-Video-Instruct`]: VLM
  **فيديو صغير جداً** (256M/500M) — مثالي لخيار الرؤية المحلية (خصوصية) على صندوق الحافة.
  فرع مضبوط للمشاعر متاح أيضاً. **توصية: اعتماده كنموذج الرؤية المحلي الافتراضي (بديل Qwen2.5-VL الأثقل).**

### 15.2 فجوات عندهم وليست عندنا
| الفجوة | عندهم | عندنا |
|---|---|---|
| **تعتيم الوجوه/الأشخاص في الأدلة** (PDPL/GDPR) | Facit/Sighthound/SecureRedact | نمنع التعرّف فقط — لا **تعتيم** فعلي |
| **الدخول التطفّلي (tailgating/piggybacking)** | Alcatraz/Coram/IntelliSee | لا |
| **تنبيهات متعددة القنوات** (Telegram/Slack/Teams/Webhook) | DeepCamera/الكل | واتساب فقط |
| **الصوت كدليل تصعيد** (طلقات/زجاج/عدوانية صوتية) | Sound Intelligence/Ambient/Axis | `audio_detection` خام، غير مربوط بالتصعيد |
| معيار التحقّق (TMA AVS‑01/verified response) | IntelliSee | لدينا SOP+درجة — ينقص حزمة إنذار مؤكَّد قياسية |

### 15.3 المقترحات (مرتّبة قيمة×جهد)
1. **تعتيم الوجوه/الأشخاص (`privacy_redaction`)** ⭐⭐ — **خندق PDPL سعودي**: نعيد استخدام كشف
   الشخص (YOLO الموجود لـ re-ID) لتعتيم مناطق الأشخاص/الوجوه في اللقطات/الأدلة قبل التخزين/التصدير.
   يحوّل شعار «لا تعرّف على الوجوه» إلى **ميزة امتثال فعّالة** — حاسم للمدارس/الصحة.
2. **الدخول التطفّلي (`tailgating`)** ⭐ — موديول VDE/قاعدة: عدّ الأشخاص العابرين منطقة بوابة
   خلال نافذة قصيرة؛ إن > المسموح (عادة 1) → تنبيه (بلا تعرّف وجوه — يطابق NIST). قيمة عالية
   للبوابات/مراكز البيانات/المدارس.
3. **تنبيهات متعددة القنوات (`notifier` عام)** ⭐ — Telegram/Slack/Teams/Webhook بجانب واتساب.
   جهد منخفض، يوسّع الوصول ويطابق معيار الصناعة.
4. **الصوت كدليل تصعيد** — ربط أحداث صوت المحرك (طلقات/زجاج/صراخ) بـ`true_alarm_score` و
   `compound_alert` (صوت+صورة) — رفع الثقة وتقليل الكاذب. نموذج صوت مخصّص لاحقاً (dataset).
5. **حزمة إنذار مؤكَّد قياسية** (AVS‑01) — إخراج مُهيكل (أدلة+خط زمني+درجة) للإرسال — يقوّي محرك التصعيد.

### 15.4 الأثر
- **القريب (يُبنى الآن):** `privacy_redaction` + `tailgating` + التنبيهات متعددة القنوات — كلها
  على البنية القائمة (كشف الشخص + مناطق Frigate + notifier). أولوية **تعتيم الخصوصية** (خندق PDPL).
- **التشغيلي:** SmolVLM2-Video كنموذج الرؤية المحلي الافتراضي (خصوصية قصوى، خفيف).
- **القرار المعماري:** لا إعادة بناء — كلها موديولات/قدرات فوق ما أنجزناه.

**تأكيد تنافسي:** DeepCamera/OpenNVR (open-source) يثبتان أننا على المسار الصحيح (منصّة مهارات
+ بحث NL + وكيل)؛ تفوّقنا يبقى **عربي + امتثال سعودي (PDPL/بلدية/تعليم) + تعتيم خصوصية +
كاميرات قائمة + إدارة كاملة عن بُعد**.

### 15.5 ما نُفّذ (2026-07-05) — خصوصية + متعدد القنوات + تطفّل ✅
- **`privacy_redaction` — تعتيم الوجوه/الأشخاص (خندق PDPL)**: `reid.redact(jpeg, mode)` يعيد
  استخدام كاشف الشخص (YOLO) لتعتيم مناطق الأشخاص (`persons`) أو الرؤوس (`faces`) في لقطة
  الحدث **قبل التخزين**. مفعّل لكل كاميرا (كتالوج)؛ `/events` و`/analyze` يعتّمان إن فُعّل.
  **مُختبر:** لقطة حقيقية → 30 شخصاً معتّماً، JPEG صالح مختلف عن الأصل. يحوّل «لا وجوه» إلى امتثال فعّال.
- **تنبيهات متعددة القنوات**: `notifier._channels` يبثّ لـ Telegram/Slack/Teams/Webhook (بمتغيّرات
  بيئة) بجانب واتساب — no-op آمن بلا مفاتيح. مُدمج في `send_alert` (يخدم التنبيه والتصعيد).
- **`tailgating` — دخول تطفّلي**: ميزة قاعدة (كثافة ≥2 على منطقة بوابة) عبر منطق `check_thresholds`
  القائم — بلا كود كشف جديد، بلا تعرّف وجوه (يطابق NIST). كتالوج جاهز.
- الكتالوج الآن **81 ميزة**. الاستدلال الثقيل (كشف/تعتيم) على السحابة كنمط VLM/re-ID.
- 🔜 التالي (roadmap): الصوت كدليل تصعيد + حزمة AVS‑01 + SmolVLM2-Video كنموذج محلي افتراضي.

### 15.6 معاينة التعتيم + الصوت كدليل تصعيد ✅ (2026-07-05)
- **معاينة تعتيم الخصوصية** (قبل/بعد) في `EdgeDevicePanel`: `GET /api/insights/redact_preview/{event}`
  ([RedactionPreview](../local-db-version/src/components/branches/RedactionPreview.tsx)) — نمطا
  persons/faces. **مُثبت بصرياً** (بطاقة قبل/بعد تعمل).
- **الصوت كدليل تصعيد**: المحرك ينشر `frigate/<cam>/audio/<label>` → VDE يوزّعه (`audio`) →
  كاشف `AudioAlert` (صراخ/زجاج/طلق) → **حدث أمني أول-درجة**. يُغذّي `compound_alert` (صوت+صورة)،
  و**يرفع `true_alarm_score` 0.15** لأحداث الفيديو المتزامنة على نفس الكاميرا (نمط verified alarm).
  ميزة كتالوج `audio_event`. **مُختبر** (توزيع + مسار MQTT الصوتي). الكتالوج الآن **82 ميزة**.

### 15.7 حزمة AVS-01 + الرؤية المحلية SmolVLM2 ✅ (2026-07-05)
- **حزمة الإنذار المؤكَّد (AVS-01)** (`escalation.verified_package` + `GET /api/insights/verified/{event}`):
  إخراج مُهيكل للإرسال — مستوى AVS-01 (0..4) من (الدرجة + دليل صوتي + أحداث مترابطة + تحقّق بشري)
  + خط زمني للأدلة + توصية (monitor/verify/dispatch). **مُختبر حياً** (level 2، حدثان مترابطان،
  توصية verify). يطابق معيار TMA AVS-01/verified-response 2026.
- **الرؤية المحلية SmolVLM2-Video** ([docs/LOCAL-VLM.md](LOCAL-VLM.md)): توصية + إعداد تشغيل
  نموذج رؤية **يفهم الفيديو وصغير** (SmolVLM2 256M/500M، Apache) أو Qwen2.5-VL عبر vLLM/LM Studio
  **داخل المنشأة** — الصور لا تغادر المبنى (خصوصية PDPL). بلا تغيير كود (المسار OpenAI-compatible جاهز).

**اكتملت كل مقترحات بحوث 2026 (الخامس والسادس) — 14 ميزة/قدرة.** الكتالوج **82 ميزة**؛ طبقة
الإنذار المؤكَّد كاملة: درجة (مُعزَّزة صوتياً) → تصعيد SOP → إقرار → **حزمة AVS-01 للإرسال**.

---

## 16. بحث سابع (أواخر 2026) — من الأمن إلى الإيرادات + MCP

> بعد إغلاق فجوات الأمن بالكامل، ظهر **محوران جديدان حقيقيان** لم نبنِهما، وأحدهما
> يحوّل Veedon من «تكلفة أمنية» إلى **أداة إيرادات** لعملائنا الأساسيين (مطاعم/تجزئة).

### 16.1 المستجدّات
- **تحليلات الأعمال من الفيديو (BI)** — أهمّ تحوّل 2026: عدّ الزوّار الفريدين، **خرائط حرارية
  للمناطق**، **زمن المكوث (dwell)**، **معدّل التحويل**، تحليل الطوابير، اتجاهات — على الكاميرات
  القائمة. NRF: **73% من كبار التجار** يستخدمونها؛ ROI: تحويل +45%، إيراد مناطق +20%.
  «قضية المدير المالي لا قضية فريق الأمن.» (Agrex/JARVIS/V-Count/ARSA).
- **MCP (Model Context Protocol)** — معيار 2026 لوصول الوكلاء: خوادم MCP تُتيح لأي وكيل AI
  (Claude/Dify 132k★) استعلام الفيديو كأداة. مشاريع: `ai-vision-mcp`، سجل MCP الرسمي.
- **مفتوح المصدر يؤكّد مسارنا:** OpenNVR («وكيل سيادي على الجهاز، اكتشاف كاميرا صفر-تهيئة»)،
  DeepCamera (SmolVLM/YOLO26، Telegram/Discord) = فكرة VDE+insights. **لسنا متأخرين.**

### 16.2 فجوات (محوران جديدان)
| الفجوة | عندهم | عندنا |
|---|---|---|
| **تحليلات تشغيلية/BI** (footfall/dwell/heatmap/تحويل/اتجاهات) | الكل (retail) | عدّ خام فقط (entry/queue) — لا لوحة تحليلات |
| **خادم MCP** (وصول وكلاء AI للفيديو كأداة) | ai-vision-mcp/Dify | نقاط insights موجودة — بلا غلاف MCP |

### 16.3 المقترحات
1. **لوحة التحليلات التشغيلية (`analytics`)** ⭐⭐ — **يحوّل الأمن إلى إيراد**: من عدّاداتنا
   القائمة (entry_exit/queue/occupancy) + كشف الأشخاص → **عدّ زوّار فريد، زمن مكوث، خريطة
   حرارية للمناطق، معدّل تحويل، اتجاهات ساعية/يومية، ذروة الطوابير**. نقطة `/api/insights/analytics`
   + صفحة لوحة. **أقوى ورقة تجارية لمطاعمنا وتجزئتنا** (قضية المدير المالي). يُبنى على الموجود.
2. **خادم MCP لـ Veedon (`mcp`)** ⭐ — يغلّف insights كأدوات MCP: «كم شخصاً في فرع X الآن؟»،
   «حوادث اليوم»، «مسار هذا الشخص»، «ملخّص الأسبوع». يجعل Veedon **منصّة يستعلمها أي وكيل AI**
   (Claude/Dify) — معيار تكامل 2026. نعيد استخدام نقاط insights الجاهزة.
3. **تنبيهات ذكية على الاتجاهات** — «طوابير أطول 30% عن أمس»، «إشغال ذروة» — من `analytics`.

### 16.4 الأثر
- **تجاري (الأهم):** لوحة التحليلات تفتح **قيمة إيرادية** لمطاعمنا/تجزئتنا (شريحتنا الأولى) —
  تبرّر اشتراكاً أعلى وتقصّر دورة البيع (المدير المالي يوقّع على زيادة التحويل، لا الأمن فقط).
- **تقني:** MCP يضع Veedon في نظام وكلاء 2026 — تكامل مع Claude/مساعدي العملاء.
- **القرار المعماري:** كلاهما **فوق البنية القائمة** (عدّادات + insights) — لا إعادة بناء ولا كشف جديد.

**تأكيد الخندق:** open-source (OpenNVR/DeepCamera) يثبت صحّة معماريتنا؛ تفوّقنا يبقى **عربي +
امتثال سعودي + خصوصية + إنذار مؤكَّد + الآن قيمة تشغيلية/إيرادية** — لا منافس محلي يجمعها للـSMB.

### 16.5 ما نُفّذ (2026-07-05) — لوحة التحليلات + خادم MCP ✅
- **لوحة التحليلات التشغيلية (BI)** (`app/analytics.py` + `GET /api/insights/analytics/branch/{id}`):
  من الأحداث القائمة → **إجمالي الزوّار (footfall) · اتجاه اليوم مقابل المتوسط · خريطة حرارية
  زمنية (يوم×ساعة) · ساعة الذروة · أنشط المناطق · ذروة الطوابير · إشغال + تقدير مكوث (قانون ليتل)**.
  صفحة `/ops-analytics` ([OpsAnalytics.tsx](../local-db-version/src/pages/OpsAnalytics.tsx)) —
  **مُثبتة حياً** (KPIs + خريطة حرارية ملوّنة + footfall يومي على بيانات فرع). **يحوّل الأمن إلى قيمة إيرادية.**
- **خادم MCP لـ Veedon** (`cloud/api/mcp_server.py`, FastMCP): **6 أدوات** يستعلمها أي وكيل AI —
  `list_branches · branch_analytics · search_events(عربي) · ops_brief · recent_incidents ·
  verified_alarm(AVS-01)`. يعيد استخدام منطق insights. **مُختبر** (6 أدوات مُسجّلة + نداء حيّ).
  يضع Veedon في نظام وكلاء 2026 (Claude/Dify).

**اكتمل محورا البحث السابع.** الكتالوج **82 ميزة**؛ Veedon الآن: كشف→عقل→تحقّق→استجابة→**قيمة تشغيلية+MCP**.
