aleph

.. epigraph::

لا يمكن للحقيقة أن تخترق عقلًا مغلقًا. إذا كانت جميع الأماكن في الكون موجودة في الألف، فإن جميع النجوم، جميع المصابيح، جميع مصادر الضوء موجودة فيه أيضًا.

-- الألف <http://www.phinnweb.org/links/literature/borges/aleph.html>_, خورخي لويس بورخيس

⚠️ حالة المشروع: إيقاف تدريجي ⚠️ تم إيقاف مشاركتنا في هذا المشروع مفتوح المصدر تدريجيًا. سينتهي الدعم الرسمي لهذا الإصدار رسميًا بعد ديسمبر 2025.

لماذا؟

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

لمزيد من التفاصيل حول هذا القرار وما يعنيه للمستقبل، يرجى قراءة الأسئلة الشائعة الرسمية <https://www.occrp.org/en/announcement/aleph-pro-frequently-asked-questions-on-the-future-of-occrps-investigative-data-platform/>__ .

الجدول الزمني والدعم

• سنواصل تقديم الصيانة لهذا المستودع حتى 31 ديسمبر 2025. بعد هذا التاريخ، لن يتم تقديم أي تحديثات أو إصلاحات للأخطاء أو دعم من الفريق الأساسي.
• لأي استفسارات بخصوص الانتقال أو البرنامج القديم، يرجى التواصل عبر مجتمع ديسكورس الخاص بنا <https://aleph.discourse.group/>__.
• بالنسبة لمن يستضيفون حاليًا نسخهم الخاصة من الألف، سنتواصل معكم قريبًا جدًا بخصوص عملية الانتقال.
• المؤسسات والأفراد الراغبون في التعاون يمكنهم التواصل عبر [email protected].

شكرًا لكم! نحن فخورون جدًا بما بنيناه حتى الآن. شكرًا لجميع المساهمين وأعضاء المجتمع الذين ساعدوا في بناء هذا المشروع وآمنوا برسالتنا.

حول البرنامج

ألف (Aleph) هي أداة لفهرسة كميات كبيرة من المستندات (PDF، Word، HTML) والبيانات المنظمة (CSV، XLS، SQL) لتسهيل التصفح والبحث. صممت مع استخدام التحقيقات الصحفية كحالة استخدام رئيسية. تتيح ألف الربط بين ذكر كيانات معروفة (مثل الأشخاص والشركات) وقوائم المراقبة، مثل تلك المستمدة من الأبحاث السابقة أو مجموعات البيانات العامة.

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

• https://docs.aleph.occrp.org
• التثبيت: https://docs.aleph.occrp.org/developers/installation

الدعم

يتم استخدام وتطوير ألف من قبل عدة مؤسسات وأفراد مهتمين. إذا كنت مهتمًا بالمشاركة في هذه العملية، يرجى قراءة سياسة الدعم (SUPPORT.md)، قواعد المساهمة (CONTRIBUTING.md)، ومدونة قواعد السلوك (CODE_OF_CONDUCT.md) ثم التواصل:

• https://docs.aleph.occrp.org/get-in-touch

تطوير ألف

إذا كنت تتطلع إلى المشاركة في تطوير ألف، يرجى مراجعة ملف CONTRIBUTING.md للحصول على تفاصيل حول كيفية البدء.

⚠️ هام ⚠️ الفرع الافتراضي في هذا المستودع على GitHub هو "develop". يحتوي فرع develop على كود غير مستقر ولم يتم إصداره. للإصدارات المستقرة، يرجى مراجعة قائمة الإصدارات <https://github.com/alephdata/aleph/releases>_ أو التبديل إلى الفرع الرئيسي <https://github.com/alephdata/aleph/tree/main>_.

عملية الإصدار

إذا كنت مهتمًا أو تم تكليفك بإصدار نسخة جديدة من ألف، يجب اتباع الخطوات التالية:

نظرة عامة

العملية الأساسية لإصدار ألف هي:

1. التحقق من وجود تحديثات للمكتبات الداخلية ودمجها. إصدار مكتباتنا بالترتيب التالي
2. servicelayer
3. followthemoney
4. ingest-file
5. react-ftm
6. التأكد من أن جميع المكتبات اللازمة للإصدار محدثة في ألف وتم دمجها في فرع develop.
7. التأكد من دمج أي ميزات أو إصلاحات للأخطاء في develop وأن جميع عمليات البناء ناجحة.
8. التأكد من أن ملف CHANGELOG.md محدث في فرع develop. إضافة المعلومات حسب الحاجة.
9. إنشاء إصدار RC من ألف.
10. اختبار والتحقق من إصدار RC. القيام بإصدارات RC إضافية حسب الحاجة.
11. دمج جميع التغييرات إلى main
12. إنشاء إصدار نهائي من ألف

بقدر الإمكان، تطبيق قواعد التحكم الدلالي في الإصدارات عند تحديد نوع الإصدار.

العملية الفنية

إصدارات RC

إذا كنت بحاجة إلى إجراء إصدار RC من ألف، اتبع هذه الخطوات:

1. التأكد من أن ملف CHANGELOG محدث في فرع develop وأن جميع طلبات السحب المعلقة قد تم دمجها.
2. من فرع develop، قم بتشغيل bump2version (major, minor, patch) سيؤدي ذلك إلى إنشاء إصدار x.x.x-rc1 من ألف.
3. ادفع العلامات إلى المستودع البعيد باستخدام git push --tags
4. ادفع زيادة الإصدار باستخدام git push
5. إذا كانت هناك مشاكل في إصدار RC، يمكنك إصلاحها واستخدام bump2version build لإنشاء إصدار RC جديد

إصدارات رئيسية، ثانوية، تصحيحية

1. التبديل إلى main وسحب من المستودع البعيد
2. إذا لم يتم دمج develop في main بعد، قم بدمجه
3. تحديث الترجمات باستخدام make translate
4. إذا واجهت أخطاء npm، انتقل إلى مجلد ui وقم بتشغيل npm install
5. إيداع الترجمات في main ودفعها إلى المستودع البعيد
6. تشغيل bump2version --verbose --sign-tags release. لاحظ أن bump2version لن يعرض التغييرات عند إجراء التغيير، لكنه سيعمل (تحقق باستخدام git log للتأكد)
7. ادفع العلامات إلى المستودع البعيد باستخدام git push --tags
8. ادفع زيادة الإصدار إلى المستودع البعيد باستخدام git push
9. دمج main مرة أخرى في develop. غير مرتبط بشكل مباشر بعملية الإصدار ولكنه وقت مناسب للقيام بذلك بحيث تظهر أرقام الإصدارات الجديدة في أيضًا