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

# Samlingen Dropbox Projects

`dropboxProjects` kopplar ett projekt till dess mapp i en användares Dropbox. Ett projekt som delas med flera Dropbox-användare har ett dokument per användare. Samlingen hör till Dropbox-synkroniseringen: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) skriver den, och webbmodulen `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) läser och rensar den. Det finns inget Mongoose-schema.

#### Fält

| Fält | Typ | Betydelse | Källa |
| - | - | - | - |
| `_id` | ObjectId | Sätts av drivrutinen vid infogning. | `StateManager.mjs:144` |
| `userId` | ObjectId | Overleaf-användaren vars Dropbox har mappen. | `StateManager.mjs:145` |
| `projectId` | ObjectId | Projektet som synkas till mappen. | `StateManager.mjs:146` |
| `dropboxId` | String | Mappens `id` i Dropbox-mappens metadata. | `StateManager.mjs:147`, `JobProcessor.mjs:82-87`, `PullManager.mjs:138` |
| `pathLower` | String | Mappens sökväg i Dropbox, i gemener och utan avslutande snedstreck. Projektmappar ligger på översta nivån, en per projekt, till exempel `/thesis (1)` när Dropbox numrerade den bredvid ett annat projekts `Thesis`. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Vem som skriver den

| Kod | Vad den gör |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Tar bort användarens dokument med samma `projectId`, `dropboxId` eller `pathLower` och infogar sedan den nya kopplingen. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Skapar mappen i Dropbox och registrerar den när web ber om mappen för ett nytt projekt eller ett projekt som användaren lades till i (`createProject`, `:245-251`), eller skickar en fil från ett projekt som ännu saknar mapp (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | När ett namnbyte av projektet har flyttat mappen registrerar den den nya sökvägen, eller tar bort kopplingen när mappen är borta (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | När en pull hittar en mapp utan koppling registrerar den projektet som web matchade på namn. |
| `PullManager.mjs:188-207` (`applyDeletion`) | När en projektmapp tas bort i Dropbox tar den bort kopplingen (`StateManager.mjs:152-157`). |
| `StateManager.mjs:186-190` (`removeUserState`), anropad från `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Tar bort alla användarens dokument när third-party-datastore kopplar bort ett konto som den inte längre kan använda. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Tar bort alla användarens dokument vid länkning (`:125`), vid avlänkning (`:183`) och när en borttagen användare löper ut (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Tar bort projektets dokument när ett borttaget projekt löper ut (`index.mjs:54-56`). |

#### Vem som läser den

| Kod | Vad den gör |
| - | - |
| `StateManager.mjs:130-135` (`getFolderOfProject`) | Hittar ett projekts mapp: `JobProcessor.mjs:59,98,176` och `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Hittar en mapps projekt: `JobProcessor.mjs:65` (namnet är redan upptaget), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Listar mappsökvägarna efter en återställning av markören, så att en mapp som saknas i listningen räknas som borttagen (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Ger mappnamnet som visas i redigerarens Dropbox-dialog (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Index

| Namn | Nycklar | Alternativ | Migrering |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

CE har inget annat index här. De unika indexen `projectId_userId_1` och `userId_dropboxId_1` kommer från `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` och `20220817120900_create_dropboxProjects_index.mjs`, som bara har taggen `saas`, så CE kör dem aldrig.

#### Anteckningar

* Unikheten kommer enbart från borttagningen före varje infogning i `setProjectFolder` (`StateManager.mjs:140-149`). Kommentaren i `StateManager.mjs:3-11` nämner unika index; CE har dem inte.
* När ett projekts koppling tas bort ligger mappen kvar i Dropbox. En redigering där läses då som ett nytt projekt, som för en mapp skapad i Dropbox (`DropboxHandler.mjs:148-149`).
* Ett borttaget projekt behåller sin koppling tills det löper ut, eftersom det fortfarande kan återställas (`index.mjs:52-53`).
* Användarens Dropbox-markör `list_folder` finns inte här. Den är `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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