دراسة حالة: دخول شخص واحد إلى الغرفة مع Server Approval
المتطلب
احتاج أحد العملاء الذي يدير غرفة مقيّدة الدخول (مثل غرفة خوادم أو خزنة أو مختبر) إلى قاعدة بسيطة وصارمة تُطبَّق عند الباب:
يُسمح لشخص واحد فقط بالتواجد داخل الغرفة في الوقت نفسه. ولا يُسمح للشخص التالي بالدخول حتى يسجّل الشخص الموجود حاليًا خروجه.
يتولى جهاز Cams التحقق من الهوية، وتوسّع ميزة Server Approval ذلك بإتاحة الفرصة لبرنامجك الخاص لإضافة منطق «هل يوجد أحد بالداخل بالفعل؟» فوق ذلك، ليقرر في الوقت الفعلي ما إذا كان المستخدم الذي تم التحقق منه يجب أن يُسمح له بالدخول فعلًا.
لماذا تناسب ميزة Server Approval هذه الحالة
افتراضيًا (عند تعطيل Server Approval)، يمنح الجهاز الدخول فور تحققه من المستخدم محليًا، ولا يعلم برنامجك بذلك إلا لاحقًا. هذا مقبول لمجرد التسجيل، لكنه لا يستطيع منع الدخول.
عند تفعيل Server Approval، يتوقف الجهاز بعد التحقق المحلي وينتظر تأكيد برنامجك للبصمة قبل أن يفتح الباب. هذه الدورة من الاتصال هي ما يتيح لك إدخال منطق العمل، مثل «هل يوجد أحد بالداخل بالفعل؟»، في قرار السماح بالدخول نفسه، بدلًا من تسجيله بعد وقوعه فقط.
كيف تعمل العملية
- يسجّل المستخدم بصمته على الجهاز.
- يتحقق الجهاز منه محليًا، ثم يرسل طلب JSON إلى عنوان callback URL المسجّل لديك.
- يفحص برنامجك حالة الإشغال لديه ويردّ:
{"status": "done"}→ يقبل الجهاز البصمة ويفتح الباب.{"status": "reject"}→ يرفض الجهاز الدخول ويُبقي الباب مغلقًا.
- عند تسجيل الخروج، يحدّث برنامجك حالة الإشغال ليُقيَّم تسجيل الدخول التالي بشكل صحيح.
مثال تطبيقي مع مستخدمين اثنين
المستخدم X يسجّل الدخول. يتحقق الجهاز من X ويرسل الاستدعاء الراجع، فيجد برنامجك أن الغرفة فارغة ويعيد done. يدخل X، ويضع برنامجك علامة الغرفة مشغولة.
المستخدم Y يحاول تسجيل الدخول بينما X ما زال بالداخل. يتحقق الجهاز من Y ويرسل الاستدعاء الراجع، تمامًا كأي بصمة أخرى. يرى برنامجك أن الغرفة ما زالت مشغولة ويعيد reject. يرفض الجهاز Y ويبقى الباب مغلقًا. ولن يُسمح لـ Y بالدخول إلا عندما يأذن برنامجك بذلك.
X يسجّل الخروج. يسجّل برنامجك الخروج ويزيل علامة الإشغال.
Y يحاول مرة أخرى. المسار نفسه للاستدعاء الراجع، لكن برنامجك يرى هذه المرة أن الغرفة خالية ويعيد done. يدخل Y.
لا يتغير دور الجهاز أبدًا، فهو يتحقق من الشخص دائمًا ثم يسأل برنامجك عمّا يجب فعله بعد ذلك. أما الأمر الوحيد الذي يفرّق بين «reject» و«done» فهو ما يعرفه برنامجك عمّن هو بالداخل حاليًا.
ملاحظات التنفيذ
- فحص الإشغال مسؤوليتك بالكامل، فالجهاز لا يحتفظ بأي معلومة عمّن هو بالداخل. يكفي علم بسيط أو سجل لكل غرفة في حالة الغرفة ذات الإشغال الفردي، أما الإعدادات التي تضم عدة غرف أو سعات متعددة فتحتاج إلى جدول حالة صغير مفهرس حسب الغرفة/الجهاز.
- احرص على التقاط أحداث تسجيل الخروج بشكل موثوق، لأن فوات تسجيل خروج واحد سيُبقي الغرفة مقفلة بشكل دائم حتى بعد مغادرة المستخدم.
- اختبر مسار الاستدعاء الراجع محليًا قبل الإطلاق الفعلي، وراجع دليلنا المرافق حول اختبار الاستدعاءات الراجعة لـ Cams API محليًا باستخدام أدوات النفق لإعداد ngrok/Cloudflare Tunnel/localhost.run مع بيئة التطوير لديك.
ما يجب التخطيط له: الاتصال وردود الاستدعاء الراجع
تعتمد ميزة Server Approval على اتصال مباشر ذهابًا وإيابًا بين الجهاز وخادمك، وعلى أن يرد خادمك دائمًا بشكل صحيح. وهناك حالتان تستحقان أن تضعهما في الحسبان عند التصميم:
الجهاز غير متصل. لا يستطيع إرسال استدعاء التحقق الراجع في الوقت الفعلي، وبالتالي لا تتاح لبرنامجك فرصة الرد بـ done أو reject. يعرض الجهاز رسالة «Disconnected» ويرفض البصمة تمامًا، ولا يعود إلى السماح بالدخول محليًا فقط.
يعيد الاستدعاء الراجع لديك شيئًا غير {"status": "done"} أو {"status": "reject"}. يعلق الرد غير الصالح أو غير المتوقع في قائمة الانتظار، ولن يرسل الجهاز أي بيانات بصمات لاحقة إلى الاستدعاء الراجع لديك إلى أن تُحل المشكلة، فيبقى الباب مغلقًا، ليس لذلك المستخدم فقط بل لكل من يليه، إلى أن يبدأ الاستدعاء الراجع بالرد بشكل صحيح من جديد.
بعبارة أخرى، لا يكون ضمان دخول شخص واحد في كل مرة أقوى من اتصال الجهاز بالشبكة وموثوقية ردود الاستدعاء الراجع لديك. وفي بيئات الإنتاج، ضع الأمرين في الاعتبار عند الإعداد، مثل استخدام الاتصال السلكي بدلًا من Wi-Fi أو التنبيه عند فترات انقطاع الاتصال الطويلة، مع تحقق صارم يضمن أن يعيد الاستدعاء الراجع دائمًا ردًّا سليم الصيغة من نوع done/reject، حتى في مسارات الأخطاء.
النتيجة
بعد تفعيل Server Approval وإضافة علم إشغال بسيط في برنامج العميل، تم فرض شرط دخول شخص واحد في كل مرة بالكامل عبر إمكانات الجهاز الحالية، دون أي أجهزة إضافية ودون أي تغييرات على جانب الجهاز سوى تبديل إعداد واحد.