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 BucketOVERLEAF_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;
getBlobbeantwortet ihn ohne Abfrage (blob_store/index.js:378-380). projectHistoryGlobalBlobswird beim Start gelesen (blob_store/index.js:138-148), aber kein CE-Code schreibt es, daher ist in CE jeder Blob ein Projekt-Blob.

