المشكلة التي نشتغل عليها
لو أردت اليوم أن تبني تطبيقًا للقرآن الكريم، ستقضي أسابيعك الأولى في شيء لا علاقة له بفكرتك: البحث عن نص مصحف موثوق، وتفسير مرخّص، وترجمة يُسمح لك باستخدامها، وتلاوة بجودة مقبولة. تجمعها من مصادر متفرقة، ولا تعرف من أين جاءت بالضبط، ولا هل يحق لك نشرها أصلًا.
وعلى الطرف الآخر، الناشر الذي بذل سنوات في تدقيق تفسير أو تسجيل تلاوة يسلّم عمله ثم ينقطع خبره عنه. لا يعرف كم تطبيقًا يستخدمه، ولا كم قارئًا وصله، ولا إن كانت تصحيحاته اللاحقة قد وصلت إلى أحد.
فَنار منصة تقف بين الطرفين: الناشر يرفع محتواه القرآني برخصة واضحة وإصدارات مرقّمة، والمطوّر يصل إليه عبر واجهة برمجية موحّدة بنموذج طلب وموافقة. الطرفان يستفيدان، وهوية المستخدم النهائي لا تُسلَّم لأحد.
رؤيتنا: أن يكون بناء تطبيق قرآني أمرًا سهلًا — بلا احتكاك للمطوّر، وبشفافية كاملة للناشر.
أين وصلنا
قبل الحديث عن القادم، هذا ما صار جاهزًا فعلًا:
| ما تم إنجازه | الحالة |
|---|
| نموذج المحتوى (مورد أصل، بإصدارات ورخص) مع مسار الطلب والموافقة | مكتمل |
| تسجيل دخول المطوّرين والتحقق من التطبيقات | مكتمل |
| البيانات المرجعية للقرآن: ١١٤ سورة، ٦٢٣٦ آية، ٧٧٤٣٢ كلمة | مكتمل |
| تتبّع الاستخدام لكل طلب، منسوبًا للناشر | مكتمل |
| تحرير التفاسير والترجمات | قيد العمل |
| توقيتات التلاوة على مستوى الآية | قيد العمل |
الجدول الزمني
خارطة الطريق — الربعان الأول والثاني من 1448
الربع الأول (محرم – ربيع الأول)
١. تسجيل دخول يعرّف بنفسه
اليوم، ليستخدم المطوّر واجهتنا يحتاج خادمًا خلفيًا يحفظ فيه مفتاحًا سريًا. من يبني تطبيق جوال أو موقعًا فقط لا يملك هذا الخادم، فيتوقف عند الباب. الحل: مفتاح عام غير سرّي يُضمَّن في التطبيق مباشرة، مع معرّف مجهول لكل مستخدم نهائي يختاره المطوّر بنفسه — لا اسم ولا بريد ولا رقم. النتيجة: المطوّر يدخل بلا عوائق، والناشر يرى أثر محتواه، ولا أحد يحتفظ ببيانات شخصية.
٢. مجلدات التلاوة
التلاوة الواحدة للقارئ الواحد قد تصدر بأكثر من صيغة: صافية، وبصدى وترديد، وبجودات صوتية مختلفة، وأحيانًا مرئية. اليوم نضطر لمعاملتها كتلاوات منفصلة، فتتشتت وتضيع على المستمع. سنُدخل طبقة "مجلد" تجمع هذه الصيغ تحت تلاوة واحدة، لكل مجلد توقيتاته الخاصة — لأن الصدى يزيح مواضع الآيات.
٣. تقديم التلاوة آية آية
الآن التلاوة تُقدَّم سورة كاملة في ملف واحد. من أراد آية واحدة نزّل السورة كلها ورمى الباقي — وهذا هو الاستخدام الأغلب: مشغّلات الآيات، تطبيقات الحفظ، نتائج البحث. التوقيتات موجودة عندنا بالفعل؛ ما ينقص هو تقطيع الملفات وتقديمها، مع دعم نطاقات الآيات.
الربع الثاني (ربيع الآخر – جمادى الآخرة)
٤. مدير حزم للمحتوى
النصوص تُنزَّل مرة واحدة وتُدمج داخل التطبيق ثم لا تُحدَّث أبدًا، بينما الناشر يواصل التصحيح والتحسين. القارئ يبقى على نسخة قديمة، وتصحيح الناشر لا يصل. سنبني تجربة يعرفها كل مطوّر من npm وpip: ملف يعلن فيه المشروع أصوله بإصدارات محددة، وأمر itqan install يجلبها، وتحديث تلقائي يفتح طلب دمج عند صدور إصدار جديد.
٥. عرض البيانات للمطوّرين
قبل أن يبني المطوّر على بياناتنا يريد أن يراها: ما شكلها، وكيف ترتبط، وكيف تبدو فعلًا. صفحة لكل نوع تشرح البنية بلغة مفهومة بجانب مثال حقيقي — آية بتفسيرها وترجمتها وتوقيت تلاوتها.
٦. لوحات الاستخدام
للناشر: أين وصل محتواه وكم انتفع به. وللمطوّر: كيف يُستخدم تطبيقه.
٧. سجل التغييرات والتراجع
لا يوجد اليوم سجل يخبرنا من غيّر ماذا ومتى، ولا وسيلة للتراجع عن تعديل خاطئ أو حذف. المحتوى ملك الناشر وقابل للتعديل، فنحتاج تاريخًا موثوقًا وقدرة على استرجاع أي حالة سابقة عند الطلب.
نستقبل مساهماتكم — والباب مفتوح الآن
كل ما سبق مقسّم إلى مهام حقيقية على لوحة المشروع، وليست عناوين عامة: كل مهمة فيها سياقها، ومعايير قبولها، وروابط للكود الذي تمسّه.
لوحة المهام: github.com/orgs/Itqan-community/projects/12
المستودع: github.com/Itqan-community/cms-backend
كيف تبدأ
- جهّز بيئتك — اعمل Fork للمستودع واتبع دليل CONTRIBUTING.md.
- اختر مهمة — إن كانت أول مرة لك، ابدأ بالمصنّفة
Good First Issue (مهام صغيرة محدّدة). وإن أردت شيئًا أكبر، فانظر Help Wanted. وتجاوز ما عليه blocked — فهي تنتظر قرارًا أو مهمة سابقة.
- علّق قبل أن تبدأ — حتى لا يعمل اثنان على الشيء نفسه.
- اشتغل — فرع جديد من
staging باسم feat/<وصف-مختصر>، وتشغيل pre-commit install مرة واحدة.
- افتح طلب دمج — بوصف واضح لما غيّرته.
- راجع معنا — ملاحظاتنا للبناء لا للنقد.
قاعدة واحدة نطلب الالتزام بها
استخدام أدوات الذكاء الاصطناعي في عملك مرحّب به ومتوقّع — كلنا نستخدمها. لكن قبل أن تفتح طلب دمج، نطلب منك ثلاثة أشياء:
- أن تفهم الكود الذي تقدّمه، بحيث تستطيع شرح سبب عمله
- أن تشغّله على جهازك وترى بعينك أنه يعمل
- أن تختبره، بما في ذلك الحالات التي تتوقع فشلها
هذا مشروع مفتوح المصدر يخدم كتاب الله، ولكي يبقى بعدنا يحتاج أن يفهمه من يساهم فيه فهمًا حقيقيًا — وهذا الفهم هو ما نبنيه في الحقيقة. لو تعثّرت في منتصف الطريق فاذكر ذلك في التعليقات؛ عمل ناقص تفهمه أنفع لنا من عمل كامل لا تفهمه.
وإن عثرت على شيء لم نذكره — خلل، أو فكرة، أو تحسين — فافتح Issue على المستودع، أو اكتب لنا. لا تحتاج إذنًا لتبدأ.
جزاكم الله خيرًا على ما تقدّمونه لخدمة كتابه.
