メインコンテンツへスキップ
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 です。
最終更新日 2026年11月21日