Vai al contenuto principale
projectHistoryBlobs contiene un documento per ogni cronologia di progetto: i metadati (hash e dimensioni) di ogni blob che history-v1 ha salvato per quel progetto. Un blob è il contenuto di un file o di un doc in un certo punto della sua cronologia. I byte veri e propri sono oggetti nel bucket dei blob di progetto. Non esiste uno schema Mongoose: history-v1 scrive la collezione in services/history-v1/storage/lib/blob_store/mongo.js, che usa per gli id di cronologia di 24 caratteri esadecimali, come in CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Campi

Chi scrive

Da dove arrivano i nuovi blob:
  • Caricamenti di file: web invia il file a PUT /projects/:project_id/blobs/:hash di history-v1 (services/web/app/src/Features/History/HistoryManager.mjs:164-169, services/history-v1/api/controllers/projects.js:376-402).
  • Copie di progetti: web chiede a history-v1 di copiare il blob di ogni file con 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).
  • Testo dei doc: quando history-v1 scrive un chunk, salva come blob il testo di ogni doc e i suoi commenti e le modifiche tracciate in JSON (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Chi legge

Indici

Solo l’indice predefinito su _id. Nessuna migrazione in tools/migrations/ ne aggiunge uno.

Note

  • I byte di un blob si trovano alla chiave <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) nel bucket OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). La chiave del progetto è l’id di cronologia riempito con zeri, invertito e diviso in 3/3/resto caratteri (libraries/object-persistor/src/ProjectKey.js:8-15).
  • Un blob viene salvato una volta per progetto: l’inserimento di un hash che il progetto ha già viene saltato (blob_store/index.js:227-230, 249-252).
  • Il contenuto vuoto non ha bisogno di un record; getBlob lo restituisce senza ricerca (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs viene letta all’avvio (blob_store/index.js:138-148), ma nessun codice CE la scrive, quindi in CE ogni blob è un blob di progetto.
Ultima modifica il 21 novembre 2026