Siirry pääsisältöön
projectHistoryBlobs sisältää yhden dokumentin projektihistoriaa kohden: jokaisen blobin metatiedot (hash ja koot), jonka history-v1 on tallentanut kyseiselle projektille. Blob on tiedoston tai docin sisältö jossakin sen historian kohdassa. Itse tavut ovat objekteja projektiblobien bucketissa. Mongoose-skeemaa ei ole: history-v1 kirjoittaa kokoelman tiedostossa services/history-v1/storage/lib/blob_store/mongo.js, jota se käyttää 24 heksamerkin historiatunnisteille, kuten CE:ssä (services/history-v1/storage/lib/blob_store/index.js:108-116).

Kentät

Kuka kirjoittaa

Mistä uudet blobit tulevat:
  • Tiedostojen lataukset: web lähettää tiedoston history-v1:n reitille 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).
  • Projektien kopiot: web pyytää history-v1:tä kopioimaan jokaisen tiedoston blobin reitillä 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).
  • Docin teksti: kun history-v1 kirjoittaa chunkin, se tallentaa jokaisen docin tekstin sekä sen kommentit ja seuratut muutokset JSON-muodossa blobeina (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Kuka lukee

Indeksit

Vain oletusindeksi kentälle _id. Mikään migraatio hakemistossa tools/migrations/ ei lisää muita.

Huomautukset

  • Blobin tavut ovat avaimessa <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) bucketissa OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). Projektiavain on nollilla täydennetty historiatunniste käännettynä ja jaettuna osiin 3/3/loput merkit (libraries/object-persistor/src/ProjectKey.js:8-15).
  • Blob tallennetaan kerran projektia kohden: sellaisen hashin lisäys, joka projektilla jo on, ohitetaan (blob_store/index.js:227-230, 249-252).
  • Tyhjä sisältö ei tarvitse tietuetta; getBlob vastaa siihen ilman hakua (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs luetaan käynnistyksessä (blob_store/index.js:138-148), mutta mikään CE-koodi ei kirjoita sitä, joten CE:ssä jokainen blob on projektiblob.
Viimeksi muokattu 21. marraskuuta 2026