نشر الأخ @abdullah mohammed في موضوع سابق عن مشروع quran-meta. وهي مكتبة تقوم بتوفير إحداثيات وهياكل دقيقة جداً لمقارنة وتقسيم الروايات الكبرى للقرآن الكريم: حفص، قالون، وورش.
ولكن، لكون هذه المكتبة "صامتة" برمجياً (Headless)، فإن المطور الراغب في استخدامها يحتاج إلى تثبيتها وتجربة استدعاء دوالها وطباعة المخرجات لمعرفة شكل البيانات وحدودها (مثل بداية الصفحات ونهايتها في كل رواية، أو تقسيم الأجزاء والأحزاب) - لذا أردت إنجاز صفحة Sandbox بسيطة يمكن من خلالها تجربة هذه المكتبة بتفاصيلها واستعراض ميزاتها.
الفكرة الأساسية: تقريب البيانات للمطورين
الهدف الرئيسي من هذا الـ Sandbox هو إظهار مدى فائدة وعمق مكتبة quran-meta للمطور الذي يريد بناء تطبيقات قرآنية (مثل تطبيقات الحفظ، القراءة، أو التحليلات الإحصائية).
بدلاً من قراءة ملفات التوثيق النصية أو تخمين شكل الكائنات البرمجية (Objects)، يتيح الـ Sandbox للمطورين رؤية الفوائد التالية بشكل عملي ولحظي:
فهم هياكل الروايات القرآنية ومقارنتها:
توفر المكتبة تقسيمات دقيقة للآيات والصفحات والأجزاء لكل رواية. من خلال مصفوفة المقارنة الموحدة في التطبيق، يمكن للمطور أن يرى فوراً كيف تختلف روايات حفص وقالون وورش في أعداد الآيات أو توزيع الصفحات والأجزاء والمنازل جنباً إلى جنب. كما تمت إضافة مؤشرات تنبيهية تبرز أي اختلاف برقم الآية أو الصفحة بين الروايات بشكل فوري، مما يسهل على المطور بناء تطبيقات تدعم روايات متعددة دون الوقوع في أخطاء التقسيم البنيوي.
الاستعلام البصري الفوري (Multi-Mode Search Playground):
تتضمن المكتبة محركات استعلام قوية جداً. يتيح الـ Sandbox تجربة هذه المحركات عبر 6 محاور استعلام تفاعلية (البحث عبر رقم السورة والآية، الصفحة، الجزء، المنزل، الركوع، أو الرقم المطلق للآية). بمجرد سحب أي منزلق (Slider)، تظهر للمطور البيانات المسترجعة كاملة وتفاصيل السورة المرتبطة بها، مما يمنحه تصوراً كاملاً عن كيفية الاستفادة من هذه الإحداثيات في ربط واجهات تطبيقه.
منظومة مطابقة وفحص صحة البيانات لحظياً (Real-Time Validation Suite):
لتأكيد الدقة، قمنا بدمج واجهة فحص ومطابقة البيانات مباشرة داخل التطبيق. تتيح هذه اللوحة تشغيل أكثر من 30,000 فحص وتأكيد برمي (Assertions) بشكل حي ومتسلسل ومقارنتها بـ 8 مصادر بيانات خارجية معتمدة (مثل Tanzil.net، AlQuran Cloud، ومصحف مجمع الملك فهد لخطوط حفص، شعبة، قالون، وورش). يعرض التطبيق لوحة أداء مضيئة للعدادات (عدد الفحوصات الناجحة، الاختلافات المكتشفة، سرعة المعالجة بالملي ثانية)، إلى جانب شاشة طرفية (Terminal Console) تعرض سجل التشغيل اللحظي بالتفصيل مع إبراز كيفية قيام المكتبة بتجاوز وتصحيح الأخطاء الموجودة في ملفات الجهات الخارجية تلقائياً.
روابط
