aleph

.. epigraph::

La vérité ne peut pénétrer un esprit fermé. Si tous les lieux de l'univers sont dans l'Aleph, alors toutes les étoiles, toutes les lampes, toutes les sources de lumière y sont aussi.

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

⚠️ STATUT DU PROJET : ABANDON PROGRESSIF ⚠️ Notre implication dans ce projet open-source est en cours d'abandon progressif. La maintenance de cette version prendra officiellement fin après décembre 2025.

Pourquoi ?

Cette décision marque un changement stratégique majeur pour nous. Au cours de l'année écoulée, notre équipe a complètement réécrit le code source d'Aleph à partir de zéro pour lancer Aleph Pro. Alors que nous passons à cette nouvelle plateforme prise en charge, nous concentrons toutes nos ressources sur Aleph Pro pour garantir que les lumières restent allumées pour les enquêtes dans le monde entier.

Pour plus de détails sur cette décision et ce qu'elle signifie pour l'avenir, veuillez lire notre FAQ officielle <https://www.occrp.org/en/announcement/aleph-pro-frequently-asked-questions-on-the-future-of-occrps-investigative-data-platform/>__ .

Calendrier et support

• Nous continuerons à assurer la maintenance de ce dépôt jusqu'au 31 décembre 2025. Après cette date, aucune mise à jour, correction de bug ou support ne sera fourni par l'équipe principale.
• Pour toute question concernant la transition ou le logiciel existant, veuillez nous contacter via notre communauté Discourse <https://aleph.discourse.group//>__.
• Pour ceux qui hébergent actuellement leurs propres instances Aleph, nous vous contacterons très prochainement au sujet de la transition.
• Les organisations et les personnes souhaitant collaborer peuvent contacter [email protected].

Merci ! Nous sommes extrêmement fiers de ce que nous avons construit jusqu'à présent. Merci à tous les contributeurs et membres de la communauté qui ont aidé à construire ce projet et ont cru en notre mission.

À propos du logiciel

Aleph est un outil permettant d'indexer de grandes quantités de documents (PDF, Word, HTML) et de données structurées (CSV, XLS, SQL) pour une navigation et une recherche faciles. Il est conçu principalement pour le journalisme d'investigation. Aleph permet de croiser les mentions d'entités connues (telles que des personnes et des entreprises) avec des listes de surveillance, par exemple issues de recherches antérieures ou de jeux de données publics.

Pour plus de détails sur le logiciel, son utilisation, son installation ou la gestion des importations de données, veuillez consulter la documentation sur :

• https://docs.aleph.occrp.org
• Installation : https://docs.aleph.occrp.org/developers/installation

Support

Aleph est utilisé et développé par plusieurs organisations et personnes intéressées. Si vous souhaitez participer à ce processus, veuillez lire la politique de support (SUPPORT.md), les règles de contribution (CONTRIBUTING.md) et le code de conduite (CODE_OF_CONDUCT.md), puis contactez-nous :

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

Développement d'Aleph

Si vous souhaitez vous impliquer dans le développement d'Aleph, veuillez consulter le fichier CONTRIBUTING.md pour savoir comment commencer.

⚠️ IMPORTANT ⚠️ La branche par défaut de ce dépôt GitHub est "develop". La branche develop contient du code non publié et instable. Pour les versions stables, veuillez consulter la liste des versions <https://github.com/alephdata/aleph/releases>_ ou passer à la branche main <https://github.com/alephdata/aleph/tree/main>_.

Processus de version

Si vous êtes intéressé(e) ou chargé(e) de publier une nouvelle version d'Aleph, les étapes suivantes doivent être suivies :

Aperçu

Le processus de base pour publier Aleph est le suivant :

1. Vérifier les mises à jour des bibliothèques internes et les fusionner. Publier nos bibliothèques dans l'ordre suivant
2. servicelayer
3. followthemoney
4. ingest-file
5. react-ftm
6. S'assurer que toutes les bibliothèques pour une version sont à jour dans aleph et fusionnées dans la branche develop.
7. S'assurer que toutes les fonctionnalités et corrections de bugs sont fusionnées dans develop et que toutes les builds passent.
8. S'assurer que le fichier CHANGELOG.md est à jour sur la branche develop. Ajouter les informations nécessaires.
9. Créer une version RC d'Aleph.
10. Tester et vérifier la RC. Effectuer d'autres versions RC si nécessaire.
11. Fusionner toutes les modifications dans main.
12. Créer une version finale d'Aleph.

Dans la mesure du possible, appliquer les règles de version sémantique pour déterminer le type de version à effectuer.

Processus technique

Versions RC

Si vous devez effectuer une version RC d'Aleph, suivez ces étapes :

1. S'assurer que le CHANGELOG est à jour sur la branche develop et que toutes les PR en attente ont été fusionnées.
2. Depuis la branche develop, exécuter bump2version (major, minor, patch) ; cela créera une version x.x.x-rc1 d'aleph.
3. Pousser les tags vers le dépôt distant avec git push --tags
4. Pousser l'incrémentation de version avec git push
5. S'il y a des problèmes avec la RC, vous pouvez les corriger et utiliser bump2version build pour générer une nouvelle version RC.

Versions majeures, mineures, de correctif

1. Passer à main et tirer depuis le dépôt distant.
2. Si ce n'est pas déjà fait, fusionner develop dans main.
3. Mettre à jour les traductions en utilisant make translate
4. Si vous obtenez des erreurs npm, allez dans le dossier ui et exécutez npm install
5. Commiter les traductions dans main et pousser vers le dépôt distant.
6. Exécuter bump2version --verbose --sign-tags release. Notez que bump2version n'affichera pas les modifications lorsque vous effectuerez le changement, mais cela fonctionnera (consultez git log pour vérifier).
7. Pousser les tags vers le dépôt distant avec git push --tags
8. Pousser l'incrémentation de version vers le dépôt distant avec git push
9. Fusionner main dans develop. Cela n'est pas directement lié au processus de version, mais c'est un bon moment pour le faire afin que les nouveaux numéros de version apparaissent également dans .