مصطفى الخناني | مسؤول علاقات المطوّرين والشركاء (Developer Partner Advocate) في Quran.Foundation، اسألني ما تشاء
السلام عليكم ورحمة الله وبركاته،
بدأ عملي مع Quran.Foundation من رؤية مشتركة بيننا: أن يكون في مجال القرآن الرقمي محتوى موثوق، معلوم المصدر، مراجَع ومحقَّق من أهل العلم، ويبقى محدَّثًا أوّلًا بأوّل. كان هذا هو القاسم المشترك قبل أي شيء آخر. أصبحت مسؤولًا عن مبادرة التطبيقات المتّصلة (Connected Apps) ومتجر تطبيقات القرآن (Quran App Store)، بدأت أنظر في المسألة من زاوية المطوّر نفسه: ما العقبات التي ستواجهني كمطوّر حين أقرّر أن أبني شيئًا في هذا المجال؟
لكن المشكلة التي تتكرر أمامنا ليست نقص الشغف أو المهارة بقدر ما هي أن كل مطوّر جديد يواجه مجموعة من العقبات التي سبق أن حلّها مطوّرون آخرون عشرات المرات. وبناء على ذلك أعمل اليوم مسؤولًا عن علاقات المطوّرين والشركاء (Developer Partner Advocate)، وعلى معظم التواصل بين المطوّرين والمؤسسة.
سأعرض هنا العقبات الأكثر تكرارًا وما نقدّمه من أدوات للمطوّرين لتجاوزها. ستلاحظون أنها تتجمّع كلها في اتجاه واحد وهو المسار الذي ندعو إليه: أن يصبح تطبيقكم جزءًا من منظومة متّصلة في مبادرة متجر القرآن (quran.com/apps)، هدفها النهائي أبعد من التطبيق نفسه، وهو أن ينتقل المستخدم من مجرد فتح المصحف إلى علاقة أعمق وأدوم مع القرآن.
ما الذي يمكنكم البناء عليه اليوم؟
من خلال أدوات المطوّرين (Developer Tools) المتاحة لدينا، والتي تتمحور حول أربعة محاور كبيرة من خلالها يمكنكم أن تتخطوا هذه العقبات بإذن الله.
المحور الأول ويشمل:
واجهاتنا البرمجية للمحتوى (Content APIs)
هذه أول عقبة يصطدم بها الجميع تقريبًا، من أين نأتي بالمحتوى وكيف نعرف أن ما نبنيه صحيح؟ (Scholarly Reviewed Verified Content). يبدأ المطوّر بتجميع النصوص والترجمات والتفاسير من مصادر متفرقة على GitHub وغيره، فيحصل على نسخة تعمل، لكنها غير مُحدثة. ولذلك ما نقدّمه من خلال واجهاتنا البرمجية للمحتوى (Content APIs) هو محتوى موثوق، معلوم المصدر، مراجَع ومحقَّق من أهل العلم، ومصان بحيث تبقى تحديثاته وتصحيحاته متصلة بما يصل إلى المستخدم: فستجدون الترجمات والتفاسير، الدروس والتدبّرات، الأسئلة والأجوبة، المقالات وخطط التعلّم، وملف حقائق القراءات، وإلى جانبه محتوى من شركاء علميين ومؤسسات موثوقة، مثل معهد يقين للبحوث الإسلامية (Yaqeen Institute for Islamic Research) والقرآن تدبّر وعمل (Quran Tadabbur wa Amal) وغيرهم.
واجهاتنا البرمجية للمستخدمين والحسابات والهوية (User-Related APIs, OAuth & Identity)
بناء نظام مصادقة آمن (authentication) يستهلك وقتًا وجهدًا. فنحن ندرك أن من بنى نظامه الخاص فقد أنجز عملًا محمودًا لا يُنقص منه شيء. لكن استخدام نظام التفويض المفتوح (OAuth) الخاص بـ Quran.Foundation يرفع عنكم هذا العبء ابتداءً، ومن لديه نظام قائم يستطيع الانتقال إليه ليستفيد من تسجيل الدخول الموحّد (SSO) واستمرارية رحلة المستخدم (User Journey Continuity) عبر المنظومة. ولا يتوقف الأمر عند تسجيل الدخول؛ إذ توفّر واجهات المستخدم (User APIs) مجموعة من الوظائف الجاهزة التي يمكن البناء عليها بدل تطويرها من الصفر في كل تطبيق، مثل العلامات المرجعية (bookmarks)، والملاحظات والتدبّرات (notes/reflections) وغيرها. وبذلك يستطيع المطوّر أن يركّز أكثر على التجربة والقيمة المميّزة لتطبيقه، مع الاعتماد على بنية Quran.Foundation في الوظائف المشتركة بين التجارب القرآنية.
المحور الثاني يشمل بروتوكول سياق النموذج القرآني (Quran MCP)
خادم MCP قرآن (mcp.quran.ai) يتيح لنماذج الذكاء الاصطناعي الوصول إلى المحتوى القرآني الموثوق والبحث فيه واسترجاع مصادره عبر واجهة موحّدة، ويمكن ربطه مباشرة بتطبيقاتكم إذا كنتم تطوّرون ميزات تعتمد على الذكاء الاصطناعي.
المحور الثالث يشمل معمل أبحاث القرآن (Quran Labs)
يقدّم Quran Labs عبر labs.quran.com مساحة مخصّصة للمشاريع والأفكار التي ما تزال في مراحلها المبكرة؛ من بلورة الفكرة والاستكشاف (Ideation)، إلى التجارب الأولية وإثباتات المفهوم (Proofs of Concept)، ثم بناء النماذج الأولية (Prototypes) واختبارها أثناء التطوير. يتيح Quran Labs للمجتمع تجربة أفكار واتجاهات جديدة، والتحقق من جدواها وتعلّم ما يصلح منها، قبل أن تتحول إلى منتجات أو تجارب أكثر نضجًا.
المحور الرابع: مسار التطبيقات المتصلة ومتجر القرآن (Connected Apps Path & Quran App Store)
هذه المبادرة تجمع ما تحدثنا عنه حتى الآن، وتجيب عن سؤال مهم لأي مطوّر: «من سيرى ما بنيت؟» (Discoverability). فهي تجمع بين محتوى موثوق يبقى محدَّثًا، ومراجعة شرعية تساعدكم على اتخاذ قرارات المنتج بثقة، وهوية موحّدة تربط تجربة المستخدم عبر المنظومة، ثم تمنح التطبيقات المؤهلة فرصة الوصول إلى جمهور واسع من مستخدمي تطبيقات القرآن.
أولًا، المراجعة الشرعية والتقنية
أغلبنا يواجه أثناء بناء منتج قرآني أسئلة من نوع: كيف تُعرض الترجمة؟ وما التفاسير الأنسب للجمهور المستهدف؟ وما الذي يصحّ أن يقوله نموذج ذكاء اصطناعي عن آية؟ ضمن مسار التطبيقات المتصلة (Connected Apps) يمرّ التطبيق بمراجعة شرعية إلى جانب المراجعة التقنية. والغاية ليست وضع عقبة أمامكم إطلاقًا، بل أن تحصلوا على رأي متخصص يساعدكم في اتخاذ هذه القرارات قبل أن يصل المنتج إلى المستخدم، لا بعد ذلك.
ثانيًا، الاكتشاف والوصول إلى المستخدمين
بعد قبول التطبيقات المناسبة، يتم عرضها على صفحة التطبيقات المتصلة (quran.com/apps)، بينما أكثر التطبيقات تكاملًا مع واجهاتنا البرمجية (Content & User APIs, and OAuth) تحصل على حضور أكبر، بما في ذلك الظهور على الصفحة الرئيسية. فكثير من التطبيقات عالية الجودة لا تُهمَّش لقصور في قيمتها، بل لأنها لا تمتلك قنوات كافية للوصول إلى جمهورها. وهنا تأتي قيمة هذا المسار: أن يصبح ما تبنونه قابلًا للاكتشاف داخل المنظومة نفسها. فـQuran.com وتطبيقاتنا تخدم أكثر من ٨٢ مليون مستخدم نشط سنويًا، وأكثر من ١٠٠ مليون مستخدم عبر منصاتنا مجتمعة، بينما تخدم واجهاتنا البرمجية (APIs) نحو ٤٥ مليون طلب شهريًا.
هذا هو هدف التطبيقات المتّصلة (Connected Apps): ألّا يبدأ المستخدم من الصفر في كل تطبيق، بل تكون رحلته واحدة متصلة. غايتنا ليست عدد التطبيقات في المتجر، بل أن تتضافر هذه التجارب حتى تُحدث أثرًا حقيقيًا: أن ينتقل المستخدم من الاطّلاع إلى الفهم، ومن الفهم إلى التدبّر، ومن التدبّر إلى عمل يدوم. وتطبيقكم قد يكون هو الخطوة التي كانت ناقصة في هذه الرحلة.
من أين تبدأ عمليًا للالتحاق بمسار التطبيقات المتصلة ومتجر القرآن؟
الرحلة كلها تبدأ اليوم من لوحة تحكّم المطوّرين (Developer Console)، وليست من نموذج طلب كما كان سابقًا.
سجّل الدخول إلى لوحة التحكّم بحساب Quran.Foundation الخاص بك.
أنشئ تطبيقك الأول، وستحصل على بيانات الاعتماد (API credentials) مباشرة.
اطّلع على وثائق الواجهات البرمجية (API docs) للتعرّف على ما هو متاح.
أضف روابط تطبيقك، واطلب الصلاحيات (scopes) التي تحتاجها للإنتاج، وتابع حالة طلباتك من اللوحة نفسها.
لوحة تحكّم المطوّرين: Developer Console - https://dev-console.quran.foundation/login
رحلة المطوّر والوثائق: Developer journey - https://api-docs.quran.foundation/docs/developer-journey
إن كنت تستخدم محتوانا أو OAuth أو واجهات المستخدم (User APIs) ببيانات اعتماد حصلت عليها من Quran.Foundation قبل إطلاق لوحة التحكّم، فيمكنك استيراد تطبيقك من خلال اللوحة.
يمرّ التطبيق بأكثر من مراجعة من أهدافها إفادة المطوّر نفسه:
- مراجعة شرعية (Scholarly Review) عبر هيئة علمائنا (Scholars Panel)، للتأكد من أن التطبيق يتوافق مع رؤيتنا وأنه نافع للمستخدم فعلًا.
- مراجعة تقنية (Technical Review) من فريق الهندسة، تنظر في البنية والأداء والاعتمادية.
- مراجعة لتجربة المستخدم (UX Review) من فريق التصميم.
- ثم نعمل معكم على الملاحظات في جولة تعديل وإعادة نظر، حتى يصل المنتج إلى المستوى المناسب للإدراج.
والملاحظات لا تأتي من جهة واحدة، ولا نقول «مرفوض» ونمضي. تصلكم من العلماء في المحتوى، ومن فريق التصميم في التجربة، ومن المهندسين في البنية والأداء.
والأهم عندنا أن هذه الفترة هي التي نتعرّف فيها عليكم فعلًا. نفهم إلى أين يتّجه تطبيقكم، وما خارطة طريقكم (Roadmap) للمرحلة القادمة، وأين نستطيع أن نعينكم. ولهذا تأخذ العملية وقتها؛ هي متأنّية بقصد، لأنها ليست إجراء قبول بقدر ما هي بداية علاقة عمل نرجو أن تطول.
ملاحظة بشفافية: إمكانية تقديم طلب الانضمام من داخل لوحة التحكّم ما زالت في مرحلة الاختبار، وستصدر قريبًا بإذن الله، ومعها وثائق التطبيقات المتّصلة كاملة (Connected Apps Documentation). يرجى التواصل معنا من خلال مراسلتنا على developers@quran.com إلى حين.
سؤالي لكم
ما الذي اضطررتم إلى بنائه بأنفسكم وكنتم تتمنون أن تجدوه جاهزًا كواجهة برمجية أو خدمة؟ وأين ترون فجوة في تجربة المستخدم العربي على Quran.com أو في التطبيقات القرآنية عمومًا، ما زالت تنتظر من يعالجها؟
اسألوني عمّا شئتم
رؤيتنا لهذا المتجر قائمة على التعاون لا المنافسة. إن بنى أحدكم شيئًا نافعًا، فرغبتنا أن نعينه على تطويره وأن نوصله إلى الناس، لا أن نعيد بناءه. نسعى أن يكون الأساس المشترك جاهزًا للجميع، حتى ينصرف وقتكم إلى ما يميّز تطبيقكم وحده.
ومن أراد مكالمة مباشرة، يسعدني ذلك، ويمكنه حجز موعد هنا: https://calendar.app.google/2Nx32EZSgwXkPiJX6
جزاكم الله خيرًا على ما تبنونه، وبارك الله في جهودكم.
وعليكم السلام ورحمة الله وبركاته.
