Naar hoofdinhoud gaan
projectHistoryChunks bevat één document per geschiedenischunk, een reeks versies in de geschiedenis van één project. Mongo bevat alleen de metadata van de chunk; de chunk zelf (een snapshot plus de wijzigingen daarna) is een met gzip gecomprimeerd JSON-object in de chunks-bucket. Er is geen Mongoose-schema: history-v1 schrijft de collectie in services/history-v1/storage/lib/chunk_store/mongo.js, dat het gebruikt voor elk geschiedenis-id van 24 hexadecimale tekens, zoals in CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Velden

Wie schrijft

Nieuwe chunks komen van project-history, dat de bewerkingen in de wachtrij naar history-v1 POST /projects/:project_id/legacy_changes stuurt (services/history-v1/api/routes/project_import.js:29-31); history-v1 roept daarna chunkStore.update of chunkStore.create aan (services/history-v1/storage/lib/persist_changes.js:215, 229). Een nieuw project krijgt zijn eerste chunk van chunkStore.initializeProject (chunk_store/index.js:54-80).

Wie leest

Indexen

Opmerkingen

  • Toestandsverloop: pending (record geschreven, upload bezig) → active (de nieuwste chunk, kan nog worden uitgebreid) → closed (er volgt een nieuwere chunk) of deleted (vervangen, of het project is verwijderd). Leesbewerkingen kijken alleen naar active en closed.
  • Het chunkobject is met gzip gecomprimeerde JSON (services/history-v1/storage/lib/history_store.js:151-170) onder de sleutel <project key>/<chunk id> (history_store.js:65-67). De projectsleutel is het met nullen aangevulde geschiedenis-id, omgekeerd en opgesplitst in 3/3/rest tekens (libraries/object-persistor/src/ProjectKey.js:8-15). De bucket is OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): /buckets/chunks in de ontwikkelomgeving (develop/docker-compose.yml:90), of overleaf-chunks met S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Records in de toestand deleted of pending, en hun bucketobjecten, worden alleen verwijderd door delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). De CE-image heeft daar geen cronjob voor (server-ce/config/crontab-history, server-ce/config/crontab-deletion), dus in CE blijven ze staan.
  • Wanneer web een verwijderd project laat verlopen, roept het history-v1 DELETE /projects/:history_id aan (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), waardoor alle chunks van het project als deleted worden gemarkeerd.
  • Met een geconfigureerde backupStore schrijft het bevestigen van een chunk ook overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt en overleaf.backup.pendingChangeAt naar het project (mongo.js:232-262). CE configureert backupStore niet, dus mongo.js:238-240 keert vroegtijdig terug.
Laatst gewijzigd op 21 november 2026