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) oderdeleted(ersetzt, oder das Projekt wurde gelöscht). Lesevorgänge betrachten nuractiveundclosed. - 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 istOVERLEAF_EDITOR_CHUNKS_BUCKET(services/history-v1/config/custom-environment-variables.json:53-56):/buckets/chunksin der Entwicklungsumgebung (develop/docker-compose.yml:90) oderoverleaf-chunksmitS3_ENABLED=true(develop/s3/docker-compose.yml:51). - Einträge im Zustand
deletedoderpendingund ihre Bucket-Objekte werden nur vondelete_old_chunks.jsentfernt (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_idauf (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391,HistoryManager.mjs:127-135,152-162), was alle Chunks des Projekts alsdeletedmarkiert. - Mit einem konfigurierten
backupStoreschreibt das Bestätigen eines Chunks außerdemoverleaf.history.currentEndVersion,currentEndTimestamp,updatedAtundoverleaf.backup.pendingChangeAtin das Projekt (mongo.js:232-262). CE konfiguriertbackupStorenicht, daher kehrtmongo.js:238-240vorzeitig zurück.

