> ## 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 集合

`dropboxProjects` 将一个项目映射到某个用户 Dropbox 中的文件夹。与多个 Dropbox 用户共享的项目，每个用户各有一个文档。该集合属于 Dropbox 同步：third-party-datastore（`services/third-party-datastore/app/js/StateManager.mjs`）写入它，`dropbox` web 模块（`services/web/modules/dropbox/app/src/DropboxHandler.mjs`）读取并清除它。没有 Mongoose schema。

#### 字段

| 字段 | 类型 | 含义 | 来源 |
| - | - | - | - |
| `_id` | ObjectId | 插入时由驱动设置。 | `StateManager.mjs:144` |
| `userId` | ObjectId | 其 Dropbox 中有该文件夹的 Overleaf 用户。 | `StateManager.mjs:145` |
| `projectId` | ObjectId | 同步到该文件夹的项目。 | `StateManager.mjs:146` |
| `dropboxId` | String | Dropbox 文件夹元数据中该文件夹的 `id`。 | `StateManager.mjs:147`、`JobProcessor.mjs:82-87`、`PullManager.mjs:138` |
| `pathLower` | String | 文件夹在 Dropbox 中的路径，小写且不带末尾斜杠。项目文件夹位于顶层，每个项目一个，例如 Dropbox 在另一个项目的 `Thesis` 旁为其编号时为 `/thesis (1)`。 | `StateManager.mjs:14-16,148`、`PullManager.mjs:112-117` |

#### 谁写入

| 代码 | 作用 |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150`（`setProjectFolder`） | 删除该用户具有相同 `projectId`、`dropboxId` 或 `pathLower` 的文档，然后插入新的映射。 |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91`（`projectFolder`） | 当 web 请求新项目或用户被加入的项目的文件夹（`createProject`，`:245-251`），或发送一个尚无文件夹的项目的文件（`addEntity`，`:113`）时，在 Dropbox 中创建文件夹并记录。 |
| `JobProcessor.mjs:174-203`（`renameProject`） | 项目重命名移动文件夹后，记录新路径；文件夹已不存在时删除映射（`:190`）。 |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140`（`resolveProject`） | pull 发现没有映射的文件夹时，记录 web 按名称匹配到的项目。 |
| `PullManager.mjs:188-207`（`applyDeletion`） | 项目文件夹在 Dropbox 中被删除时，删除映射（`StateManager.mjs:152-157`）。 |
| `StateManager.mjs:186-190`（`removeUserState`），由 `services/third-party-datastore/app/js/QueueWorker.mjs:43` 调用 | third-party-datastore 解除一个无法再使用的账户的关联时，删除该用户的所有文档。 |
| `DropboxHandler.mjs:142-146`（`removeUserState`） | 在关联时（`:125`）、解除关联时（`:183`）以及已删除用户过期时（`services/web/modules/dropbox/index.mjs:62-64`）删除该用户的所有文档。 |
| `DropboxHandler.mjs:150-154`（`removeProjectState`） | 已删除项目过期时删除该项目的文档（`index.mjs:54-56`）。 |

#### 谁读取

| 代码 | 作用 |
| - | - |
| `StateManager.mjs:130-135`（`getFolderOfProject`） | 查找项目的文件夹：`JobProcessor.mjs:59,98,176` 和 `PullManager.mjs:133`。 |
| `StateManager.mjs:123-128`（`getProjectByFolder`） | 查找文件夹对应的项目：`JobProcessor.mjs:65`（名称已被占用）、`PullManager.mjs:120,197`。 |
| `StateManager.mjs:160-175`（`getSyncedPaths`） | 游标重置后列出文件夹路径，使列表中缺失的文件夹被视为已删除（`PullManager.mjs:74-85`）。 |
| `DropboxHandler.mjs:234-250`（`getProjectFolderName`） | 提供编辑器 Dropbox 对话框中显示的文件夹名称（`services/web/modules/dropbox/app/src/DropboxController.mjs:130`）。 |

#### 索引

| 名称 | 键 | 选项 | 迁移 |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

CE 在这里没有其他索引。唯一索引 `projectId_userId_1` 和 `userId_dropboxId_1` 来自 `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` 和 `20220817120900_create_dropboxProjects_index.mjs`，它们只带有 `saas` 标签，因此 CE 从不运行它们。

#### 说明

* 唯一性仅来自 `setProjectFolder` 中每次插入前的删除（`StateManager.mjs:140-149`）。`StateManager.mjs:3-11` 的注释提到了唯一索引；CE 没有这些索引。
* 项目的映射被删除后，其文件夹仍留在 Dropbox 中。在那里的编辑会被当作新项目读取，与在 Dropbox 中创建的文件夹一样（`DropboxHandler.mjs:148-149`）。
* 已删除的项目在过期前保留其映射，因为它仍可被恢复（`index.mjs:52-53`）。
* 用户的 Dropbox `list_folder` 游标不在这里，而在 `users.dropbox.cursor` 中（`StateManager.mjs:177-184`）。


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