Langsung ke konten utama
projectHistoryChunks menyimpan satu dokumen per chunk riwayat, yaitu rangkaian versi dalam riwayat satu proyek. Mongo hanya menyimpan metadata chunk; chunk itu sendiri (sebuah snapshot beserta perubahan setelahnya) adalah objek JSON terkompresi gzip di bucket chunks. Tidak ada skema Mongoose: history-v1 menulis koleksi ini di services/history-v1/storage/lib/chunk_store/mongo.js, yang digunakannya untuk setiap id riwayat berupa 24 karakter heksadesimal, seperti di CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Field

Siapa yang menulis

Chunk baru berasal dari project-history, yang mengirim suntingan yang mengantre ke history-v1 POST /projects/:project_id/legacy_changes (services/history-v1/api/routes/project_import.js:29-31); history-v1 lalu memanggil chunkStore.update atau chunkStore.create (services/history-v1/storage/lib/persist_changes.js:215, 229). Proyek baru mendapatkan chunk pertamanya dari chunkStore.initializeProject (chunk_store/index.js:54-80).

Siapa yang membaca

Indeks

Catatan

  • Alur status: pending (catatan ditulis, unggahan berjalan) → active (chunk terbaru, masih bisa diperpanjang) → closed (chunk yang lebih baru menyusul) atau deleted (diganti, atau proyek dihapus). Pembacaan hanya memperhatikan active dan closed.
  • Objek chunk adalah JSON terkompresi gzip (services/history-v1/storage/lib/history_store.js:151-170) di kunci <project key>/<chunk id> (history_store.js:65-67). Kunci proyek adalah id riwayat yang diisi nol, dibalik, dan dipecah menjadi 3/3/sisa karakter (libraries/object-persistor/src/ProjectKey.js:8-15). Bucket-nya adalah OVERLEAF_EDITOR_CHUNKS_BUCKET (services/history-v1/config/custom-environment-variables.json:53-56): /buckets/chunks di lingkungan pengembangan (develop/docker-compose.yml:90), atau overleaf-chunks dengan S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Catatan dalam status deleted atau pending, beserta objek bucket-nya, hanya dihapus oleh delete_old_chunks.js (yarn delete_old_chunks, services/history-v1/package.json:79). Image CE tidak memiliki cron job untuk itu (server-ce/config/crontab-history, server-ce/config/crontab-deletion), sehingga di CE catatan tersebut tetap ada.
  • Ketika web mengedaluwarsakan proyek yang dihapus, ia memanggil history-v1 DELETE /projects/:history_id (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162), yang menandai semua chunk proyek sebagai deleted.
  • Dengan backupStore yang dikonfigurasi, mengonfirmasi chunk juga menulis overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt, dan overleaf.backup.pendingChangeAt ke proyek (mongo.js:232-262). CE tidak mengonfigurasi backupStore, sehingga mongo.js:238-240 kembali lebih awal.
Terakhir diubah pada 21 November 2026