Ana içeriğe atla
projectHistoryBlobs, her proje geçmişi için bir belge tutar: history-v1’in o proje için sakladığı her blob’un meta verileri (hash ve boyutlar). Blob, bir dosyanın veya doc’un geçmişinin bir noktasındaki içeriğidir. Baytların kendisi proje blob’ları bucket’ındaki nesnelerdir. Mongoose şeması yoktur: history-v1 koleksiyonu services/history-v1/storage/lib/blob_store/mongo.js içinde yazar ve CE’de olduğu gibi 24 onaltılık karakterli geçmiş kimlikleri için bunu kullanır (services/history-v1/storage/lib/blob_store/index.js:108-116).

Alanlar

Kim yazar

Yeni blob’ların geldiği yerler:
  • Dosya yüklemeleri: web dosyayı history-v1 PUT /projects/:project_id/blobs/:hash adresine gönderir (services/web/app/src/Features/History/HistoryManager.mjs:164-169, services/history-v1/api/controllers/projects.js:376-402).
  • Proje kopyaları: web, history-v1’den her dosyanın blob’unu POST /projects/:project_id/blobs/:hash?copyFrom= ile kopyalamasını ister (services/web/app/src/Features/Project/ProjectDuplicator.mjs:333-338, HistoryManager.mjs:177-187, projects.js:521-555).
  • Doc metni: history-v1 bir chunk yazdığında, her doc’un metnini ve yorumlarıyla izlenen değişikliklerini JSON olarak blob şeklinde saklar (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Kim okur

İndeksler

Yalnızca varsayılan _id indeksi. tools/migrations/ içindeki hiçbir migration başka indeks eklemez.

Notlar

  • Bir blob’un baytları OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET bucket’ında (services/history-v1/config/custom-environment-variables.json:49-52) <project key>/<hash[0:2]>/<hash[2:]> anahtarında (blob_store/index.js:51-53) bulunur. 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).
  • Bir blob proje başına bir kez saklanır: projenin zaten sahip olduğu bir hash’in eklenmesi atlanır (blob_store/index.js:227-230, 249-252).
  • Boş içerik için kayıt gerekmez; getBlob bunu arama yapmadan yanıtlar (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs başlangıçta okunur (blob_store/index.js:138-148), ancak hiçbir CE kodu ona yazmaz; bu nedenle CE’de her blob bir proje blob’udur.
Son değiştirilme tarihi 21 Kasım 2026