deya2021/mauritania-edu-app

تطبيق تعليمي موريتاني - Flutter App with Firebase # Mauritania Educational App - MVP A comprehensive educational mobile application designed specifically for students in Mauritania, built with Flutter for both Android and iOS platforms. ## 🎯 Overview This MVP (Minimum Viable Product) provides a structured curriculum learning platform with: - Phone-based authentication - Progressive lesson unlocking system - Bilingual support (Arabic RTL + French) - Integrated custom ad system - Offline content caching - Exercise tracking and progress monitoring ## 📱 Features ### Core Features - **Authentication**: Phone number + OTP verification - **Multi-language Support**: Arabic (RTL) and French with auto-detection - **Curriculum Structure**: Year → Subject → Unit → Lesson - **Progressive Unlocking**: Smart lesson unlock system (max 2 lessons per day per subject) - **Interactive Exercises**: MCQ and True/False questions with instant feedback - **Progress Tracking**: Per-lesson and per-subject progress monitoring - **Custom Ads**: Banner ads with in-app WebView display - **Offline Support**: Cached lessons for offline access ### Progressive Unlock Logic (CRITICAL) Per subject basis: 1. **Automatic unlock**: At least 1 new lesson every 24 hours 2. **Conditional second unlock**: Complete current lesson at 70%+ to unlock second lesson same day 3. **Daily limit**: Maximum 2 lessons per day per subject 4. **Visual feedback**: Clear lock indicators and countdown timers ## 🏗️ Architecture ### Tech Stack - **Framework**: Flutter 3.0+ - **Backend**: Firebase (Auth + Firestore) - **State Management**: Provider - **UI Components**: Material Design 3 - **Localization**: Custom i18n system ### Project Structure ``` lib/ ├── config/ # App configuration │ ├── theme.dart │ └── firebase_options.dart ├── models/ # Data models │ └── models.dart ├── services/ # Business logic │ ├── auth_service.dart │ ├── firestore_service.dart │ └── progress_service.dart ├── providers/ # State man …