Royal Fitness Mobile App

تطبيق Royal Fitness هو مشروع متكامل واحترافي يركز على تقديم تجربة مستخدم "ملكية" (Premium UI) للمشتركين في الصالات الرياضية، مع دعم كامل للغتين العربية والإنجليزية.

إليكم تفاصيل أكثر عن الوصف والمميزات التقنية والفنية لهذا العمل:

أولاً: الوصف العام للمشروع

التطبيق مبني باستخدام إطار عمل Flutter مع خلفية برمجية (Backend) قوية تعتمد على Supabase. تم تصميمه ليكون أداة مساعدة شاملة للمتدربين، حيث يجمع بين إدارة التدريبات، تتبع التقدم، والتفاعل مع المدربين بشكل عصري وسلس.

ثانياً: المميزات الرئيسية (Features)

تجربة مستخدم ثنائية اللغة (Bilingual): دعم كامل للغتين العربية والإنجليزية باستخدام easy_localization.

نظام دخول متطور: يدعم التسجيل بالبريد الإلكتروني مع خاصية استعادة كلمة المرور عبر الرمز المؤقت (OTP).

تخصيص الأهداف (Onboarding): عند التشغيل الأول، يتيح التطبيق للمستخدم اختيار أهدافه الرياضية ولغته المفضلة لتخصيص المحتوى.

مكتبة التمارين (Workouts Library):

يعتمد بشكل أساسي على Supabase RPC لجلب التمارين.

يحتوي على نظام احتياطي (Fallback) محلي من قاعدة بيانات ExerciseDB لضمان عمل التطبيق حتى عند تعذر الاتصال بالسيرفر.

جلسات تدريب موجهة:

مؤقت مدمج لكل تمرين.

دعم تحويل النص إلى صوت (TTS) لتوجيه المستخدم صوتياً أثناء التمرين.

تتبع التقدم (Progress Tracking):

تسجيل الوزن والإحصائيات البدنية.

تمثيل البيانات برمجياً باستخدام رسوم بيانية تفاعلية (fl_chart).

نظام الاشتراكات والخطط:

إمكانية طلب اشتراك مع تحديد المدرب المفضل وعرض الأسعار قبل التأكيد.

قسم "خطتي" (My Plan) لمتابعة البرامج التدريبية الحالية.

التكامل مع الإعلانات: مدمج به نظام Google Mobile Ads لعرض بنرات إعلانية (AdMob).

ثالثاً: الجانب التقني (Tech Stack)

إدارة الحالة (State Management): يستخدم flutter_bloc لضمان استقرار وكفاءة التطبيق.

حقن التبعيات (Dependency Injection): يعتمد على get_it و injectable.

قواعد البيانات والخدمات السحابية: استخدام مكثف لـ Supabase في المصادقة، قواعد البيانات، والتخزين.

المعمارية: مبني باستخدام Clean Architecture لسهولة الصيانة والتوسع مستقبلاً.