aleph

.. epigraph::

A verdade não penetra uma mente fechada. Se todos os lugares do universo estão no Aleph, então todas as estrelas, todas as lâmpadas, todas as fontes de luz estão nele também.

-- The Aleph <http://www.phinnweb.org/links/literature/borges/aleph.html>_, Jorge Luis Borges

⚠️ ESTADO DO PROJETO: ENCERRAMENTO ⚠️ Nosso envolvimento com este projeto de código aberto está sendo encerrado. A manutenção desta versão terminará oficialmente após dezembro de 2025.

Por quê?

Esta decisão marca uma mudança estratégica significativa para nós. No último ano, nossa equipe reescreveu completamente o código base do Aleph do zero para lançar o Aleph Pro. À medida que fazemos a transição para esta nova plataforma suportada, estamos concentrando todos os nossos recursos no Aleph Pro para garantir que possamos manter as luzes acesas para investigações ao redor do mundo.

Para mais detalhes sobre esta decisão e o que ela significa para o futuro, por favor leia nossas FAQs oficiais <https://www.occrp.org/en/announcement/aleph-pro-frequently-asked-questions-on-the-future-of-occrps-investigative-data-platform/>__ .

Cronograma e Suporte

• Continuaremos a fornecer manutenção para este repositório até 31 de dezembro de 2025. Após esta data, nenhuma atualização, correção de bugs ou suporte será fornecido pela equipe principal.
• Para quaisquer perguntas sobre a transição ou o software legado, entre em contato através da nossa comunidade Discourse <https://aleph.discourse.group//>__.
• Para aqueles que atualmente hospedam suas próprias instâncias do Aleph, entraremos em contato em breve sobre a transição.
• Organizações e indivíduos interessados em colaborar podem entrar em contato pelo e-mail [email protected].

Obrigado! Estamos incrivelmente orgulhosos do que construímos até agora. Obrigado a todos os contribuidores e membros da comunidade que ajudaram a construir este projeto e acreditaram na nossa missão.

Sobre o software

Aleph é uma ferramenta para indexar grandes quantidades de dados tanto de documentos (PDF, Word, HTML) quanto estruturados (CSV, XLS, SQL) para fácil navegação e pesquisa. Foi construída com a reportagem investigativa como caso de uso principal. O Aleph permite o cruzamento de menções de entidades conhecidas (como pessoas e empresas) com listas de vigilância, por exemplo, de pesquisas anteriores ou conjuntos de dados públicos.

Para mais detalhes sobre o software, como usá-lo, instalá-lo ou gerenciar importações de dados, consulte a documentação em:

• https://docs.aleph.occrp.org
• Instalação: https://docs.aleph.occrp.org/developers/installation

Suporte

O Aleph é usado e desenvolvido por várias organizações e indivíduos interessados. Se você está interessado em participar deste processo, por favor leia a política de suporte (SUPPORT.md), as regras de contribuição (CONTRIBUTING.md) e o código de conduta (CODE_OF_CONDUCT.md) e então entre em contato:

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

Desenvolvimento do Aleph

Se você deseja se envolver no desenvolvimento do Aleph, consulte o arquivo CONTRIBUTING.md para detalhes sobre como começar.

⚠️ IMPORTANTE ⚠️ O branch padrão neste repositório GitHub é "develop". O branch develop contém código instável e não lançado. Para versões estáveis, consulte a lista de releases <https://github.com/alephdata/aleph/releases>_ ou mude para o branch main <https://github.com/alephdata/aleph/tree/main>_.

Processo de release

Se você está interessado em, ou foi encarregado de lançar uma nova versão do Aleph, os seguintes passos devem ser seguidos:

Visão geral

O processo básico para lançar o Aleph é este:

1. Verifique se há atualizações nas bibliotecas internas e faça merge. Lance nossas bibliotecas na seguinte ordem
2. servicelayer
3. followthemoney
4. ingest-file
5. react-ftm
6. Certifique-se de que todas as bibliotecas para um release estão atualizadas no aleph e mescladas no branch develop.
7. Certifique-se de que quaisquer funcionalidades, correções de bugs estão mescladas no develop e que todas as builds estão passando
8. Certifique-se de que o arquivo CHANGELOG.md está atualizado no branch develop. Adicione informações conforme necessário.
9. Crie um release RC do Aleph.
10. Teste e verifique o RC. Realize releases RC adicionais conforme necessário.
11. Mescle todas as alterações no main
12. Crie uma versão final do Aleph

Na medida do possível, aplique as regras de versionamento semântico ao determinar o tipo de release a ser realizado.

Processo técnico

Releases RC

Se você precisar realizar um release RC do Aleph, siga estes passos:

1. Certifique-se de que o CHANGELOG está atualizado no branch develop e que todos os PRs pendentes foram mesclados
2. A partir do branch develop, execute bump2version (major, minor, patch) - isso criará uma versão x.x.x-rc1 do aleph
3. Envie as tags para o remoto com git push --tags
4. Envie o incremento de versão com git push
5. Se houver problemas com o RC, você pode corrigi-los e usar bump2version build para gerar um novo release rc

Releases major, minor, patch

1. Mude para main e puxe do remoto
2. Se ainda não foi feito, mescle develop no main
3. Atualize as traduções usando make translate
4. Se você receber erros npm, vá para a pasta ui e execute npm install
5. Confirme as traduções no main e envie para o remoto
6. Execute bump2version --verbose --sign-tags release. Note que o bump2version não mostrará alterações quando você fizer a alteração, mas funcionará (veja git log para verificar)
7. Envie as tags para o remoto com git push --tags
8. Envie o incremento de versão para o remoto com git push
9. Mescle main de volta no develop. Um pouco não relacionado ao processo de release, mas é um bom momento para fazer isso para que os novos números de versão apareçam no também