المساهمة في مكتبة
مكتبة منصة وسائط تستضيفها بنفسك: تحوّل شجرة مجلدات من ملفات الفيديو إلى مكتبة قابلة للبث، يمكن البحث فيها عن كل كلمة منطوقة، ولها تطبيقات رسمية للويب والهواتف والحواسيب وأجهزة التلفاز. العربية لغة أساسية في كل جزء منها.
هذه الأدلة موجّهة إلى من يعملون على مكتبة نفسها: الخدمات والتطبيقات والاختبارات والتكامل المستمر. الشيفرة المصدرية موجودة في github.com/Hamza-Labs-Core/Maktaba.
الأدلة
- نظرة عامة على البنية: الخدمات وقاعدة البيانات وكيف تتواصل فيما بينها.
- تنظيم المستودع: المجلدات الرئيسية وما يحويه كل منها.
- الإعداد المحلي: المتطلبات المسبقة وتشغيل بيئة تطوير.
- تشغيل الاختبارات: كل مجموعة اختبارات، والمستويات، وبوابة الاختبارات المتأثرة.
- الأعراف: الإنجليزية والعربية معًا، والاختبارات مع الشيفرة، والأدوار المفروضة على الخادم، ولا أسرار في الشيفرة، وأسلوب الإيداعات.
- التكامل المستمر: كيف يختار التكامل المستمر المهام التي يحتاجها كل تغيير، وبوابة الدمج الوحيدة.
- طلبات الدمج: أنشئ فرعًا، واختبر، واكتب الوصف، وراجع، وادمج.
- قواعد الأمان للإضافات والمساهمين: ما يجب أن تلتزم به الإضافات والمساهمون، وكيف تبلّغ عن ثغرة.
الخلاصة
git clone https://github.com/Hamza-Labs-Core/Maktaba.git
cd Maktaba
cp .env.example .env
make prereqs # tells you which tools are missing
make dev # live-reload stack
make test # unit tier: no network, no sudo
يشغّل التكامل المستمر أهداف make نفسها التي تشغّلها محليًا، فإذا نجح make lint وmake test
على جهازك فستنجح فحوص التدقيق واختبارات الوحدات كذلك.
الإبلاغ عن مشكلة أمنية
لا تفتح بلاغًا عامًا عن ثغرة أبدًا. راسل security@maktaba.dev واطّلع على سياسة الإبلاغ.