BiometricFlow-ZK

BiometricFlow-ZK هو نظام مؤسسي متكامل لإدارة حضور وانصراف الموظفين باستخدام أجهزة البصمة من ZK. صُمم النظام للمؤسسات التي تمتلك عدة فروع وتحتاج إلى ربط أجهزة الحضور المختلفة بمنصة مركزية واحدة، مع إمكانية متابعة الأجهزة، وتجميع سجلات الحضور، واستخراج التقارير والتحليلات بصورة لحظية.

يعتمد المشروع على بنية Microservices قابلة للتوسع، ويضم خدمات مستقلة لكل فرع، وبوابة API مركزية لتجميع البيانات، ولوحة تحكم تفاعلية للإدارة. تم تطوير الخدمات الخلفية باستخدام FastAPI، بينما تعتمد الواجهة على Streamlit لعرض البيانات والتقارير بطريقة واضحة وسهلة الاستخدام.

أهم المميزات

* دعم عدد كبير من الفروع والمواقع.

* ربط عدة أجهزة بصمة داخل كل فرع.

* إدارة مركزية لجميع الأجهزة والموظفين.

* مزامنة بيانات الحضور لحظياً.

* عرض حالة الأجهزة ومتابعة الاتصال بها.

* البحث عن الموظفين وسجلات الحضور.

* تصفية النتائج حسب الموظف أو الفرع أو الجهاز.

* تحديد نطاق زمني للتقارير.

* تحليل الحضور والغياب والتأخير.

* حساب ساعات العمل والساعات الإضافية.

* متابعة الالتزام بمواعيد العمل الرسمية.

* إدارة العطلات والإجازات وأيام العمل.

* إنشاء تقارير خاصة بكل فرع أو جهاز.

* عرض إحصائيات موحدة لجميع الفروع.

* تصدير البيانات والتقارير بصيغة CSV.

* تنفيذ مزامنة يدوية مع أجهزة البصمة.

* لوحة تحكم تفاعلية تعرض البيانات لحظياً.

* واجهات REST API للتكامل مع الأنظمة الأخرى.

* توثيق تفاعلي للواجهات باستخدام Swagger.

* حماية الخدمات باستخدام JWT وAPI Keys.

* إدارة الجلسات وتجديد رموز المصادقة تلقائياً.

* تحديد معدل الطلبات والحماية من الاستخدام المفرط.

* التحقق من المدخلات وتسجيل الأحداث الأمنية.

* مراقبة صحة الخدمات والأجهزة بشكل مستمر.

* دعم النشر الموزع على أكثر من خادم.

* دعم Docker لتسهيل التشغيل والنشر.

* إمكانية النشر المحلي أو السحابي باستخدام NGROK.

* دعم أنظمة Windows وLinux وmacOS.

* توفير سجلات للتدقيق، والأخطاء، والأداء.

* اختبارات للتحقق من الاتصال وعمل المصادقة بين الخدمات.

* تصميم قابل للتوسع وإضافة فروع وأجهزة جديدة مستقبلاً.