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

`dropboxProjects` yhdistää projektin sen kansioon yhden käyttäjän Dropboxissa. Projektilla, joka on jaettu usealle Dropbox-käyttäjälle, on yksi dokumentti käyttäjää kohden. Kokoelma kuuluu Dropbox-synkronointiin: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) kirjoittaa sen, ja `dropbox`-verkkomoduuli (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) lukee ja tyhjentää sen. Mongoose-skeemaa ei ole.

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Ajuri asettaa lisäyksen yhteydessä. | `StateManager.mjs:144` |
| `userId` | ObjectId | Overleaf-käyttäjä, jonka Dropboxissa kansio on. | `StateManager.mjs:145` |
| `projectId` | ObjectId | Kansioon synkronoitava projekti. | `StateManager.mjs:146` |
| `dropboxId` | String | Kansion `id` Dropboxin kansiometatiedoissa. | `StateManager.mjs:147`, `JobProcessor.mjs:82-87`, `PullManager.mjs:138` |
| `pathLower` | String | Kansion polku Dropboxissa pienillä kirjaimilla ja ilman loppukauttaviivaa. Projektikansiot ovat ylimmällä tasolla, yksi projektia kohden, esimerkiksi `/thesis (1)`, kun Dropbox numeroi sen toisen projektin `Thesis`-kansion viereen. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Kuka kirjoittaa sen

| Koodi | Mitä se tekee |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Poistaa käyttäjän dokumentit, joilla on sama `projectId`, `dropboxId` tai `pathLower`, ja lisää sitten uuden yhdistämisen. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Luo kansion Dropboxiin ja tallentaa sen, kun web pyytää uuden projektin tai sellaisen projektin kansiota, johon käyttäjä lisättiin (`createProject`, `:245-251`), tai lähettää tiedoston projektista, jolla ei vielä ole kansiota (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | Kun projektin uudelleennimeäminen on siirtänyt kansion, tallentaa uuden polun tai poistaa yhdistämisen, jos kansiota ei enää ole (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | Kun pull löytää kansion ilman yhdistämistä, tallentaa projektin, jonka web löysi nimen perusteella. |
| `PullManager.mjs:188-207` (`applyDeletion`) | Kun projektikansio poistetaan Dropboxissa, poistaa yhdistämisen (`StateManager.mjs:152-157`). |
| `StateManager.mjs:186-190` (`removeUserState`), kutsutaan kohdasta `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Poistaa kaikki käyttäjän dokumentit, kun third-party-datastore irrottaa tilin, jota se ei enää voi käyttää. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Poistaa kaikki käyttäjän dokumentit linkitettäessä (`:125`), linkitystä purettaessa (`:183`) ja kun poistettu käyttäjä vanhenee (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Poistaa projektin dokumentit, kun poistettu projekti vanhenee (`index.mjs:54-56`). |

#### Kuka lukee sen

| Koodi | Mitä se tekee |
| - | - |
| `StateManager.mjs:130-135` (`getFolderOfProject`) | Etsii projektin kansion: `JobProcessor.mjs:59,98,176` ja `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Etsii kansion projektin: `JobProcessor.mjs:65` (nimi on jo käytössä), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Listaa kansiopolut kursorin nollauksen jälkeen, jotta listauksesta puuttuva kansio katsotaan poistetuksi (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Antaa kansion nimen, joka näytetään editorin Dropbox-valintaikkunassa (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

CE:ssä ei ole tässä muita indeksejä. Yksilölliset indeksit `projectId_userId_1` ja `userId_dropboxId_1` tulevat migraatioista `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` ja `20220817120900_create_dropboxProjects_index.mjs`, joilla on vain `saas`-tunniste, joten CE ei koskaan aja niitä.

#### Huomautukset

* Yksilöllisyys perustuu vain poistoon ennen jokaista lisäystä `setProjectFolder`-funktiossa (`StateManager.mjs:140-149`). Kohdan `StateManager.mjs:3-11` kommentti mainitsee yksilölliset indeksit; CE:ssä niitä ei ole.
* Kun projektin yhdistäminen poistetaan, sen kansio jää Dropboxiin. Siellä tehty muokkaus luetaan silloin uutena projektina, kuten Dropboxissa luodun kansion kohdalla (`DropboxHandler.mjs:148-149`).
* Poistettu projekti säilyttää yhdistämisensä vanhenemiseen asti, koska se voidaan vielä palauttaa (`index.mjs:52-53`).
* Käyttäjän Dropbox-kursori `list_folder` ei ole täällä. Se on `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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