CLARYEL Perimetroمشروع للنقاش
وثيقة تقنية · 3 من 3

الحل البرمجي

Home Assistant على الخادم المحلي: تطبيق واحد لأي هاتف أو جهاز لوحي أو متصفح، وصلاحيات محدودة، وتنبيهات تصل حتى عندما يكون الهاتف في الوضع الصامت.

Home AssistantAndroid · iPhone · متصفحصلاحيات حسب الدورتنبيهات حرجةكل شيء محليًا، مشفّر، بلا سحابة
1

ما اخترناه من مجموعتنا ولماذا

من المجموعة العاملة بالفعل على خادمنا المحلي، لا يلزم سوى بضعة عناصر. أما الباقي — تحليل الذكاء الاصطناعي، والأرشيف المشفّر، والتسجيلات — فيبقى خارج Home Assistant.

  1. 1

    Home Assistant

    المركز الوحيد للنظام: يستقبل أحداث المحيط، ويدير المستخدمين وصلاحياتهم، ويرسل التنبيهات إلى الهواتف. برنامج حر، يعمل محليًا على خادمنا.

  2. 2

    MQTT (Mosquitto)

    قناة الرسائل المحلية بين العُقد الميدانية (ESP32) وتحليل الذكاء الاصطناعي وHome Assistant. تنتقل الأحداث في رسائل نصية قصيرة، بدون صور.

  3. 3

    NUT (حالة UPS)

    ينقل حالة مصدر الطاقة الاحتياطي إلى Home Assistant: انقطاع الكهرباء أو تفريغ البطارية يتحول فورًا إلى تنبيه تقني.

  4. 4

    تطبيق Home Assistant Companion

    العميل الرسمي لأندرويد ولـ iPhone/iPad: عبره تصل التنبيهات وتُفتح لوحة المعلومات المعتمدة.

  5. 5

    WireGuard

    القناة المحمية التي خطط لها المشروع بالفعل للاتصال: عند الحاجة تتيح استخدام التطبيق خارج المبنى أيضًا، بدون اشتراكات سحابية.

يبقى خارج Home Assistant: تحليل الذكاء الاصطناعي والأرشيف المشفّر والتسجيلات تبقى على الخادم، ولا يستطيع التطبيق عرضها.
2

المخطط: من الخادم إلى العملاء، والأدوار والصلاحيات

نقطة الميدان

كاميرا أو وحدات Wi-Fi CSI، مع إشارة

الخادم المحلي

تحليل الذكاء الاصطناعي، والتشفير، والأرشيف، وUPS، والنسخ الاحتياطي للبيانات

Home Assistant

الأحداث، المستخدمون، الصلاحيات، التنبيهات

العملاء

تطبيق واحد أو المتصفح

  • Android
  • iPhone / iPad
  • متصفح (حاسوب)
  • جهاز لوحي

الأدوار والصلاحيات

كل شخص يرى المعتمد فقط

  • المسؤول التقني
  • شخص معيَّن
  • ساكن

يتلقى Home Assistant الحدث فقط (نص، وقت، جزء من السياج): لا صور ولا فيديو. ما ليس في Home Assistant لا يمكن رؤيته في التطبيق.

3

عميل واحد لأي جهاز

العميل هو تطبيق Home Assistant Companion الرسمي أو المتصفح فقط: اختر ما لديك.

  • Android

    تطبيق Home Assistant Companion من متجر التطبيقات: تنبيهات، ولوحة معلومات معتمدة، وإجراءات سريعة.

  • iPhone وiPad

    تطبيق Home Assistant Companion لنظامي iOS وiPadOS: تنبيهات، بما فيها الحرجة، ولوحة معلومات معتمدة.

  • متصفح على الحاسوب

    يكفي فتح عنوان Home Assistant: بدون تثبيت.

  • جهاز لوحي

    تطبيق أو متصفح؛ ومع مستخدم مخصص يمكن أن يبقى معلقًا على الحائط كلوحة دائمة، مثلًا عند المدخل.

يتم الوصول داخل الشبكة المحلية للمبنى أو، خارج المبنى، عبر قناة WireGuard المحمية. لا حاجة إلى اشتراك في Home Assistant Cloud.
4

الوصول بصلاحيات محدودة

يسجّل الجميع الدخول باسم المستخدم وكلمة المرور الخاصين بهم (مع التحقق بخطوتين إن كان مفعّلًا) ولا يرون إلا ما هو معتمد لدورهم. الأدوار أدناه اقتراح للنقاش.

  • مدير Home Assistant

    المسؤول التقني

    يضبط النظام والمستخدمين والأتمتة. حسابات قليلة، مع التحقق بخطوتين؛ ويمكن السماح بالوصول من الشبكة المحلية فقط.

  • مستخدم بدون صلاحيات المسؤول

    شخص معيَّن

    يتلقى الإنذارات مع أزرار إجراءات لتأكيد الحدث. أما الصور في الأرشيف فيسري عليها الإجراء المخصص للأشخاص المعيَّنين، مع سجل وصول.

  • مستخدم بدون صلاحيات المسؤول

    ساكن

    يتلقى التنبيهات (نصًا فقط) ويرى لوحة معلومات معتمدة بحالة النظام. لا وصول إلى الكاميرا أو الأرشيف أو الإعدادات.

من يستطيع فعل ماذاالمسؤول التقنيشخص معيَّنساكن
تلقي تنبيهات الإنذار
عرض حالة النظام (لوحة معلومات معتمدة)
تأكيد الحدث بأزرار الإجراءات
عرض صور الأرشيف (للأشخاص المعيَّنين فقط، مع سجل)
إدارة قائمة المستلمين وإعدادات التنبيهات
تغيير الإعدادات والمستخدمين والأتمتة

كيف يتحقق التقييد

  • لا يملك المستخدمون بدون صلاحيات المسؤول وصولًا إلى الإعدادات ولا يستطيعون إدارة المستخدمين والأجهزة والأتمتة ولوحات المعلومات.
  • يمكن حصر كل لوحة معلومات بالمسؤولين؛ ويُخصَّص للسكان لوحة معلومات منفصلة ومعتمدة.
  • لكل مستخدم يمكن السماح بالوصول من الشبكة المحلية فقط، ويمكن تفعيل التحقق بخطوتين.
  • يمكن فصل كل جهاز بإزالة رمز الوصول الخاص به من الملف الشخصي؛ ويمكن تعطيل حساب المستخدم.
  • أقوى حد هو الحد البنيوي: لا يوفّر Home Assistant في واجهته أذونات على مستوى كل جهاز، لذلك لا تدخل إليه إلا المعلومات المعتمدة (حدث الإنذار، حالة النظام، حالة UPS). أما الصور والأرشيف فتبقى خارجه.
5

تنبيهات تصل حتى عندما يكون الهاتف في الوضع الصامت

عند انتهاك خطير للمحيط يُرسَل التنبيه بوصفه حرجًا: وبالإعداد الموصوف أدناه يرنّ حتى عندما يكون الهاتف في الوضع الصامت ومع تفعيل «عدم الإزعاج»، أي عندما تكون جميع المكالمات الواردة محجوبة (مثلًا ليلًا).

شاشة القفل
03:12
الهاتف في الوضع الصامت«عدم الإزعاج» مفعّل
إنذارتنبيه حرج

تنبيه! تم رصد شخص في الجزء المراقَب من السياج.

iPhone
شاشة القفل
03:12
الهاتف في الوضع الصامت«عدم الإزعاج» مفعّل
إنذارalarm_stream

تنبيه! تم رصد شخص في الجزء المراقَب من السياج.

Android

مثال على الإعداد (من الوثائق الرسمية لـ Home Assistant Companion)

iPhone وiPad: تنبيه حرج

  • تظهر التنبيهات الحرجة (Critical Alerts) في iOS أعلى شاشة القفل فوق كل الإشعارات الأخرى وتُصدر صوتًا حتى مع تفعيل «عدم الإزعاج» أو مع وضع iPhone على الصامت.
  • ويمكنها أيضًا تجاوز حدود معدل إشعارات التطبيق.

1× مرة واحدة: في إعدادات iOS لتطبيق Home Assistant اسمح بالإشعارات، بما فيها التنبيهات الحرجة.

data:
  push:
    sound:
      name: "default"
      critical: 1
      volume: 1.0

Android: أولوية عالية وقناة إنذار

  • مع أولوية عالية ومدة صلاحية 0 يصل الإشعار فورًا، حتى لو كان الهاتف ساكنًا أو كانت شاشته مطفأة منذ وقت طويل.
  • باستخدام مجرى الصوت «المنبّه» (alarm stream) يرنّ الهاتف حتى في الوضع الصامت أو وضع الاهتزاز.

1× مرة واحدة: في إعدادات النظام للتطبيق افتح قناة الإنذار واسمح لها بتجاوز «عدم الإزعاج» (افتراضيًا لا تتجاوزه).

data:
  ttl: 0
  priority: high
  channel: alarm_stream

ما الذي ينبغي الانتباه إليه

  • صُمّم التنبيه ليصل حتى في الوضع الصامت، لكن لا يمكن ضمان التسليم المطلق: يجب أن يكون الهاتف قيد التشغيل ومتاحًا (شبكة بيانات أو Wi-Fi)، ويجب إجراء الإعداد لمرة واحدة على كل هاتف.
  • الرسالة نصية فقط، بدون صور أو فيديو أو بيانات شخصية.
  • عادةً يمر الإرسال إلى الهاتف عبر البنية التحتية للإشعارات الفورية لدى Apple أو Google، كأي تطبيق. وفي الشبكة المحلية للمبنى يتوفر أيضًا تسليم محلي (Local Push) عبر WebSocket، بعيدًا عن Apple وGoogle.
  • نوصي بتنبيه فحص دوري للتأكد في الوقت المناسب من أن أي هاتف لم يتوقف عن استقبال التنبيهات.
6

ليس المحيط وحده: تنبيهات مهمة أخرى

يمكن أن تحمل القناة نفسها رسائل مهمة أخرى بدرجات استعجال مختلفة. يُختار النغم والأولوية لكل مستوى.

  • حرج

    انتهاك خطير للمحيط: يرنّ دائمًا، حتى عندما يكون الهاتف في الوضع الصامت.

  • عاجل (تقني)

    انقطاع الكهرباء أو تفريغ بطارية UPS، فقدان الاتصال بنقطة الميدان، تعذّر الوصول إلى الخادم.

  • إعلامي

    حرارة أو رطوبة غير طبيعية أو تسرب ماء في الصندوق، ورسائل أخرى متفق عليها مع اتحاد الملاك. يجوز أن يبقى صامتًا.

في iOS يتجاوز المستوى «حرج» حتى الوضع الصامت، ويتجاوز «time-sensitive» (عاجل) أوضاع التركيز، أما «سلبي» فلا يوقظ حتى الشاشة.

كل شيء محليًا، مشفّر، بلا سحابة

يبقى التحليل والأرشيف والوصول على الخادم المحلي، بشكل مشفّر ودون خدمات سحابية. عند الإنذار يُغلق الوصول إلى الأرشيف فورًا، وتُحمى تسجيلات الحدث من التعديل والحذف، كما هو موصوف في المشروع.

✉

لديك أسئلة أو ملاحظات؟

اكتب إلينا: يسعدنا أن نجيب. يمكنك أيضًا استخدام نموذج المشروع.

الانتقال إلى نموذج المشروع

وثيقة مشروع للنقاش مع السكان وإدارة اتحاد الملاك: التنفيذ ممكن فقط بعد الحصول على الموافقات اللازمة.