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) ellerdeleted(erstattet, eller prosjektet ble slettet). Lesinger ser bare påactiveogclosed. - 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 erOVERLEAF_EDITOR_CHUNKS_BUCKET(services/history-v1/config/custom-environment-variables.json:53-56):/buckets/chunksi utviklingsmiljøet (develop/docker-compose.yml:90), elleroverleaf-chunksmedS3_ENABLED=true(develop/s3/docker-compose.yml:51). - Poster i tilstanden
deletedellerpending, og bucketobjektene deres, fjernes bare avdelete_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 somdeleted. - Med en konfigurert
backupStoreskriver bekreftelsen av en chunk ogsåoverleaf.history.currentEndVersion,currentEndTimestamp,updatedAtogoverleaf.backup.pendingChangeAttil prosjektet (mongo.js:232-262). CE konfigurerer ikkebackupStore, såmongo.js:238-240returnerer tidlig.

