Saltar al contenido principal
projectHistoryBlobs contiene un documento por historial de proyecto: los metadatos (hash y tamaños) de cada blob que history-v1 ha guardado para ese proyecto. Un blob es el contenido de un archivo o de un doc en algún momento de su historial. Los bytes en sí son objetos en el bucket de blobs de proyecto. No hay esquema de Mongoose: history-v1 escribe la colección en services/history-v1/storage/lib/blob_store/mongo.js, que usa para ids de historial de 24 caracteres hexadecimales, como en CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Campos

Quién escribe

De dónde vienen los blobs nuevos:
  • Subidas de archivos: web envía el archivo a 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).
  • Copias de proyectos: web pide a history-v1 que copie el blob de cada archivo 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).
  • Texto de los docs: cuando history-v1 escribe un chunk, guarda como blobs el texto de cada doc y sus comentarios y cambios con seguimiento en JSON (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Quién lee

Índices

Solo el índice predeterminado de _id. Ninguna migración de tools/migrations/ añade otro.

Notas

  • Los bytes de un blob están en la clave <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) del bucket OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). La clave del proyecto es el id de historial rellenado con ceros, invertido y dividido en 3/3/resto caracteres (libraries/object-persistor/src/ProjectKey.js:8-15).
  • Un blob se guarda una vez por proyecto: se omite la inserción de un hash que el proyecto ya tiene (blob_store/index.js:227-230, 249-252).
  • El contenido vacío no necesita registro; getBlob lo responde sin búsqueda (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs se lee al arrancar (blob_store/index.js:138-148), pero ningún código de CE lo escribe, así que en CE todo blob es un blob de proyecto.
Última modificación el 21 de noviembre de 2026