مشروع نظام حضور وانصراف GPS للموظفين

Smart Attendance هو نظام ويب متكامل لإدارة حضور وانصراف الموظفين، مبني على PHP وMySQL، ويعمل من المتصفح (PWA) مع واجهة API لتطبيقات الموبايل. المنصة: smart.aismisr.net — واجهة عربية RTL، المنطقة الزمنية Africa/Cairo.

نظرة عامة

الفكرة الأساسية: ربط تسجيل الحضور والانصراف بـ:

• الموقع الجغرافي (GPS) والإحداثيات
• نطاق جغرافي محدد (Geofence) حول الفرع أو نقطة العمل
• صورة selfie عند الحضور/الانصراف (حسب الإعدادات)
• تتبع حي للموقع أثناء الجلسة المفتوحة
• تقارير ولوحات مراقبة للإدارة

النظام مناسب للمؤسسات التي لديها فروع متعددة، موظفون ميدانيون (كشوفات، خط ساخن، توعية، كشف مخدرات...)، وحاجة لإثبات مكان الحضور وليس الوقت فقط.

المشاكل التي يحلها

الحضور التقليدي

• تسجيل ورقي أو بصمة بدون إثبات مكان → النظام يربط الحضور بإحداثيات GPS ونطاق جغرافي
• تلاعب بالحضور من مكان آخر → Geofence + selfie + سجل أحداث
• غياب رؤية لحظية → لوحة مراقبة + خريطة + حضور اليوم
• صعوبة التجميع الشهري → تقارير PDF قابلة للطباعة

الموظفون الميدانيون

• عمل في أكثر من موقع → دعم فروع متعددة ووصف مكان الحضور (place_note)
• جلسات متعددة يومياً → حدود قابلة للضبط لكل إدارة/فرع
• نطاق عمل مختلف → إعدادات Geofence لكل إدارة داخل الفرع

الخروج من نطاق العمل

• مغادرة دون إذن → رصد خروج خارج Geofence + تنبيهات + unauthorized_exits
• انصراف تلقائي بعد البقاء خارج النطاق → outside_auto_checkout_minutes
• انصراف تلقائي عند توقف GPS → gps_silence_auto_checkout_minutes

لوحة التحكم

لوحة التحكم الرئيسية تعرض مؤشرات KPI: نسبة الحضور، حضور اليوم، تقدم شهري، ورسوم بيانية لحركة الحضور خلال الأسبوع — مع تحديث حي (LIVE) وتبويبات للبطاقات التعريفية والخريطة والتحليلات.

المراقبة والخريطة الحية

شاشة مراقبة الموظفين تعرض بطاقات حالة (حاضر، انصراف، خارج نطاق، إذن خروج، متصل الآن) مع خريطة تفاعلية Leaflet/OpenStreetMap — وألوان توضح حالة كل موظف: أخضر حضور، أزرق انصراف، بنفسجي إذن، برتقالي خارج النطاق.

الخريطة الحية تعرض كل الفروع ونقاط الحضور على خريطة مصر — مع تحديث تلقائي للمواقع، عدّادات الفروع (17 فرعاً)، وحالات الحضور والانصراف لحظياً. يمكن تتبع مسار موظف (polyline من location_pings) مع polling حي وزر واتساب للتواصل.

شاشة تتبع موظف تعرض جلسة مفتوحة (LIVE) مع موقع الحضور على الخريطة، العنوان النصي من Geocoding، وقت الحضور، حالة الجلسة، وزر واتساب مباشر — مع إمكانية متابعة مسار GPS (location_pings) أثناء اليوم.

للموظف (PWA / ويب)

• Check-in مع GPS + دقة الموقع + selfie + وصف المكان
• Check-out من أي مكان مع تسجيل الإحداثيات
• Ping دوري أثناء الجلسة (inside/outside_geofence)
• إذن قصير وإذن خروج (حسب إعدادات المنشأة)
• لوحة موظف + شات داخلي + ملف شخصي

للإدارة

• حضور اليوم — عرض فوري مع فلاتر فرع/إدارة/موظف
• تقارير: ملخص كل موظف، تفصيل بالجلسات، ملخص يومي، تقرير المواقع — PDF مع الشعار
• إدارة الفروع والمستخدمين وإعدادات الإدارات (Geofence، حد الجلسات، انصراف تلقائي)
• مراجعة أذونات الخروج ومغادرات غير مصرح بها
• سجل النظام (system_logs) + دليل الصلاحيات + دخول نيابة (impersonate)

API للموبايل

واجهة REST-like: api_login، api_me، api_checkin، api_checkout، api_ping، api_permission، api_exit_permit_return، api_session — مع توكنات api_tokens منتهية الصلاحية.

الأدوار

• super_admin — مدير عام: صلاحيات كاملة
• technician — فني: مراقبة وتقارير ودعم
• branch_admin — مدير فرع
• employee — موظف: حضور، ping، شات

التقنيات

• Backend: PHP 8+، PDO/MySQL
• Frontend: HTML/CSS/JS، Cairo، RTL
• Maps: Leaflet.js + OpenStreetMap
• Geocoding: Nominatim + Photon
• Session ويب + API tokens للموبايل

الإدارات المدعومة

hotline (خط ساخن)، drug_screening (كشف مخدرات)، awareness (توعية)، other — مع إعدادات مستقلة لكل إدارة: max_sessions_per_day، geofence_radius_meters، outside_auto_checkout_minutes.

الفوائد للمنشأة

• ✓ إثبات مكان الحضور والانصراف بالGPS
• ✓ مراقبة لحظية للموظفين الميدانيين على خريطة
• ✓ تتبع مسار التحرك أثناء اليوم
• ✓ تقارير شهرية: جلسات وأيام عمل لكل موظف
• ✓ رصد الخروج غير المصرح والانصراف التلقائي
• ✓ فروع متعددة + صلاحيات + سجل تدقيق

اعتبارات مهمة

• يعتمد على GPS الجهاز — الدقة تتأثر بالمباني والطقس
• Geocoding تقريبي على OpenStreetMap
• يتطلب اتصال إنترنت للحضور والمراقبة
• الصور والـ pings تزيد حجم التخزين مع الوقت