439,376

عدد المواد التي أصبحت منصة باحث تستضيفها بشكل مباشر ولا تعتمد على YouTube اعتمادا كاملا في عرضها للمستخدم!

لم أتصور يوما أن تصل منصة باحث إلى هذا الحد، ولكنه توفيق الله سبحانه وتعالى.

ساهم أحد الإخوة -جزاه الله عنا وعن المسلمين خير الجزاء- في منصة باحث من خلال توفير خادم لنستخدمه في استضافة المواد الموجودة على المنصة بصيغة صوتية (لتوفير المساحة) وتخيير المستخدم بين متابعة المواد من خلال YouTube صوتا وصورة أو متابعتها صوتيًّا فقط من خلال صوتيات باحث والاستفادة من:
- عدم وجود الإعلانات
- إمكانية تشغيل المواد في الخلفية (إمكانية إغلاق التطبيق أثناء الاستماع)
- متابعة المواد المحذوفة من YouTube

تقنيًّا، لم يكن الأمر معقدًّا، كل ما قمت به هو ضغط صوتيات المواد من خلال استخدام صيغة Opus ضمن حاوية WebM و Bitrate يساوي 28K، مما أدى إلى تقليل مساحة الصوتيات من 8TB إلى 1.7TB مع المحافظة على جودة صوت ممتازة، خصوصا وأن أغلب الصوتيات يتكلم فيها شخص واحد فقط.

بعد ذلك رفعت الصوتيات إلى الخادم الجديد من حاسبي الشخصي، واستغرقت هذه العملية 5 أيام تقريبا 😁، وأخيرا وضعت NGINX على الخادم لتمكين باحث من الوصول إلى هذه الصوتيات (وكل شخص على الشبكة فعليا 😂).

من جهة منصة باحث أضفت مصدرًا جديدًا لعرض المواد وكتبت الشيفرة البرمجية الخاصة به، ولم يكن الأمر صعبًا، حيث أنه مشابه إلى حد كبير لما قمت به عندما استخدمت GitHub لعرض بعض المواد المحذوفة من YouTube.

الحمدلله أصبح بإمكان مستخدمي باحث متابعة الدروس الشرعية والمحاضرات النافعة دون الحاجة لمشاهدة إعلانات YouTube مع إمكانية إغلاق التطبيق أو شاشة الهاتف أثناء الاستماع وحافظنا في نفس الوقت على تراث العلماء والمشايخ والدعاة من الحذف.

أيضًا، إذا قمت بتسجيل الدخول إلى منصة باحث، ستستطيع تحديد ما إذا كنت تريد المتابعة بشكل افتراضي من صوتيات باحث أو من YouTube!

حسب التقديرات، فالتجهيزات الحالية تسمح بعدد مستمعين متزامنين للمواد الصوتية بين 5 آلاف و 10 آلاف مستخدم، وهو عدد أكثر من كافٍ حسب إحصائيات مستخدمي المنصة.

لم يكن هذا بالإمكان لولا توفيق الله عز وجل ومن ثم مساهمة الإخوة سواء بتوفير الخادم أو بالنصائح التقنية، والقادم بإذن الله أفضل 😎

والسلام عليكم 👋🏻

احتجت في الأيام الماضية إلى استخدام أكثر من بريدٍ إلكترونيٍّ مع Git حسب المشروع الذي أعمل عليه، فبدأت البحث في الأمر للمرة الثانية في حياتي، لأن المرة الأولى بائت بالفشل 😂 فاكتشفت أن الأمر سهل، لكنه يحتاج إلى فهمٍ لما تقرأ 😁

ينقسم الأمر إلى خطوتين، إنشاء مفتاح SSH جديد وتخصيص البريد الإلكتروني واسم المستخدم الذي تريد استخدامهما مع المستودعات المختلفة.

نفّذ الأمر التالي لإنشاء مفتاح SSH جديد:

ssh-keygen -t ed25519 -C "email@example.com"

بعد ذلك، ستحتاج إلى إضافة المفتاح الجديد إلى GitHub (إذا كنت تستخدمه) وستحتاج إلى تنفيذ الأمر التالي لإضافة المفتاح الجديد إلى SSH:

ssh-add ~/.ssh/id_ed25519_example

ثم أضف المحتوى التالي إلى ملف config داخل مجلد ssh./~ لتتمكن من استخدام المفتاح الجديد مع Git:

Host github-example
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519_example

وأخيرا، عند إضافتك للـ Remote إلى مستودعك، يجب أن تستخدم نفس اسم الـ Host الذي وضعته في ملف config قبل قليل (في حالتنا الـ Host هو github-example):

git remote add origin git@github-example:username/repo.git

لتنفيذ الخطوة الثانية، وهي تخصيص البريد الإلكتروني واسم المستخدم حسب المستودع، نحتاج إلى تعديل ملف gitconfig./~.

داخل هذا الملف ستجد المعلومات الافتراضية الخاصة بك في Git كالتالي:

[user]
name = Ali Hamdi Ali Fadel
email = aliosm1997@gmail.com

لنفترض أن المستودعات الخاصة بالبريد الإلكتروني الجديد موجودة داخل مجلد واحد على حاسبك وهو Users/aliosm/Desktop/repositories/other_email/، لتعديل البريد الإلكتروني واسم المستخدم لكل المستودعات الموجودة داخل هذا المجلد سنحتاج إلى إضافة الإعدادات التالية إلى الملف المذكور في الأعلى:

[includeIf "gitdir:/Users/aliosm/Desktop/repositories/other_email/"]
  path = /Users/aliosm/Desktop/repositories/other_email/.gitconfig

وأخيرا، ستحتاج إلى إنشاء ملف gitconfig. داخل مجلد other_email وتضع فيه بريدك الإلكتروني الثاني واسم مستخدم مختلف:

[user]
name = Ali Hamdi Ali Fadel
email = different@email.com

قد تبدو الخطوات كثيرة، لكن إذا طبقتها بالشكل الصحيح، سينجح الأمر وسترتاح من تداخل البريد الإلكتروني بين مشاريعك وحساباتك على Git و GitHub 😎

والسلام عليكم 👋🏻

ملاحظة: كل الأوامر ومحتويات الملفات موجودة في الصورة ومرتبة حسب ترتيب ظهورها في المنشور 😁

أول 200 سطر برمجي في منصة باحث من كتابة أحد غيري!

خلال آخر سنة ونصف، كنت وحيدًا في الشيفرة البرمجية لمنصة باحث، أكتب وأكتب وأكتب دون أن يُراجع أحد ما أكتب (والله وحده يعلم بالأخطاء) ودون أن يكتب أحد معي، ولكن تغيّر كل شيء خلال الأسبوع الماضي، أخيرًا وبعد طول عناء 😂

أضفنا البارحة (ولله الحمد، فالجمع في هذه الجملة جمعٌ حقيقي على عكس منشوراتي السابقة) ميزة جديدة إلى منصة باحث، وهي ميزة "السجل"، حيث أصبحت المنصّة تحتفظ بتقدّمك في مشاهدة المواد وتعرضه لك في صفحة السجل كما هو موضّح في الصورة المرفقة.

كذلك، عند فتح نفس المادة مرة أخرى، سيبدأ التشغيل من آخر نقطة كنت تشاهد عندها.

أضفت ميزة إعادة تشغيل المادة من آخر نقطة كنت تشاهدها منذ فترة، لكنني لم أُضف صفحة السجل بسبب الكسل 😁 فطلبت من أحد الأصدقاء إضافة هذه الميزة للتعرّف على شيفرة المنصة، ولله الحمد، انتهى منها في عضون أيام 🚀

من فوائد التعاون في تطوير هذه الميزة:
- اختبار جاهزية بيئة التطوير للعمل على أجهزة مختلفة، واكتشفنا خلال هذه التجربة بعض الأمور التي يمكن تحسينها بخصوص بيئة التطوير
- اختبار مدى قابلية الآخرين على فهم الشيفرة البرمجية الخاصة بالمنصة والتعديل عليها والبحث داخلها
- خطوة أولى لي في طريق بناء فريق يُساعد في تطوير ومتابعة المنصة

فالحمدلله على نعمائه، وانتظروا المزيد من الميزات التي لن أكتبها بيدي 😎

والسلام عليكم 👋🏻

قال صلى الله عليه وسلم: "إنَّ اللهَ لا يقبضُ العلمَ انتزاعًا ينتزعُهُ منَ النَّاسِ، ولَكن يقبضُ العلمَ بقبضِ العُلماءِ، حتَّى إذا لم يترُك عالمًا اتَّخذَ النَّاسُ رؤوسًا جُهَّالًا، فسُئلوا فأفتوا بغيرِ عِلمٍ فضلُّوا وأضلُّوا".

تُوُفّي اليوم الشيخ المُحدّث أبي إسحاق الحويني، الذي أفنى عمره في خدمة السُّنة النبوية ونشر العلم الشرعي.

لم أدرس كتابا أو متنا كاملا على الشيخ من خلال شروحاته، لكنني شاهدت العديد من محاضراته المتفرقة والتي أثّرت في وعي الإنسان وطريقة تفكيره وديانته.

نسأل الله أن يرحمه رحمةً واسعة، وأن يجزيه عن الإسلام والمسلمين خير الجزاء، وأن يُسكنه الفردوس الأعلى من الجنة، وأن يُلهم أهله ومُحبيه وطلابه الصبر والسلوان.

ولمن أحب أن يستفيد من علم الشيخ، فهذه قناته على YouTube:
https://youtube.com/@alhewenytube

وهذه صفحته على منصة باحث:
https://baheth.ieasybooks.com/speakers/أبو-إسحاق-الحويني

في Ruby on Rails، وبشكل افتراضي، يوجد ملف واحد لتعريف الـ Routes في مشروعك وهو ملف config/routes.rb.

بمرور الأيام وتعاقب السنين يطول هذا الملف ويتعقّد، خصوصا عند وجود Routes للـ APIs وأخرى للوحة إدارة التطبيق، بالإضافة إلى الـ Routes الخاصة بالتطبيق نفسه والتي يستخدمها المستخدم العادي.

هذا ما حدث البارحة في منصة باحث، فقررت تجربة أمرين:
- فصل هذا الملف إلى ملفات أصغر
- إجراء هذا التعديل باستخدام الـ Agents، وتحديدا محرر Cursor

لفصل ملف config/routes.rb إلى ملفات أصغر يجب إنشاء مجلد جديد باسم config/routes، ثم إنشاء ملفات أصغر داخل هذا المجلد، فمثلا ملف config/routes/api.rb للـ Routes الخاصة بالـ APIs وملف config/routes/admin.rb للـ Routes الخاصة بلوحة التحكم.

بدايةً، طلبت من Cursor استخراج الـ Routes الخاصة بالـ APIs إلى ملف منفصل، وفعلا أنشأ المجلد المطلوب وملف api.rb ونقل الشيفرة البرمجية من ملف routes.rb إليه وقام باستخدام الملف الجديد في الملف الأساسي من خلال كتابة draw(:api) وهذه هي طريقة استخدام الملفات الفرعية في الملف الأساسي للـ Routes في Rails.

انتقلت بعدها إلى الـ Routes الخاصة بلوحة التحكم، ونفّذ الـ Agent نفس الأمر.

الملف أصبح أكثر تنظيما، وتجربة الـ Agents كانت لطيفة. أجريت بعض العديلات الأخرى على الملف وأضفت Routes جديدة لإعادة التوجيه، ولكن احتاج الـ Agent إلى مساعدة لإجراء بعض التعديلات المعقدة، رغم استخدامي لأفضل النماذج المتاحة Claude Sonnet 3.7 Thinking.

والسلام عليكم 👋🏻

كنت أفكر البارحة في إعادة ترتيب وتنظيم أحد الـ Classes المهمة في منصة باحث وهو الـ Class المسؤول عن إنشاء كل الأوامر الخاصة بتفريغ المواد ونقلها من الحاسب الشخصي إلى خادم باحث وإدخالها إلى المنصة وغيرها من الأوامر.

قررت استخدام الذكاء الاصطناعي في هذه العملية ولكن كان لدي سؤال: "كيف سأتأكد من أن الترتيب والتنظيم الذي قام به الذكاء الاصطناعي صحيح ولم يُغيّر مخرجات الـ Class؟"، فكان الحل هو إنشاء حالات اختبار في البداية قبل ترتيب وتنظيم الملف.

طلبت من الذكاء الاصطناعي كتابة حالات اختبار للملف باستخدام مكتبة RSpec، وفعلا قام بإضافة ملف جديد وأضاف إليه حالات الاختبار لكل الدوال الموجودة في الـ Class، لكنه أخطأ في اختبار دالة واحدة من أصل 10.

قضيت بعض الوقت في إصلاح هذا الخطأ ووصلت نسبة تغطية الشيفرة البرمجية بحالات الاختبار إلى 100%.

بعد ذلك طلبت منه ترتيب وتنظيم الملف وإعادة صياغة بعض الدوال الموجودة فيه مع المحافظة على نجاح حالات الاختبار الخاصة به، وفعلا أعاد ترتيب وتنظيم الملف وأنشأ دوال جديدة وأصبح الملف أفضل بكثير.

أخيرا، طلبت منه إعادة ترتيب وتنظيم ملف الاختبارات ليتماشى مع ملف الـ Class الجديد من حيث تنظيم الدوال وتجميع حالات اختبارها بناء على الوظيفة التي تُقدّمها.

كمُلخّص، إذا كان لديك حالات اختبار، فاستخدام الذكاء الاصطناعي في إعادة ترتيب وتنظيم الشيفرة البرمجية الخاصة بك هو أمر آمن إلى حد كبير، ولكن إذا لم تمتلك حالات اختبار لشيفرتك البرمجية، فابدأ بإنشاء حالات اختبار باستخدام الذكاء الاصطناعي ثم اطلب منه إعادة ترتيب وتنظيم الشيفرة البرمجية.

والسلام عليكم 👋🏻

الحلول الغريبة

عندما أنشأت مكتبة تحويل (رابطها في الأسفل)، لتحويل الصور وملفات PDF إلى نصوص، لم أكتب حالات اختبار لضيق الوقت أولا وللكسل ثانيا 😁

بعد فترة من التطوير، احتجت إلى إضافة حالات اختبار لكي لا أختبر المكتبة في كل مرة أُعدّلها، فلمعت في ذهني الفكرة التالية:

بدلا من كتابة حالات اختبار طبيعية كما يكتبها المطورون الآخرون تختبر كل جزء في المكتبة بشكل منفصل، قررت كتابة حالات اختبار تختبر المكتبة من خلال تشغيلها والتحقق من مخرجاتها النهائية (End-to-end).

فقررت إنشاء GitHub Action يُثبّت المكتبة ويبدأ في إرسال الملفات إليها والتأكد من أن المخرجات سليمة كما هو متوقّع، فكتبت 12 حالة تجدها في هذا الملف:
https://github.com/ieasybooks/tahweel/blob/main/.github/workflows/tests.yml

في كل مرة أُعدّل فيها المكتبة أو يُرسِل أحدهم تعديلًا، يعمل هذا الـ Action ليُخبرنا أن التعديل الجديد لم يؤثر على عمل المكتبة 🥳

الحمدلله كان هذا حلًّا جيِّدا في حالة تحويل، لكنه ليس الأمثل بكل تأكيد.

هذا رابط المكتبة:
https://github.com/ieasybooks/tahweel

والسلام عليكم 👋🏻

استعراض 10 مميزات جديدة في منصة باحث 🚀

0️⃣ البرامج العلمية
1️⃣ تشكيل التفريغات
2️⃣ نسخ التفريغات
3️⃣ صوتيات باحث
4️⃣ تفضيل المتحدثين
5️⃣ Yamli
6️⃣ تفضيل صوتيات باحث
7️⃣ تمييز كمُشاهَد
8️⃣ الملاحظات
9️⃣ تتبع المشاهدة

رابط المقطع على YouTube:
https://youtu.be/BmgzPva671I

رابط موقع المنصّة
رابط تطبيق المنصّة لأجهزة Android
رابط تطبيق المنصّة لأجهزة iPhone
رابط بوت المنصّة على تيليجرام

كل عام وأنتم بخير، وأعاده الله علينا وعليكم بالصحة والعافية، وفرّج الله عن المسلمين ما هم فيه ❤️

#مساعدة

لخبراء GCP، أستخدم Service Account Credentials للتعامل مع Google Drive API وكانت تعمل بدون مشاكل في الأشهر السابقة، ولكن بدأت أواجه مشكلة TimeoutError: [Errno 60] Operation timed out بشكل عشوائي خلال الأربعة أيام السابقة.

غيرت الحاسوب وشبكة الانترنت وحدّثت الاعتماديات واستخدمت Service Account جديد وبحثت في Google ولم أصل إلى أي نتيجة، مع العلم أن سرعة الانترنت عندي 100Mbps!

وجدت شخصا طرح مشكلة مشابهة لمشكلتي على StackOverflow من يومين، وهذا رابط سؤاله:
https://stackoverflow.com/questions/79543938/google-api-python-client-random-timeout-error

فهل من أي نصائح؟

هذه هي الشيفرة البرمجية التي تستخدم الـ Service Account Credentials وتتعامل مع Google Drive API:
https://github.com/ieasybooks/tahweel/blob/main/tahweel/processors/google_drive_base_ocr_processor.py

الناس: الذكاء الاصطناعي خطير وسيأخذ وظائفنا
أنا في السوق:

محطة جديدة في رحلة منصة باحث: الانتقال من ChromaDB إلى Qdrant 🚀

الحمدلله رب العالمين، خطوة الانتقال هذه كانت مؤجّلة منذ أشهر طويلة، ولكن بعد الانتقال من Kamal V1 إلى Kamal V2، وكمال هي الأداة المستخدمة في نشر (Deploy) منصة باحث، واجهت مشكلة مع ChromaDB أجبرتني على اتخاذ القرار والمضي قدمًا.

المضحك في الأمر أن الانتقال لم يستغرق سوى 5 أو 6 أيام فقط!

وهنا يظهر تأثير "الخوف من المجهول". كنت أؤجل هذه الخطوة مرارًا بسبب التفكير المستمر بها، لكن عندما اضطررت لخوض التجربة، تمّت بسلاسة وفي وقت ممتاز، بفضل الله.

✅ الأحاديث الآن تعمل بالكامل على Qdrant
📚 والمكتبة الشاملة يتم تحويل صفحاتها إلى تضمينات (Embeddings) وستنتهي العملية خلال الأيام القادمة بإذن الله.

من أبرز فوائد الانتقال إلى Qdrant:
⚡️ سرعة أعلى في الإضافة والاسترجاع
🎯 دقة أفضل بفضل تحسين النماذج وأخذ النص الكامل بعين الاعتبار
🛠 تجربة برمجية أسهل وأكثر مرونة

لكل من يؤجل خطوة تقنية بسبب الخوف أو الغموض: أحيانًا نحتاج فقط إلى دفعة، والباقي يأتي تباعًا.

رابط منصة باحث:
https://baheth.ieasybooks.com

إعلان إضافة المتصفح لمنصة باحث 🚀 🖥

رابط الإضافة على متصفح Chrome
رابط الإضافة على متصفح FireFox

رابط المقطع على YouTube:
https://youtu.be/BHslgbgwmIQ

رابط موقع المنصّة
رابط تطبيق المنصّة لأجهزة Android
رابط تطبيق المنصّة لأجهزة iPhone
رابط بوت المنصّة على تيليجرام

للمبرمجين: انتهينا من تحويل كافة كتب المكتبة الوقفية إلى نصوص 🚀

نستعرض في هذا المقطع كيفية الاستفادة من كتب المكتبة الوقفية بعد أن حوّلناها من ملفات PDF إلى نصوص باستخدام Google Document AI بصيغة TXT 📄 و DOCX 📝

يمكن الاستفادة من هذه البيانات في بناء تطبيقات للبحث أو التلخيص أو غيرها من قِبل المطوّرين ونشرها لتعم الفائدة بإذن الله

رابط المقطع على YouTube:
https://youtu.be/qxO0GTz-cp8

رابط مستودع البيانات غير المضغوطة
رابط مستودع البيانات المضغوطة

لغير المبرمجين: واجهة لتحميل ملفات المكتبة الوقفية بصيغ PDF و TXT و DOCX 🚀

قمنا ببناء واجهة تسمح للمستخدم بالبحث في كتب المكتبة الوقفية باستخدام العنوان وفرز النتائج حسب التصنيف والمؤلف وتحميل ملفات الكتاب بأي صيغة شاء

رابط المقطع على YouTube:
https://youtu.be/VE3NJr5Fo8U

رابط واجهة البحث والتحميل
رابط منشور البارحة

كدت أُشلّ 🫠

أجريت بعض التعديلات على مكتبة تحويل خلال الأيام الماضية تسمح باستخدام أكثر من Service Account Credentials من GCP لتحويل أكثر من ملف PDF أو صورة في نفس الوقت إلى نصوص:
https://github.com/ieasybooks/tahweel

وبدأت باستخدام هذا التعديل وكانت النتائج مرضية، فأصبحت قادرا على تحويل الملفات بشكل أسرع من السابق، ولكن حاصرني سؤال قبل قليل: "مكتبة تحويل تُحوّل ملفات الـ PDF إلى صور قبل تحويلها إلى نصوص وتُخزّنها في مجلد واحد مشترك، فهل صور الملفات المختلفة تتداخل؟".

لم أستطع النوم ودخلت على الشيفرة البرمجية من الهاتف للتحقق فوجدت أنني أحتفظ بملفات الصور الخاصة بأكثر من ملف PDF في مجلد عشوائي مشترك 😨:
https://github.com/ieasybooks/tahweel/blob/main/tahweel/managers/pdf_file_manager.py#L19-L35

ببساطة، هذا يعني أن كل ما كنت أُفرّغه في الفترة الماضية من كتب يحتاج إلى إعادة نظر، خصوصا وأنني كنت أُحوّل مجموعات مختلفة من الكتب بالتوازي على نفس الحاسب.

قبل أن تبدأ نوبة الذعر الداخلية، شغّلت الحاسب ووضعت ملفَّي PDF في مجلد واحد، الأول باللغة العربية والثاني باللغة الإنجليزية وبدأت بتحويلهما إلى نصوص باستخدام تحويل ونظرت في النتائج لأكتشف أن النتائج لا مشكلة فيها، فأعدت الكرة مرة أخرى وكان الأمر نفسه.

في هذه اللحظة أوقفت الشيفرة البرمجية المسؤولة عن حذف ملفات الصور من المجلد المشترك لأنظر فيه وأتأكد من التداخل بين صور الملفات المختلفة بعيني:
https://github.com/ieasybooks/tahweel/blob/main/tahweel/managers/base_file_manager.py#L104-L106

فلما فتحت المجلد المشترك، رأيت ما هو موضّح في الصورة المرفقة مع المنشور 🤓

ببساطة، قلقي لم يكن في محله، فمكتبة pdf2image تستخدم UUID4 تلقائيا في تسمية ملفات الصور الخاصة بكل ملف PDF، فالتداخل شبه مستحيل 🥳

هذا لا يعني أن ما فعلته كان صحيحًا، فالأفضل إنشاء مجلد خاص لكل ملف PDF يجري تحويله إلى نص، ولكن هذا تعديل مستقبليّ قد يساهم أحدكم في تنفيذه 😁

والسلام عليكم 👋🏻