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

# Colección Dropbox Projects

`dropboxProjects` asocia un proyecto con su carpeta en el Dropbox de un usuario. Un proyecto compartido con varios usuarios de Dropbox tiene un documento por usuario. Pertenece a la sincronización con Dropbox: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) la escribe, y el módulo web `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) la lee y la vacía. No hay esquema de Mongoose.

#### Campos

| Campo | Tipo | Significado | Fuente |
| - | - | - | - |
| `_id` | ObjectId | Lo establece el driver al insertar. | `StateManager.mjs:144` |
| `userId` | ObjectId | El usuario de Overleaf en cuyo Dropbox está la carpeta. | `StateManager.mjs:145` |
| `projectId` | ObjectId | El proyecto sincronizado en la carpeta. | `StateManager.mjs:146` |
| `dropboxId` | String | El `id` de la carpeta en los metadatos de carpeta de Dropbox. | `StateManager.mjs:147`, `JobProcessor.mjs:82-87`, `PullManager.mjs:138` |
| `pathLower` | String | La ruta de la carpeta en Dropbox, en minúsculas y sin barra final. Las carpetas de proyecto están en el nivel superior, una por proyecto, por ejemplo `/thesis (1)` cuando Dropbox la numeró junto al `Thesis` de otro proyecto. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Quién la escribe

| Código | Qué hace |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Elimina los documentos del usuario con el mismo `projectId`, `dropboxId` o `pathLower` y luego inserta la nueva asociación. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Crea la carpeta en Dropbox y la registra cuando web pide la carpeta de un proyecto nuevo o de un proyecto al que se añadió al usuario (`createProject`, `:245-251`), o envía un archivo de un proyecto que aún no tiene carpeta (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | Después de que un cambio de nombre del proyecto mueva la carpeta, registra la nueva ruta, o elimina la asociación cuando la carpeta ya no existe (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | Cuando un pull encuentra una carpeta sin asociación, registra el proyecto que web encontró por nombre. |
| `PullManager.mjs:188-207` (`applyDeletion`) | Cuando se elimina una carpeta de proyecto en Dropbox, elimina la asociación (`StateManager.mjs:152-157`). |
| `StateManager.mjs:186-190` (`removeUserState`), llamado desde `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Elimina todos los documentos del usuario cuando third-party-datastore desvincula una cuenta que ya no puede usar. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Elimina todos los documentos del usuario al vincular (`:125`), al desvincular (`:183`) y cuando caduca un usuario eliminado (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Elimina los documentos del proyecto cuando caduca un proyecto eliminado (`index.mjs:54-56`). |

#### Quién la lee

| Código | Qué hace |
| - | - |
| `StateManager.mjs:130-135` (`getFolderOfProject`) | Encuentra la carpeta de un proyecto: `JobProcessor.mjs:59,98,176` y `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Encuentra el proyecto de una carpeta: `JobProcessor.mjs:65` (nombre ya ocupado), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Lista las rutas de carpetas tras reiniciar el cursor, de modo que una carpeta que falta en el listado cuenta como eliminada (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Da el nombre de carpeta que se muestra en el diálogo de Dropbox del editor (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Índices

| Nombre | Claves | Opciones | Migración |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

CE no tiene ningún otro índice aquí. Los índices únicos `projectId_userId_1` y `userId_dropboxId_1` provienen de `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` y `20220817120900_create_dropboxProjects_index.mjs`, que solo tienen la etiqueta `saas`, así que CE nunca las ejecuta.

#### Notas

* La unicidad viene solo de la eliminación previa a cada inserción en `setProjectFolder` (`StateManager.mjs:140-149`). El comentario en `StateManager.mjs:3-11` menciona índices únicos; CE no los tiene.
* Cuando se elimina la asociación de un proyecto, su carpeta permanece en Dropbox. Una edición allí se lee entonces como un proyecto nuevo, igual que una carpeta creada en Dropbox (`DropboxHandler.mjs:148-149`).
* Un proyecto eliminado conserva su asociación hasta que caduca, porque todavía se puede restaurar (`index.mjs:52-53`).
* El cursor `list_folder` de Dropbox del usuario no está aquí. Está en `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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