Home/Hire/نظام تسجيل الحضور بالـ QR

Case Study · 2024–الآن

Node.jsReact.jsPostgreSQLRedisDockerQRلوحة تحكم للمدير

نظام تسجيل الحضور بالـ QR

نظام متكامل · هندسة الأداء (Performance Engineering)

+2000مستخدم نشط يومياً

The Problem

كانت إحدى الجامعات بحاجة إلى تتبع حضور آلاف الطلاب عبر 7 كليات مختلفة. كانت العملية الحالية يدوية — دفاتر ورقية، وجداول بيانات، وإهدار كبير لوقت المحاضرين. كان على النظام الجديد أن يتعامل مع ذروة الاستخدام عندما يقوم مئات الطلاب بمسح الكود في نفس اللحظة بداية المحاضرة، وأن يعمل على أي هاتف بدون تطبيق، ويوفر للإدارة لوحة تحكم لعرض وتصدير السجلات، وأن يبقى متاحاً بنسبة 100% خلال ساعات العمل.

The Solution

صمم حامد وبنى نظاماً متكاملاً يعتمد على الـ QR. يمسح الطلاب كود QR المعروض في القاعة — يفتح في المتصفح، يسجل حضورهم فوراً، ثم يُغلق. كل كود QR محدد بوقت قصير لمنع الغش والمشاركة. يسجل المحاضرون والمديرون الدخول إلى لوحة تحكم لرؤية السجلات، وإنشاء التقارير، وإدارة النظام. وفي الواجهة الخلفية، بنى حامد مسار تحقق هجين: فحوصات سريعة في الذاكرة (In-memory) للسرعة، وتأكيد من قاعدة البيانات للدقة، مع آلية احتياطية (Fallback) في حالة تعطل أي جزء. تمت إضافة التخزين المؤقت (Redis) لتقليل الحمل على قاعدة البيانات بشكل كبير في أوقات ذروة الاستخدام.

Technologies Used

  • Node.js + Express.js (واجهة الـ API الخلفية)
  • React.js (واجهة المستخدم للطلاب)
  • React.js + لوحة تحكم (لوحة تحكم الكادر الجامعي)
  • PostgreSQL (قاعدة بيانات الطلاب وسجلات الحضور)
  • Redis (طبقة التخزين المؤقت للتعامل مع ضغط الزوار)
  • Docker (نشر النظام عبر الحاويات)
  • JWT (رموز QR مشفرة ومؤقتة)
  • Opossum (نمط قاطع الدائرة Circuit Breaker لضمان 99.9% عمل متواصل)

Results

تخفيض وقت الاستجابة 98%

انخفض وقت استجابة الـ API من 94.91ms إلى 1.53ms فقط بعد تطبيق Redis وتحسين الاستعلامات.

+6100% زيادة في معدل النقل

يتعامل النظام الآن مع 653 طلباً في الثانية — قادر على معالجة مسح مئات الطلاب للكود في نفس اللحظة.

+2000 مستخدم يومياً

يعمل النظام حالياً بشكل يومي للطلاب والكادر التعليمي في 7 كليات.

99.9% وقت عمل متواصل

يضمن نمط قاطع الدائرة (Circuit Breaker) استمرار النظام في العمل حتى إذا واجهت خدمة خلفية معينة مشاكل.

~85% تغطية الاختبارات

مجموعة اختبارات شاملة تغطي مسارات التحقق، وسيناريوهات الفشل، والحالات الشاذة.

إصلاح +15 ثغرة أمنية

التقط الفحص الأمني (SAST/DAST) أكثر من 15 مشكلة وتمت معالجتها قبل إطلاق النظام الفعلي.

What This Proves

هذا نظام حقيقي يعمل يومياً للطلاب وأعضاء هيئة التدريس في جامعة توقات غازي عثمان باشا، بتركيا، وليس مجرد نموذج تجريبي.

إذا كنت بحاجة إلى نظام حضور لمدرستك، أو شركتك، أو لفعالية تنظمها — حامد يستطيع بناءه لك.