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) ofdeleted(vervangen, of het project is verwijderd). Leesbewerkingen kijken alleen naaractiveenclosed. - 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 isOVERLEAF_EDITOR_CHUNKS_BUCKET(services/history-v1/config/custom-environment-variables.json:53-56):/buckets/chunksin de ontwikkelomgeving (develop/docker-compose.yml:90), ofoverleaf-chunksmetS3_ENABLED=true(develop/s3/docker-compose.yml:51). - Records in de toestand
deletedofpending, en hun bucketobjecten, worden alleen verwijderd doordelete_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_idaan (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391,HistoryManager.mjs:127-135,152-162), waardoor alle chunks van het project alsdeletedworden gemarkeerd. - Met een geconfigureerde
backupStoreschrijft het bevestigen van een chunk ookoverleaf.history.currentEndVersion,currentEndTimestamp,updatedAtenoverleaf.backup.pendingChangeAtnaar het project (mongo.js:232-262). CE configureertbackupStoreniet, dusmongo.js:238-240keert vroegtijdig terug.

