تطبيق MealVerse — تطبيق أندرويد لتخطيط الوجبات

MealVerse هو تطبيق أندرويد احترافي ومتكامل تم تصميمه وبرمجته لمساعدة المستخدمين على اكتشاف وصفات الطعام من جميع أنحاء العالم، حفظ وصفاتهم المفضلة، والتخطيط لوجباتهم الأسبوعية بسهولة. التطبيق يعتمد على TheMealDB API كمصدر بيانات خارجي يحتوي على آلاف الوصفات العالمية. تم بناء التطبيق باستخدام أفضل ممارسات تطوير تطبيقات الأندرويد الحديثة، مع الحرص على فصل المسؤوليات (Separation of Concerns) وقابلية الاختبار (Testability) والأداء العالي. المزايا والوظائف الرئيسية # الميزة الوصف 1 نظام المصادقة (Authentication) تسجيل دخول/إنشاء حساب عبر البريد الإلكتروني وكلمة المرور باستخدام Firebase Auth، تسجيل الدخول بحساب Google، وضع الزائر (Guest Mode) مع إمكانية تذكر الجلسة 2 شاشة Splash احترافية شاشة بداية بتصميم أنيق باستخدام Splash Screen API مع فحص تلقائي لحالة المستخدم (مسجل/زائر/جديد) 3 الصفحة الرئيسية (Home) عرض وجبة اليوم العشوائية، التصفح حسب الفئات (Categories)، الدول (Countries)، والمكونات (Ingredients) 4 البحث المتقدم (Search & Filter) بحث بالاسم مع فلاتر متعددة: حسب الفئة، الدولة، المكون الرئيسي — مع تحديث فوري للنتائج 5 تفاصيل الوجبة (Meal Details) عرض شامل للوصفة يتضمن: الصورة، التعليمات، المكونات مع المقادير، رابط فيديو YouTube، وإمكانية الإضافة للمفضلة أو خطة الأسبوع 6 مخطط الوجبات الأسبوعي (Meal Planner) تخطيط الوجبات حسب اليوم ونوع الوجبة (فطور/غداء/عشاء) مع تقويم تفاعلي 7 الوجبات المحفوظة (Saved/Favorites) حفظ الوصفات المفضلة محلياً مع إمكانية الحذف والاستعراض — تعمل بدون إنترنت 8 الملف الشخصي (Profile) عرض بيانات المستخدم مع إمكانية تسجيل الخروج ومسح البيانات 9 تصفح الدول والمكونات شاشات مخصصة لتصفح الوصفات حسب البلد (مع أعلام الدول) أو حسب المكونات الرئيسية 10 الدعم بدون إنترنت (Offline Support) حفظ البيانات محلياً عبر Room Database مما يتيح الوصول للمفضلة والوجبات المخطط لها بدون اتصال 11 المزامنة السحابية (Cloud Sync) مزامنة الوجبات المحفوظة والمخطط لها عبر Firebase Firestore لضمان عدم فقدان البيانات 12 تنقل سلس (Navigation) شريط تنقل سفلي مخصص مع Navigation Component لتجربة مستخدم سلسة 🏗️ الهندسة المعمارية (Architecture) 📐 MVP (Model-View-Presenter) + Repository Pattern 🖥️ View(Fragments) 🎯 Presenter(UI Logic) 📦 Repository(Single Source of Truth) 💾 Local Data Source(Room DB) 🌐 Remote Data Source(Retrofit + API) ☁️ Firestore Data Source(Cloud Sync) طبقات التطبيق: View (العرض): الـ Fragments والـ Activity — مسؤولة عن عرض البيانات والتفاعل مع المستخدم Presenter (المقدم): يحتوي على منطق واجهة المستخدم ويعمل كوسيط بين View وModel Repository (المستودع): يوفر مصدر بيانات موحد مع التبديل التلقائي بين المصادر المحلية والبعيدة Data Sources (مصادر البيانات): ثلاث مصادر (محلي، API خارجي، Firebase) مع فصل تام