اعمل بصفتك مهندسًا معماريًا أول لتطبيقات Flutter + مهندس منتج. لديك خبرة تتجاوز 10 سنوات في بناء تطبيقات Flutter جاهزة للإنتاج على Android و iOS، مع تركيز على المعمارية النظيفة، تجربة مستخدم ممتازة، خصوصية قوية، وسرعة في التكرار والتحسين.
## نظرة عامة على المشروع
طوّر تطبيق جوال يعرض مصروفات المستخدم واستثماراته في واجهة واحدة. يجب أن يقدّم التطبيق واجهة حديثة وسلسة، ويدعم عدة لغات، ويتجاوب مع مختلف موديلات الجوالات. يجب أن يبدأ بسرعة، ويدعم الوضع الداكن، ويكون قابلًا للتوسّع مستقبلًا.
## متطلبات غير قابلة للتنازل
- **حزمة التقنيات**: Flutter بأحدث إصدار مستقر مع دعم null-safety.
- **دعم المنصات**: Android و iOS.
- **واجهة متجاوبة**: تتكيّف مع أحجام شاشات الجوال المختلفة.
- **دعم تعدد اللغات**: نفّذ i18n مع اللغات كحد أدنى.
- **الوضع الداكن**: دعم كامل.
- **بدء تشغيل سريع**: تجنّب العمليات التي تحجب main isolate؛ استخدم skeleton loading عند الحاجة.
- **الخصوصية**: يجب أن تبقى كل البيانات الحساسة على جهاز المستخدم؛ لا ترسل أي بيانات شخصية إلى خادم.
## استراتيجية تحقيق الدخل
- قدّم مزايا مدفوعة عبر اشتراك أو شراء لمرة واحدة.
- أضف مواضع مخصصة للإعلانات كـ placeholders بحيث يمكن استبدالها أو إزالتها بسهولة.
## مزايا اختيارية
- دمج اتصالات APIs بنكية لاستيراد العمليات مع الحفاظ على الخصوصية.
- بناء واجهة provider معيارية مع mock bank provider لاستخدامه أثناء التطوير.
## تجربة المستخدم والواجهة المطلوبة
- واجهة حديثة وسلسة باستخدام Material 3، مع حركات انتقالية ورسوم بيانية.
- الشاشات الأساسية: لوحة التحكم، المصروفات، الاستثمارات، الإعدادات.
- دعم العمل بدون اتصال بالإنترنت.
## المعمارية وجودة الكود
- استخدم Clean Architecture بطبقات: Presentation و Domain و Data.
- اختر أداة لإدارة الحالة () والتزم بها طوال المشروع.
- استخدم تخزينًا محليًا مشفّرًا للبيانات الحساسة.
- اجعل التحليلات الأساسية اختيارية التفعيل opt-in وآمنة من ناحية الخصوصية.
- فعّل ميزة التصدير والاستيراد بصيغ CSV/JSON.
## متطلبات المخرجات
سلّم المشروع على خطوات تدريجية باستخدام أسلوب «vibe coding».
### الخطوة 0 — التخطيط
- وضّح خطة المشروع وهيكلة المجلدات.
- اذكر الحزم والاعتماديات والغرض من كل واحدة.
- فصّل إعدادات المنصات لـ Android و iOS.
### الخطوة 1 — تهيئة التطبيق
- قدّم أوامر إنشاء المشروع.
- اذكر اعتماديات pubspec.yaml.
- نفّذ أساسيات التوجيه routing، والثيمات، وتجهيز الترجمة localization.
### الخطوة 2 — طبقة البيانات المحلية
- جهّز التخزين المحلي للعمليات والاستثمارات.
- طوّر entities و repositories وحالات استخدام CRUD.
### الخطوة 3 — لوحة التحكم والرسوم البيانية
- طوّر لوحة التحكم مع تجميع البيانات والرسوم البيانية.
### الخطوة 4 — المزايا المدفوعة والإعلانات
- جهّز هيكل مزايا الاشتراك ومواضع الإعلانات.
### الخطوة 5 — واجهة مزوّد البنك
- نفّذ mock bank provider وميزة المزامنة.
## إرشادات كتابة الكود
- أبقِ ملفات الكود صغيرة ومركّزة مع تعليقات واضحة.
- بعد كل خطوة، أضف تعليمات «How to run».
- اذكر أي أدوات أو إضافات خارجية مستخدمة مع تفاصيلها.
## قيود نسخة MVP
- ابدأ بنسخة MVP خفيفة؛ وتجنّب المبالغة في الهندسة.
- لا يلزم وجود خادم خلفي.
- تجنّب أي ادعاءات قانونية أو مالية.
## المتغيرات
- **اسم التطبيق**:
- **اسم الحزمة**:
- **اللغات**:
- **العملة الافتراضية**:
- **إدارة الحالة**:
