جزاكم الله جميعًا خير الجزاء على تفاعلكم ودعمكم واعتذر جداً منكم على التأخر في الرد
شكراً أخت دينا أحمد
فكرة ال Webhook notifications رائعة فعلًا ويمكن أن تكون من أهم القيم المضافة النوعية في النظام
فكرة مشاركة التحديثات للموارد القرآنية بشكل فوري ومؤتمت (بشكل عام) هو شيء مهم ويمكن اعتباره لجميع الموارد القرآنية (تلاوات، تفاسير، تراجم، الخ) ولجميع المستخدمين للمنصة (مطورين/باحثين/مهتمين) سواء كان الاستخدام للموارد عن طريق apis أو عن طريق التحميل المباشر للملفات أو غير ذلك.
هناك أفكار كثيرة أيضاً في هذا السياق منها مثلاً إضافة قسم Update Feed أو "سجل تحديثات موحّد" في النظام بشكل أو بآخر مع إمكانيات عرض وفلترة مرنة بحيث يمكن متابعة التحديثات بسهولة من النظام أو ربط ذلك عن طريق webhooks أو apis خاصة. كذلك ممكن في حالات معينة إرسال email notifications لمن قام بتحميل الملفات (offline consumers)، وغير ذلك.
بصراحة أود معرفة إن كان لديكِ:
- اقتراح أو تفضيل معين لتصميم أو شكل التنبيهات في النظام بنظرة تفصيلية أكبر (بالاعتبارات المذكورة)
- تفاصيل أخرى ذات علاقة، تجارب سابقة، أمثلة معينة تودي مشاركتها أو لفت النظر إليها أو ممكن تفيدنا
بحيث يتم اعتبار ذلك أثناء التخطيط للنسخ والتطويرات القادمة للنظام إن شاء الله
شكراً أخت رقية بورية
اقتراح رائع وفي محله. توضيح الرواية المستخدمة (ورش، حفض، الخ) أو مثلاً نوع التلاوة (مرتلة، مجودة) أو تفاصيل أخرى خاصة بالرواية وطريقة القرآءة (بالقصر، بالتوسط، بالجمع)، حجم الملف، امتداده، الخ (أي بيانات وصفية metadata مرتبطة بالتلاوة) توضّح التفاصيل وتسّهل الاستخدام حسب الحاجة.
نفس الملاحظة أضافها الأخ @عادل بن يحي مشكورًا هنا: https://github.com/Itqan-community/cms-backend/issues/131 وكما تم ذكره، سيتم اعتبار ذلك في التحديثات القريبة للنظام إن شاء الله.
شكرًا كذلك على لفت نظر الأخ عادل لاستخدام التلاوات في تطبيقه Open Tarteel. في الحقيقة كنت أنوي الإشارة لذلك أيضًا. وبدأت فعلياً تخيل كيف ممكن أن يتم ذلك بسهولة والتفكير في النقاط التالية:
- كما ذكر الأخ عادل أنه استخدم mp3quran ك مزود خدمة رئيسي لجلب التلاوات في Open Tarteel، هل سيكون من المباشر استخدام مزود آخر للتلاوات (اتقان) مع اختلاف شكل المخرجات للتلاوات / API responses؟ إلى أي مدى سيكون ذلك مباشرًا؟ اعتقد ذلك يتطلب بناء adapters لتوحيد interface واحدة للتلاوات ليتم استخدام ذلك في التطبيق بسهولة (بغض النظر عن المصدر الناشر وشكل المخرج للتلاوات)
- بعض التحسينات والإضافات المتطلبة/الرئيسة
أود فعلاً معرفة إن كان لديكِ اقتراحات أو نقاط أخرى تسهم في تسهيل استخدام اتقان apis من قبل المطورين
مثل الأخ عادل و تطبيق "Open Tarteel" أو الأخ طارق منصور وتطبيق "الكتاب" أو غيرهم
شكراً أخ عادل بن يحي
سيكون فعلاً من أجمل الأخبار إضافة تلاوات اتقان في تطبيق Open Tarteel
من فضلك أود معرفة:
- ما المقصود بعمليات التصنيف والبحث التي أشرت إليها؟
- أي اقتراحات أو تفضيلات أو اعتبارات تحب تشاركها معنا للتحديث القادم؟
بالفعل نقوم حاليًا ببعض التحسينات والإضافات وسيتم الانتهاء والاعلان عن ذلك قريبًا إن شاء الله، ولكن إن كان هناك نقاط تود لفت النظر إليها سنحاول أخذ ذلك في الاعتبار في أقرب وقت ممكن في التحديث القادم والتحديثات المقلبة القريبة إن شاء الله
شكراً أخت علا صالح
تجربتك العملية للنظام اهتمامك بالتفاصيل ومشاركة الملاحظات كان له أثر فعلي في تحسين النظام وإثراء النقاشات.
تم توضيح وحل المشكلة مسبقًا ولكن للتأكيد ولفائدة الجميع هنا
مشكلة ال CORS من أشهر المشاكل حدوثا في عالم تطبيقات الويب، وهي built-in security feature في المتصفحات تمنع من اختلاف ال origins (الطالب للبيانات -في هذه الحالية ال localhost- مختلف المقدم لهذه البيانات -في هذه الحالة خادم اتقان-) إلى بسماحية وتطبيق معين.
الحل الأمثل الذي تم تطبيقه هو أن يقوم ال web server بإضافة header خاص وهو Access-Control-Allow-Origin على كل response (عم طريق middleware) لتخطي حاجز CORS في المتصفحات. وباعتبار أن APIs المقدمة من نظام إدارة المحتوى هي لكل المطورين لبناء تطبيقات قرآنية (من ضمن ذلك web apps) يُفترض يجب السماح لكل ال origins بتخطي هذا الحاجز لدعم جميع ال web apps
ملاحظة: باعتبار أن ال CORS لها علاقة في المتصفحات بالذات، لم تظهر هذه المشكلة أثناء اختبار ال APIs على postman أو curl عند تنفيذ http requests مباشرة
شكراً أخ هادي الأحمد
متشوق لمعرفة تجربتك للنظام والتعاون في أي مساهمات أو تحسينات
في الختام، المجال مفتوح ونرحب بأي مساهمات في المشروع. سيكون هناك إعلان لأي تحديثات رئيسة أو مساهمات مجتمعية إن شاء الله
