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

`dropboxProjects` knytter et projekt til dets mappe i én brugers Dropbox. Et projekt, der er delt med flere Dropbox-brugere, har ét dokument pr. bruger. Samlingen hører til Dropbox-synkroniseringen: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) skriver den, og webmodulet `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) læser og rydder den. Der er intet Mongoose-skema.

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Sættes af driveren ved indsættelse. | `StateManager.mjs:144` |
| `userId` | ObjectId | Overleaf-brugeren, hvis Dropbox har mappen. | `StateManager.mjs:145` |
| `projectId` | ObjectId | Projektet, der synkroniseres til 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 sti i Dropbox, med små bogstaver og uden afsluttende skråstreg. Projektmapper ligger på øverste niveau, én pr. projekt, for eksempel `/thesis (1)`, når Dropbox nummererede den ved siden af et andet projekts `Thesis`. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Hvem skriver den

| Kode | Hvad den gør |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Sletter brugerens dokumenter med samme `projectId`, `dropboxId` eller `pathLower` og indsætter derefter den nye tilknytning. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Opretter mappen i Dropbox og registrerer den, når web beder om mappen til et nyt projekt eller et projekt, brugeren blev føjet til (`createProject`, `:245-251`), eller sender en fil fra et projekt, der endnu ikke har en mappe (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | Efter at en omdøbning af projektet har flyttet mappen, registrerer den den nye sti eller fjerner tilknytningen, når mappen er væk (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | Når et pull finder en mappe uden tilknytning, registrerer den det projekt, web fandt ud fra navnet. |
| `PullManager.mjs:188-207` (`applyDeletion`) | Når en projektmappe slettes i Dropbox, fjerner den tilknytningen (`StateManager.mjs:152-157`). |
| `StateManager.mjs:186-190` (`removeUserState`), kaldt fra `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Sletter alle brugerens dokumenter, når third-party-datastore frakobler en konto, den ikke længere kan bruge. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Sletter alle brugerens dokumenter ved tilknytning (`:125`), ved frakobling (`:183`) og når en slettet bruger udløber (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Sletter projektets dokumenter, når et slettet projekt udløber (`index.mjs:54-56`). |

#### Hvem læser den

| Kode | Hvad den gør |
| - | - |
| `StateManager.mjs:130-135` (`getFolderOfProject`) | Finder et projekts mappe: `JobProcessor.mjs:59,98,176` og `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Finder en mappes projekt: `JobProcessor.mjs:65` (navnet er allerede taget), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Lister mappestierne efter en nulstilling af markøren, så en mappe, der mangler i listen, regnes som slettet (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Giver mappenavnet, der vises i editorens Dropbox-dialog (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Indekser

| Navn | Nøgler | Indstillinger | Migrering |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

CE har intet andet indeks her. De unikke indekser `projectId_userId_1` og `userId_dropboxId_1` kommer fra `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` og `20220817120900_create_dropboxProjects_index.mjs`, som kun har tagget `saas`, så CE kører dem aldrig.

#### Bemærkninger

* Unikhed kommer kun fra sletningen før hver indsættelse i `setProjectFolder` (`StateManager.mjs:140-149`). Kommentaren i `StateManager.mjs:3-11` nævner unikke indekser; CE har dem ikke.
* Når et projekts tilknytning fjernes, bliver mappen liggende i Dropbox. En redigering dér læses så som et nyt projekt, som for en mappe oprettet i Dropbox (`DropboxHandler.mjs:148-149`).
* Et slettet projekt beholder sin tilknytning, indtil det udløber, fordi det stadig kan gendannes (`index.mjs:52-53`).
* Brugerens Dropbox-markør `list_folder` ligger ikke her. Den er `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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