Przejdź do głównej treści
projectHistoryChunks zawiera jeden dokument na chunk historii, czyli ciąg wersji w historii jednego projektu. Mongo przechowuje tylko metadane chunka; sam chunk (migawka plus zmiany po niej) jest skompresowanym przez gzip obiektem JSON w buckecie chunków. Nie ma schematu Mongoose: history-v1 zapisuje kolekcję w services/history-v1/storage/lib/chunk_store/mongo.js, którego używa dla każdego id historii o długości 24 znaków szesnastkowych, jak w CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Pola

Kto zapisuje

Nowe chunki pochodzą z project-history, który wysyła zakolejkowane edycje do POST /projects/:project_id/legacy_changes w history-v1 (services/history-v1/api/routes/project_import.js:29-31); history-v1 wywołuje następnie chunkStore.update lub chunkStore.create (services/history-v1/storage/lib/persist_changes.js:215, 229). Nowy projekt dostaje pierwszy chunk z chunkStore.initializeProject (chunk_store/index.js:54-80).

Kto odczytuje

Indeksy

Uwagi

  • Przepływ stanów: pending (rekord zapisany, trwa przesyłanie) → active (najnowszy chunk, nadal można go rozszerzać) → closed (następuje po nim nowszy chunk) lub deleted (zastąpiony albo projekt został usunięty). Odczyty uwzględniają tylko active i closed.
  • Obiekt chunka to skompresowany przez gzip JSON (services/history-v1/storage/lib/history_store.js:151-170) pod kluczem <project key>/<chunk id> (history_store.js:65-67). Klucz projektu to id historii dopełnione zerami, odwrócone i podzielone na 3/3/resztę znaków (libraries/object-persistor/src/ProjectKey.js:8-15). Bucket to OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): /buckets/chunks w środowisku deweloperskim (develop/docker-compose.yml:90) lub overleaf-chunks przy S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Rekordy w stanie deleted lub pending oraz ich obiekty w buckecie usuwa tylko delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). Obraz CE nie ma do tego zadania cron (server-ce/config/crontab-history, server-ce/config/crontab-deletion), więc w CE pozostają.
  • Gdy web wygasza usunięty projekt, wywołuje DELETE /projects/:history_id w history-v1 (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), co oznacza wszystkie chunki projektu jako deleted.
  • Przy skonfigurowanym backupStore potwierdzenie chunka zapisuje też w projekcie overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt i overleaf.backup.pendingChangeAt (mongo.js:232-262). CE nie konfiguruje backupStore, więc mongo.js:238-240 kończy wcześniej.
Ostatnia modyfikacja 21 listopada 2026