Saltar para o conteúdo principal
projectHistoryChunks contém um documento por chunk de histórico, uma sequência de versões no histórico de um projeto. O Mongo guarda apenas os metadados do chunk; o chunk em si (um snapshot mais as alterações posteriores) é um objeto JSON compactado com gzip no bucket de chunks. Não há esquema Mongoose: o history-v1 escreve a coleção em services/history-v1/storage/lib/chunk_store/mongo.js, que ele usa para todo id de histórico de 24 caracteres hexadecimais, como no CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Campos

Quem escreve

Novos chunks vêm do project-history, que envia as edições enfileiradas para POST /projects/:project_id/legacy_changes do history-v1 (services/history-v1/api/routes/project_import.js:29-31); o history-v1 então chama chunkStore.update ou chunkStore.create (services/history-v1/storage/lib/persist_changes.js:215, 229). Um projeto novo recebe seu primeiro chunk de chunkStore.initializeProject (chunk_store/index.js:54-80).

Quem lê

Índices

Notas

  • Fluxo de estados: pending (registro escrito, envio em andamento) → active (o chunk mais recente, ainda pode ser estendido) → closed (um chunk mais novo o segue) ou deleted (substituído, ou o projeto foi excluído). As leituras consideram apenas active e closed.
  • O objeto do chunk é JSON compactado com gzip (services/history-v1/storage/lib/history_store.js:151-170) na chave <project key>/<chunk id> (history_store.js:65-67). 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). O bucket é OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): /buckets/chunks no ambiente de desenvolvimento (develop/docker-compose.yml:90), ou overleaf-chunks com S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Registros no estado deleted ou pending, e seus objetos no bucket, só são removidos por delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). A imagem do CE não tem cron job para isso (server-ce/config/crontab-history, server-ce/config/crontab-deletion), então no CE eles permanecem.
  • Quando o web faz expirar um projeto excluído, ele chama DELETE /projects/:history_id do history-v1 (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), o que marca todos os chunks do projeto como deleted.
  • Com um backupStore configurado, confirmar um chunk também escreve overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt e overleaf.backup.pendingChangeAt no projeto (mongo.js:232-262). O CE não configura backupStore, então mongo.js:238-240 retorna antes.
Última modificação em 21 de novembro de 2026