Passer au contenu principal
projectHistoryBlobs contient un document par historique de projet : les métadonnées (hachage et tailles) de chaque blob que history-v1 a stocké pour ce projet. Un blob est le contenu d’un fichier ou d’un doc à un moment de son historique. Les octets eux-mêmes sont des objets dans le bucket des blobs de projet. Il n’y a pas de schéma Mongoose : history-v1 écrit la collection dans services/history-v1/storage/lib/blob_store/mongo.js, qu’il utilise pour les ids d’historique de 24 caractères hexadécimaux, comme dans CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Champs

Qui écrit

D’où viennent les nouveaux blobs :
  • Téléversements de fichiers : web envoie le fichier à PUT /projects/:project_id/blobs/:hash de history-v1 (services/web/app/src/Features/History/HistoryManager.mjs:164-169, services/history-v1/api/controllers/projects.js:376-402).
  • Copies de projet : web demande à history-v1 de copier le blob de chaque fichier avec 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).
  • Texte des docs : quand history-v1 écrit un chunk, il stocke le texte de chaque doc, ainsi que ses commentaires et modifications suivies en JSON, sous forme de blobs (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Qui lit

Index

Seulement l’index _id par défaut. Aucune migration de tools/migrations/ n’en ajoute.

Remarques

  • Les octets d’un blob se trouvent à la clé <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) dans le bucket OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). La clé de projet est l’id d’historique complété par des zéros, inversé et découpé en 3/3/reste caractères (libraries/object-persistor/src/ProjectKey.js:8-15).
  • Un blob est stocké une fois par projet : l’insertion d’un hachage que le projet possède déjà est ignorée (blob_store/index.js:227-230, 249-252).
  • Le contenu vide n’a pas besoin d’enregistrement ; getBlob y répond sans recherche (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs est lu au démarrage (blob_store/index.js:138-148), mais aucun code CE ne l’écrit ; dans CE, chaque blob est donc un blob de projet.
Dernière modification le 21 novembre 2026