Saltar para o conteúdo principal
projectHistoryBlobs contém um documento por histórico de projeto: os metadados (hash e tamanhos) de cada blob que o history-v1 armazenou para esse projeto. Um blob é o conteúdo de um arquivo ou de um doc em algum ponto do seu histórico. Os bytes em si são objetos no bucket de blobs de projeto. Não há esquema Mongoose: o history-v1 escreve a coleção em services/history-v1/storage/lib/blob_store/mongo.js, que ele usa para ids de histórico de 24 caracteres hexadecimais, como no CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Campos

Quem escreve

De onde vêm os novos blobs:
  • Envios de arquivos: o web envia o arquivo para PUT /projects/:project_id/blobs/:hash do history-v1 (services/web/app/src/Features/History/HistoryManager.mjs:164-169, services/history-v1/api/controllers/projects.js:376-402).
  • Cópias de projetos: o web pede ao history-v1 que copie o blob de cada arquivo com 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 dos docs: quando o history-v1 escreve um chunk, ele armazena como blobs o texto de cada doc e seus comentários e alterações rastreadas em JSON (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Quem lê

Índices

Apenas o índice padrão de _id. Nenhuma migração em tools/migrations/ adiciona outro.

Notas

  • Os bytes de um blob ficam na chave <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) no bucket OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). A chave do projeto é o id de histórico preenchido com zeros, invertido e dividido em 3/3/resto caracteres (libraries/object-persistor/src/ProjectKey.js:8-15).
  • Um blob é armazenado uma vez por projeto: a inserção de um hash que o projeto já tem é ignorada (blob_store/index.js:227-230, 249-252).
  • O conteúdo vazio não precisa de registro; getBlob o responde sem busca (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs é lida na inicialização (blob_store/index.js:138-148), mas nenhum código do CE a escreve, então no CE todo blob é um blob de projeto.
Última modificação em 21 de novembro de 2026