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

`dropboxProjects` memetakan sebuah proyek ke foldernya di Dropbox milik satu pengguna. Proyek yang dibagikan dengan beberapa pengguna Dropbox memiliki satu dokumen per pengguna. Koleksi ini milik sinkronisasi Dropbox: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) menulisnya, dan modul web `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) membaca serta membersihkannya. Tidak ada skema Mongoose.

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Ditetapkan oleh driver saat penyisipan. | `StateManager.mjs:144` |
| `userId` | ObjectId | Pengguna Overleaf yang Dropbox-nya berisi folder tersebut. | `StateManager.mjs:145` |
| `projectId` | ObjectId | Proyek yang disinkronkan ke folder tersebut. | `StateManager.mjs:146` |
| `dropboxId` | String | `id` folder dalam metadata folder Dropbox. | `StateManager.mjs:147`, `JobProcessor.mjs:82-87`, `PullManager.mjs:138` |
| `pathLower` | String | Path folder di Dropbox, dalam huruf kecil dan tanpa garis miring di akhir. Folder proyek berada di tingkat teratas, satu per proyek, misalnya `/thesis (1)` ketika Dropbox menomorinya di samping `Thesis` milik proyek lain. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Siapa yang menulisnya

| Kode | Apa yang dilakukan |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Menghapus dokumen pengguna dengan `projectId`, `dropboxId`, atau `pathLower` yang sama, lalu menyisipkan pemetaan baru. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Membuat folder di Dropbox dan mencatatnya ketika web meminta folder proyek baru atau proyek tempat pengguna ditambahkan (`createProject`, `:245-251`), atau mengirim file dari proyek yang belum punya folder (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | Setelah penggantian nama proyek memindahkan folder, mencatat path baru, atau menghapus pemetaan ketika folder sudah tidak ada (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | Ketika pull menemukan folder tanpa pemetaan, mencatat proyek yang dicocokkan web berdasarkan nama. |
| `PullManager.mjs:188-207` (`applyDeletion`) | Ketika folder proyek dihapus di Dropbox, menghapus pemetaan (`StateManager.mjs:152-157`). |
| `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:130-135` (`getFolderOfProject`) | Menemukan folder sebuah proyek: `JobProcessor.mjs:59,98,176` dan `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Menemukan proyek sebuah folder: `JobProcessor.mjs:65` (nama sudah dipakai), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Mendaftar path folder setelah kursor direset, sehingga folder yang tidak ada dalam daftar dianggap terhapus (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Memberikan nama folder yang ditampilkan di dialog Dropbox pada editor (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

CE tidak memiliki indeks lain di sini. Indeks unik `projectId_userId_1` dan `userId_dropboxId_1` berasal dari `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` dan `20220817120900_create_dropboxProjects_index.mjs`, yang hanya bertag `saas`, sehingga CE tidak pernah menjalankannya.

#### Catatan

* Keunikan hanya berasal dari penghapusan sebelum setiap penyisipan di `setProjectFolder` (`StateManager.mjs:140-149`). Komentar di `StateManager.mjs:3-11` menyebut indeks unik; CE tidak memilikinya.
* Ketika pemetaan proyek dihapus, foldernya tetap ada di Dropbox. Suntingan di sana kemudian dibaca sebagai proyek baru, sama seperti folder yang dibuat di Dropbox (`DropboxHandler.mjs:148-149`).
* Proyek yang dihapus mempertahankan pemetaannya sampai kedaluwarsa, karena masih bisa dipulihkan (`index.mjs:52-53`).
* Kursor Dropbox `list_folder` milik pengguna tidak ada di sini. Kursor itu ada di `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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