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/:hashw 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 buckecieOVERLEAF_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;
getBlobodpowiada na nią bez wyszukiwania (blob_store/index.js:378-380). projectHistoryGlobalBlobsjest 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.

