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

# Coleção Dropbox Projects

`dropboxProjects` associa um projeto à sua pasta no Dropbox de um usuário. Um projeto compartilhado com vários usuários do Dropbox tem um documento por usuário. Ela pertence à sincronização com o Dropbox: o third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) a escreve, e o módulo web `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) a lê e a limpa. Não há esquema Mongoose.

#### Campos

| Campo | Tipo | Significado | Fonte |
| - | - | - | - |
| `_id` | ObjectId | Definido pelo driver na inserção. | `StateManager.mjs:144` |
| `userId` | ObjectId | O usuário do Overleaf em cujo Dropbox está a pasta. | `StateManager.mjs:145` |
| `projectId` | ObjectId | O projeto sincronizado na pasta. | `StateManager.mjs:146` |
| `dropboxId` | String | O `id` da pasta nos metadados de pasta do Dropbox. | `StateManager.mjs:147`, `JobProcessor.mjs:82-87`, `PullManager.mjs:138` |
| `pathLower` | String | O caminho da pasta no Dropbox, em minúsculas e sem barra final. As pastas de projeto ficam no nível superior, uma por projeto, por exemplo `/thesis (1)` quando o Dropbox a numerou ao lado do `Thesis` de outro projeto. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Quem a escreve

| Código | O que faz |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Exclui os documentos do usuário com o mesmo `projectId`, `dropboxId` ou `pathLower` e depois insere a nova associação. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Cria a pasta no Dropbox e a registra quando o web pede a pasta de um projeto novo ou de um projeto ao qual o usuário foi adicionado (`createProject`, `:245-251`), ou envia um arquivo de um projeto que ainda não tem pasta (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | Depois que uma renomeação de projeto move a pasta, registra o novo caminho, ou remove a associação quando a pasta não existe mais (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | Quando um pull encontra uma pasta sem associação, registra o projeto que o web encontrou pelo nome. |
| `PullManager.mjs:188-207` (`applyDeletion`) | Quando uma pasta de projeto é excluída no Dropbox, remove a associação (`StateManager.mjs:152-157`). |
| `StateManager.mjs:186-190` (`removeUserState`), chamado a partir de `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Exclui todos os documentos do usuário quando o third-party-datastore desvincula uma conta que não pode mais usar. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Exclui todos os documentos do usuário ao vincular (`:125`), ao desvincular (`:183`) e quando um usuário excluído expira (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Exclui os documentos do projeto quando um projeto excluído expira (`index.mjs:54-56`). |

#### Quem a lê

| Código | O que faz |
| - | - |
| `StateManager.mjs:130-135` (`getFolderOfProject`) | Encontra a pasta de um projeto: `JobProcessor.mjs:59,98,176` e `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Encontra o projeto de uma pasta: `JobProcessor.mjs:65` (nome já em uso), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Lista os caminhos das pastas após uma redefinição do cursor, para que uma pasta ausente da listagem conte como excluída (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Fornece o nome da pasta mostrado na caixa de diálogo do Dropbox no editor (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Índices

| Nome | Chaves | Opções | Migração |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

O CE não tem nenhum outro índice aqui. Os índices únicos `projectId_userId_1` e `userId_dropboxId_1` vêm de `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` e `20220817120900_create_dropboxProjects_index.mjs`, que têm apenas a tag `saas`, então o CE nunca as executa.

#### Notas

* A unicidade vem apenas da exclusão antes de cada inserção em `setProjectFolder` (`StateManager.mjs:140-149`). O comentário em `StateManager.mjs:3-11` menciona índices únicos; o CE não os tem.
* Quando a associação de um projeto é removida, sua pasta permanece no Dropbox. Uma edição ali é então lida como um projeto novo, como acontece com uma pasta criada no Dropbox (`DropboxHandler.mjs:148-149`).
* Um projeto excluído mantém sua associação até expirar, porque ainda pode ser restaurado (`index.mjs:52-53`).
* O cursor `list_folder` do Dropbox do usuário não fica aqui. Ele está em `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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