يهدف دليل التطبيقات القرآنية إلى توفير منصة شاملة تجمع التطبيقات القرآنية المميزة المهمة للفرد المسلم حول العالم ومن مختلف الأعمار والقدرات والأهداف، وتسهل استكشاف هذه التطبيقات حسب الاستخدام (المصاحف، الترجمات، التلاوة، التفسير، الروايات وغيرها...) مع دعم البحث والفلترة لتسهيل الوصول للتطبيق المناسب.
أهم التقنيات المستخدمة في المشروع
دليل التطبيقات القرآنية هو تطبيق PWA (مع تفعيل Service Worker)
- الواجهة الأمامية: Angular + TypeScript + SCSS، مع دعم العربية والإنجليزية.
- الواجهة الخلفية: Django 5.2 (REST API)
المهام المتاحة للمساهمة
عملنا على مراجعة قائمة المهام المفتوحة في مشروع دليل التطبيقات القرآنية ضمن مبادرة رمضان الأثر، وكان الهدف واضحاً: نبقي فقط ما يستحق العمل عليه، ونغلق كل ما تم إنجازه بالفعل أو ما هو مكرر.
راجعنا أكثر من 30 مهمة مفتوحة على GitHub، وفحصنا كل واحدة منها مقابل الكود الحالي في المشروع لنتحقق: هل هي منجزة؟ هل هي مكررة؟ هل لا تزال صالحة؟
ما تم إغلاقه
أغلقنا 17 مهمة كانت إما منجزة بالفعل في الكود، أو مكررة، أو اختبارية:
- #44 - webapp icon and link → موجود بالفعل في manifest.webmanifest
- #35 - make the category clickable → منجز عبر routerLink
- #26 - Add Structured data markup → منجز في SeoService بالكامل
- #25 - add schema.org → مكرر مع #26
- #75 - البحث بالرواية → مكرر مع #137
- #74 - البحث بأنواع المصاحف → مكرر مع #136
- #119 - Fix Robots.txt errors → ملف robots.txt شامل ومكتمل
- #86 - CI/CD Pipeline → 6 ملفات workflows موجودة
- #85 - AI search → صفحة المساعد ودليل Dalil موجودان
- #80 - SEO improvements → OG tags و schema.org مكتملة
- #78 - Developer page → صفحة المطور موجودة وتعمل
- #134 - Test 123 → قضية اختبارية
- #133 - Good First Issue Example → قضية نموذجية وهمية
- #22 - fix half star issue → تم تغيير طريقة عرض التقييم لرقم بدلاً من نجوم
- #12 - same height for app store icons → جميع الأيقونات بارتفاع 49px
- #64 - dots overlap the description → تم الإصلاح بـ -webkit-line-clamp
- #73 - add test cases → يوجد 7 ملفات اختبار في Backend + E2E بـ Playwright
قائمة المهام التي تنتظر المساهمين للعمل عليها 🎯
بعد المراجعة والتنظيف، بقيت المشاكل الحقيقية التي تنتظر المساهمين:
🐛 أخطاء تحتاج إصلاح:
- #235 - RTL/LTR لا يتحدث عند تبديل اللغة - عند الانتقال بين العربية والإنجليزية، يبقى اتجاه الصفحة كما هو حتى إعادة التحميل الكامل
- #234 - صفحة التطبيق لا تعرض حالة خطأ أو 404
- #232 - تسريب ذاكرة في صفحات app-detail و developer
- #184 - رابط Backend مكشوف في ملفات البيئة
- #170 - 79 استدعاء لـ console.log في كود الإنتاج
- #169 - مشكلة في عرض النص العربي في Firefox
✨ تحسينات وميزات جديدة:
- #236 - توليد صورة OG مخصصة لكل تطبيق عند المشاركة - الـ Frontend جاهز، الـ Backend endpoint مفقود
- #233 - إضافة شارات Featured و New على بطاقات التطبيقات
- #212 - مشكلة في الفلاتر + اتجاه RTL/LTR
- #137 - البحث بالرواية
- #136 - البحث بنوع المصحف
- #120 - الوضع الليلي - الكود موجود لكن الزر معطّل
- #45 - إضافة رابط صفحة التطبيق الرسمية
- #43 - إضافة أيقونات المتاجر على بطاقات التطبيقات
لمزيد من التفاصيل اطلع المهام المفتوحة Issues للمشروع على جيتهب
https://github.com/Itqan-community/quran-apps-directory/issues
كيف يمكنك المساهمة؟
- انتقل إلى مستودع مشروع دليل التطبيقات القرآنية على GitHub للاطلاع على المهام المفتوحة.
- اختر مهمة تناسب وقتك وخبرتك، واطلب إسنادها لك (Assign) أو علّق بنيّتك العمل عليها.
- بعد الإسناد، نفّذ المهمة على فرع مستقل وفق إرشادات المشروع.
- بعد اكتمال التنفيذ، أرسل Pull Request عبر GitHub للمراجعة والدمج.
- بعد قبول مساهمتك وثّقها برد داخل هذا الموضوع يتضمن رابط الـ Pull Request.
ملاحظة: يمكنك المساهمة في أكثر من مهمة داخل المشروع.
يوفر دليل التطبيقات القرآنية منصة موثوقة ومنظّمة تجمع أبرز التطبيقات القرآنية في مكان واحد، وتختصر على المستخدم عناء البحث والتجربة العشوائية، وتساعده على الوصول إلى ما يناسب هدفه: وكل مساهمة فيه تسهم في تحسين تجربة آلاف المستخدمين حول العالم.
نرحب بكل من يرغب في أن يكون جزءًا من هذا الأثر ويحسِّن هذا المشروع.
