projectHistoryChunks innehåller ett dokument per historikchunk, en följd av versioner i historiken för ett projekt. Mongo innehåller bara chunkens metadata; själva chunken (en ögonblicksbild plus ändringarna efter den) är ett gzip-komprimerat JSON-objekt i chunks-bucketen. Det finns inget Mongoose-schema: history-v1 skriver samlingen i services/history-v1/storage/lib/chunk_store/mongo.js, som den använder för varje historik-id med 24 hexadecimala tecken, som i CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).
Fält
Vem skriver
Nya chunkar kommer från project-history, som skickar de köade redigeringarna till history-v1
POST /projects/:project_id/legacy_changes (services/history-v1/api/routes/project_import.js:29-31); history-v1 anropar sedan chunkStore.update eller chunkStore.create (services/history-v1/storage/lib/persist_changes.js:215, 229). Ett nytt projekt får sin första chunk från chunkStore.initializeProject (chunk_store/index.js:54-80).
Vem läser
Index
Anteckningar
- Tillståndsflöde:
pending(post skriven, uppladdning pågår) →active(den senaste chunken, kan fortfarande utökas) →closed(en nyare chunk följer) ellerdeleted(ersatt, eller projektet raderades). Läsningar tittar bara påactiveochclosed. - Chunkobjektet är gzip-komprimerad JSON (
services/history-v1/storage/lib/history_store.js:151-170) under nyckeln<project key>/<chunk id>(history_store.js:65-67). Projektnyckeln är historik-id:t utfyllt med nollor, omvänt och uppdelat i 3/3/resten av tecknen (libraries/object-persistor/src/ProjectKey.js:8-15). Bucketen ärOVERLEAF_EDITOR_CHUNKS_BUCKET(services/history-v1/config/custom-environment-variables.json:53-56):/buckets/chunksi utvecklingsmiljön (develop/docker-compose.yml:90), elleroverleaf-chunksmedS3_ENABLED=true(develop/s3/docker-compose.yml:51). - Poster i tillståndet
deletedellerpending, och deras bucketobjekt, tas bara bort avdelete_old_chunks.js(yarn delete_old_chunks,services/history-v1/package.json:79). CE-imagen har inget cronjobb för det (server-ce/config/crontab-history,server-ce/config/crontab-deletion), så i CE ligger de kvar. - När web låter ett raderat projekt gå ut anropar den history-v1
DELETE /projects/:history_id(services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391,HistoryManager.mjs:127-135,152-162), vilket markerar alla projektets chunkar somdeleted. - Med en konfigurerad
backupStoreskriver bekräftelsen av en chunk ävenoverleaf.history.currentEndVersion,currentEndTimestamp,updatedAtochoverleaf.backup.pendingChangeAttill projektet (mongo.js:232-262). CE konfigurerar intebackupStore, såmongo.js:238-240returnerar tidigt.

