Naar hoofdinhoud gaan
projectHistoryBlobs bevat één document per projectgeschiedenis: de metadata (hash en groottes) van elke blob die history-v1 voor dat project heeft opgeslagen. Een blob is de inhoud van een bestand of een doc op een bepaald moment in de geschiedenis. De bytes zelf zijn objecten in de bucket voor projectblobs. Er is geen Mongoose-schema: history-v1 schrijft de collectie in services/history-v1/storage/lib/blob_store/mongo.js, dat het gebruikt voor geschiedenis-id’s van 24 hexadecimale tekens, zoals in CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Velden

Wie schrijft

Waar nieuwe blobs vandaan komen:
  • Bestandsuploads: web stuurt het bestand naar 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).
  • Projectkopieën: web vraagt history-v1 de blob van elk bestand te kopiëren met 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).
  • Doctekst: wanneer history-v1 een chunk schrijft, slaat het de tekst van elke doc en de opmerkingen en bijgehouden wijzigingen ervan als JSON op als blobs (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Wie leest

Indexen

Alleen de standaardindex op _id. Geen migratie in tools/migrations/ voegt er een toe.

Opmerkingen

  • De bytes van een blob staan onder de sleutel <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) in de bucket OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). De projectsleutel is het met nullen aangevulde geschiedenis-id, omgekeerd en opgesplitst in 3/3/rest tekens (libraries/object-persistor/src/ProjectKey.js:8-15).
  • Een blob wordt één keer per project opgeslagen: het invoegen van een hash die het project al heeft, wordt overgeslagen (blob_store/index.js:227-230, 249-252).
  • De lege inhoud heeft geen record nodig; getBlob beantwoordt die zonder opzoeking (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs wordt bij het opstarten gelezen (blob_store/index.js:138-148), maar geen CE-code schrijft erin, dus in CE is elke blob een projectblob.
Laatst gewijzigd op 21 november 2026