Hopp til hovedinnhold
projectHistoryChunks inneholder ett dokument per historikkchunk, en rekke versjoner i historikken til ett prosjekt. Mongo inneholder bare chunkens metadata; selve chunken (et øyeblikksbilde pluss endringene etter det) er et gzip-komprimert JSON-objekt i chunks-bucketen. Det finnes ikke noe Mongoose-skjema: history-v1 skriver samlingen i services/history-v1/storage/lib/chunk_store/mongo.js, som den bruker for hver historikk-id på 24 heksadesimale tegn, som i CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Felter

Hvem skriver

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

Hvem leser

Indekser

Merknader

  • Tilstandsflyt: pending (post skrevet, opplasting pågår) → active (den nyeste chunken, kan fortsatt utvides) → closed (en nyere chunk følger) eller deleted (erstattet, eller prosjektet ble slettet). Lesinger ser bare på active og closed.
  • Chunkobjektet er gzip-komprimert JSON (services/history-v1/storage/lib/history_store.js:151-170) under nøkkelen <project key>/<chunk id> (history_store.js:65-67). Prosjektnøkkelen er historikk-id-en fylt ut med nuller, snudd og delt opp i 3/3/resten av 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 utviklingsmiljø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 bucketobjektene deres, fjernes bare av delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). CE-imaget har ingen cronjobb for dette (server-ce/config/crontab-history, server-ce/config/crontab-deletion), så i CE blir de liggende.
  • Når web lar et slettet prosjekt utløpe, kaller 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 prosjektets chunker som deleted.
  • Med en konfigurert backupStore skriver bekreftelsen av en chunk også overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt og overleaf.backup.pendingChangeAt til prosjektet (mongo.js:232-262). CE konfigurerer ikke backupStore, så mongo.js:238-240 returnerer tidlig.
Sist endret 21. november 2026