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

`dropboxProjects` зіставляє проєкт із його папкою в Dropbox одного користувача. Проєкт, до якого мають доступ кілька користувачів Dropbox, має по одному документу на користувача. Колекція належить до синхронізації з Dropbox: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) записує її, а вебмодуль `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) читає та очищує її. Схеми Mongoose немає.

#### Поля

| Поле | Тип | Значення | Джерело |
| - | - | - | - |
| `_id` | ObjectId | Встановлюється драйвером під час вставлення. | `StateManager.mjs:144` |
| `userId` | ObjectId | Користувач Overleaf, у чиєму Dropbox є папка. | `StateManager.mjs:145` |
| `projectId` | ObjectId | Проєкт, що синхронізується в папку. | `StateManager.mjs:146` |
| `dropboxId` | String | `id` папки в метаданих папки Dropbox. | `StateManager.mjs:147`, `JobProcessor.mjs:82-87`, `PullManager.mjs:138` |
| `pathLower` | String | Шлях до папки в Dropbox у нижньому регістрі й без кінцевої скісної риски. Папки проєктів розташовані на верхньому рівні, по одній на проєкт, наприклад `/thesis (1)`, коли Dropbox пронумерував її поруч із `Thesis` іншого проєкту. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Хто записує

| Код | Що робить |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Видаляє документи користувача з тим самим `projectId`, `dropboxId` або `pathLower`, потім вставляє нове зіставлення. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Створює папку в Dropbox і записує її, коли web запитує папку нового проєкту або проєкту, до якого додали користувача (`createProject`, `:245-251`), або надсилає файл проєкту, що ще не має папки (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | Після того як перейменування проєкту перемістило папку, записує новий шлях або видаляє зіставлення, якщо папки більше немає (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | Коли pull знаходить папку без зіставлення, записує проєкт, який web знайшов за назвою. |
| `PullManager.mjs:188-207` (`applyDeletion`) | Коли папку проєкту видалено в Dropbox, видаляє зіставлення (`StateManager.mjs:152-157`). |
| `StateManager.mjs:186-190` (`removeUserState`), викликається з `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Видаляє всі документи користувача, коли third-party-datastore від'єднує обліковий запис, який більше не може використовувати. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Видаляє всі документи користувача під час під'єднання (`:125`), від'єднання (`:183`) і коли спливає термін видаленого користувача (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Видаляє документи проєкту, коли спливає термін видаленого проєкту (`index.mjs:54-56`). |

#### Хто читає

| Код | Що робить |
| - | - |
| `StateManager.mjs:130-135` (`getFolderOfProject`) | Знаходить папку проєкту: `JobProcessor.mjs:59,98,176` і `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Знаходить проєкт папки: `JobProcessor.mjs:65` (назва вже зайнята), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Перелічує шляхи папок після скидання курсора, щоб папка, відсутня в переліку, вважалася видаленою (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Повертає назву папки, що показується в діалозі Dropbox у редакторі (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Індекси

| Назва | Ключі | Параметри | Міграція |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

Інших індексів тут у CE немає. Унікальні індекси `projectId_userId_1` і `userId_dropboxId_1` створюють міграції `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` і `20220817120900_create_dropboxProjects_index.mjs`, що мають лише тег `saas`, тож CE їх ніколи не запускає.

#### Примітки

* Унікальність забезпечується лише видаленням перед кожним вставленням у `setProjectFolder` (`StateManager.mjs:140-149`). Коментар у `StateManager.mjs:3-11` згадує унікальні індекси; у CE їх немає.
* Коли зіставлення проєкту видалено, його папка залишається в Dropbox. Редагування там тоді читається як новий проєкт, так само як для папки, створеної в Dropbox (`DropboxHandler.mjs:148-149`).
* Видалений проєкт зберігає зіставлення до закінчення терміну, бо його ще можна відновити (`index.mjs:52-53`).
* Курсора Dropbox `list_folder` користувача тут немає. Він міститься в `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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