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で早期に戻ります。

