projectHistoryBlobs にはプロジェクト履歴ごとに 1 つのドキュメントがあり、history-v1 がそのプロジェクト用に保存したすべての blob のメタデータ(ハッシュとサイズ)を保持します。blob は、ファイルまたは doc の履歴のある時点での内容です。バイト列そのものはプロジェクト blob バケット内のオブジェクトです。Mongoose スキーマはありません。history-v1 が services/history-v1/storage/lib/blob_store/mongo.js でコレクションに書き込み、CE と同様に 16 進数 24 文字の履歴 id にこれを使います(services/history-v1/storage/lib/blob_store/index.js:108-116)。
フィールド
書き込み元
新しい blob の出どころ:
- ファイルのアップロード:web がファイルを history-v1 の
PUT /projects/:project_id/blobs/:hashに送ります(services/web/app/src/Features/History/HistoryManager.mjs:164-169,services/history-v1/api/controllers/projects.js:376-402)。 - プロジェクトのコピー:web が history-v1 に
POST /projects/:project_id/blobs/:hash?copyFrom=で各ファイルの blob のコピーを依頼します(services/web/app/src/Features/Project/ProjectDuplicator.mjs:333-338,HistoryManager.mjs:177-187,projects.js:521-555)。 - doc のテキスト:history-v1 がチャンクを書き込むとき、各 doc のテキストと、そのコメントおよび変更履歴(JSON)を blob として保存します(
chunk_store/index.js:402-405,libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173)。
読み取り元
インデックス
デフォルトの_id インデックスのみです。tools/migrations/ のマイグレーションでインデックスを追加するものはありません。
補足
- blob のバイト列は、バケット
OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET(services/history-v1/config/custom-environment-variables.json:49-52)内のキー<project key>/<hash[0:2]>/<hash[2:]>(blob_store/index.js:51-53)にあります。プロジェクトキーは、ゼロ埋めした履歴 id を反転し、3/3/残りの文字に分割したものです(libraries/object-persistor/src/ProjectKey.js:8-15)。 - blob はプロジェクトごとに 1 回だけ保存されます。プロジェクトがすでに持つハッシュの挿入はスキップされます(
blob_store/index.js:227-230,249-252)。 - 空の内容にはレコードが不要です。
getBlobは検索なしで応答します(blob_store/index.js:378-380)。 projectHistoryGlobalBlobsは起動時に読み込まれます(blob_store/index.js:138-148)が、CE のコードは書き込まないため、CE ではすべての blob がプロジェクト blob です。

