مشروع رتق RATQ (اختصار لعبارة Roadmap and Technologies for Qur’an) هو قاعدة معرفية تقنية مفتوحة المصدر تهدف إلى تنظيم خارطة تطوير التطبيقات القرآنية، عبر جمع التقنيات، وتصنيف مراحل التطوير، ومقارنة الأدوات المتاحة، وتحديد الفجوات في المنظومة التقنية. المشروع موجّه للمطورين، ويعتمد على ملفات Markdown منظمة تُعرض كموقع توثيقي يمكن تصفحه عبر مستودع GitHub مباشرة أو من خلال هذا الرابط: https://ratq.itqan.dev/
يتضمن المشرو ع ثلاثة محاور رئيسية:
- Development Roadmap (خارطة طريق عملية لبناء تطبيق قرآني خطوة بخطوة)
- Available Apps (قائمة تطبيقات قرآنية مع معايير مقارنة)
- Technologies (قاعدة بيانات بالتقنيات المستخدمة مع تفاصيل مثل مجال الاستخدام، الرخصة، لغة البرمجة، سهولة الدمج، جاهزية المنتج، جودة التوثيق، والمنصات المدعومة).
أهم التقنيات المستخدمة في المشروع
- Markdown: جميع المحتوى يُكتب ويُنظَّم بصيغة Markdown، لذا أي تعديل سيكون على ملفات .md.
- GitHub Pages: المشروع يُنشر تلقائيًا كموقع توثيقي عبر GitHub Pages، لذلك أي تغيير في المحتوى ينعكس مباشرة على الموقع.
- Simple-DataTables: تُستخدم لتحسين الجداول (بحث – فرز – تصفية)، لذا عند إضافة جداول يجب الالتزام بالهيكل المتوافق معها.
- Search Index ديناميكي: يوجد فهرس بحث يتم توليده تلقائيًا، ويجب الانتباه لتحديث العناوين والمحتوى بطريقة قابلة للفهرسة.
- GitHub Actions: توجد Workflows مسؤولة عن تحديث بعض الملفات (مثل manifest و search index)، فلا تعدّل الملفات المولّدة يدويًا.
المهام المتاحة للمساهمة
تشمل المهام المفتوحة حاليًا في مشروع رتق:
- إصلاح مشكلة فهرسة الصفحات العربية في البحث
- إنشاء مصفوفة مقارنة بين APIs القرآنية
- إنشاء صفحة موارد للخطوط والطباعة (Fonts & Typography)
- تغليف كود Quran Analysis في تطبيق مستقل
- تغليف كود Alfanous في تطبيق مستقل
- إضافة توثيق لمصادر الصوت على مستوى الكلمة
لمزيد من التفاصيل، اطلع على المهام المفتوحة على GitHub:
https://github.com/Itqan-community/RATQ/issues
كيف يمكنك المساهمة في المشروع؟
- انتقل إلى مستودع رتق على GitHub.
- اطّلع على المهام المفتوحة واختر ما يناسب خبرتك.
- اطلب إسناد المهمة لك (Assign).
- بعد الإسناد، نفّذ المهمة على فرع مستقل وفق إرشادات المشروع.
- أرسل Pull Request للمراجعة والدمج
- بعد قبول المساهمة، وثّقها بردّ على الموضوع الحالي يتضمن رابط الـ Pull Request.
ملاحظة: يمكنك المساهمة في أكثر من مهمة داخل المشروع الواحد.
يهدف مشروع رتق إلى أن يكون المرجعية التقنية المفتوحة لتنظيم تطوير التطبيقات القرآنية، عبر خارطة طريق واضحة وقاعدة معرفة تجمع الأدوات وتكشف الفجوات وتوحّد الجهود من أجل تسريع البناء، وتقليل التكرار، ورفع جودة الحلول القرآنية الرقمية.
نرحب بكل من يرغب أن يكون جزءًا من هذا الأثر ويساهم في تحسين هذه المرجعية.
