مشروع absence_schedule هو مثال Flutter لتنظيم الأقسام والطلاب وتسجيل حالات الحضور في جدول، مع تخزين محلي باستخدام Hive وإدارة الحالة عبر Cubit. تعرض هذه المقالة ما يمكن تعلمه من الملفات المنشورة وكيفية تقييم المشروع قبل تشغيله أو تطويره، دون افتراض أنه نظام مدرسي جاهز للإنتاج أو مرتبط بخدمة مزامنة.
رابط المصدر وما الذي راجعته
المصدر المنشور هو مستودع mohamedrashad102/absence_schedule على GitHub. راجعت ملفات الفرع main عند الالتزام 13cebaa، بما فيها نقطة التشغيل والنماذج والتخزين والواجهة. آخر دفع للمستودع بحسب بيانات GitHub وقت المراجعة كان في يناير 2024، لذلك من الطبيعي أن يحتاج فحص الاعتمادات قبل استعماله مع Flutter أحدث.
لم أجد ترخيصًا معلنًا في بيانات المستودع أو ملف ترخيص ضمن النسخة التي راجعتها. إتاحة الكود للقراءة لا تعني تلقائيًا السماح بإعادة نشره أو استخدامه تجاريًا؛ تحقق من صاحب المشروع والترخيص قبل ذلك. لهذا أصفه هنا بمشروع ذي مصدر متاح، بدل الجزم بأنه مرخص كمصدر مفتوح لأي استعمال.
بنية المشروع ومكونات البرنامج
تبدأ main.dart بتهيئة Flutter وHive، ثم تسجيل SectionAdapter وStudentAdapter وتشغيل التطبيق. توفر SectionsCubit إدارة الأقسام، بينما تعالج AbsenceCubit القسم المحدد وأسماء الطلاب وحالات الأيام. الفصل بين البيانات والواجهة مفيد للدراسة، لكنه لا يعفيك من مراجعة كيفية حفظ الأخطاء والتعامل معها.
نموذج Student يحتوي اسمًا وقائمة List<bool?> لحالات الأيام. تنتقل nextDayState بين null ثم true ثم false ثم null. لا تستنتج من القيمة وحدها أن true تعني غيابًا؛ راجع العرض وتسميات الواجهة ثم وثق معنى الحالات بوضوح قبل إنشاء تقارير. استخدام enum موثق قد يجعل المعنى أوضح عند تطوير نسخة مستقلة.
تستخدم SectionsBox صندوق Hive محليًا لحفظ الأقسام وتعديلها. وجود shared_preferences في الاعتمادات وملف مساعد له لا يثبت أن التخزين الأساسي موزع على سحابة. كما أن ذكر مكتبة ذات اسم متعلق بـExcel في pubspec لا يثبت وجود تصدير تقارير مكتمل؛ يجب تتبع الاستدعاء الفعلي والاختبار.
خطوات مراجعة وتشغيل نسخة تجريبية
نزّل المصدر من رابط المستودع الأصلي، وراجع الملفات والاعتمادات قبل تشغيله. استخدم نسخة عمل منفصلة وبيانات طلاب وهمية. الأوامر التالية توضح مسار الفحص داخل مجلد المشروع بعد حصولك على المصدر؛ اختر منصة سطح المكتب التي جهزت أدواتها محليًا. لا تعرض المقالة ملفًا تنفيذيًا مدققًا أو حزمة تثبيت جاهزة.
cd absence_schedule
flutter --version
flutter doctor -v
flutter pub get
flutter analyze
flutter test
flutter run -d windowsفي macOS استبدل الجهاز بـmacos. إذا فشل حل الاعتمادات، اقرأ أول تعارض في سجل pub بدل رفع كل القيود عشوائيًا. وإذا أضفت منصة أو أعدت توليد ملفاتها، احتفظ بنسخة سابقة وراجع فرق runner حتى لا تستبدل إعدادات أصلية دون قصد.
هذا ترتيب مقترح لتقييم نسخة المشروع؛ لم أشغّل المستودع الخارجي أو أؤكد نجاح بنائه على جميع الأنظمة. مراجعة المصدر وحدها لا تكفي لإثبات خلوه من العيوب أو جاهزيته لحفظ سجلات حقيقية. أما مثال الواجهة المتجاوبة ومثال حجم النافذة في الدروس المرتبطة فقد فُحصا في مشروع تعليمي مستقل.
اختبارات عملية للحفظ والتعديل
أنشئ قسمًا تجريبيًا وأضف طالبين، ثم غيّر حالات عدة أيام وأغلق التطبيق وافتحه للتحقق من الاسترجاع. جرب تعديل اسم القسم وحذفه وإضافة صف فارغ، وتأكد من عدم تغير طالب آخر بسبب الاعتماد على فهارس القائمة. لا تعتبر ظهور التغيير على الشاشة دليلًا كافيًا على اكتمال الكتابة على القرص.
من نقاط التطوير التي تستحق المراجعة انتظار عمليات Hive وإرجاع Future بدل async void، كي تتمكن الواجهة من إظهار فشل الحفظ. راجع أيضًا التخلص من TextEditingController عند استبداله أو إزالة صفه؛ مسح القائمة وحده لا يستدعي dispose تلقائيًا. هذه ملاحظات على التصميم المرئي في المصدر وليست ادعاء أن كل سيناريو منها تسبب بعطل مثبت أثناء التشغيل.
التصميم على سطح المكتب وحماية السجلات
اختبر الجدول مع نافذة ضيقة وعريضة وعدد كبير من الطلاب، ومع أسماء عربية طويلة. وجود تخطيط مخصص للهاتف واللوحي والكمبيوتر لا يثبت أن كل جدول يناسب كل عرض؛ راجع التمرير وتركيز لوحة المفاتيح وإمكانية الوصول للأزرار. ويمكن فصل تخطيط المحتوى عن حدود النافذة ليبقى التطبيق قابلًا للاستخدام عند تغيير حجمها.
قبل تحويل التجربة إلى أداة داخل مدرسة، ضع خطة نسخ احتياطي واستعادة وصلاحيات وصول وحذف وتوثيق للتعديلات. لا تفترض أن التخزين المحلي مشفر تلقائيًا أو أن البرنامج يرسل إشعارات لأولياء الأمور. لا تضف خصائص المزامنة والتصدير والتقارير إلى وصف المنتج إلا بعد تنفيذها واختبارها فعليًا.
هل يصلح مشروع تخرج؟
يمكن أن يكون موضوعًا لدراسة تنظيم البيانات والواجهات وإدارة الحالة، مع التحقق من حقك في الاستفادة من المصدر والإشارة لصاحبه. قدم عملك الذي طورته واختبرته بوضوح، مثل تحسين نموذج الحالات أو معالجة فشل الحفظ. ولا تصف نسخة تعليمية بأنها نظام معتمد أو مضمون لحماية بيانات الطلاب لمجرد أنها تعمل على جهازك.
قبل محاولة تشغيل المشروع على جهازك، اتبع تشغيل Flutter على سطح المكتب: Windows وmacOS وLinux واختر بيئة البناء المطابقة لنظام التشغيل.


