projectHistoryBlobs contiene un documento per ogni cronologia di progetto: i metadati (hash e dimensioni) di ogni blob che history-v1 ha salvato per quel progetto. Un blob è il contenuto di un file o di un doc in un certo punto della sua cronologia. I byte veri e propri sono oggetti nel bucket dei blob di progetto. Non esiste uno schema Mongoose: history-v1 scrive la collezione in services/history-v1/storage/lib/blob_store/mongo.js, che usa per gli id di cronologia di 24 caratteri esadecimali, come in CE (services/history-v1/storage/lib/blob_store/index.js:108-116).
Campi
Chi scrive
Da dove arrivano i nuovi blob:
- Caricamenti di file: web invia il file a
PUT /projects/:project_id/blobs/:hashdi history-v1 (services/web/app/src/Features/History/HistoryManager.mjs:164-169,services/history-v1/api/controllers/projects.js:376-402). - Copie di progetti: web chiede a history-v1 di copiare il blob di ogni file con
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). - Testo dei doc: quando history-v1 scrive un chunk, salva come blob il testo di ogni doc e i suoi commenti e le modifiche tracciate in JSON (
chunk_store/index.js:402-405,libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).
Chi legge
Indici
Solo l’indice predefinito su_id. Nessuna migrazione in tools/migrations/ ne aggiunge uno.
Note
- I byte di un blob si trovano alla chiave
<project key>/<hash[0:2]>/<hash[2:]>(blob_store/index.js:51-53) nel bucketOVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET(services/history-v1/config/custom-environment-variables.json:49-52). La chiave del progetto è l’id di cronologia riempito con zeri, invertito e diviso in 3/3/resto caratteri (libraries/object-persistor/src/ProjectKey.js:8-15). - Un blob viene salvato una volta per progetto: l’inserimento di un hash che il progetto ha già viene saltato (
blob_store/index.js:227-230,249-252). - Il contenuto vuoto non ha bisogno di un record;
getBloblo restituisce senza ricerca (blob_store/index.js:378-380). projectHistoryGlobalBlobsviene letta all’avvio (blob_store/index.js:138-148), ma nessun codice CE la scrive, quindi in CE ogni blob è un blob di progetto.

