Hoppa till huvudinnehåll
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) eller deleted (ersatt, eller projektet raderades). Läsningar tittar bara på active och closed.
  • 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 är OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): /buckets/chunks i utvecklingsmiljön (develop/docker-compose.yml:90), eller overleaf-chunks med S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Poster i tillståndet deleted eller pending, och deras bucketobjekt, tas bara bort av delete_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 som deleted.
  • Med en konfigurerad backupStore skriver bekräftelsen av en chunk även overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt och overleaf.backup.pendingChangeAt till projektet (mongo.js:232-262). CE konfigurerar inte backupStore, så mongo.js:238-240 returnerar tidigt.
Senast ändrad 21 november 2026