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

# Kolekce Dropbox Projects

`dropboxProjects` přiřazuje projekt k jeho složce v Dropboxu jednoho uživatele. Projekt sdílený s několika uživateli Dropboxu má jeden dokument na uživatele. Kolekce patří k synchronizaci s Dropboxem: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) ji zapisuje a webový modul `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) ji čte a maže. Neexistuje žádné schéma Mongoose.

#### Pole

| Pole | Typ | Význam | Zdroj |
| - | - | - | - |
| `_id` | ObjectId | Nastavuje ovladač při vložení. | `StateManager.mjs:144` |
| `userId` | ObjectId | Uživatel Overleaf, v jehož Dropboxu je složka. | `StateManager.mjs:145` |
| `projectId` | ObjectId | Projekt synchronizovaný do složky. | `StateManager.mjs:146` |
| `dropboxId` | String | `id` složky v metadatech složky Dropboxu. | `StateManager.mjs:147`, `JobProcessor.mjs:82-87`, `PullManager.mjs:138` |
| `pathLower` | String | Cesta ke složce v Dropboxu, malými písmeny a bez koncového lomítka. Složky projektů jsou na nejvyšší úrovni, jedna na projekt, například `/thesis (1)`, když ji Dropbox očísloval vedle `Thesis` jiného projektu. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Kdo ji zapisuje

| Kód | Co dělá |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Smaže dokumenty uživatele se stejným `projectId`, `dropboxId` nebo `pathLower` a poté vloží nové přiřazení. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Vytvoří složku v Dropboxu a zaznamená ji, když web požádá o složku nového projektu nebo projektu, do kterého byl uživatel přidán (`createProject`, `:245-251`), nebo pošle soubor projektu, který ještě nemá složku (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | Poté, co přejmenování projektu přesunulo složku, zaznamená novou cestu, nebo odstraní přiřazení, když složka už neexistuje (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | Když pull najde složku bez přiřazení, zaznamená projekt, který web našel podle názvu. |
| `PullManager.mjs:188-207` (`applyDeletion`) | Když je složka projektu v Dropboxu smazána, odstraní přiřazení (`StateManager.mjs:152-157`). |
| `StateManager.mjs:186-190` (`removeUserState`), volané z `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Smaže všechny dokumenty uživatele, když third-party-datastore odpojí účet, který už nemůže používat. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Smaže všechny dokumenty uživatele při propojení (`:125`), při odpojení (`:183`) a když vyprší smazaný uživatel (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Smaže dokumenty projektu, když vyprší smazaný projekt (`index.mjs:54-56`). |

#### Kdo ji čte

| Kód | Co dělá |
| - | - |
| `StateManager.mjs:130-135` (`getFolderOfProject`) | Najde složku projektu: `JobProcessor.mjs:59,98,176` a `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Najde projekt složky: `JobProcessor.mjs:65` (název už je obsazen), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Vypíše cesty složek po resetu kurzoru, aby se složka chybějící ve výpisu považovala za smazanou (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Vrací název složky zobrazený v dialogu Dropbox v editoru (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Indexy

| Název | Klíče | Volby | Migrace |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

CE zde nemá žádný další index. Unikátní indexy `projectId_userId_1` a `userId_dropboxId_1` pocházejí z `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` a `20220817120900_create_dropboxProjects_index.mjs`, které mají pouze štítek `saas`, takže je CE nikdy nespouští.

#### Poznámky

* Unikátnost zajišťuje pouze mazání před každým vložením v `setProjectFolder` (`StateManager.mjs:140-149`). Komentář v `StateManager.mjs:3-11` zmiňuje unikátní indexy; CE je nemá.
* Když je přiřazení projektu odstraněno, jeho složka v Dropboxu zůstane. Úprava v ní se pak čte jako nový projekt, stejně jako u složky vytvořené v Dropboxu (`DropboxHandler.mjs:148-149`).
* Smazaný projekt si ponechá přiřazení až do vypršení, protože jej lze ještě obnovit (`index.mjs:52-53`).
* Kurzor Dropboxu `list_folder` uživatele zde není. Je v `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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