Spring til hovedindhold
projectHistoryChunks indeholder ét dokument pr. historikchunk, en række versioner i historikken for ét projekt. Mongo indeholder kun chunkens metadata; selve chunken (et øjebliksbillede plus ændringerne efter det) er et gzip-komprimeret JSON-objekt i chunks-bucketen. Der er intet Mongoose-skema: history-v1 skriver samlingen i services/history-v1/storage/lib/chunk_store/mongo.js, som den bruger til hvert historik-id på 24 hexadecimale tegn, som i CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Felter

Hvem skriver

Nye chunks kommer fra project-history, som sender de køede redigeringer til history-v1 POST /projects/:project_id/legacy_changes (services/history-v1/api/routes/project_import.js:29-31); history-v1 kalder derefter chunkStore.update eller chunkStore.create (services/history-v1/storage/lib/persist_changes.js:215, 229). Et nyt projekt får sin første chunk fra chunkStore.initializeProject (chunk_store/index.js:54-80).

Hvem læser

Indekser

Bemærkninger

  • Tilstandsforløb: pending (post skrevet, upload i gang) → active (den nyeste chunk, kan stadig udvides) → closed (en nyere chunk følger) eller deleted (erstattet, eller projektet blev slettet). Læsninger ser kun på active og closed.
  • Chunkobjektet er gzip-komprimeret JSON (services/history-v1/storage/lib/history_store.js:151-170) under nøglen <project key>/<chunk id> (history_store.js:65-67). Projektnøglen er historik-id’et udfyldt med nuller, vendt om og delt op i 3/3/resten af tegnene (libraries/object-persistor/src/ProjectKey.js:8-15). Bucketen er OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): /buckets/chunks i udviklingsmiljøet (develop/docker-compose.yml:90), eller overleaf-chunks med S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Poster i tilstanden deleted eller pending og deres bucketobjekter fjernes kun af delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). CE-imaget har intet cronjob til det (server-ce/config/crontab-history, server-ce/config/crontab-deletion), så i CE bliver de liggende.
  • Når web lader et slettet projekt udløbe, kalder den history-v1 DELETE /projects/:history_id (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), som markerer alle projektets chunks som deleted.
  • Med en konfigureret backupStore skriver bekræftelsen af en chunk også overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt og overleaf.backup.pendingChangeAt til projektet (mongo.js:232-262). CE konfigurerer ikke backupStore, så mongo.js:238-240 returnerer tidligt.
Sidst ændret 21. november 2026