Saltar al contenido principal
projectHistoryChunks contiene un documento por chunk de historial, una serie de versiones en el historial de un proyecto. Mongo solo guarda los metadatos del chunk; el chunk en sí (una instantánea más los cambios posteriores) es un objeto JSON comprimido con gzip en el bucket de chunks. No hay esquema de Mongoose: history-v1 escribe la colección en services/history-v1/storage/lib/chunk_store/mongo.js, que usa para todo id de historial de 24 caracteres hexadecimales, como en CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Campos

Quién escribe

Los chunks nuevos vienen de project-history, que envía las ediciones en cola a POST /projects/:project_id/legacy_changes de history-v1 (services/history-v1/api/routes/project_import.js:29-31); history-v1 llama entonces a chunkStore.update o chunkStore.create (services/history-v1/storage/lib/persist_changes.js:215, 229). Un proyecto nuevo obtiene su primer chunk de chunkStore.initializeProject (chunk_store/index.js:54-80).

Quién lee

Índices

Notas

  • Flujo de estados: pending (registro escrito, subida en curso) → active (el chunk más reciente, aún se puede ampliar) → closed (le sigue un chunk más nuevo) o deleted (sustituido, o el proyecto se eliminó). Las lecturas solo tienen en cuenta active y closed.
  • El objeto del chunk es JSON comprimido con gzip (services/history-v1/storage/lib/history_store.js:151-170) en la clave <project key>/<chunk id> (history_store.js:65-67). 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). El bucket es OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): /buckets/chunks en el entorno de desarrollo (develop/docker-compose.yml:90), o overleaf-chunks con S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Los registros en estado deleted o pending, y sus objetos en el bucket, solo los quita delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). La imagen de CE no tiene ninguna tarea cron para ello (server-ce/config/crontab-history, server-ce/config/crontab-deletion), así que en CE permanecen.
  • Cuando web hace expirar un proyecto eliminado, llama a DELETE /projects/:history_id de history-v1 (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), que marca todos los chunks del proyecto como deleted.
  • Con un backupStore configurado, confirmar un chunk también escribe overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt y overleaf.backup.pendingChangeAt en el proyecto (mongo.js:232-262). CE no configura backupStore, así que mongo.js:238-240 retorna antes.
Última modificación el 21 de noviembre de 2026