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

# Dropbox Entities Koleksiyonu

`dropboxEntities`, Dropbox senkronizasyonunun bir proje ile bir kullanıcının Dropbox'ı arasında kopyaladığı her dosya için bir belge ve kısa ömürlü tombstone kayıtları tutar. Koleksiyon Dropbox senkronizasyonuna aittir: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) onu yazar ve okur, `dropbox` web modülü (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) onu temizler. Mongoose şeması yoktur.

#### Alanlar

| Alan | Tür | Anlam | Kaynak |
| - | - | - | - |
| `_id` | ObjectId | Ekleme sırasında sürücü tarafından ayarlanır. | `StateManager.mjs:46,97` |
| `overleaf.userId` | ObjectId | Dosyanın Dropbox'ında bulunduğu kullanıcı. Her belgede ayarlanır. | `StateManager.mjs:48,98` |
| `overleaf.projectId` | ObjectId | Doc'un veya dosyanın projesi. Bilindiğinde ayarlanır; tombstone kayıtlarında yoktur. | `StateManager.mjs:49-51` |
| `overleaf.id` | ObjectId | Doc'un veya dosyanın projenin `rootFolder` içindeki `_id` değeri. Bilindiğinde ayarlanır. | `StateManager.mjs:52` |
| `overleaf.type` | String | `doc` veya `file`. Mevcut kod bunu yazar ama okumaz. | `StateManager.mjs:53`; değerler `services/web/app/src/Features/ThirdPartyDataStore/TpdsUpdateSender.mjs:35,96` ve `UpdateMerger.mjs:104,119` kaynaklarından |
| `dropbox.id` | String | Dropbox dosya meta verilerindeki dosyanın `id` değeri. Tombstone kayıtlarında ayarlanmaz. | `StateManager.mjs:56` |
| `dropbox.pathLower` | String | Dosyanın Dropbox'taki yolu; küçük harfli ve sonunda eğik çizgi olmadan. Dosya veya proje klasörü taşındığında güncellenir. | `StateManager.mjs:14-16,57,91,99` |
| `dropbox.rev` | String | Son senkronizasyondaki Dropbox revizyonu. Sonraki yükleme onu gönderir; böylece Dropbox'ta değişmiş bir dosyanın üzerine yazılmaz. | `StateManager.mjs:58`, `JobProcessor.mjs:114-122` |
| `dropbox.contentHash` | String | Son senkronizasyondaki Dropbox içerik karması. Aynı karmaya sahip listelenen bir dosya atlanır, çünkü kendi yüklememizdir veya zaten uygulanmıştır. | `StateManager.mjs:59`, `PullManager.mjs:147-149` |
| `tombstone` | Boolean | `true`, third-party-datastore'un Dropbox'ta kendisinin sildiği veya başka yere taşıdığı bir yolu işaretler. Dropbox bu silmeyi geri bildirdiğinde projeye uygulanmaz. | `StateManager.mjs:100`, `PullManager.mjs:189-192` |
| `createdAt` | Date | Yalnızca tombstone kayıtları: ne zaman oluşturulduğu. Tamamlanan bir pull, başlamadan önce oluşturulan tombstone kayıtlarını kaldırır. | `StateManager.mjs:101,115-121` |

Bir tombstone kaydında yalnızca `overleaf.userId`, `dropbox.pathLower`, `tombstone` ve `createdAt` bulunur (`StateManager.mjs:96-103`).

#### Kim yazar

| Kod | Ne yapar |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:35-62` (`recordEntity`) | Kullanıcının aynı `dropbox.id`, `dropbox.pathLower` veya `overleaf.id` değerine sahip belgelerini siler, ardından yeni durumu ekler. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:102-134` (`addEntity`) | Bir doc'u veya dosyayı Overleaf'ten Dropbox'a yükledikten sonra kaydeder (`:125-133`). |
| `services/third-party-datastore/app/js/PullManager.mjs:142-177` (`applyFile`) | Web bir Dropbox dosyasını projeye uyguladıktan sonra onu kaydeder (`:168-176`). |
| `StateManager.mjs:80-94` (`moveEntities`) | Taşınan bir yolun altındaki `dropbox.pathLower` değerlerini yeniden yazar: proje yeniden adlandırma (`JobProcessor.mjs:195`) ve dosya veya klasör taşıma (`JobProcessor.mjs:239`). |
| `StateManager.mjs:96-103` (`addTombstone`) | Dropbox'ta bir silme (`JobProcessor.mjs:153`), proje yeniden adlandırma (`:202`) veya taşıma (`:240`) sonrasında. |
| `StateManager.mjs:72-78` (`removeEntities`) | Tombstone kayıtları dışında bir yoldaki ve altındaki girdileri siler: Overleaf'ten (`JobProcessor.mjs:152`) veya Dropbox'ta (`PullManager.mjs:206`) yapılan bir silmeden sonra. |
| `StateManager.mjs:115-121` (`clearTombstones`) | Bir pull'un sonunda (`PullManager.mjs:31,69`). |
| `StateManager.mjs:186-190` (`removeUserState`), `services/third-party-datastore/app/js/QueueWorker.mjs:43` tarafından çağrılır | third-party-datastore artık kullanamadığı bir hesabın bağlantısını kaldırdığında kullanıcının tüm belgelerini siler. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Bağlanırken (`:125`), bağlantı kaldırılırken (`:183`) ve silinmiş bir kullanıcının süresi dolduğunda (`services/web/modules/dropbox/index.mjs:62-64`) kullanıcının tüm belgelerini siler. |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Silinmiş bir projenin süresi dolduğunda projenin belgelerini siler (`index.mjs:54-56`). |

#### Kim okur

| Kod | Ne yapar |
| - | - |
| `StateManager.mjs:64-70` (`findEntityByPath`) | Yüklemeden önce `dropbox.rev` (`JobProcessor.mjs:114`) ve bir Dropbox dosyasını uygulamadan önce `dropbox.contentHash` (`PullManager.mjs:147`) değerini alır. |
| `StateManager.mjs:106-112` (`findTombstone`) | Bildirilen bir silmeyi yolda veya üst yollarından birinde denetler (`PullManager.mjs:189`). |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | İmleç sıfırlandıktan sonra senkronize dosya yollarını listeler; böylece listede olmayan bir dosya silinmiş sayılır (`PullManager.mjs:74-85`). |

#### Dizinler

| Ad | Anahtarlar | Seçenekler | Taşıma |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |
| `overleaf_userId_1_overleaf_projectId_1` | `overleaf.userId: 1, overleaf.projectId: 1` | | `tools/migrations/20250130104049_create_dropboxEntities_userId_projectId_index.mjs` |

`20220811111800_create_dropboxEntities_index.mjs` ve `20220825160708_recreate_dropboxEntities.mjs` yalnızca `saas` etiketlidir; bu nedenle CE'de onların `(overleaf.userId, dropbox.id)` ve `(overleaf.userId, overleaf.id)` üzerindeki benzersiz dizinleri ve `dropbox.pathLower` üzerindeki karma dizini yoktur.

#### Notlar

* Benzersizlik yalnızca `recordEntity` içinde her eklemeden önce yapılan silmeden gelir (`StateManager.mjs:38-45`). `StateManager.mjs:3-11` içindeki yorum benzersiz dizinlerden bahseder; CE'de bunlar yoktur.
* Kullanıcıya ve yola göre sorgular (`findEntityByPath`, `findTombstone`, `removeEntities`) dizini yalnızca `overleaf.userId` için kullanır.


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