Passer au contenu principal
projectHistoryChunks contient un document par chunk d’historique, une suite de versions dans l’historique d’un projet. Mongo ne contient que les métadonnées du chunk ; le chunk lui-même (un instantané plus les modifications qui le suivent) est un objet JSON compressé avec gzip dans le bucket des chunks. Il n’y a pas de schéma Mongoose : history-v1 écrit la collection dans services/history-v1/storage/lib/chunk_store/mongo.js, qu’il utilise pour tout id d’historique de 24 caractères hexadécimaux, comme dans CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Champs

Qui écrit

Les nouveaux chunks viennent de project-history, qui envoie les modifications en file d’attente à POST /projects/:project_id/legacy_changes de history-v1 (services/history-v1/api/routes/project_import.js:29-31) ; history-v1 appelle ensuite chunkStore.update ou chunkStore.create (services/history-v1/storage/lib/persist_changes.js:215, 229). Un nouveau projet reçoit son premier chunk de chunkStore.initializeProject (chunk_store/index.js:54-80).

Qui lit

Index

Remarques

  • Cycle des états : pending (enregistrement écrit, téléversement en cours) → active (le dernier chunk, peut encore être étendu) → closed (un chunk plus récent le suit) ou deleted (remplacé, ou le projet a été supprimé). Les lectures ne regardent que active et closed.
  • L’objet du chunk est du JSON compressé avec gzip (services/history-v1/storage/lib/history_store.js:151-170) à la clé <project key>/<chunk id> (history_store.js:65-67). La clé de projet est l’id d’historique complété par des zéros, inversé et découpé en 3/3/reste caractères (libraries/object-persistor/src/ProjectKey.js:8-15). Le bucket est OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56) : /buckets/chunks dans l’environnement de développement (develop/docker-compose.yml:90), ou overleaf-chunks avec S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Les enregistrements à l’état deleted ou pending, et leurs objets dans le bucket, ne sont retirés que par delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). L’image CE n’a pas de tâche cron pour cela (server-ce/config/crontab-history, server-ce/config/crontab-deletion), donc dans CE ils restent.
  • Quand web fait expirer un projet supprimé, il appelle DELETE /projects/:history_id de history-v1 (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), ce qui marque tous les chunks du projet deleted.
  • Avec un backupStore configuré, la confirmation d’un chunk écrit aussi overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt et overleaf.backup.pendingChangeAt dans le projet (mongo.js:232-262). CE ne configure pas backupStore, donc mongo.js:238-240 retourne immédiatement.
Dernière modification le 21 novembre 2026