Zum Hauptinhalt springen
projectHistoryChunks enthält ein Dokument pro Verlaufs-Chunk, einer Folge von Versionen im Verlauf eines Projekts. Mongo enthält nur die Metadaten des Chunks; der Chunk selbst (ein Snapshot plus die Änderungen danach) ist ein gzip-komprimiertes JSON-Objekt im Chunks-Bucket. Es gibt kein Mongoose-Schema: history-v1 schreibt die Collection in services/history-v1/storage/lib/chunk_store/mongo.js, das es für jede Verlaufs-ID aus 24 Hexadezimalzeichen verwendet, wie in CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Felder

Wer schreibt

Neue Chunks kommen von project-history, das die eingereihten Bearbeitungen an history-v1 POST /projects/:project_id/legacy_changes sendet (services/history-v1/api/routes/project_import.js:29-31); history-v1 ruft dann chunkStore.update oder chunkStore.create auf (services/history-v1/storage/lib/persist_changes.js:215, 229). Ein neues Projekt erhält seinen ersten Chunk von chunkStore.initializeProject (chunk_store/index.js:54-80).

Wer liest

Indizes

Hinweise

  • Zustandsablauf: pending (Eintrag geschrieben, Upload läuft) → active (der neueste Chunk, kann noch erweitert werden) → closed (ein neuerer Chunk folgt) oder deleted (ersetzt, oder das Projekt wurde gelöscht). Lesevorgänge betrachten nur active und closed.
  • Das Chunk-Objekt ist gzip-komprimiertes JSON (services/history-v1/storage/lib/history_store.js:151-170) unter dem Schlüssel <project key>/<chunk id> (history_store.js:65-67). Der Projektschlüssel ist die mit Nullen aufgefüllte Verlaufs-ID, umgekehrt und in 3/3/Rest Zeichen aufgeteilt (libraries/object-persistor/src/ProjectKey.js:8-15). Der Bucket ist OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): /buckets/chunks in der Entwicklungsumgebung (develop/docker-compose.yml:90) oder overleaf-chunks mit S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Einträge im Zustand deleted oder pending und ihre Bucket-Objekte werden nur von delete_old_chunks.js entfernt (yarn delete_old_chunks, services/history-v1/package.json:79). Das CE-Image hat dafür keinen Cron-Job (server-ce/config/crontab-history, server-ce/config/crontab-deletion), daher bleiben sie in CE erhalten.
  • Wenn Web ein gelöschtes Projekt ablaufen lässt, ruft es history-v1 DELETE /projects/:history_id auf (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), was alle Chunks des Projekts als deleted markiert.
  • Mit einem konfigurierten backupStore schreibt das Bestätigen eines Chunks außerdem overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt und overleaf.backup.pendingChangeAt in das Projekt (mongo.js:232-262). CE konfiguriert backupStore nicht, daher kehrt mongo.js:238-240 vorzeitig zurück.
Zuletzt geändert am 21. November 2026