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

`dropboxEntities` зберігає по одному документу на кожен файл, який синхронізація з Dropbox скопіювала між проєктом і Dropbox одного користувача, а також короткочасні tombstone-записи. Колекція належить до синхронізації з 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:46,97` |
| `overleaf.userId` | ObjectId | Користувач, у чиєму Dropbox є файл. Встановлюється в кожному документі. | `StateManager.mjs:48,98` |
| `overleaf.projectId` | ObjectId | Проєкт doc або файлу. Встановлюється, коли відомий; tombstone його не мають. | `StateManager.mjs:49-51` |
| `overleaf.id` | ObjectId | `_id` doc або файлу в `rootFolder` проєкту. Встановлюється, коли відомий. | `StateManager.mjs:52` |
| `overleaf.type` | String | `doc` або `file`. Поточний код записує його, але не читає. | `StateManager.mjs:53`; значення з `services/web/app/src/Features/ThirdPartyDataStore/TpdsUpdateSender.mjs:35,96` і `UpdateMerger.mjs:104,119` |
| `dropbox.id` | String | `id` файлу в метаданих файлу Dropbox. Для tombstone не встановлюється. | `StateManager.mjs:56` |
| `dropbox.pathLower` | String | Шлях до файлу в Dropbox у нижньому регістрі й без кінцевої скісної риски. Оновлюється, коли файл або папку його проєкту переміщено. | `StateManager.mjs:14-16,57,91,99` |
| `dropbox.rev` | String | Ревізія Dropbox під час останньої синхронізації. Наступне завантаження надсилає її, тож файл, змінений у Dropbox, не перезаписується. | `StateManager.mjs:58`, `JobProcessor.mjs:114-122` |
| `dropbox.contentHash` | String | Хеш вмісту Dropbox під час останньої синхронізації. Файл зі списку з тим самим хешем пропускається, бо це наше власне завантаження або його вже застосовано. | `StateManager.mjs:59`, `PullManager.mjs:147-149` |
| `tombstone` | Boolean | `true` позначає шлях, який third-party-datastore сам видалив або перемістив у Dropbox. Коли Dropbox повідомляє про це видалення у відповідь, воно не застосовується до проєкту. | `StateManager.mjs:100`, `PullManager.mjs:189-192` |
| `createdAt` | Date | Лише для tombstone: коли запис створено. Завершений pull видаляє tombstone-записи, створені до його початку. | `StateManager.mjs:101,115-121` |

Tombstone має лише `overleaf.userId`, `dropbox.pathLower`, `tombstone` і `createdAt` (`StateManager.mjs:96-103`).

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

| Код | Що робить |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:35-62` (`recordEntity`) | Видаляє документи користувача з тим самим `dropbox.id`, `dropbox.pathLower` або `overleaf.id`, потім вставляє новий стан. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:102-134` (`addEntity`) | Записує doc або файл після завантаження з Overleaf до Dropbox (`:125-133`). |
| `services/third-party-datastore/app/js/PullManager.mjs:142-177` (`applyFile`) | Записує файл Dropbox після того, як web застосував його до проєкту (`:168-176`). |
| `StateManager.mjs:80-94` (`moveEntities`) | Переписує `dropbox.pathLower` під переміщеним шляхом: перейменування проєкту (`JobProcessor.mjs:195`) і переміщення файлу чи папки (`JobProcessor.mjs:239`). |
| `StateManager.mjs:96-103` (`addTombstone`) | Після видалення (`JobProcessor.mjs:153`), перейменування проєкту (`:202`) або переміщення (`:240`) у Dropbox. |
| `StateManager.mjs:72-78` (`removeEntities`) | Видаляє записи за шляхом і нижче, крім tombstone: після видалення з Overleaf (`JobProcessor.mjs:152`) або в Dropbox (`PullManager.mjs:206`). |
| `StateManager.mjs:115-121` (`clearTombstones`) | Наприкінці pull (`PullManager.mjs:31,69`). |
| `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:64-70` (`findEntityByPath`) | Отримує `dropbox.rev` перед завантаженням (`JobProcessor.mjs:114`) і `dropbox.contentHash` перед застосуванням файлу Dropbox (`PullManager.mjs:147`). |
| `StateManager.mjs:106-112` (`findTombstone`) | Перевіряє повідомлене видалення за шляхом або за одним із батьківських шляхів (`PullManager.mjs:189`). |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Перелічує шляхи синхронізованих файлів після скидання курсора, щоб файл, відсутній у переліку, вважався видаленим (`PullManager.mjs:74-85`). |

#### Індекси

| Назва | Ключі | Параметри | Міграція |
| - | - | - | - |
| `_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` і `20220825160708_recreate_dropboxEntities.mjs` мають лише тег `saas`, тож у CE немає ні їхніх унікальних індексів за `(overleaf.userId, dropbox.id)` і `(overleaf.userId, overleaf.id)`, ні їхнього хешованого індексу за `dropbox.pathLower`.

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

* Унікальність забезпечується лише видаленням перед кожним вставленням у `recordEntity` (`StateManager.mjs:38-45`). Коментар у `StateManager.mjs:3-11` згадує унікальні індекси; у CE їх немає.
* Запити за користувачем і шляхом (`findEntityByPath`, `findTombstone`, `removeEntities`) використовують індекс лише для `overleaf.userId`.


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