Zum Hauptinhalt springen
projectHistoryBlobs enthält ein Dokument pro Projektverlauf: die Metadaten (Hash und Größen) jedes Blobs, den history-v1 für dieses Projekt gespeichert hat. Ein Blob ist der Inhalt einer Datei oder eines Docs zu einem Zeitpunkt seines Verlaufs. Die Bytes selbst sind Objekte im Bucket für Projekt-Blobs. Es gibt kein Mongoose-Schema: history-v1 schreibt die Collection in services/history-v1/storage/lib/blob_store/mongo.js, das es für Verlaufs-IDs aus 24 Hexadezimalzeichen verwendet, wie in CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Felder

Wer schreibt

Woher neue Blobs kommen:
  • Datei-Uploads: Web sendet die Datei an history-v1 PUT /projects/:project_id/blobs/:hash (services/web/app/src/Features/History/HistoryManager.mjs:164-169, services/history-v1/api/controllers/projects.js:376-402).
  • Projektkopien: Web lässt history-v1 den Blob jeder Datei mit POST /projects/:project_id/blobs/:hash?copyFrom= kopieren (services/web/app/src/Features/Project/ProjectDuplicator.mjs:333-338, HistoryManager.mjs:177-187, projects.js:521-555).
  • Doc-Text: Wenn history-v1 einen Chunk schreibt, speichert es den Text jedes Docs sowie dessen Kommentare und nachverfolgte Änderungen als JSON als Blobs (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Wer liest

Indizes

Nur der Standardindex auf _id. Keine Migration in tools/migrations/ fügt einen hinzu.

Hinweise

  • Die Bytes eines Blobs liegen unter dem Schlüssel <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) im Bucket OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). 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).
  • Ein Blob wird einmal pro Projekt gespeichert: Das Einfügen eines Hashs, den das Projekt bereits hat, wird übersprungen (blob_store/index.js:227-230, 249-252).
  • Der leere Inhalt braucht keinen Eintrag; getBlob beantwortet ihn ohne Abfrage (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs wird beim Start gelesen (blob_store/index.js:138-148), aber kein CE-Code schreibt es, daher ist in CE jeder Blob ein Projekt-Blob.
Zuletzt geändert am 21. November 2026