> ## 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` ánh xạ một dự án tới thư mục của nó trong Dropbox của một người dùng. Một dự án được chia sẻ với nhiều người dùng Dropbox có một tài liệu cho mỗi người dùng. Collection này thuộc về đồng bộ Dropbox: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) ghi nó, còn module web `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) đọc và xóa nó. Không có schema Mongoose.

#### Các trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Do driver đặt khi chèn. | `StateManager.mjs:144` |
| `userId` | ObjectId | Người dùng Overleaf có thư mục trong Dropbox của mình. | `StateManager.mjs:145` |
| `projectId` | ObjectId | Dự án được đồng bộ vào thư mục. | `StateManager.mjs:146` |
| `dropboxId` | String | `id` của thư mục trong siêu dữ liệu thư mục Dropbox. | `StateManager.mjs:147`, `JobProcessor.mjs:82-87`, `PullManager.mjs:138` |
| `pathLower` | String | Đường dẫn của thư mục trong Dropbox, viết thường và không có dấu gạch chéo ở cuối. Các thư mục dự án nằm ở cấp cao nhất, mỗi dự án một thư mục, ví dụ `/thesis (1)` khi Dropbox đánh số nó bên cạnh `Thesis` của một dự án khác. | `StateManager.mjs:14-16,148`, `PullManager.mjs:112-117` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:137-150` (`setProjectFolder`) | Xóa các tài liệu của người dùng có cùng `projectId`, `dropboxId` hoặc `pathLower`, rồi chèn ánh xạ mới. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:58-91` (`projectFolder`) | Tạo thư mục trong Dropbox và ghi lại khi web yêu cầu thư mục của một dự án mới hoặc dự án mà người dùng được thêm vào (`createProject`, `:245-251`), hoặc gửi một tệp của dự án chưa có thư mục (`addEntity`, `:113`). |
| `JobProcessor.mjs:174-203` (`renameProject`) | Sau khi việc đổi tên dự án di chuyển thư mục, ghi lại đường dẫn mới, hoặc xóa ánh xạ khi thư mục không còn (`:190`). |
| `services/third-party-datastore/app/js/PullManager.mjs:119-140` (`resolveProject`) | Khi một lần pull tìm thấy thư mục chưa có ánh xạ, ghi lại dự án mà web khớp theo tên. |
| `PullManager.mjs:188-207` (`applyDeletion`) | Khi một thư mục dự án bị xóa trong Dropbox, xóa ánh xạ (`StateManager.mjs:152-157`). |
| `StateManager.mjs:186-190` (`removeUserState`), được gọi từ `services/third-party-datastore/app/js/QueueWorker.mjs:43` | Xóa mọi tài liệu của người dùng khi third-party-datastore hủy liên kết một tài khoản mà nó không còn dùng được. |
| `DropboxHandler.mjs:142-146` (`removeUserState`) | Xóa mọi tài liệu của người dùng khi liên kết (`:125`), khi hủy liên kết (`:183`) và khi một người dùng đã xóa hết hạn (`services/web/modules/dropbox/index.mjs:62-64`). |
| `DropboxHandler.mjs:150-154` (`removeProjectState`) | Xóa các tài liệu của dự án khi một dự án đã xóa hết hạn (`index.mjs:54-56`). |

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `StateManager.mjs:130-135` (`getFolderOfProject`) | Tìm thư mục của một dự án: `JobProcessor.mjs:59,98,176` và `PullManager.mjs:133`. |
| `StateManager.mjs:123-128` (`getProjectByFolder`) | Tìm dự án của một thư mục: `JobProcessor.mjs:65` (tên đã được dùng), `PullManager.mjs:120,197`. |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Liệt kê đường dẫn các thư mục sau khi đặt lại con trỏ, để thư mục không có trong danh sách được coi là đã xóa (`PullManager.mjs:74-85`). |
| `DropboxHandler.mjs:234-250` (`getProjectFolderName`) | Trả về tên thư mục hiển thị trong hộp thoại Dropbox của trình soạn thảo (`services/web/modules/dropbox/app/src/DropboxController.mjs:130`). |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |

CE không có chỉ mục nào khác ở đây. Các chỉ mục duy nhất `projectId_userId_1` và `userId_dropboxId_1` đến từ `tools/migrations/20220815105500_create_dropboxProjects_index.mjs` và `20220817120900_create_dropboxProjects_index.mjs`, vốn chỉ có thẻ `saas`, nên CE không bao giờ chạy chúng.

#### Ghi chú

* Tính duy nhất chỉ đến từ thao tác xóa trước mỗi lần chèn trong `setProjectFolder` (`StateManager.mjs:140-149`). Chú thích tại `StateManager.mjs:3-11` nhắc tới chỉ mục duy nhất; CE không có chúng.
* Khi ánh xạ của một dự án bị xóa, thư mục của nó vẫn còn trong Dropbox. Một chỉnh sửa ở đó khi ấy được đọc như một dự án mới, giống như thư mục được tạo trong Dropbox (`DropboxHandler.mjs:148-149`).
* Một dự án đã xóa giữ ánh xạ của nó cho đến khi hết hạn, vì nó vẫn có thể được khôi phục (`index.mjs:52-53`).
* Con trỏ Dropbox `list_folder` của người dùng không nằm ở đây. Nó là `users.dropbox.cursor` (`StateManager.mjs:177-184`).


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