> ## 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 Chunks Koleksiyonu

`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

| Alan | Tür | Anlam | Kaynak |
| - | - | - | - |
| `_id` | ObjectId | Chunk kimliği. Bucket'taki chunk nesnesinin adını da verir (bkz. Notlar). | `mongo.js:183-185` |
| `projectId` | ObjectId | Projenin geçmiş kimliği, `projects.overleaf.history.id` içindeki değer. CE'de web geçmişi projenin kendi `_id` değeriyle oluşturur (`services/web/app/src/Features/History/HistoryManager.mjs:51-55`). | `mongo.js:186` |
| `startVersion` | Number | Chunk'taki ilk değişiklikten önceki proje sürümü. | `mongo.js:187` |
| `endVersion` | Number | Chunk'taki son değişiklikten sonraki proje sürümü. | `mongo.js:188` |
| `endTimestamp` | Date | Chunk'taki son değişikliğin zamanı; chunk'ta değişiklik yoksa `null`, örneğin yeni bir projenin ilk chunk'ında (`libraries/overleaf-editor-core/lib/chunk.js:146-149`). | `mongo.js:189` |
| `state` | String | `pending`, `active`, `closed` veya `deleted`, bkz. Notlar. | `mongo.js:190`, `343`, `378`, `409` |
| `updatedAt` | Date | Ekleme, etkinleştirme ve silme sırasında ayarlanır. Bir chunk'ı kapatmak onu değiştirmez. | `mongo.js:191`, `343`, `409`, `434`, `450` |

#### Kim yazar

| Kod | Ne yapar |
| - | - |
| `services/history-v1/storage/lib/chunk_store/mongo.js:179-194` | `insertPendingChunk`: chunk nesnesi yüklenmeden önce bir `pending` kaydı ekler (`chunk_store/index.js:394-410`). |
| `mongo.js:331-359` | `activateChunk`: yükleme bittiğinde `pending` durumundan `active` durumuna geçirir. Burada yinelenen anahtar, o sürümde başlayan başka bir chunk'ın zaten olduğu anlamına gelir. |
| `mongo.js:371-388` | `closeChunk`: ardından yeni bir chunk geldiğinde `active` durumundan `closed` durumuna geçirir (`confirmCreate`, `mongo.js:206-227`). |
| `mongo.js:402-419` | `deleteActiveChunk`: aynı başlangıç sürümüne sahip daha uzun bir chunk onun yerini aldığında `active` durumundan `deleted` durumuna geçirir (`confirmUpdate`, `mongo.js:295-321`). |
| `mongo.js:428-452` | `deleteChunk` ve `deleteProjectChunks`: chunk'ları `deleted` olarak işaretler. İkincisi history-v1 `DELETE /projects/:project_id` sırasında çalışır (`services/history-v1/api/controllers/projects.js:361-373`). |
| `mongo.js:144-174` | `clone`: history-v1 `POST /projects/:project_id/clone` için bir projenin kayıtlarını yeni bir geçmiş kimliği altına kopyalar. Web'in bu rota için bir istemcisi vardır (`HistoryManager.mjs:63-72`), ancak web'de onu çağıran bir şey yoktur. |
| `mongo.js:497-502` | `deleteOldChunks`: eski `deleted` ve `pending` kayıtlarını kaldırır. Yalnızca `services/history-v1/storage/tasks/delete_old_chunks.js` tarafından çalıştırılır. |

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

| Kod | Ne yapar |
| - | - |
| `mongo.js:23-43` | `getLatestChunk`: bir projenin en yeni `active` veya `closed` chunk'ı. |
| `mongo.js:54-71` | `getChunkForVersion`: bir sürümü içeren chunk. |
| `mongo.js:77-103` | `getChunkForTimestamp`: belirli bir zamanda geçerli olan chunk. |
| `mongo.js:108-137` | `getProjectChunkIds` ve `getProjectChunks`: bir projenin tüm geçerli chunk'ları. |
| `mongo.js:457-492` | `getOldChunksBatch`: temizleme görevi için eski `deleted` ve `pending` kayıtları. |
| `services/history-v1/api/controllers/projects.js:115-265` | history-v1 okuma rotaları (en son içerik, bir sürümdeki içerik, geçmiş, değişiklikler); chunk'ları `chunk_store/index.js` üzerinden yükler. |

#### İndeksler

| Ad | Anahtarlar | Seçenekler | Migration |
| - | - | - | - |
| `projectId_1_startVersion_1_v2` | `{ projectId: 1, startVersion: 1 }` | unique, kısmi: `state` değeri `active`, `closed` | `tools/migrations/20250411200550_active_chunk_index_update.mjs` (`20221122191857_project_history_chunks_indexes.mjs` içindeki `projectId_1_startVersion_1` indeksinin yerini alır) |
| `deleted_updated_at` | `{ updatedAt: 1 }` | kısmi: `state: 'deleted'` | `tools/migrations/20230428154643_history_chunks_garbage_collection_index.mjs` (`state_1` indeksinin yerini alır) |
| `pending_updated_at` | `{ updatedAt: -1 }` | kısmi: `state: 'pending'` | `tools/migrations/20230428154643_history_chunks_garbage_collection_index.mjs` (`20230217205311_fix_deleted_history_chunks_index.mjs` içindeki `state_pending` indeksinin yerini alır) |

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


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