عن المشروع

Fiestaaa Front هو تطبيق واجهة أمامية مبني باستخدام Flutter 3.44 / Dart 3.11 لتنظيم الفعاليات الخاصة مع الأصدقاء والعائلة. التطبيق مرخص بموجب MPL-2.0 ويتكامل مع Firebase. تتضمن الميزات ما يلي: - المصادقة عبر Google Sign-In، وSign in with Apple، والبريد الإلكتروني/كلمة المرور - إنشاء الفعاليات وإدارتها بالكامل مع تفاصيل مخصصة - إرسال وإدارة الدعوات عبر البريد الإلكتروني - قوائم عناصر/تسوق تعاونية - تنظيم النقل المشترك (Carpool) مع المشاركين - تتبع المصاريف المشتركة وتقسيمها بين الحاضرين - أكواد QR للوصول لإدارة الدخول - إشعارات دفع عبر Firebase Cloud Messaging (FCM) - تخصيص تفضيلات المستخدم يستهدف التطبيق الويب، وAndroid، وiOS. يتطلب التطوير المحلي تكوين متغيرات البيئة (API URL، وOAuth client IDs، وFirebase config، وFCM VAPID key) في ملف .env. يتم إنشاء Firebase web service worker من قالب ومتغيرات البيئة عبر أداة Dart. تتضمن أدوات التطوير dart format وflutter analyze وflutter test مع تقارير التغطية. يفرض نظام CI حداً أدنى لتغطية الأسطر بنسبة 22%. تشمل عمليات الفحص الأمني في CI تدقيق سير العمل (workflow linting)، وفحوصات Dockerfile، وفحص Gitleaks للسجل الكامل. تستخدم إصدارات الويب الإنتاجية Dockerfile مع خدمة Nginx. تستخدم إصدارات Android النهائية ملفات توقيع محلية في حال توفرها. يتم التعامل مع إصدارات IPA الموقعة ونشر صورة الويب الرسمية في مستودع عمليات خاص؛ بينما يوفر هذا المستودع العام الكود المصدري، وتعليمات البناء المحلي، وCI العام فقط. يوجد مستودع خلفي (backend) مصاحب مكتوب بلغة Rust باسم (fiestaaa_back) بشكل منفصل. تتضمن وثائق المشروع الهندسة المعمارية، والمساهمة الأولى، وخارطة الطريق، وإشعارات الطرف الثالث، والحوكمة، وإرشادات العلامة التجارية.