aleph

.. epigraph::

Wahrheit kann in einen verschlossenen Geist nicht eindringen. Wenn alle Orte im Universum im Aleph sind, dann sind auch alle Sterne, alle Lampen, alle Lichtquellen darin.

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

⚠️ PROJEKTSTATUS: WIRD EINGESTELLT ⚠️ Unser Engagement für dieses Open-Source-Projekt wird eingestellt. Die Wartung dieser Version endet offiziell nach Dezember 2025.

Warum?

Diese Entscheidung markiert eine bedeutende strategische Neuausrichtung für uns. Im vergangenen Jahr hat unser Team die Aleph-Codebasis von Grund auf neu geschrieben, um Aleph Pro zu starten. Während wir auf diese neue unterstützte Plattform umsteigen, konzentrieren wir unsere gesamten Ressourcen auf Aleph Pro, um sicherzustellen, dass wir für Untersuchungen weltweit den Betrieb aufrechterhalten können.

Weitere Einzelheiten zu dieser Entscheidung und ihrer Bedeutung für die Zukunft finden Sie in unseren offiziellen FAQs <https://www.occrp.org/en/announcement/aleph-pro-frequently-asked-questions-on-the-future-of-occrps-investigative-data-platform/>__ .

Zeitplan & Support

• Wir werden dieses Repository bis zum 31. Dezember 2025 weiterhin warten. Nach diesem Datum werden vom Kernteam keine weiteren Updates, Fehlerbehebungen oder Support bereitgestellt.
• Bei Fragen zum Übergang oder zur Legacy-Software wenden Sie sich bitte an unsere Discourse-Community <https://aleph.discourse.group//>__.
• Für diejenigen, die derzeit ihre eigenen Aleph-Instanzen hosten, werden wir uns in Kürze bezüglich des Übergangs bei Ihnen melden.
• Organisationen und Einzelpersonen, die an einer Zusammenarbeit interessiert sind, können sich an [email protected] wenden.

Vielen Dank! Wir sind unglaublich stolz auf das, was wir bisher aufgebaut haben. Vielen Dank an alle Mitwirkenden und Community-Mitglieder, die beim Aufbau dieses Projekts geholfen und an unsere Mission geglaubt haben.

Über die Software

Aleph ist ein Werkzeug zur Indexierung großer Mengen sowohl von Dokumenten (PDF, Word, HTML) als auch strukturierten Daten (CSV, XLS, SQL) für einfaches Durchsuchen und Suchen. Es wurde mit investigativer Berichterstattung als primärem Anwendungsfall entwickelt. Aleph ermöglicht die Querverweisung von Erwähnungen bekannter Entitäten (wie Personen und Unternehmen) mit Überwachungslisten, z. B. aus früheren Recherchen oder öffentlichen Datensätzen.

Weitere Details zur Software, ihrer Verwendung, Installation oder Verwaltung von Datenimporten finden Sie in der Dokumentation unter:

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

Support

Aleph wird von mehreren Organisationen und interessierten Einzelpersonen verwendet und weiterentwickelt. Wenn Sie an einer Teilnahme an diesem Prozess interessiert sind, lesen Sie bitte die Support-Richtlinie (SUPPORT.md), die Beitragsregeln (CONTRIBUTING.md) und den Verhaltenskodex (CODE_OF_CONDUCT.md) und nehmen Sie dann Kontakt auf:

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

Aleph-Entwicklung

Wenn Sie sich an der Entwicklung von Aleph beteiligen möchten, lesen Sie bitte die Datei CONTRIBUTING.md für Details zum Einstieg.

⚠️ WICHTIG ⚠️ Der Standardbranch in diesem GitHub-Repository ist "develop". Der develop-Branch enthält unveröffentlichten, instabilen Code. Für stabile Versionen sehen Sie sich bitte die Liste der Releases <https://github.com/alephdata/aleph/releases>_ an oder wechseln Sie zum main-Branch <https://github.com/alephdata/aleph/tree/main>_.

Release-Prozess

Wenn Sie daran interessiert sind oder den Auftrag haben, eine neue Version von Aleph zu veröffentlichen, sollten die folgenden Schritte befolgt werden:

Überblick

Der grundlegende Prozess für die Veröffentlichung von Aleph ist wie folgt:

1. Überprüfen Sie interne Bibliotheken auf Aktualisierungen und führen Sie diese zusammen. Veröffentlichen Sie unsere Bibliotheken in der folgenden Reihenfolge
2. servicelayer
3. followthemoney
4. ingest-file
5. react-ftm
6. Stellen Sie sicher, dass alle Bibliotheken für eine Veröffentlichung in aleph auf dem neuesten Stand und in den develop-Branch eingeflossen sind.
7. Stellen Sie sicher, dass alle Funktionen und Fehlerbehebungen in develop eingeflossen sind und alle Builds erfolgreich sind.
8. Stellen Sie sicher, dass die Datei CHANGELOG.md im develop-Branch aktuell ist. Fügen Sie bei Bedarf Informationen hinzu.
9. Erstellen Sie einen RC-Release von Aleph.
10. Testen und überprüfen Sie den RC. Führen Sie bei Bedarf weitere RC-Releases durch.
11. Führen Sie alle Änderungen in main zusammen.
12. Erstellen Sie eine endgültige Version von Aleph.

Wenden Sie nach Möglichkeit die Regeln der semantischen Versionierung an, um die Art des durchzuführenden Releases zu bestimmen.

Technischer Prozess

RC-Releases

Wenn Sie einen RC-Release von Aleph durchführen müssen, gehen Sie wie folgt vor:

1. Stellen Sie sicher, dass CHANGELOG im develop-Branch aktuell ist und alle ausstehenden PRs eingeflossen sind.
2. Führen Sie vom develop-Branch aus bump2version (major, minor, patch) aus. Dadurch wird eine x.x.x-rc1-Version von Aleph erstellt.
3. Pushen Sie die Tags mit git push --tags auf das entfernte Repository.
4. Pushen Sie den Versionssprung mit git push.
5. Wenn es Probleme mit dem RC gibt, können Sie diese beheben und mit bump2version build einen neuen RC-Release erzeugen.

Major-, Minor-, Patch-Releases

1. Wechseln Sie zu main und pullen Sie vom entfernten Repository.
2. Führen Sie, falls noch nicht geschehen, develop in main zusammen.
3. Aktualisieren Sie die Übersetzungen mit make translate.
4. Wenn Sie npm-Fehler erhalten, gehen Sie in den ui-Ordner und führen Sie npm install aus.
5. Committen Sie die Übersetzungen in main und pushen Sie sie auf das entfernte Repository.
6. Führen Sie bump2version --verbose --sign-tags release aus. Beachten Sie, dass bump2version keine Änderungen anzeigt, wenn Sie die Änderung vornehmen, aber es funktioniert (siehe git log zur Überprüfung).
7. Pushen Sie die Tags mit git push --tags auf das entfernte Repository.
8. Pushen Sie den Versionssprung mit git push auf das entfernte Repository.
9. Führen Sie main zurück in develop zusammen. Dies ist zwar nicht direkt Teil des Release-Prozesses, aber ein guter Zeitpunkt, dies zu tun, damit die neuen Versionsnummern auch in erscheinen.