projectHistoryBlobs bevat één document per projectgeschiedenis: de metadata (hash en groottes) van elke blob die history-v1 voor dat project heeft opgeslagen. Een blob is de inhoud van een bestand of een doc op een bepaald moment in de geschiedenis. De bytes zelf zijn objecten in de bucket voor projectblobs. Er is geen Mongoose-schema: history-v1 schrijft de collectie in services/history-v1/storage/lib/blob_store/mongo.js, dat het gebruikt voor geschiedenis-id’s van 24 hexadecimale tekens, zoals in CE (services/history-v1/storage/lib/blob_store/index.js:108-116).
Velden
Wie schrijft
Waar nieuwe blobs vandaan komen:
- Bestandsuploads: web stuurt het bestand naar 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). - Projectkopieën: web vraagt history-v1 de blob van elk bestand te kopiëren met
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). - Doctekst: wanneer history-v1 een chunk schrijft, slaat het de tekst van elke doc en de opmerkingen en bijgehouden wijzigingen ervan als JSON op als blobs (
chunk_store/index.js:402-405,libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).
Wie leest
Indexen
Alleen de standaardindex op_id. Geen migratie in tools/migrations/ voegt er een toe.
Opmerkingen
- De bytes van een blob staan onder de sleutel
<project key>/<hash[0:2]>/<hash[2:]>(blob_store/index.js:51-53) in de bucketOVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET(services/history-v1/config/custom-environment-variables.json:49-52). De projectsleutel is het met nullen aangevulde geschiedenis-id, omgekeerd en opgesplitst in 3/3/rest tekens (libraries/object-persistor/src/ProjectKey.js:8-15). - Een blob wordt één keer per project opgeslagen: het invoegen van een hash die het project al heeft, wordt overgeslagen (
blob_store/index.js:227-230,249-252). - De lege inhoud heeft geen record nodig;
getBlobbeantwoordt die zonder opzoeking (blob_store/index.js:378-380). projectHistoryGlobalBlobswordt bij het opstarten gelezen (blob_store/index.js:138-148), maar geen CE-code schrijft erin, dus in CE is elke blob een projectblob.

