Přejít na hlavní obsah
projectHistoryBlobs obsahuje jeden dokument na historii projektu: metadata (hash a velikosti) každého blobu, který history-v1 pro daný projekt uložil. Blob je obsah souboru nebo doc v určitém bodě jeho historie. Samotné bajty jsou objekty v bucketu projektových blobů. Schéma Mongoose neexistuje: history-v1 zapisuje kolekci v services/history-v1/storage/lib/blob_store/mongo.js, který používá pro id historie o 24 hexadecimálních znacích, jako v CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Pole

Kdo zapisuje

Odkud přicházejí nové bloby:
  • Nahrávání souborů: web odešle soubor na PUT /projects/:project_id/blobs/:hash v history-v1 (services/web/app/src/Features/History/HistoryManager.mjs:164-169, services/history-v1/api/controllers/projects.js:376-402).
  • Kopie projektů: web požádá history-v1 o zkopírování blobu každého souboru pomocí POST /projects/:project_id/blobs/:hash?copyFrom= (services/web/app/src/Features/Project/ProjectDuplicator.mjs:333-338, HistoryManager.mjs:177-187, projects.js:521-555).
  • Text docs: když history-v1 zapisuje chunk, uloží jako bloby text každého doc a jeho komentáře a sledované změny ve formátu JSON (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Kdo čte

Indexy

Jen výchozí index _id. Žádná migrace v tools/migrations/ další nepřidává.

Poznámky

  • Bajty blobu jsou pod klíčem <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) v bucketu OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). Klíč projektu je id historie doplněné nulami, obrácené a rozdělené na 3/3/zbytek znaků (libraries/object-persistor/src/ProjectKey.js:8-15).
  • Blob se ukládá jednou na projekt: vložení hashe, který projekt už má, se přeskočí (blob_store/index.js:227-230, 249-252).
  • Prázdný obsah nepotřebuje záznam; getBlob na něj odpoví bez vyhledávání (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs se čte při spuštění (blob_store/index.js:138-148), ale žádný kód CE do ní nezapisuje, takže v CE je každý blob projektovým blobem.
Naposledy změněno 21. listopadu 2026