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

# Koleksi Dropbox Entities

`dropboxEntities` menyimpan satu dokumen per file yang telah disalin sinkronisasi Dropbox antara sebuah proyek dan Dropbox milik satu pengguna, ditambah tombstone berumur pendek. Koleksi ini milik sinkronisasi Dropbox: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) menulis dan membacanya, dan modul web `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) membersihkannya. Tidak ada skema Mongoose.

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Ditetapkan oleh driver saat penyisipan. | `StateManager.mjs:46,97` |
| `overleaf.userId` | ObjectId | Pengguna yang Dropbox-nya berisi file tersebut. Ditetapkan pada setiap dokumen. | `StateManager.mjs:48,98` |
| `overleaf.projectId` | ObjectId | Proyek dari doc atau file. Ditetapkan jika diketahui; tombstone tidak memilikinya. | `StateManager.mjs:49-51` |
| `overleaf.id` | ObjectId | `_id` doc atau file di `rootFolder` proyek. Ditetapkan jika diketahui. | `StateManager.mjs:52` |
| `overleaf.type` | String | `doc` atau `file`. Kode saat ini menulisnya tetapi tidak membacanya. | `StateManager.mjs:53`; nilai dari `services/web/app/src/Features/ThirdPartyDataStore/TpdsUpdateSender.mjs:35,96` dan `UpdateMerger.mjs:104,119` |
| `dropbox.id` | String | `id` file dalam metadata file Dropbox. Tidak ditetapkan pada tombstone. | `StateManager.mjs:56` |
| `dropbox.pathLower` | String | Path file di Dropbox, dalam huruf kecil dan tanpa garis miring di akhir. Diperbarui ketika file atau folder proyeknya dipindahkan. | `StateManager.mjs:14-16,57,91,99` |
| `dropbox.rev` | String | Revisi Dropbox pada sinkronisasi terakhir. Unggahan berikutnya mengirimkannya, sehingga file yang berubah di Dropbox tidak tertimpa. | `StateManager.mjs:58`, `JobProcessor.mjs:114-122` |
| `dropbox.contentHash` | String | Hash konten Dropbox pada sinkronisasi terakhir. File dalam daftar dengan hash yang sama dilewati, karena itu unggahan kita sendiri atau sudah diterapkan. | `StateManager.mjs:59`, `PullManager.mjs:147-149` |
| `tombstone` | Boolean | `true` menandai path yang dihapus atau dipindahkan sendiri oleh third-party-datastore di Dropbox. Ketika Dropbox melaporkan kembali penghapusan itu, penghapusan tersebut tidak diterapkan ke proyek. | `StateManager.mjs:100`, `PullManager.mjs:189-192` |
| `createdAt` | Date | Khusus tombstone: kapan dibuat. Pull yang selesai menghapus tombstone yang dibuat sebelum pull itu dimulai. | `StateManager.mjs:101,115-121` |

Tombstone hanya memiliki `overleaf.userId`, `dropbox.pathLower`, `tombstone`, dan `createdAt` (`StateManager.mjs:96-103`).

#### Siapa yang menulisnya

| Kode | Apa yang dilakukan |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:35-62` (`recordEntity`) | Menghapus dokumen pengguna dengan `dropbox.id`, `dropbox.pathLower`, atau `overleaf.id` yang sama, lalu menyisipkan status baru. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:102-134` (`addEntity`) | Mencatat doc atau file setelah mengunggahnya dari Overleaf ke Dropbox (`:125-133`). |
| `services/third-party-datastore/app/js/PullManager.mjs:142-177` (`applyFile`) | Mencatat file Dropbox setelah web menerapkannya ke proyek (`:168-176`). |
| `StateManager.mjs:80-94` (`moveEntities`) | Menulis ulang `dropbox.pathLower` di bawah path yang dipindahkan: penggantian nama proyek (`JobProcessor.mjs:195`) dan pemindahan file atau folder (`JobProcessor.mjs:239`). |
| `StateManager.mjs:96-103` (`addTombstone`) | Setelah penghapusan (`JobProcessor.mjs:153`), penggantian nama proyek (`:202`), atau pemindahan (`:240`) di Dropbox. |
| `StateManager.mjs:72-78` (`removeEntities`) | Menghapus entri pada dan di bawah sebuah path, kecuali tombstone: setelah penghapusan dari Overleaf (`JobProcessor.mjs:152`) atau di Dropbox (`PullManager.mjs:206`). |
| `StateManager.mjs:115-121` (`clearTombstones`) | Di akhir pull (`PullManager.mjs:31,69`). |
| `StateManager.mjs:186-190` (`removeUserState`), dipanggil dari `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Menghapus semua dokumen pengguna ketika third-party-datastore memutus akun yang tidak bisa lagi digunakannya. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Menghapus semua dokumen pengguna saat menautkan (`:125`), saat memutus tautan (`:183`), dan ketika pengguna yang dihapus kedaluwarsa (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Menghapus dokumen proyek ketika proyek yang dihapus kedaluwarsa (`index.mjs:54-56`). |

#### Siapa yang membacanya

| Kode | Apa yang dilakukan |
| - | - |
| `StateManager.mjs:64-70` (`findEntityByPath`) | Mengambil `dropbox.rev` sebelum unggahan (`JobProcessor.mjs:114`) dan `dropbox.contentHash` sebelum menerapkan file Dropbox (`PullManager.mjs:147`). |
| `StateManager.mjs:106-112` (`findTombstone`) | Memeriksa penghapusan yang dilaporkan pada path atau salah satu path induknya (`PullManager.mjs:189`). |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Mendaftar path file yang tersinkron setelah kursor direset, sehingga file yang tidak ada dalam daftar dianggap terhapus (`PullManager.mjs:74-85`). |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `_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` dan `20220825160708_recreate_dropboxEntities.mjs` hanya bertag `saas`, sehingga CE tidak memiliki indeks unik mereka pada `(overleaf.userId, dropbox.id)` dan `(overleaf.userId, overleaf.id)`, maupun indeks hashed mereka pada `dropbox.pathLower`.

#### Catatan

* Keunikan hanya berasal dari penghapusan sebelum setiap penyisipan di `recordEntity` (`StateManager.mjs:38-45`). Komentar di `StateManager.mjs:3-11` menyebut indeks unik; CE tidak memilikinya.
* Kueri berdasarkan pengguna dan path (`findEntityByPath`, `findTombstone`, `removeEntities`) hanya memakai indeks untuk `overleaf.userId`.


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