كيفية تجربة التعديلات التي تجريها كمساهم في برنامج منجم عبر جوجل كولاب
مشروع منجّم هو عبارة عن واجهة خلفية (Backend) وبرنامج لتزمين التلاوة القرآنية ومزامنتها مع النص بدقة عالية باستخدام نماذج الذكاء الاصطناعي.
من أبرز التحديات التي قد تواجهكم أثناء المساهمة في المشروع أو تجربة الشيفرة البرمجية بعد تعديلها، هو أن تشغيل نماذج الذكاء الاصطناعي يتطلب عادةً حواسيب تمتلك بطاقات رسومية (GPU) قوية، وهو ما قد لا يتوفر لدى الجميع.
لتسهيل الأمر وتسريع بيئة التطوير والاختبار، أعددت واجهة أمامية مخصصة لتجربة منجّم تتصل بخادم يعمل على Google Colab. بهذه الطريقة، يمكنك اختبار تعديلاتك وتجربة المزامنة سحابيًا دون استهلاك موارد جهازك الشخصي.
كيف تختبر تعديلاتك خطوة بخطوة؟
افتح أولًا واجهة برنامج منجم الموجودة على هذا الرابط:
https://alinice1998.github.io/munajjamfrontend/
وهي موجود في هذا المستودع إذا احتجت لتعديلها لتجريب ميزة لا تدعمها:
https://github.com/alinice1998/munajjamfrontend
ثم حدد الرواية، وانقر على زر أكواد التشغيل (COLAB). سيظهر لك كودين قم بنسخهما والاحتفاظ بهما، مع تعديل رابط المستودع داخل الكود ليُشير إلى مستودعك المُعدَّل بدلًا من المستودع الرسمي.
بعد ذلك توجه إلى Google Colab وأنشئ مفكرة جديدة، ثم اختر Change runtime type.
وتأكد من اختيار T4 GPU لكي تحصل على خادم بكرت شاشة يسرع عملية التزمين بدلًا من خادم بـ CPU فقط، ثم انقر على زر Save للحفظ.
بعد ذلك انقر على زر Code، وألصق الكود الأول من كودي كولاب اللذين احتفظت بهما، ثم انقر على زر تشغيل الموجود على جانبه.
ثم انتظر عدة دقائق، عادة بين دقيقتين و 4 دقائق، وإذا ظهر لك مربع يسألك فيما إذا كنت تريد عمل إعادة تشغيل للجلسة، انقر على زر Cancel.
وبعد الانتهاء من التنفيذ كرر نفس العملية للكود الآخر، وخلال ثوانٍ قليلة سيظهر لك رابط انسخه.
ثم عد إلى واجهة منجم الأمامية، وضع الرابط في حقل رابط خادم كولاب، ثم اختر السورة التي تريد مزامنتها وارفع الملف الصوتي الخاص بالتلاوة، ثم انقر على زر بدء المزامنة.
التأكد من دقة المزامنة
بعد انتهاء عملية المزامنة ستعمل التلاوة تلقائيًا مع تظليل لحظي للكلمات التي يتم نطقها، ويمكن النقر على أي كلمة لتشغيلها وحدها أو تشغيل آيتها للتأكد من أن مزامنتها قد تمت بشكل صحيح.
قبل إرسال PR يجب أن يتم اختبار التعديلات على سورة قصيرة وسورة طويلة بحد أدنى والتأكد من أن المشكلة المرتبطة بالمهمة تم حلها بشكل صحيح.
شكرًا جزيلًا لجهودكم، وأرجو أن تكون مساهماتكم في ميزان حسناتكم بإذن الله.
