Vai al contenuto principale
projectHistoryChunks contiene un documento per ogni chunk di cronologia, una serie di versioni nella cronologia di un progetto. Mongo contiene solo i metadati del chunk; il chunk stesso (uno snapshot più le modifiche successive) è un oggetto JSON compresso con gzip nel bucket dei chunk. Non esiste uno schema Mongoose: history-v1 scrive la collezione in services/history-v1/storage/lib/chunk_store/mongo.js, che usa per ogni id di cronologia di 24 caratteri esadecimali, come in CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Campi

Chi scrive

I nuovi chunk arrivano da project-history, che invia le modifiche in coda a POST /projects/:project_id/legacy_changes di history-v1 (services/history-v1/api/routes/project_import.js:29-31); history-v1 chiama poi chunkStore.update o chunkStore.create (services/history-v1/storage/lib/persist_changes.js:215, 229). Un nuovo progetto riceve il suo primo chunk da chunkStore.initializeProject (chunk_store/index.js:54-80).

Chi legge

Indici

Note

  • Flusso degli stati: pending (record scritto, caricamento in corso) → active (il chunk più recente, può ancora essere esteso) → closed (lo segue un chunk più recente) o deleted (sostituito, o il progetto è stato eliminato). Le letture considerano solo active e closed.
  • L’oggetto del chunk è JSON compresso con gzip (services/history-v1/storage/lib/history_store.js:151-170) alla chiave <project key>/<chunk id> (history_store.js:65-67). 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). Il bucket è OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): /buckets/chunks nell’ambiente di sviluppo (develop/docker-compose.yml:90), oppure overleaf-chunks con S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • I record negli stati deleted o pending, e i loro oggetti nel bucket, vengono rimossi solo da delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). L’immagine CE non ha un cron job per questo (server-ce/config/crontab-history, server-ce/config/crontab-deletion), quindi in CE restano.
  • Quando web fa scadere un progetto eliminato, chiama DELETE /projects/:history_id di history-v1 (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), che contrassegna tutti i chunk del progetto come deleted.
  • Con un backupStore configurato, la conferma di un chunk scrive anche overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt e overleaf.backup.pendingChangeAt nel progetto (mongo.js:232-262). CE non configura backupStore, quindi mongo.js:238-240 ritorna subito.
Ultima modifica il 21 novembre 2026