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

`dropboxProjects` ordnet ein Projekt seinem Ordner in der Dropbox eines Benutzers zu. Ein Projekt, das mit mehreren Dropbox-Benutzern geteilt ist, hat ein Dokument pro Benutzer. Die Collection gehört zur Dropbox-Synchronisierung: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) schreibt sie, und das Web-Modul `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) liest und leert sie. Es gibt kein Mongoose-Schema.

#### Felder

| Feld | Typ | Bedeutung | Quelle |
| - | - | - | - |
| `_id` | ObjectId | Wird beim Einfügen vom Treiber gesetzt. | `StateManager.mjs:144` |
| `userId` | ObjectId | Der Overleaf-Benutzer, in dessen Dropbox der Ordner liegt. | `StateManager.mjs:145` |
| `projectId` | ObjectId | Das Projekt, das in den Ordner synchronisiert wird. | `StateManager.mjs:146` |
| `dropboxId` | String | Die `id` des Ordners in den Dropbox-Ordnermetadaten. | `StateManager.mjs:147`, `JobProcessor.mjs:82-87`, `PullManager.mjs:138` |
| `pathLower` | String | Der Pfad des Ordners in Dropbox, kleingeschrieben und ohne abschließenden Schrägstrich. Projektordner liegen auf der obersten Ebene, einer pro Projekt, zum Beispiel `/thesis (1)`, wenn Dropbox ihn neben dem `Thesis` eines anderen Projekts nummeriert hat. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Wer sie schreibt

| Code | Was er tut |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Löscht die Dokumente des Benutzers mit derselben `projectId`, `dropboxId` oder `pathLower` und fügt dann die neue Zuordnung ein. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Legt den Ordner in Dropbox an und speichert ihn, wenn Web den Ordner eines neuen Projekts oder eines Projekts anfordert, zu dem der Benutzer hinzugefügt wurde (`createProject`, `:245-251`), oder eine Datei eines Projekts sendet, das noch keinen Ordner hat (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | Nachdem eine Projektumbenennung den Ordner verschoben hat, speichert es den neuen Pfad oder entfernt die Zuordnung, wenn der Ordner nicht mehr existiert (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | Wenn ein Pull einen Ordner ohne Zuordnung findet, speichert es das Projekt, das Web anhand des Namens gefunden hat. |
| `PullManager.mjs:188-207` (`applyDeletion`) | Wenn ein Projektordner in Dropbox gelöscht wird, entfernt es die Zuordnung (`StateManager.mjs:152-157`). |
| `StateManager.mjs:186-190` (`removeUserState`), aufgerufen von `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Löscht alle Dokumente des Benutzers, wenn third-party-datastore ein Konto trennt, das es nicht mehr verwenden kann. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Löscht alle Dokumente des Benutzers beim Verknüpfen (`:125`), beim Trennen (`:183`) und wenn ein gelöschter Benutzer abläuft (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Löscht die Dokumente des Projekts, wenn ein gelöschtes Projekt abläuft (`index.mjs:54-56`). |

#### Wer sie liest

| Code | Was er tut |
| - | - |
| `StateManager.mjs:130-135` (`getFolderOfProject`) | Findet den Ordner eines Projekts: `JobProcessor.mjs:59,98,176` und `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Findet das Projekt eines Ordners: `JobProcessor.mjs:65` (Name bereits vergeben), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Listet die Ordnerpfade nach einem Zurücksetzen des Cursors auf, sodass ein Ordner, der in der Auflistung fehlt, als gelöscht gilt (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Liefert den Ordnernamen, der im Dropbox-Dialog des Editors angezeigt wird (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Indizes

| Name | Schlüssel | Optionen | Migration |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

CE hat hier keinen weiteren Index. Die eindeutigen Indizes `projectId_userId_1` und `userId_dropboxId_1` stammen aus `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` und `20220817120900_create_dropboxProjects_index.mjs`, die nur mit `saas` getaggt sind, sodass CE sie nie ausführt.

#### Hinweise

* Die Eindeutigkeit ergibt sich nur aus dem Löschen vor jedem Einfügen in `setProjectFolder` (`StateManager.mjs:140-149`). Der Kommentar in `StateManager.mjs:3-11` erwähnt eindeutige Indizes; CE hat sie nicht.
* Wenn die Zuordnung eines Projekts entfernt wird, bleibt sein Ordner in Dropbox. Eine Bearbeitung dort wird dann als neues Projekt gelesen, wie bei einem in Dropbox angelegten Ordner (`DropboxHandler.mjs:148-149`).
* Ein gelöschtes Projekt behält seine Zuordnung, bis es abläuft, weil es noch wiederhergestellt werden kann (`index.mjs:52-53`).
* Der Dropbox-`list_folder`-Cursor des Benutzers liegt nicht hier. Er ist `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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