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возвращается раньше.

