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