Lordlitor 🐊

تدريب القدرات الذهنية والحساب السريع
_{Mental Abilities & Fast Math Training App}

الميزات • الصعوبة • البدء • المساهمة • خارطة الطريق

---

🎯 حول التطبيق

Lordlitor تطبيق تعليمي تفاعلي مستوحى من Duolingo لتدريب القدرات الذهنية والرياضيات. مصمم لمساعدة الطلاب على التحضير لاختبارات القدرات من خلال تمارين متنوعة بأنماط مستخلصة من 68 سؤال امتحاني حقيقي.

🧠	أنماط حقيقية — الأسئلة مبنية على تحليل أسئلة امتحانية فعلية
🎮	تجربة ممتعة — تصميم Duolingo-like يجعل التعلم إدمانياً
📊	صعوبة ذكية — يتكيف مع مستواك تلقائياً بـ 3 مستويات
🐊	شخصية محبوبة — التمساح اللطيف يرافقك في رحلتك

---

✨ الميزات

📚 5 فئات تدريبية الفئة الوصف ✖️ الضرب عمليات مركبة وجداول 1-20 ➕ الجمع أنماط امتحانية متعددة العمليات ➖ الطرح خدع حقيقية وسلاسل عمليات ➗ القسمة سلاسل عمليات مع التحقق 🧠 حساب ذهني 21 نمط سؤال متنوع!

🎮 تجربة مستخدم غنية الميزة الوصف 🎨 تصميم Duolingo-like + أزرار 3D 🔥 كومبو مضاعفات ×1.5, ×2, ×3 📈 تقدم XP + مستويات + streaks 📳 لمسي اهتزازات Haptic متنوعة ✨ انيميشن حركات سلسة على كل شاشة 🏋️ إتقان نظام إعادة محاولة ذكي

🧠 الحساب الذهني — 21 نمط سؤال

مبني على تحليل عميق لأسئلة الامتحانات الحقيقية:

العمليات المركبة (14 نمط):
  a×b+c  │  a×b×c  │  a×b+c×d  │  a×b-c×d  │  a×b÷c+d
  a×b+c÷d  │  a×b÷c×d  │  a+b×c×d  │  a÷b×c+d  │  a÷b×c
  a×b÷c-d  │  a÷b×c-d  │  a÷b÷c×d  │  a-b×c-d  ...وأكثر

مسائل لفظية (7 أنماط):
  كسور   →  ثلث، نصف، ربع، خمس، سدس، ثمن...
  وقت    →  ثواني ↔ دقائق ↔ ساعات ↔ أيام
  تقويم  →  أشهر، عقود، عدّ الوحدات
  هندسة  →  مجموع أضلاع الأشكال
  نسب %  │  عدد مفقود  │  ضعف/نصف  │  حاصل ضرب

🏋️ جدول الضرب (1-20)

• تدريب شامل لكل جدول على حدة
• نظام إتقان: الأسئلة الخاطئة تُعاد حتى تُجيب على الكل صح ✅
• ضمان عدم الانتقال بدون إتقان كامل

---

📊 نظام الصعوبة

المستوى	نطاق الأرقام	العمليات	النتيجة	مثال
🟢 سهل	2 — 20	1-2	< 200	14 × 4 ÷ 2 + 18
🟡 متوسط	10 — 100	2-3	100 — 600	9 × 6 + 12 × 4
🔴 صعب	50 — 1000+	3-4+	500+	955 - 133 × 6 + 459

📌 نظام الصعوبة الذكي: 90% من الأسئلة تكون من المستوى المُختار مع 10% تنوع — لضمان تجربة عادلة ومتدرجة.

---

🏗️ بنية المشروع

lordlitor/
├── lib/
│   ├── core/                    # الثيم (AppTheme) + الثوابت
│   │   ├── app_theme.dart       # ألوان + ثيم Duolingo
│   │   └── constants.dart       # ثوابت التطبيق
│   ├── models/
│   │   └── question_model.dart  # نماذج: Question, QuizResult, UserProgress
│   ├── services/
│   │   ├── question_generator.dart  # محرك توليد الأسئلة (5 فئات + 21 نمط)
│   │   └── storage_service.dart     # حفظ/استرجاع التقدم (SharedPreferences)
│   ├── screens/
│   │   ├── home_screen.dart     # الرئيسية + الإحصائيات
│   │   ├── categories_screen.dart   # اختيار الفئة والصعوبة
│   │   ├── quiz_screen.dart     # شاشة الاختبار
│   │   ├── result_screen.dart   # عرض النتائج + XP
│   │   ├── multiplication_table_screen.dart  # جداول الضرب 1-20
│   │   ├── stats_screen.dart    # إحصائيات تفصيلية
│   │   └── splash_screen.dart   # شاشة البداية
│   ├── widgets/
│   │   └── duo_button.dart      # زر Duolingo 3D
│   ├── image/                   # أصول الصور والشخصيات
│   └── main.dart                # نقطة الدخول
├── .github/
│   ├── workflows/flutter_ci.yml # CI/CD (Analyze + Test + Build)
│   ├── ISSUE_TEMPLATE/          # قوالب Issues (Bug/Feature)
│   └── PULL_REQUEST_TEMPLATE.md # قالب PR
├── README.md
├── CONTRIBUTING.md
├── CHANGELOG.md
├── SECURITY.md
├── CODE_OF_CONDUCT.md
└── LICENSE (MIT)

---

🚀 البدء السريع

المتطلبات

• Flutter SDK 3.9+
• Dart 3.9+
• Android Studio أو VS Code
• جهاز Android/iOS أو محاكي

التثبيت والتشغيل

# 1. استنساخ المشروع
git clone https://github.com/Lord-shaban/lordlitor.git
cd lordlitor

# 2. تثبيت الحزم
flutter pub get

# 3. تشغيل في وضع التطوير
flutter run

البناء للإنتاج

# Android APK
flutter build apk --release

# Android App Bundle (Google Play)
flutter build appbundle --release

إعداد اختياري

# إنشاء Native Splash Screen
dart run flutter_native_splash:create

# إنشاء أيقونات التطبيق
dart run flutter_launcher_icons

---

📦 الحزم المستخدمة

الحزمة	الغرض	الإصدار
flutter_animate	انيميشن سلسة	^4.5.2
google_fonts	خط Cairo العربي	^6.2.1
shared_preferences	حفظ التقدم محلياً	^2.3.4
confetti	تأثيرات احتفال	^0.8.0
percent_indicator	مؤشرات دائرية	^4.2.3
fl_chart	رسوم بيانية	^0.70.2
flutter_native_splash	Splash أصلي	^2.4.5
flutter_launcher_icons	أيقونات التطبيق	^0.14.3

---

📈 نظام التقدم

┌─────────────────────────────────────────────────┐
│  📊 الإحصائيات                                  │
│                                                 │
│  🔥 Streak    ⭐ XP       ✅ دروس   🏆 كومبو  │
│  ─────────    ──────      ──────    ──────── │
│  أيام متتالية  نقاط خبرة   مكتملة    أفضل سلسلة │
│                                                 │
│  📈 التقدم للمستوى التالي: ████████░░ 75%       │
│  🎯 نسبة الدقة: 85%   📝 صح/مجموع: 340/400    │
└─────────────────────────────────────────────────┘

• XP: 10 نقاط لكل إجابة صحيحة + مكافآت إضافية
• كومبو: 3+ إجابات متتالية = ×1.5 | 5+ = ×2 | 8+ = ×3
• المستويات: كل 100 XP = مستوى جديد
• Streak: تدريب يومي متتالي

---

🛣️ خارطة الطريق

• الإطلاق مع 5 فئات تدريبية
• 21 نمط حساب ذهني من أسئلة حقيقية
• نظام كومبو، XP، ومستويات
• تصميم Duolingo-like كامل
• جداول الضرب 1-20 مع نظام إتقان
• إحصائيات تفصيلية (دقة، أسئلة، كومبو)
• CI/CD مع GitHub Actions
• 🎯 وضع التحدي اليومي
• 🏅 لوحة المتصدرين
• 📝 إضافة أنماط أسئلة جديدة
• 🌍 دعم لغات متعددة
• 👥 وضع المسابقة (Multiplayer)
• 📱 دعم iOS كامل

---

🤝 المساهمة

المساهمات مرحب بها! اقرأ CONTRIBUTING.md للبدء.

🔒 الأمان

اقرأ SECURITY.md للإبلاغ عن ثغرات.

📄 الرخصة

MIT License — استخدم، عدّل، وزّع بحرية.

---

صُنع بـ ❤️ باستخدام Flutter
_{⭐ لا تنسَ نجمة للمشروع إذا أعجبك!}