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/:hashhistory-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-ом проекта.

