Przejdź do głównej treści
projectHistoryBlobs zawiera jeden dokument na historię projektu: metadane (hash i rozmiary) każdego blobu, który history-v1 zapisał dla tego projektu. Blob to zawartość pliku lub doc w pewnym punkcie jego historii. Same bajty są obiektami w buckecie blobów projektu. Nie ma schematu Mongoose: history-v1 zapisuje kolekcję w services/history-v1/storage/lib/blob_store/mongo.js, którego używa dla id historii o długości 24 znaków szesnastkowych, jak w CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Pola

Kto zapisuje

Skąd biorą się nowe bloby:
  • Przesyłanie plików: web wysyła plik do PUT /projects/:project_id/blobs/:hash w history-v1 (services/web/app/src/Features/History/HistoryManager.mjs:164-169, services/history-v1/api/controllers/projects.js:376-402).
  • Kopie projektów: web prosi history-v1 o skopiowanie blobu każdego pliku przez 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).
  • Tekst docs: gdy history-v1 zapisuje chunk, zapisuje jako bloby tekst każdego doc oraz jego komentarze i śledzone zmiany w formacie JSON (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Kto odczytuje

Indeksy

Tylko domyślny indeks _id. Żadna migracja w tools/migrations/ nie dodaje innego.

Uwagi

  • Bajty blobu znajdują się pod kluczem <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) w buckecie OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). Klucz projektu to id historii dopełnione zerami, odwrócone i podzielone na 3/3/resztę znaków (libraries/object-persistor/src/ProjectKey.js:8-15).
  • Blob jest zapisywany raz na projekt: wstawienie hasha, który projekt już ma, jest pomijane (blob_store/index.js:227-230, 249-252).
  • Pusta zawartość nie wymaga rekordu; getBlob odpowiada na nią bez wyszukiwania (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs jest odczytywana przy starcie (blob_store/index.js:138-148), ale żaden kod CE do niej nie pisze, więc w CE każdy blob jest blobem projektu.
Ostatnia modyfikacja 21 listopada 2026