Siirry pääsisältöön
projectHistoryChunks sisältää yhden dokumentin historiachunkia kohden; chunk on versioiden jakso yhden projektin historiassa. Mongossa on vain chunkin metatiedot; itse chunk (tilannekuva ja sen jälkeiset muutokset) on gzip-pakattu JSON-objekti chunks-bucketissa. Mongoose-skeemaa ei ole: history-v1 kirjoittaa kokoelman tiedostossa services/history-v1/storage/lib/chunk_store/mongo.js, jota se käyttää jokaiselle 24 heksamerkin historiatunnisteelle, kuten CE:ssä (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Kentät

Kuka kirjoittaa

Uudet chunkit tulevat project-historysta, joka lähettää jonossa olevat muokkaukset history-v1:n reitille POST /projects/:project_id/legacy_changes (services/history-v1/api/routes/project_import.js:29-31); history-v1 kutsuu sitten chunkStore.update- tai chunkStore.create-funktiota (services/history-v1/storage/lib/persist_changes.js:215, 229). Uusi projekti saa ensimmäisen chunkinsa funktiosta chunkStore.initializeProject (chunk_store/index.js:54-80).

Kuka lukee

Indeksit

Huomautukset

  • Tilojen kulku: pending (tietue kirjoitettu, lataus käynnissä) → active (uusin chunk, voi vielä laajentua) → closed (uudempi chunk seuraa) tai deleted (korvattu, tai projekti on poistettu). Luvut huomioivat vain tilat active ja closed.
  • Chunk-objekti on gzip-pakattua JSONia (services/history-v1/storage/lib/history_store.js:151-170) avaimessa <project key>/<chunk id> (history_store.js:65-67). Projektiavain on nollilla täydennetty historiatunniste käännettynä ja jaettuna osiin 3/3/loput merkit (libraries/object-persistor/src/ProjectKey.js:8-15). Bucket on OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): kehitysympäristössä /buckets/chunks (develop/docker-compose.yml:90), tai overleaf-chunks, kun S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Tilassa deleted tai pending olevat tietueet ja niiden bucket-objektit poistaa vain delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). CE-kuvassa ei ole tälle cron-työtä (server-ce/config/crontab-history, server-ce/config/crontab-deletion), joten CE:ssä ne jäävät.
  • Kun web vanhentaa poistetun projektin, se kutsuu history-v1:n reittiä DELETE /projects/:history_id (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), mikä merkitsee kaikki projektin chunkit tilaan deleted.
  • Kun backupStore on määritetty, chunkin vahvistaminen kirjoittaa projektiin myös overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt ja overleaf.backup.pendingChangeAt (mongo.js:232-262). CE ei määritä backupStore-asetusta, joten mongo.js:238-240 palaa aikaisin.
Viimeksi muokattu 21. marraskuuta 2026