aleph

.. epigraph::

Истина не может проникнуть в закрытый ум. Если все места во вселенной находятся в Алефе, то все звезды, все лампы, все источники света тоже в нем.

-- Алеф <http://www.phinnweb.org/links/literature/borges/aleph.html>_, Хорхе Луис Борхес

⚠️ СТАТУС ПРОЕКТА: ЗАКРЫТИЕ ⚠️ Наше участие в этом проекте с открытым исходным кодом завершается. Официальная поддержка этой версии закончится после декабря 2025 года.

Почему?

Это решение знаменует собой значительный стратегический сдвиг для нас. За последний год наша команда полностью переписала кодовую базу Aleph с нуля, чтобы запустить Aleph Pro. По мере перехода на эту новую поддерживаемую платформу мы сосредотачиваем все наши ресурсы на Aleph Pro, чтобы обеспечить возможность продолжать расследования по всему миру.

Для получения дополнительной информации об этом решении и о том, что оно значит для будущего, пожалуйста, прочитайте наши официальные FAQ <https://www.occrp.org/en/announcement/aleph-pro-frequently-asked-questions-on-the-future-of-occrps-investigative-data-platform/>__ .

Сроки и поддержка

• Мы будем продолжать обеспечивать поддержку этого репозитория до 31 декабря 2025 года. После этой даты основные обновления, исправления ошибок или поддержка от основной команды предоставляться не будут.
• По любым вопросам, касающимся перехода или устаревшего программного обеспечения, обращайтесь через наше сообщество Discourse <https://aleph.discourse.group//>__.
• Тем, кто в настоящее время размещает свои собственные экземпляры Aleph, мы свяжемся с вами в ближайшее время по поводу перехода.
• Организации и частные лица, желающие сотрудничать, могут обращаться по адресу [email protected].

Спасибо! Мы невероятно гордимся тем, что создали на данный момент. Спасибо всем участникам и членам сообщества, которые помогли построить этот проект и поверили в нашу миссию.

About the software

Aleph — это инструмент для индексации больших объёмов как документов (PDF, Word, HTML), так и структурированных данных (CSV, XLS, SQL) для удобного просмотра и поиска. Он создан с учётом расследовательской журналистики в качестве основного сценария использования. Aleph позволяет перекрёстно ссылаться на упоминания известных сущностей (например, людей и компаний) с контрольными списками, например, из предыдущих исследований или общедоступных наборов данных.

Для получения дополнительной информации о программном обеспечении, его использовании, установке или управлении импортом данных, пожалуйста, обратитесь к документации по адресу:

• https://docs.aleph.occrp.org
• Установка: https://docs.aleph.occrp.org/developers/installation

Поддержка

Aleph используется и разрабатывается несколькими организациями и заинтересованными лицами. Если вы заинтересованы в участии в этом процессе, пожалуйста, прочитайте политику поддержки (SUPPORT.md), правила участия (CONTRIBUTING.md) и кодекс поведения (CODE_OF_CONDUCT.md), а затем свяжитесь с нами:

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

Разработка Aleph

Если вы хотите принять участие в разработке Aleph, пожалуйста, ознакомьтесь с файлом CONTRIBUTING.md, чтобы узнать, как начать.

⚠️ ВАЖНО ⚠️ Веткой по умолчанию в этом репозитории GitHub является "develop". Ветка develop содержит невыпущенный, нестабильный код. Для стабильных релизов, пожалуйста, посмотрите список релизов <https://github.com/alephdata/aleph/releases>_ или переключитесь на ветку main <https://github.com/alephdata/aleph/tree/main>_.

Процесс релиза

Если вы заинтересованы или вам поручено выпустить новую версию Aleph. Следуйте следующим шагам:

Обзор

Основной процесс выпуска Aleph выглядит следующим образом:

1. Проверьте внутренние библиотеки на наличие обновлений и объедините их. Выпускайте наши библиотеки в следующем порядке
2. servicelayer
3. followthemoney
4. ingest-file
5. react-ftm
6. Убедитесь, что все библиотеки для релиза актуальны в Aleph и объединены в ветку develop.
7. Убедитесь, что все новые функции и исправления ошибок объединены в ветку develop, и все сборки проходят.
8. Убедитесь, что файл CHANGELOG.md актуален в ветке develop. Добавьте информацию по мере необходимости.
9. Создайте RC-релиз Aleph.
10. Протестируйте и проверьте RC. При необходимости выполните дополнительные RC-релизы.
11. Объедините все изменения в ветку main.
12. Создайте финальную версию Aleph.

По возможности применяйте правила семантического версионирования при определении типа выполняемого релиза.

Технический процесс

RC-релизы

Если вам нужно выполнить RC-релиз Aleph, выполните следующие шаги:

1. Убедитесь, что файл CHANGELOG актуален в ветке develop и все ожидающие PR объединены.
2. Из ветки develop выполните bump2version (major, minor, patch); это создаст версию aleph x.x.x-rc1.
3. отправьте теги в удалённый репозиторий с помощью git push --tags
4. отправьте приращение версии с помощью git push
5. Если возникнут проблемы с RC, вы можете их исправить и использовать bump2version build для создания нового RC-релиза.

Major, minor, patch релизы

1. переключитесь на ветку main и выполните pull из удалённого репозитория
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. Не совсем связано с процессом релиза, но это хорошее время сделать это, чтобы новые номера версий также появились в