> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Project History Blobs Koleksiyonu

`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

| Alan | Tür | Anlam | Kaynak |
| - | - | - | - |
| `_id` | ObjectId | Projenin geçmiş kimliği, `projects.overleaf.history.id` içindeki değer. | `mongo.js:37-40` |
| `blobs` | Object | Kovalara gruplanmış blob kayıtları. Bir kovanın anahtarı hash'in ilk 3 onaltılık basamağıdır. | `mongo.js:39`, `429-431` |
| `blobs.<abc>` | Array of Object | Hash'i `abc` ile başlayan en fazla 8 kayıt. Bir kovada zaten 8 kayıt varsa sonraki kayıt [Project History Sharded Blobs Koleksiyonu](https://ayakaleaf-pro.mintlify.site/tr/dev/data-model/project-history-sharded-blobs-collection.md) içine gider. | `mongo.js:23`, `375-389` |
| `blobs.<abc>[].h` | Binary | Hash, 20 bayt: git blob SHA-1, `sha1("blob " + byteLength + "\0" + content)` (`libraries/overleaf-editor-core/lib/blob_utils.js:36-43`). Onaltılık biçimi başka yerlerde kullanılan hash'tir, örneğin projelerdeki `fileRefs.hash`. | `mongo.js:472` |
| `blobs.<abc>[].b` | Number | İçeriğin bayt cinsinden uzunluğu. | `mongo.js:473` |
| `blobs.<abc>[].s` | Number | İçeriğin metin olarak uzunluğu; içerik düzenlenebilir metin değilse (ikili veya düzenlemek için çok büyük) `null` (`blob_utils.js:116-130`). | `mongo.js:474` |

#### Kim yazar

| Kod | Ne yapar |
| - | - |
| `services/history-v1/storage/lib/blob_store/mongo.js:34-47` | `initialize`: history-v1 proje geçmişini oluşturduğunda `{ _id, blobs: {} }` ekler (`services/history-v1/storage/lib/chunk_store/index.js:67-68`). |
| `mongo.js:370-390` | `insertBlob`: kovada 8'den az kayıt olduğu sürece kaydı kovasına `$addToSet` ile ekler, aksi halde parçalanmış koleksiyona ekler. Baytlar yüklendikten sonra `putString`, `putBlob` ve `copyBlob` içinden çalışır (`blob_store/index.js:223-237`, `271-278`, `456-467`). |
| `mongo.js:54-105` | `clone`: history-v1 `POST /projects/:project_id/clone` için kovaları başka bir geçmiş kimliğine kopyalar. Web'de bu rotayı çağıran bir şey yoktur (bkz. [Project History Chunks Koleksiyonu](https://ayakaleaf-pro.mintlify.site/tr/dev/data-model/project-history-chunks-collection.md)). |
| `mongo.js:413-422` | `deleteBlobs`: history-v1 `DELETE /projects/:project_id` sırasında belgeyi ve projenin parçalanmış belgelerini siler (`services/history-v1/api/controllers/projects.js:361-373`). |

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

| Kod | Ne yapar |
| - | - |
| `mongo.js:113-157` | `findBlob`: hash ile tek bir blob; kova doluysa parçalanmış koleksiyonda arar. Blob rotaları (`projects.js:416-480`) için `BlobStore.getBlob` (`blob_store/index.js:376-387`) tarafından ve bir eklemeden önce zaten var olan blob'ları atlamak için kullanılır (`blob_store/index.js:441-448`). |
| `mongo.js:165-260` | `findBlobs`: bir chunk'ın dosyalarını yüklemek için aynı anda çok sayıda blob. |
| `mongo.js:265-309` | `getProjectBlobs`: bir projenin tüm blob'ları. |
| `mongo.js:316-363` | `getProjectBlobsBatch`: history-v1 `POST /projects/blob-stats` (`projects.js:620`) için birkaç projenin tüm blob'ları. admin-tools modülü sonucu proje boyutu olarak gösterir (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:395-405`). |

#### İ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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.