aleph

.. epigraph::

真理は閉ざされた心には届かない。宇宙のすべての場所がアレフの中にあるなら、すべての星、すべての灯り、すべての光源もまたその中にある。

-- 『アレフ』（ホルヘ・ルイス・ボルヘス、http://www.phinnweb.org/links/literature/borges/aleph.html ）

⚠️ プロジェクトステータス: サンセット進行中 ⚠️ このオープンソースプロジェクトへの私たちの関与は終了に向かっています。このバージョンのメンテナンスは2025年12月をもって正式に終了します。

なぜですか？

この決定は、私たちにとって重要な戦略的転換を示しています。過去1年間、私たちのチームはAleph Proを立ち上げるためにAlephのコードベースを完全にゼロから書き直しました。この新しいサポート対象プラットフォームへの移行に伴い、世界中の調査活動を支え続けられるよう、リソースをAleph Proに完全に集中しています。

この決定の詳細と今後の意味については、公式の FAQ <https://www.occrp.org/en/announcement/aleph-pro-frequently-asked-questions-on-the-future-of-occrps-investigative-data-platform/>__ をお読みください。

スケジュールとサポート

• このリポジトリのメンテナンスは2025年12月31日まで継続します。それ以降は、コアチームによるアップデート、バグ修正、サポートは一切提供されません。
• 移行やレガシーソフトウェアに関するご質問は、Discourseコミュニティ <https://aleph.discourse.group//>__ までお問い合わせください。
• 現在Alephインスタンスをホストしている方には、移行について近日中にご連絡いたします。
• コラボレーションを希望される組織や個人は、[email protected] までご連絡ください。

ありがとうございます！ これまでに構築してきたものを非常に誇りに思っています。このプロジェクトの構築に協力し、私たちの使命を信じてくださったすべてのコントリビューターとコミュニティメンバーに感謝します。

ソフトウェアについて

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. Aleph の RC リリースを作成します。
10. RC をテストして検証します。必要に応じてさらに RC リリースを実施します。
11. すべての変更を main にマージします。
12. Aleph の最終バージョンを作成します。

可能な限り、セマンティックバージョニングのルールを適用して、実行するリリースの種類を決定します。

技術的なプロセス

RC リリース

Aleph の RC リリースを実施する必要がある場合は、以下の手順に従います：

1. CHANGELOG が develop ブランチで最新であり、未処理の PR がすべてマージされていることを確認します。
2. develop ブランチから bump2version (major, minor, patch) を実行します。これにより、x.x.x-rc1 バージョンの Aleph が作成されます。
3. git push --tags でタグをリモートにプッシュします。
4. git push でバージョンアップをプッシュします。
5. RC に問題がある場合は修正し、bump2version build を使用して新しい RC リリースを生成できます。

メジャー、マイナー、パッチリリース

1. main に切り替え、リモートからプルします。
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 にマージして戻します。リリースプロセスとは直接関係ありませんが、新しいバージョン番号が develop にも反映される良いタイミングです。