Přejít na hlavní obsah
projectHistoryChunks obsahuje jeden dokument na chunk historie, tedy úsek verzí v historii jednoho projektu. Mongo uchovává jen metadata chunku; samotný chunk (snímek a změny po něm) je objekt JSON komprimovaný gzipem v bucketu chunků. Schéma Mongoose neexistuje: history-v1 zapisuje kolekci v services/history-v1/storage/lib/chunk_store/mongo.js, který používá pro každé id historie o 24 hexadecimálních znacích, jako v CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Pole

Kdo zapisuje

Nové chunky přicházejí z project-history, které posílá zařazené úpravy na POST /projects/:project_id/legacy_changes v history-v1 (services/history-v1/api/routes/project_import.js:29-31); history-v1 pak zavolá chunkStore.update nebo chunkStore.create (services/history-v1/storage/lib/persist_changes.js:215, 229). Nový projekt dostane svůj první chunk z chunkStore.initializeProject (chunk_store/index.js:54-80).

Kdo čte

Indexy

Poznámky

  • Průběh stavů: pending (záznam zapsán, probíhá nahrávání) → active (nejnovější chunk, lze jej ještě rozšířit) → closed (následuje novější chunk) nebo deleted (nahrazen, nebo byl projekt smazán). Čtení bere v úvahu jen active a closed.
  • Objekt chunku je JSON komprimovaný gzipem (services/history-v1/storage/lib/history_store.js:151-170) pod klíčem <project key>/<chunk id> (history_store.js:65-67). Klíč projektu je id historie doplněné nulami, obrácené a rozdělené na 3/3/zbytek znaků (libraries/object-persistor/src/ProjectKey.js:8-15). Bucket je OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): /buckets/chunks ve vývojovém prostředí (develop/docker-compose.yml:90), nebo overleaf-chunks s S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Záznamy ve stavu deleted nebo pending a jejich objekty v bucketu odstraňuje jen delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). Obraz CE pro to nemá úlohu cron (server-ce/config/crontab-history, server-ce/config/crontab-deletion), takže v CE zůstávají.
  • Když web nechá vypršet smazaný projekt, zavolá DELETE /projects/:history_id v history-v1 (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), což označí všechny chunky projektu jako deleted.
  • S nakonfigurovaným backupStore zapíše potvrzení chunku do projektu také overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt a overleaf.backup.pendingChangeAt (mongo.js:232-262). CE backupStore nekonfiguruje, takže mongo.js:238-240 skončí předčasně.
Naposledy změněno 21. listopadu 2026