Перейти к основному содержанию
projectHistoryChunks содержит один документ на чанк истории, то есть последовательность версий в истории одного проекта. В Mongo хранятся только метаданные чанка; сам чанк (снимок плюс изменения после него) представляет собой сжатый gzip JSON-объект в бакете чанков. Схемы Mongoose нет: history-v1 записывает коллекцию в services/history-v1/storage/lib/chunk_store/mongo.js, который он использует для любого id истории из 24 шестнадцатеричных символов, как в CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Поля

Кто пишет

Новые чанки приходят от project-history, который отправляет накопленные правки в POST /projects/:project_id/legacy_changes history-v1 (services/history-v1/api/routes/project_import.js:29-31); затем history-v1 вызывает chunkStore.update или chunkStore.create (services/history-v1/storage/lib/persist_changes.js:215, 229). Новый проект получает первый чанк из chunkStore.initializeProject (chunk_store/index.js:54-80).

Кто читает

Индексы

Примечания

  • Смена состояний: pending (запись создана, идёт загрузка) → active (последний чанк, ещё может расширяться) → closed (за ним следует более новый чанк) или deleted (заменён или проект удалён). Чтение учитывает только active и closed.
  • Объект чанка представляет собой сжатый gzip JSON (services/history-v1/storage/lib/history_store.js:151-170) по ключу <project key>/<chunk id> (history_store.js:65-67). Ключ проекта: id истории, дополненный нулями, перевёрнутый и разбитый на 3/3/остальные символы (libraries/object-persistor/src/ProjectKey.js:8-15). Бакет: OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): /buckets/chunks в среде разработки (develop/docker-compose.yml:90) или overleaf-chunks с S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Записи в состоянии deleted или pending и их объекты в бакете удаляет только delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). В образе CE для этого нет задания cron (server-ce/config/crontab-history, server-ce/config/crontab-deletion), поэтому в CE они остаются.
  • Когда web завершает срок удалённого проекта, он вызывает DELETE /projects/:history_id в history-v1 (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), и все чанки проекта помечаются как deleted.
  • Если настроен backupStore, подтверждение чанка также записывает в проект overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt и overleaf.backup.pendingChangeAt (mongo.js:232-262). CE не настраивает backupStore, поэтому mongo.js:238-240 возвращается раньше.
Последнее изменение 21 ноября 2026 г.