Langsung ke konten utama
projectHistoryBlobs menyimpan satu dokumen per riwayat proyek: metadata (hash dan ukuran) setiap blob yang disimpan history-v1 untuk proyek tersebut. Blob adalah isi sebuah file atau doc pada suatu titik dalam riwayatnya. Byte-nya sendiri adalah objek di bucket blob proyek. Tidak ada skema Mongoose: history-v1 menulis koleksi ini di services/history-v1/storage/lib/blob_store/mongo.js, yang digunakannya untuk id riwayat berupa 24 karakter heksadesimal, seperti di CE (services/history-v1/storage/lib/blob_store/index.js:108-116).

Field

Siapa yang menulis

Asal blob baru:
  • Unggahan file: web mengirim file ke 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).
  • Salinan proyek: web meminta history-v1 menyalin blob setiap file dengan 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).
  • Teks doc: ketika history-v1 menulis sebuah chunk, ia menyimpan teks setiap doc, serta komentar dan perubahan terlacaknya dalam bentuk JSON, sebagai blob (chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

Siapa yang membaca

Indeks

Hanya indeks bawaan _id. Tidak ada migrasi di tools/migrations/ yang menambahkan indeks lain.

Catatan

  • Byte sebuah blob berada di kunci <project key>/<hash[0:2]>/<hash[2:]> (blob_store/index.js:51-53) dalam bucket OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET (services/history-v1/config/custom-environment-variables.json:49-52). Kunci proyek adalah id riwayat yang diisi nol, dibalik, dan dipecah menjadi 3/3/sisa karakter (libraries/object-persistor/src/ProjectKey.js:8-15).
  • Sebuah blob disimpan sekali per proyek: penyisipan hash yang sudah dimiliki proyek akan dilewati (blob_store/index.js:227-230, 249-252).
  • Isi kosong tidak memerlukan catatan; getBlob menjawabnya tanpa pencarian (blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs dibaca saat startup (blob_store/index.js:138-148), tetapi tidak ada kode CE yang menulisnya, sehingga di CE setiap blob adalah blob proyek.
Terakhir diubah pada 21 November 2026