Ana içeriğe atla
projectHistoryChunks, her geçmiş chunk’ı için bir belge tutar; chunk, bir projenin geçmişindeki bir dizi sürümdür. Mongo yalnızca chunk’ın meta verilerini tutar; chunk’ın kendisi (bir anlık görüntü ve ondan sonraki değişiklikler) chunks bucket’ında gzip ile sıkıştırılmış bir JSON nesnesidir. Mongoose şeması yoktur: history-v1 koleksiyonu services/history-v1/storage/lib/chunk_store/mongo.js içinde yazar ve CE’de olduğu gibi 24 onaltılık karakterli her geçmiş kimliği için bunu kullanır (services/history-v1/storage/lib/chunk_store/index.js:644-652).

Alanlar

Kim yazar

Yeni chunk’lar project-history’den gelir; project-history kuyruktaki düzenlemeleri history-v1 POST /projects/:project_id/legacy_changes adresine gönderir (services/history-v1/api/routes/project_import.js:29-31); history-v1 ardından chunkStore.update veya chunkStore.create çağırır (services/history-v1/storage/lib/persist_changes.js:215, 229). Yeni bir proje ilk chunk’ını chunkStore.initializeProject üzerinden alır (chunk_store/index.js:54-80).

Kim okur

İndeksler

Notlar

  • Durum akışı: pending (kayıt yazıldı, yükleme sürüyor) → active (en son chunk, hâlâ genişletilebilir) → closed (ardından daha yeni bir chunk geliyor) veya deleted (yerine başkası geçti ya da proje silindi). Okumalar yalnızca active ve closed durumlarına bakar.
  • Chunk nesnesi gzip ile sıkıştırılmış JSON’dur (services/history-v1/storage/lib/history_store.js:151-170) ve <project key>/<chunk id> anahtarındadır (history_store.js:65-67). Proje anahtarı, sıfırlarla doldurulmuş geçmiş kimliğinin ters çevrilip 3/3/kalan karakter olarak bölünmüş halidir (libraries/object-persistor/src/ProjectKey.js:8-15). Bucket OVERLEAF_EDITOR_CHUNKS_BUCKET değeridir (services/history-v1/config/custom-environment-variables.json:53-56): geliştirme ortamında /buckets/chunks (develop/docker-compose.yml:90), S3_ENABLED=true ile overleaf-chunks (develop/s3/docker-compose.yml:51).
  • deleted veya pending durumundaki kayıtlar ve bucket nesneleri yalnızca delete_old_chunks.js tarafından kaldırılır (yarn delete_old_chunks, services/history-v1/package.json:79). CE imajında bunun için bir cron işi yoktur (server-ce/config/crontab-history, server-ce/config/crontab-deletion), bu nedenle CE’de kalırlar.
  • Web silinmiş bir projenin süresini doldurduğunda history-v1 DELETE /projects/:history_id çağırır (services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162); bu, projenin tüm chunk’larını deleted olarak işaretler.
  • Bir backupStore yapılandırılmışsa, bir chunk’ı onaylamak projeye ayrıca overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt ve overleaf.backup.pendingChangeAt yazar (mongo.js:232-262). CE backupStore yapılandırmaz, bu yüzden mongo.js:238-240 erken döner.
Son değiştirilme tarihi 21 Kasım 2026