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

# Collection Dropbox Projects

`dropboxProjects` associe un projet à son dossier dans la Dropbox d'un utilisateur. Un projet partagé avec plusieurs utilisateurs Dropbox a un document par utilisateur. La collection appartient à la synchronisation Dropbox : third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) l'écrit, et le module web `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) la lit et la vide. Il n'y a pas de schéma Mongoose.

#### Champs

| Champ | Type | Signification | Source |
| - | - | - | - |
| `_id` | ObjectId | Défini par le pilote à l'insertion. | `StateManager.mjs:144` |
| `userId` | ObjectId | L'utilisateur Overleaf dont la Dropbox contient le dossier. | `StateManager.mjs:145` |
| `projectId` | ObjectId | Le projet synchronisé dans le dossier. | `StateManager.mjs:146` |
| `dropboxId` | String | L'`id` du dossier dans les métadonnées de dossier Dropbox. | `StateManager.mjs:147`, `JobProcessor.mjs:82-87`, `PullManager.mjs:138` |
| `pathLower` | String | Le chemin du dossier dans Dropbox, en minuscules et sans barre oblique finale. Les dossiers de projet sont au premier niveau, un par projet, par exemple `/thesis (1)` quand Dropbox l'a numéroté à côté du `Thesis` d'un autre projet. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Qui l'écrit

| Code | Ce qu'il fait |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Supprime les documents de l'utilisateur ayant le même `projectId`, `dropboxId` ou `pathLower`, puis insère la nouvelle association. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Crée le dossier dans Dropbox et l'enregistre, quand web demande le dossier d'un nouveau projet ou d'un projet auquel l'utilisateur a été ajouté (`createProject`, `:245-251`), ou envoie un fichier d'un projet qui n'a pas encore de dossier (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | Après qu'un renommage de projet a déplacé le dossier, enregistre le nouveau chemin, ou supprime l'association quand le dossier n'existe plus (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | Quand un pull trouve un dossier sans association, enregistre le projet que web a trouvé par son nom. |
| `PullManager.mjs:188-207` (`applyDeletion`) | Quand un dossier de projet est supprimé dans Dropbox, supprime l'association (`StateManager.mjs:152-157`). |
| `StateManager.mjs:186-190` (`removeUserState`), appelé depuis `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Supprime tous les documents de l'utilisateur quand third-party-datastore délie un compte qu'il ne peut plus utiliser. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Supprime tous les documents de l'utilisateur à la liaison (`:125`), à la déliaison (`:183`) et quand un utilisateur supprimé expire (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Supprime les documents du projet quand un projet supprimé expire (`index.mjs:54-56`). |

#### Qui la lit

| Code | Ce qu'il fait |
| - | - |
| `StateManager.mjs:130-135` (`getFolderOfProject`) | Trouve le dossier d'un projet : `JobProcessor.mjs:59,98,176` et `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Trouve le projet d'un dossier : `JobProcessor.mjs:65` (nom déjà pris), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Liste les chemins des dossiers après une réinitialisation du curseur, afin qu'un dossier absent de la liste soit considéré comme supprimé (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Fournit le nom de dossier affiché dans la boîte de dialogue Dropbox de l'éditeur (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Index

| Nom | Clés | Options | Migration |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

CE n'a pas d'autre index ici. Les index uniques `projectId_userId_1` et `userId_dropboxId_1` proviennent de `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` et `20220817120900_create_dropboxProjects_index.mjs`, qui sont étiquetées `saas` uniquement, donc CE ne les exécute jamais.

#### Remarques

* L'unicité vient uniquement de la suppression avant chaque insertion dans `setProjectFolder` (`StateManager.mjs:140-149`). Le commentaire de `StateManager.mjs:3-11` mentionne des index uniques ; CE ne les a pas.
* Quand l'association d'un projet est supprimée, son dossier reste dans Dropbox. Une modification à cet endroit est alors lue comme un nouveau projet, comme pour un dossier créé dans Dropbox (`DropboxHandler.mjs:148-149`).
* Un projet supprimé garde son association jusqu'à son expiration, car il peut encore être restauré (`index.mjs:52-53`).
* Le curseur Dropbox `list_folder` de l'utilisateur n'est pas ici. Il se trouve dans `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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