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) oudeleted(remplacé, ou le projet a été supprimé). Les lectures ne regardent queactiveetclosed. - 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 estOVERLEAF_EDITOR_CHUNKS_BUCKET(services/history-v1/config/custom-environment-variables.json:53-56) :/buckets/chunksdans l’environnement de développement (develop/docker-compose.yml:90), ouoverleaf-chunksavecS3_ENABLED=true(develop/s3/docker-compose.yml:51). - Les enregistrements à l’état
deletedoupending, et leurs objets dans le bucket, ne sont retirés que pardelete_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_idde 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 projetdeleted. - Avec un
backupStoreconfiguré, la confirmation d’un chunk écrit aussioverleaf.history.currentEndVersion,currentEndTimestamp,updatedAtetoverleaf.backup.pendingChangeAtdans le projet (mongo.js:232-262). CE ne configure pasbackupStore, doncmongo.js:238-240retourne immédiatement.

