أجهزة الاستشعار وسلسلة التبريد: كيف يعمل
يستقبل قسم أجهزة الاستشعار وسلسلة التبريد القراءات من أجهزتك (مسجّلات الثلاجات والمجمّدات والغرف، ومقاييس خزانات الوقود) عبر API بمفتاح لكل جهاز، ويُطلق تنبيهًا في التطبيق وبالإشعار الفوري وبالبريد الإلكتروني عندما تبقى قراءة خارج نطاقها أو يصبح جهاز صامتًا، ويعرض منحنى كل جهاز مع الحد الأدنى والحد الأقصى والمتوسط والوقت ضمن النطاق.
الدرس 5 من 12 · كيف يعمل
كيف يعمل
افتح أجهزة الاستشعار وسلسلة التبريد وأضف جهازًا برقمه التسلسلي (المعرّف الذي يرسله الجهاز). تحصل الثلاجة على النطاق 2–8 °C والمجمّد على −18 °C كحد أقصى فورًا؛ ويمكنك تغيير النطاقات من صفحة الجهاز.
في صفحة الجهاز اختر «Create key». يُعرض المفتاح مرة واحدة: أدخله في الجهاز أو في بوابته. ولا يمكنه سوى إرسال قراءات هذا الجهاز.
يرسل الجهاز إلى /api/v1/sensors/readings حتى 500 قراءة في كل طلب (درجة الحرارة أو الرطوبة أو مستوى الوقود أو أي رقم) مع الترويسة Idempotency-Key، حتى لا تُحتسب إعادة المحاولة مرتين أبدًا. يتضمن مركز المساعدة مثالًا باستخدام curl.
لكل نطاق مهلة تأخير: القراءة التي تبقى خارجه لمدة أطول من المهلة تفتح تنبيهًا، ويتلقاه أصحاب صلاحيات أجهزة الاستشعار في التطبيق وبالإشعار الفوري وبالبريد الإلكتروني. وعند العودة إلى النطاق يُغلق التنبيه ويُبلَّغون بذلك أيضًا. والجهاز الذي يبقى صامتًا لمدة أطول من الدقائق المحددة له يُطلق تنبيه «silent».
أقرّ بالتنبيه مع ملاحظة بما تم اتخاذه (نُقلت البضائع، أُغلق الباب). تبقى الملاحظة مع التنبيه لأغراض التدقيق.
تعرض صفحة الجهاز منحنى 24 ساعة أو 7 أيام أو 30 يومًا مع النطاق المسموح، والحد الأدنى والحد الأقصى والمتوسط، ونسبة الوقت ضمن النطاق، والتجاوزات.
تُحفظ القراءات الخام لعدد الأيام الذي تحدده (30 افتراضيًا) ثم تُلخَّص لكل ساعة، لتبقى الفترات الطويلة سريعة. ويمكن للجهاز أيضًا ملء سجل وحدة سلسلة تبريد في المخزون ← سلسلة التبريد تلقائيًا.
أين تجده
- Sensors & cold chain
/admin/sensors
إعدادات تغيّره
- Sensors & cold chain → Retention
/admin/sensors
قائمة التحقق
قبل أن تنتقل، تأكد أنك تستطيع:
- فتح Sensors & cold chain
- افتح أجهزة الاستشعار وسلسلة التبريد وأضف جهازًا برقمه التسلسلي (المعرّف الذي يرسله الجهاز).
- في صفحة الجهاز اختر Create key.
- يرسل الجهاز إلى /api/v1/sensors/readings حتى 500 قراءة في كل طلب (درجة الحرارة أو الرطوبة أو مستوى الوقود أو…
- لكل نطاق مهلة تأخير: القراءة التي تبقى خارجه لمدة أطول من المهلة تفتح تنبيهًا، ويتلقاه أصحاب صلاحيات أجهزة…
نصائح وأخطاء شائعة
- اضبط للنطاق مهلة تأخير من بضع دقائق حتى لا يُطلق فتح الباب للتحميل تنبيهًا.
- أخرج من الخدمة أي جهاز لم تعد تستخدمه: يتوقف مفتاحه فورًا وتبقى قراءاته.
- المفتاح الخاص بجهاز واحد هو الأكثر أمانًا؛ أما المفتاح العام ذو النطاق sensors:write فيجب أن يذكر الرقم التسلسلي للجهاز في كل عملية رفع.