تطبيق إسلامي شامل لمواقيت الصلاة والأذكار واتجاه القبلة والتقويم الهجري.

• ✅ عرض مواقيت الصلوات الخمس يومياً
• ✅ العد التنازلي للصلاة القادمة
• ✅ دعم جميع مدن العالم (عبر Aladhan API)
• ✅ دعم الموقع التلقائي (GPS)
• ✅ طرق حساب متعددة (أم القرى، ISNA، MWL، إلخ)
• ✅ العمل أوفلاين - حفظ المواقيت للاستخدام بدون إنترنت

• ✅ بوصلة تفاعلية لتحديد اتجاه القبلة
• ✅ استخدام GPS والحساسات لتحديد الاتجاه بدقة
• ✅ عرض درجة اتجاه القبلة من موقعك
• ✅ مؤشر دقة الحساس مع تعليمات المعايرة

• ✅ عرض التاريخ الهجري والميلادي
• ✅ تقويم شهري تفاعلي
• ✅ عرض سريع للأسبوع الحالي
• ✅ العد التنازلي لشهر رمضان المبارك

• ✅ أذكار الصباح والمساء
• ✅ عداد تفاعلي لتتبع التكرارات
• ✅ تقدم مرئي لكل ذكر
• ✅ حفظ التقدم

• ✅ إشعارات لكل صلاة
• ✅ اختيار صوت الأذان (مكة، المدينة، الأقصى)
• ✅ خيار تشغيل الأذان كاملاً
• ✅ معاينة أصوات الأذان

• ✅ اختيار المدينة (يدوي أو تلقائي)
• ✅ اختيار طريقة حساب المواقيت
• ✅ تفعيل/تعطيل الإشعارات

التطبيق يدعم جميع مدن العالم من خلال:

• يحدد موقعك تلقائياً
• يحسب المواقيت بناءً على إحداثياتك الدقيقة

• أدخل اسم أي مدينة في العالم
• أدخل اسم الدولة
• API ستجد المواقيت الصحيحة

التطبيق يحتوي على ملفات الأذان التالية:

• adhan_makkah.wav - أذان الحرم المكي
• adhan_madinah.wav - أذان المسجد النبوي
• adhan_alaqsa.wav - أذان المسجد الأقصى
• adhan_makkah_full.mp3 - الأذان كاملاً

ALmuadhin/
├── app/
│   ├── src/main/
│   │   ├── java/com/example/almuadhin/
│   │   │   ├── MainActivity.kt
│   │   │   ├── MuadhinApp.kt
│   │   │   ├── alarm/
│   │   │   │   ├── AlarmReceiver.kt
│   │   │   │   ├── BootReceiver.kt
│   │   │   │   ├── NotificationHelper.kt
│   │   │   │   └── PrayerAlarmScheduler.kt
│   │   │   ├── data/
│   │   │   │   ├── SettingsModels.kt
│   │   │   │   ├── SettingsRepository.kt
│   │   │   │   └── repo/
│   │   │   │       ├── LocationRepository.kt
│   │   │   │       └── PrayerRepository.kt
│   │   │   ├── di/
│   │   │   │   └── AppModule.kt
│   │   │   ├── network/
│   │   │   │   └── AladhanApi.kt
│   │   │   ├── ui/
│   │   │   │   ├── NavGraph.kt
│   │   │   │   ├── screens/
│   │   │   │   │   ├── HomeScreen.kt
│   │   │   │   │   ├── AzkarScreen.kt
│   │   │   │   │   ├── CalendarScreen.kt
│   │   │   │   │   ├── QiblaScreen.kt
│   │   │   │   │   ├── SettingsScreen.kt
│   │   │   │   │   └── RamadanScreen.kt
│   │   │   │   ├── theme/
│   │   │   │   │   └── Theme.kt
│   │   │   │   ├── viewmodel/
│   │   │   │   │   ├── HomeViewModel.kt
│   │   │   │   │   ├── AzkarViewModel.kt
│   │   │   │   │   └── SettingsViewModel.kt
│   │   │   │   └── widgets/
│   │   │   │       ├── AdMobBanner.kt
│   │   │   │       ├── AppGradientBackground.kt
│   │   │   │       └── DotPagerIndicator.kt
│   │   │   └── util/
│   │   │       └── TimeUtils.kt
│   │   ├── res/
│   │   │   ├── raw/           # ملفات الأذان
│   │   │   ├── values/        # الألوان والنصوص
│   │   │   └── mipmap-*/      # الأيقونات
│   │   └── AndroidManifest.xml
│   └── build.gradle.kts
├── build.gradle.kts
├── settings.gradle.kts
└── keystore.properties        # إعدادات التوقيع (لا تُرفع على Git)

• Android Studio Hedgehog أو أحدث
• JDK 17
• Android SDK 34

1. افتح المشروع في Android Studio
2. انتظر تحميل Gradle dependencies
3. اختر جهاز أو محاكي
4. اضغط Run ▶️

./gradlew :app:assembleRelease

الملف سيكون في: app/build/outputs/apk/release/app-release.apk

• الرابط: https://api.aladhan.com/
• التوثيق: https://aladhan.com/prayer-times-api
• الميزات:
  • مواقيت الصلاة لأي موقع في العالم
  • التاريخ الهجري
  • طرق حساب متعددة
  • لا يتطلب API Key

بالمدينة والدولة:

GET /v1/timingsByCity/23-01-2026?city=London&country=UK&method=2

بالإحداثيات:

GET /v1/timings/23-01-2026?latitude=51.5074&longitude=-0.1278&method=2

• نظام الألوان: ذهبي إسلامي دافئ
• الخطوط: عربية واضحة
• التخطيط: RTL (من اليمين لليسار)
• المكتبة: Jetpack Compose + Material3

التطبيق يدعم العمل بدون إنترنت:

1. الحفظ التلقائي: عند جلب المواقيت، تُحفظ محلياً
2. الاسترجاع: عند انقطاع الإنترنت، تُستخدم البيانات المحفوظة
3. المؤشر: يظهر "وضع أوفلاين" في الشاشة الرئيسية
4. الإشعارات: تعمل حتى مع البيانات المحفوظة

أنشئ ملف keystore.properties في المجلد الرئيسي:

storeFile=../your-keystore.jks
storePassword=yourPassword
keyAlias=yourAlias
keyPassword=yourKeyPassword

1. حساب التاريخ الهجري: تقريبي (±1 يوم)
2. دقة البوصلة: تعتمد على حساسات الجهاز
3. Kapt Warning: ستظهر تحذيرات عن Kapt، يُنصح بالترقية إلى KSP

اللهم تقبل منا صالح الأعمال وانفع بهذا التطبيق المسلمين في كل مكان

هذا المشروع مفتوح المصدر ومتاح للاستخدام والتطوير.

تم التطوير بـ ❤️ للأمة الإسلامية