Hopp til hovedinnhold
projectHistoryBlobs inneholder ett dokument per prosjekthistorikk: metadataene (hash og størrelser) for hver blob som history-v1 har lagret for prosjektet. En blob er innholdet i en fil eller et doc på et tidspunkt i historikken. Selve bytene er objekter i bucketen for prosjektblobber. Det finnes ikke noe Mongoose-skjema: history-v1 skriver samlingen i services/history-v1/storage/lib/blob_store/mongo.js, som den bruker for historikk-id-er på 24 heksadesimale tegn, som i CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Felter

Hvem skriver

Hvor nye blobber kommer fra:
  • Filopplastinger: web sender filen til 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).
  • Prosjektkopier: web ber history-v1 kopiere bloben til hver fil 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-tekst: når history-v1 skriver en chunk, lagrer den teksten i hvert doc, og kommentarene og de sporede endringene som JSON, som blobber (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Hvem leser

Indekser

Bare standardindeksen på _id. Ingen migrering i tools/migrations/ legger til noen.

Merknader

  • Bytene i en blob ligger under nøkkelen <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). Prosjektnøkkelen er historikk-id-en fylt ut med nuller, snudd og delt opp i 3/3/resten av tegnene (libraries/object-persistor/src/ProjectKey.js:8-15).
  • En blob lagres én gang per prosjekt: innsetting av en hash prosjektet allerede har, hoppes over (blob_store/index.js:227-230, 249-252).
  • Tomt innhold trenger ingen post; getBlob besvarer det uten oppslag (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs leses ved oppstart (blob_store/index.js:138-148), men ingen CE-kode skriver den, så i CE er hver blob en prosjektblob.
Sist endret 21. november 2026