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/:hashde 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 bucketOVERLEAF_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;
getBloblo responde sin búsqueda (blob_store/index.js:378-380). projectHistoryGlobalBlobsse 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.

