مع التطور التقني المتسارع في المؤسسات التعليمية والشركات، أصبحت الطرق التقليدية لتسجيل الحضور والغياب ورقية ومكلفة زمنياً. في هذا الدرس التطبيقي المتقدم على Doros4U، سنشرح كيفية تطوير تطبيق هاتف محمول ذكي (Smart Attendance Mobile App) يتيح مسح رمز QR Code بسرعة فائقة ومزامنة البيانات فورياً مع سحابة Google Firebase.
🚀 المكونات والميزات التقنية:
- كاميرا فائقة السرعة للتعرف على كود QR باستخدام مكتبة Mobile Scanner.
- نظام صلاحيات متعدد (مدير النظام، الأستاذ، الطالب).
- دعم الوضع الليلي والنهاري وتعدد اللغات (عربي، فرنسي، إنجليزي).
- تصدير تقارير الحضور بصيغة Excel و PDF بنقرة واحدة.
1. إعداد المشروع والمكتبات البرمجية الأساسية
في ملف pubspec.yaml، قم بإضافة الحزم التالية للبدء بالتطوير:
dependencies:
flutter:
sdk: flutter
firebase_core: ^3.0.0
cloud_firestore: ^5.0.0
mobile_scanner: ^5.1.1
qr_flutter: ^4.1.0
provider: ^6.1.2
2. كود مسح كود QR وتسجيل الحضور بالفايرستور
// Dart Code: QR Attendance Logic
import 'package:flutter/material.dart';
import 'package:cloud_firestore/cloud_firestore.dart';
Future recordAttendance(String studentId, String classId) async {
try {
final now = DateTime.now();
final todayStr = "${now.year}-${now.month}-${now.day}";
await FirebaseFirestore.instance
.collection('attendance')
.doc("$classId_$todayStr_$studentId")
.set({
'studentId': studentId,
'classId': classId,
'timestamp': FieldValue.serverTimestamp(),
'status': 'present',
'date': todayStr,
});
print("تم تسجيل الحضور بنجاح!");
} catch (e) {
print("خطأ أثناء تسجيل الحضور: $e");
}
}
3. نصائح تحسين تجربة المستخدم (UI/UX Best Practices)
- إضافة اهتزاز وصوت تنبيه لطيف (Haptic Feedback) عند المسح الناجح.
- التأكد من التخزين المحلي الاحتياطي (Offline Support) في حال انقطاع شبكة الإنترنت.
📱 احصل على مشروع Flutter الكامل للتحميل
حمل الكود المصدري وادعم استمرار الدروس والمشاريع المفتوحة المصدر على المنصة!
يُعد موضوع بناء تطبيق هواتف ذكية لمتابعة الحضور والغياب بتقنية QR Code باستخدام Flutter و Firebase من أهم المحاور التقنية والبرمجية التي يبحث عنها المطورون ورواد الأعمال في بيئة التطوير السريع WinDev و WinDev Mobile. في هذا الدليل العملي والمفصل المقدم من منصة Doros4U، نستعرض المعمارية الكاملة لهذا المشروع، كيفية ربطه مع قواعد البيانات HFSQL Client/Server، وأهم مميزات WLanguage التي تضمن أداءً فائقاً وتجربة مستخدم متميزة.
1. نظرة عامة والخصائص الرئيسية للمشروع
تم تصميم وتطوير بناء تطبيق هواتف وفق أحدث معايير هندسة البرمجيات لتوفير تجربة استخدام سهلة وسريعة، وتشتمل الخصائص الجوهرية على:
- واجهة مستخدم احترافية (UI/UX Ergonomics): تصميم متجاوب وأنيق يضمن سرعة الوصول إلى الوظائف وإدخال البيانات بأقل عدد من النقرات.
- أمان وتكامل البيانات (Data Integrity): حماية قواعد البيانات عبر خادم HFSQL مع إمكانية النسخ الاحتياطي التلقائي وتشفير المعاملات.
- تقارير وإحصائيات متقدمة: إمكانية توليد وتصدير تقارير وبيانات تفصيلية بصيغة PDF وطباعتها مباشرة بضغطة زر.
- قابلية التوسع والتخصيص: بنية كود WLanguage مرنة ونظيفة تتيح للمبرمج إضافة أي وحدات برمجية جديدة بكل سهولة.
2. المتطلبات التقنية وبيئة العمل (WLanguage & HFSQL)
لضمان تشغيل بناء تطبيق هواتف بأعلى كفاءة في بيئة العمل، يُوصى بالمتطلبات الآمنة التالية:
- نظام التشغيل: Windows 10 / 11 أو Windows Server (بالإضافة إلى دعم أنظمة Android للهواتف الذكية).
- محرك قواعد البيانات: HFSQL Classic للعمل على جهاز محلي أو HFSQL Client/Server للربط الشبكي المتعدد.
- بيئة التطوير: متوافق مع إصدارات WinDev 20 حتى WinDev 28 والإصدارات الأحدث.
3. كود برمجي تطبيقي وإرشادات التنفيذ (WLanguage Implementation)
يوضح الكود النموذجي التالي كيفية التعامل مع السجلات والتحقق من صحة المعطيات قبل الحفظ:
// WLanguage: Verification et Enregistrement Securise
SI SAI_Designation = "" ALORS
ToastAffiche("يرجى ملء الحقول الإجبارية أولاً", toastCourt)
Retour
FIN
HRAZ(FICHIER_DONNEES)
FICHIER_DONNEES.Designation = SAI_Designation
FICHIER_DONNEES.DateOperation = DateDuJour()
SI HAjoute(FICHIER_DONNEES) ALORS
ToastAffiche("تم الحفظ بنجاح في قاعدة البيانات HFSQL", toastCourt)
SINON
Erreur("خطأ في حفظ السجل: " + HErreurInfo())
FIN
4. الأسئلة الشائعة حول المشروع (FAQ)
هل المشروع قابل للتعديل بالكامل؟
نعم، المشروع مفتوح المصدر 100% ويشمل كافة النوافذ (Windows)، الأكواد، وتحليل قاعدة البيانات (Analysis .wdd).
أين يمكنني الحصول على الكود المصدري والمشاريع المشابهة؟
يمكنكم تصفح كافة الحلول البرمجية عبر متجر Doros4U الرسمي أو الاطلاع على المشاريع المكتملة في صفحة الحلول البرمجية.