Перейти до основного вмісту
projectHistoryBlobs містить один документ на історію проєкту: метадані (хеш і розміри) кожного blob, який history-v1 зберіг для цього проєкту. Blob є вмістом файлу або doc у певний момент його історії. Самі байти зберігаються як об’єкти в бакеті blob-ів проєкту. Схеми Mongoose немає: history-v1 записує колекцію в services/history-v1/storage/lib/blob_store/mongo.js, який він використовує для id історії з 24 шістнадцяткових символів, як у CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Поля

Хто записує

Звідки беруться нові blob-и:
  • Завантаження файлів: web надсилає файл у PUT /projects/:project_id/blobs/:hash history-v1 (services/web/app/src/Features/History/HistoryManager.mjs:164-169, services/history-v1/api/controllers/projects.js:376-402).
  • Копії проєктів: web просить history-v1 скопіювати blob кожного файлу через POST /projects/:project_id/blobs/:hash?copyFrom= (services/web/app/src/Features/Project/ProjectDuplicator.mjs:333-338, HistoryManager.mjs:177-187, projects.js:521-555).
  • Текст docs: коли history-v1 записує чанк, він зберігає як blob-и текст кожного doc, а також його коментарі й відстежувані зміни у вигляді JSON (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Хто читає

Індекси

Лише стандартний індекс _id. Жодна міграція в tools/migrations/ не додає інших.

Примітки

  • Байти blob зберігаються за ключем <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) у бакеті OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). Ключ проєкту: id історії, доповнений нулями, перевернутий і поділений на 3/3/решту символів (libraries/object-persistor/src/ProjectKey.js:8-15).
  • Blob зберігається один раз на проєкт: вставку хешу, який у проєкті вже є, пропускають (blob_store/index.js:227-230, 249-252).
  • Порожньому вмісту запис не потрібен; getBlob відповідає на нього без пошуку (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs читається під час запуску (blob_store/index.js:138-148), але жоден код CE у неї не пише, тому в CE кожен blob є blob-ом проєкту.
Останнє оновлення 21 листопада 2026 р.