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

# Kolekcja Dropbox Projects

`dropboxProjects` przypisuje projekt do jego folderu w Dropboxie jednego użytkownika. Projekt udostępniony kilku użytkownikom Dropboxa ma po jednym dokumencie na użytkownika. Kolekcja należy do synchronizacji z Dropboxem: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) ją zapisuje, a moduł web `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) ją odczytuje i czyści. Nie ma schematu Mongoose.

#### Pola

| Pole | Typ | Znaczenie | Źródło |
| - | - | - | - |
| `_id` | ObjectId | Ustawiane przez sterownik przy wstawianiu. | `StateManager.mjs:144` |
| `userId` | ObjectId | Użytkownik Overleaf, w którego Dropboxie jest folder. | `StateManager.mjs:145` |
| `projectId` | ObjectId | Projekt synchronizowany do folderu. | `StateManager.mjs:146` |
| `dropboxId` | String | `id` folderu w metadanych folderu Dropbox. | `StateManager.mjs:147`, `JobProcessor.mjs:82-87`, `PullManager.mjs:138` |
| `pathLower` | String | Ścieżka folderu w Dropboxie, małymi literami i bez końcowego ukośnika. Foldery projektów są na najwyższym poziomie, po jednym na projekt, na przykład `/thesis (1)`, gdy Dropbox ponumerował go obok `Thesis` innego projektu. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Kto ją zapisuje

| Kod | Co robi |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Usuwa dokumenty użytkownika z tym samym `projectId`, `dropboxId` lub `pathLower`, a następnie wstawia nowe przypisanie. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Tworzy folder w Dropboxie i zapisuje go, gdy web prosi o folder nowego projektu lub projektu, do którego dodano użytkownika (`createProject`, `:245-251`), albo wysyła plik projektu, który nie ma jeszcze folderu (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | Po tym, jak zmiana nazwy projektu przeniosła folder, zapisuje nową ścieżkę lub usuwa przypisanie, gdy folderu już nie ma (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | Gdy pull znajdzie folder bez przypisania, zapisuje projekt, który web dopasował po nazwie. |
| `PullManager.mjs:188-207` (`applyDeletion`) | Gdy folder projektu zostanie usunięty w Dropboxie, usuwa przypisanie (`StateManager.mjs:152-157`). |
| `StateManager.mjs:186-190` (`removeUserState`), wywoływane z `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Usuwa wszystkie dokumenty użytkownika, gdy third-party-datastore odłącza konto, którego nie może już używać. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Usuwa wszystkie dokumenty użytkownika przy łączeniu (`:125`), przy odłączaniu (`:183`) i gdy wygasa usunięty użytkownik (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Usuwa dokumenty projektu, gdy wygasa usunięty projekt (`index.mjs:54-56`). |

#### Kto ją odczytuje

| Kod | Co robi |
| - | - |
| `StateManager.mjs:130-135` (`getFolderOfProject`) | Znajduje folder projektu: `JobProcessor.mjs:59,98,176` i `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Znajduje projekt folderu: `JobProcessor.mjs:65` (nazwa już zajęta), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Wypisuje ścieżki folderów po zresetowaniu kursora, aby folder nieobecny na liście był uznany za usunięty (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Podaje nazwę folderu wyświetlaną w oknie Dropbox w edytorze (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Indeksy

| Nazwa | Klucze | Opcje | Migracja |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

CE nie ma tu innych indeksów. Unikalne indeksy `projectId_userId_1` i `userId_dropboxId_1` pochodzą z `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` i `20220817120900_create_dropboxProjects_index.mjs`, które mają tylko tag `saas`, więc CE nigdy ich nie uruchamia.

#### Uwagi

* Unikalność wynika wyłącznie z usuwania przed każdym wstawieniem w `setProjectFolder` (`StateManager.mjs:140-149`). Komentarz w `StateManager.mjs:3-11` wspomina o unikalnych indeksach; CE ich nie ma.
* Gdy przypisanie projektu zostanie usunięte, jego folder pozostaje w Dropboxie. Edycja w nim jest wtedy odczytywana jako nowy projekt, tak jak w przypadku folderu utworzonego w Dropboxie (`DropboxHandler.mjs:148-149`).
* Usunięty projekt zachowuje przypisanie do wygaśnięcia, ponieważ nadal można go przywrócić (`index.mjs:52-53`).
* Kursora Dropbox `list_folder` użytkownika tu nie ma. Znajduje się w `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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