projectHistoryBlobs indeholder ét dokument pr. projekthistorik: metadataene (hash og størrelser) for hver blob, som history-v1 har gemt for projektet. En blob er indholdet af en fil eller et doc på et tidspunkt i historikken. Selve bytene er objekter i bucketen til projektblobs. Der er intet Mongoose-skema: history-v1 skriver samlingen i services/history-v1/storage/lib/blob_store/mongo.js, som den bruger til historik-id’er på 24 hexadecimale tegn, som i CE (services/history-v1/storage/lib/blob_store/index.js:108-116).
Felter
Hvem skriver
Hvor nye blobs kommer fra:
- Filuploads: web sender filen til history-v1
PUT /projects/:project_id/blobs/:hash(services/web/app/src/Features/History/HistoryManager.mjs:164-169,services/history-v1/api/controllers/projects.js:376-402). - Projektkopier: web beder history-v1 om at kopiere hver fils blob med
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). - Doc-tekst: når history-v1 skriver en chunk, gemmer den teksten i hvert doc og dets kommentarer og sporede ændringer som JSON, som blobs (
chunk_store/index.js:402-405,libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).
Hvem læser
Indekser
Kun standardindekset på_id. Ingen migrering i tools/migrations/ tilføjer andre.
Bemærkninger
- Bytene i en blob ligger under nøglen
<project key>/<hash[0:2]>/<hash[2:]>(blob_store/index.js:51-53) i bucketenOVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET(services/history-v1/config/custom-environment-variables.json:49-52). Projektnøglen er historik-id’et udfyldt med nuller, vendt om og delt op i 3/3/resten af tegnene (libraries/object-persistor/src/ProjectKey.js:8-15). - En blob gemmes én gang pr. projekt: indsættelse af en hash, som projektet allerede har, springes over (
blob_store/index.js:227-230,249-252). - Tomt indhold kræver ingen post;
getBlobbesvarer det uden opslag (blob_store/index.js:378-380). projectHistoryGlobalBlobslæses ved opstart (blob_store/index.js:138-148), men ingen CE-kode skriver den, så i CE er hver blob en projektblob.

