メインコンテンツへスキップ
projectHistoryChunks には履歴チャンクごとに 1 つのドキュメントがあります。チャンクとは、1 つのプロジェクトの履歴における連続したバージョンの範囲です。Mongo にはチャンクのメタデータだけがあり、チャンク本体(スナップショットとその後の変更)は chunks バケット内の gzip 圧縮された JSON オブジェクトです。Mongoose スキーマはありません。history-v1 が services/history-v1/storage/lib/chunk_store/mongo.js でコレクションに書き込み、CE と同様に 16 進数 24 文字のすべての履歴 id にこれを使います(services/history-v1/storage/lib/chunk_store/index.js:644-652)。

フィールド

書き込み元

新しいチャンクは project-history から来ます。project-history はキューに入った編集を history-v1 の POST /projects/:project_id/legacy_changes に送り(services/history-v1/api/routes/project_import.js:29-31)、history-v1 は chunkStore.update または chunkStore.create を呼び出します(services/history-v1/storage/lib/persist_changes.js:215, 229)。新しいプロジェクトは最初のチャンクを chunkStore.initializeProject から受け取ります(chunk_store/index.js:54-80)。

読み取り元

インデックス

補足

  • 状態の流れ:pending(レコード書き込み済み、アップロード中)→ active(最新のチャンク、まだ拡張可能)→ closed(より新しいチャンクが続く)または deleted(置き換えられた、またはプロジェクトが削除された)。読み取りは active と closed だけを対象にします。
  • チャンクオブジェクトは gzip 圧縮された JSON(services/history-v1/storage/lib/history_store.js:151-170)で、キー <project key>/<chunk id>(history_store.js:65-67)にあります。プロジェクトキーは、ゼロ埋めした履歴 id を反転し、3/3/残りの文字に分割したものです(libraries/object-persistor/src/ProjectKey.js:8-15)。バケットは OVERLEAF_EDITOR_CHUNKS_BUCKET(services/history-v1/config/custom-environment-variables.json:53-56)で、開発環境では /buckets/chunks(develop/docker-compose.yml:90)、S3_ENABLED=true では overleaf-chunks(develop/s3/docker-compose.yml:51)です。
  • deleted または pending 状態のレコードとそのバケットオブジェクトは、delete_old_chunks.js だけが削除します(yarn delete_old_chunks、services/history-v1/package.json:79)。CE イメージにはそのための cron ジョブがない(server-ce/config/crontab-history, server-ce/config/crontab-deletion)ため、CE では残り続けます。
  • web が削除済みプロジェクトを期限切れにするとき、history-v1 の DELETE /projects/:history_id を呼び出し(services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162)、プロジェクトのすべてのチャンクが deleted になります。
  • backupStore が設定されている場合、チャンクの確定時に overleaf.history.currentEndVersion、currentEndTimestamp、updatedAt、overleaf.backup.pendingChangeAt もプロジェクトに書き込まれます(mongo.js:232-262)。CE は backupStore を設定しないため、mongo.js:238-240 で早期に戻ります。
最終更新日 2026年11月21日