Перейти до основного вмісту
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 р.