تطبيق المسلم 🕌 | Al-Muslim App

تطبيق إسلامي ويب شامل (Progressive Web App - PWA) يهدف إلى توفير أدوات متكاملة للمسلم في حياته اليومية. يتميز التطبيق بواجهة مستخدم عصرية وسريعة الاستجابة، ويدعم إمكانية التثبيت كبرنامج مستقل على الهاتف أو الحاسوب.

✨ المميزات الرئيسية

• مواقيت الصلاة: عرض أوقات الصلاة بدقة مع عد تنازلي للصلاة القادمة بناءً على الموقع الجغرافي.
• القرآن الكريم: قراءة سلسة للقرآن الكريم مع إمكانية الاستماع الصوتي لآيات الذكر الحكيم بصوت عدة قراء مشاهير، بالإضافة لإحصائيات القراءة.
• الأذكار: مجموعة شاملة من الأذكار (أذكار الصباح، المساء، بعد الصلاة، وتسابيح متنوعة) مع عداد إلكتروني لكل ذكر.
• البث المباشر (الراديو): الاستماع لإذاعات القرآن الكريم المباشرة على مدار الساعة والتنقل بينها بسهولة.
• اتجاه القبلة: بوصلة دقيقة ومتحركة لتحديد اتجاه القبلة أينما كنت.
• وضع الخشوع: تفعيل وضع هادئ وإشعارات تذكيرية عند دخول وقت الصلاة.
• التخصيص الكامل: يدعم الوضع المظلم (Dark Mode)، واختيار المذهب الفقهي لحساب المواقيت (شافعي أو حنفي).
• سجل العبادات: أدوات لتتبع المهام الدينية وتحديد نية يومية لزيادة الإنتاجية.
• تقنية PWA: يمكن تثبيت التطبيق والوصول إليه بسرعة كأي تطبيق أصلي (Native App).

🛠 التقنيات المستخدمة

تم بناء المشروع بالاعتماد الكامل على تقنيات الويب القياسية لضمان أقصى سرعة وأفضل أداء بدون استخدام إطارات عمل ثقيلة:

• HTML5: لهيكلة المحتوى بشكل دلالي وواضح.
• CSS3 (Vanilla): لتصميم واجهات عصرية ومتجاوبة وتفاعلية باستخدام المتغيرات والأنماط الحديثة.
• JavaScript (Vanilla): لبرمجة التفاعلات المنطقية للمستخدم (SPA logic).
• PWA (Manifest & Service Worker): لدعم التثبيت المباشر.

📂 هيكل المشروع

aloslim-main/
├── css/
│   └── style.css       # الأنماط والتنسيقات البصرية للتطبيق بأسره
├── js/
│   ├── app.js          # الملف الرئيسي والمنسق لتحميل الصفحات والتنقل
│   ├── home.js         # العمليات الخاصة بالصفحة الرئيسية والوقت والمواقيت
│   ├── quran.js        # منطق استدعاء السور الكريمة وتشغيل التلاوات الصوتية
│   ├── azkar.js        # التعامل مع فئات الأذكار وتخزين التكرارات
│   ├── live.js         # تشغيل وإدارة موجات ومشغل راديو البث المباشر
│   └── settings.js     # التعامل مع تفضيلات المستخدم وحفظها محلياً
├── index.html          # الصفحة الرئيسية المجمعة لجميع أقسام التطبيق وتصميمه
├── manifest.json       # بيانات التطبيق التعريفية للهواتف الذكية والمتصفحات
├── sw.js               # ملف مشغل الخدمة (Service Worker) 
└── README.md           # ملف تعريف المستودع الحالي

🚀 طريقة الاستخدام محلياً

لتشغيل المشروع وتجربته على جهازك الشخصي:

1. قم بتنزيل (أو استنساخ) هذا المستودع إلى جهازك:

   git clone https://github.com/your-username/aloslim.git

2. استخدم خادماً محلياً لتفادي مشاكل الأمان الخاصة بالمتصفح (CORS Policy) وتمكين ميزات الموقع الجغرافي:
   • عن طريق VS Code: قم بتشغيل إضافة Live Server.
   • أو عن طريق Python:

     python -m http.server 8000

   • أو عن طريق Node.js:

     npx serve .

3. افتح المتصفح وانتقل إلى الرابط http://localhost:8000.

🤝 المشاركة والمساهمة

نرحب بجميع المساهمات والمقترحات البرمجية التي تهدف لتطوير التطبيق ورفع كفاءته. الخطوات الأساسية للمساهمة:

1. قم بعمل Fork للمشروع.
2. أنشئ فرعاً جديداً (git checkout -b feature/NewAwesomeFeature).
3. احفظ تعديلاتك ورسالتك بوضوح (git commit -m 'Add some NewAwesomeFeature').
4. ارفع التعديلات الخاصة بك (git push origin feature/NewAwesomeFeature).
5. قم بإنشاء Pull Request لمناقشة تعديلاتك ودمجها.

📄 رخصة الاستخدام

هذا المشروع متاح للجميع (مفتوح المصدر). نسأل الله أن يكتب فيه الأجر والفائدة.