aleph

.. epigraph::

La verità non può penetrare una mente chiusa. Se tutti i luoghi dell'universo sono nell'Aleph, allora tutte le stelle, tutte le lampade, tutte le fonti di luce sono in esso.

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

⚠️ STATO DEL PROGETTO: IN FASE DI CHIUSURA ⚠️ Il nostro coinvolgimento in questo progetto open-source sta per concludersi. La manutenzione di questa versione terminerà ufficialmente dopo dicembre 2025.

Perché?

Questa decisione segna un cambiamento strategico significativo per noi. Nell'ultimo anno, il nostro team ha riscritto completamente il codice di Aleph da zero per lanciare Aleph Pro. Mentre transitiamo verso questa nuova piattaforma supportata, concentriamo tutte le nostre risorse su Aleph Pro per garantire di poter mantenere attive le indagini in tutto il mondo.

Per ulteriori dettagli su questa decisione e su cosa significa per il futuro, si prega di leggere le nostre FAQ ufficiali <https://www.occrp.org/en/announcement/aleph-pro-frequently-asked-questions-on-the-future-of-occrps-investigative-data-platform/>__ .

Cronologia e supporto

• Continueremo a fornire manutenzione per questo repository fino al 31 dicembre 2025. Dopo questa data, non saranno forniti ulteriori aggiornamenti, correzioni di bug o supporto dal team principale.
• Per qualsiasi domanda riguardante la transizione o il software legacy, contattateci tramite la nostra community Discourse <https://aleph.discourse.group//>__.
• Per coloro che attualmente ospitano le proprie istanze di Aleph, vi contatteremo molto presto riguardo alla transizione.
• Organizzazioni e individui interessati a collaborare possono contattare [email protected].

Grazie! Siamo incredibilmente orgogliosi di ciò che abbiamo costruito finora. Grazie a tutti i contributori e i membri della community che hanno contribuito a realizzare questo progetto e hanno creduto nella nostra missione.

Informazioni sul software

Aleph è uno strumento per indicizzare grandi quantità di dati sia documentali (PDF, Word, HTML) che strutturati (CSV, XLS, SQL) per una facile navigazione e ricerca. È stato creato con l'inchiesta investigativa come caso d'uso principale. Aleph consente il cross-referencing di menzioni di entità note (come persone e aziende) rispetto a watchlist, ad esempio da ricerche precedenti o dataset pubblici.

Per ulteriori dettagli sul software, come usarlo, installarlo o gestire le importazioni di dati, consultare la documentazione su:

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

Supporto

Aleph è utilizzato e sviluppato da diverse organizzazioni e individui interessati. Se sei interessato a partecipare a questo processo, ti preghiamo di leggere la politica di supporto (SUPPORT.md), le regole di contribuzione (CONTRIBUTING.md) e il codice di condotta (CODE_OF_CONDUCT.md), quindi mettiti in contatto:

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

Sviluppo di Aleph

Se stai cercando di partecipare allo sviluppo di Aleph, consulta il file CONTRIBUTING.md per i dettagli su come iniziare.

⚠️ IMPORTANTE ⚠️ Il branch predefinito in questo repository GitHub è "develop". Il branch develop contiene codice non rilasciato e instabile. Per le versioni stabili, consulta l'elenco delle release <https://github.com/alephdata/aleph/releases>_ o passa al branch main <https://github.com/alephdata/aleph/tree/main>_.

Processo di rilascio

Se sei interessato o hai ricevuto l'incarico di rilasciare una nuova versione di Aleph, segui questi passaggi:

Panoramica

Il processo di base per rilasciare Aleph è il seguente:

1. Verifica la presenza di aggiornamenti nelle librerie interne e uniscili. Rilascia le nostre librerie nel seguente ordine:
2. servicelayer
3. followthemoney
4. ingest-file
5. react-ftm
6. Assicurati che tutte le librerie per un rilascio siano aggiornate in aleph e unite al branch develop.
7. Assicurati che tutte le funzionalità e correzioni di bug siano unite in develop e che tutte le build siano superate.
8. Assicurati che il file CHANGELOG.md sia aggiornato sul branch develop. Aggiungi informazioni se necessario.
9. Crea una release RC di Aleph.
10. Testa e verifica la RC. Esegui ulteriori release RC secondo necessità.
11. Unisci tutte le modifiche a main.
12. Crea una versione finale di Aleph.

Per quanto possibile, applica le regole del versionamento semantico per determinare il tipo di rilascio da eseguire.

Processo tecnico

Release RC

Se devi eseguire una release RC di Aleph, segui questi passaggi:

1. Assicurati che il CHANGELOG sia aggiornato sul branch develop e che tutte le PR in sospeso siano state unite.
2. Dal branch develop, esegui bump2version (major, minor, patch); questo creerà una versione x.x.x-rc1 di aleph.
3. Carica i tag sul remoto con git push --tags.
4. Carica il bump di versione con git push.
5. Se ci sono problemi con la RC, puoi correggerli e usare bump2version build per generare una nuova release RC.

Release major, minor, patch

1. Passa a main e fai il pull dal remoto.
2. Se non già fatto, unisci develop in main.
3. Aggiorna le traduzioni usando make translate.
4. Se ottieni errori npm, vai nella cartella ui ed esegui npm install.
5. Committa le traduzioni su main e poi carica sul remoto.
6. Esegui bump2version --verbose --sign-tags release. Nota che bump2version non mostrerà le modifiche quando le apporti, ma funzionerà (controlla con git log).
7. Carica i tag sul remoto con git push --tags.
8. Carica il bump di versione sul remoto con git push.
9. Unisci main di nuovo in develop. Non direttamente correlato al processo di rilascio, ma è un buon momento per farlo in modo che i nuovi numeri di versione appaiano anche in .