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) taideleted(korvattu, tai projekti on poistettu). Luvut huomioivat vain tilatactivejaclosed. - 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 onOVERLEAF_EDITOR_CHUNKS_BUCKET(services/history-v1/config/custom-environment-variables.json:53-56): kehitysympäristössä/buckets/chunks(develop/docker-compose.yml:90), taioverleaf-chunks, kunS3_ENABLED=true(develop/s3/docker-compose.yml:51). - Tilassa
deletedtaipendingolevat tietueet ja niiden bucket-objektit poistaa vaindelete_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 tilaandeleted. - Kun
backupStoreon määritetty, chunkin vahvistaminen kirjoittaa projektiin myösoverleaf.history.currentEndVersion,currentEndTimestamp,updatedAtjaoverleaf.backup.pendingChangeAt(mongo.js:232-262). CE ei määritäbackupStore-asetusta, jotenmongo.js:238-240palaa aikaisin.

