Spring til hovedindhold
projectHistoryBlobs indeholder ét dokument pr. projekthistorik: metadataene (hash og størrelser) for hver blob, som history-v1 har gemt for projektet. En blob er indholdet af en fil eller et doc på et tidspunkt i historikken. Selve bytene er objekter i bucketen til projektblobs. Der er intet Mongoose-skema: history-v1 skriver samlingen i services/history-v1/storage/lib/blob_store/mongo.js, som den bruger til historik-id’er på 24 hexadecimale tegn, som i CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Felter

Hvem skriver

Hvor nye blobs kommer fra:
  • Filuploads: 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).
  • Projektkopier: web beder history-v1 om at kopiere hver 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-tekst: når history-v1 skriver en chunk, gemmer den teksten i hvert doc og dets kommentarer og sporede ændringer som JSON, som blobs (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Hvem læser

Indekser

Kun standardindekset på _id. Ingen migrering i tools/migrations/ tilføjer andre.

Bemærkninger

  • Bytene i en blob ligger under nøglen <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). Projektnøglen er historik-id’et udfyldt med nuller, vendt om og delt op i 3/3/resten af tegnene (libraries/object-persistor/src/ProjectKey.js:8-15).
  • En blob gemmes én gang pr. projekt: indsættelse af en hash, som projektet allerede har, springes over (blob_store/index.js:227-230, 249-252).
  • Tomt indhold kræver ingen post; getBlob besvarer det uden opslag (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs læses ved opstart (blob_store/index.js:138-148), men ingen CE-kode skriver den, så i CE er hver blob en projektblob.
Sidst ændret 21. november 2026