Hoppa till huvudinnehåll
projectHistoryBlobs innehåller ett dokument per projekthistorik: metadata (hash och storlekar) för varje blob som history-v1 har lagrat för projektet. En blob är innehållet i en fil eller ett doc vid en viss punkt i dess historik. Själva byten är objekt i bucketen för projektblobbar. Det finns inget Mongoose-schema: history-v1 skriver samlingen i services/history-v1/storage/lib/blob_store/mongo.js, som den använder för historik-id med 24 hexadecimala tecken, som i CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Fält

Vem skriver

Var nya blobbar kommer ifrån:
  • Filuppladdningar: web skickar filen till 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).
  • Projektkopior: web ber history-v1 kopiera varje fils blob med 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).
  • Doc-text: när history-v1 skriver en chunk lagrar den texten i varje doc, och dess kommentarer och spårade ändringar som JSON, som blobbar (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Vem läser

Index

Bara standardindexet på _id. Ingen migrering i tools/migrations/ lägger till något.

Anteckningar

  • Byten i en blob finns under nyckeln <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) i bucketen OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). Projektnyckeln är historik-id:t utfyllt med nollor, omvänt och uppdelat i 3/3/resten av tecknen (libraries/object-persistor/src/ProjectKey.js:8-15).
  • En blob lagras en gång per projekt: infogning av en hash som projektet redan har hoppas över (blob_store/index.js:227-230, 249-252).
  • Tomt innehåll behöver ingen post; getBlob besvarar det utan uppslag (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs läses vid start (blob_store/index.js:138-148), men ingen CE-kod skriver den, så i CE är varje blob en projektblob.
Senast ändrad 21 november 2026