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

`dropboxEntities` lưu một tài liệu cho mỗi tệp mà đồng bộ Dropbox đã sao chép giữa một dự án và Dropbox của một người dùng, cùng các tombstone tồn tại ngắn hạn. Collection này thuộc về đồng bộ Dropbox: third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) ghi và đọc nó, còn module web `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) 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:46,97` |
| `overleaf.userId` | ObjectId | Người dùng có tệp trong Dropbox của mình. Được đặt trên mọi tài liệu. | `StateManager.mjs:48,98` |
| `overleaf.projectId` | ObjectId | Dự án của doc hoặc tệp. Được đặt khi biết; tombstone không có. | `StateManager.mjs:49-51` |
| `overleaf.id` | ObjectId | `_id` của doc hoặc tệp trong `rootFolder` của dự án. Được đặt khi biết. | `StateManager.mjs:52` |
| `overleaf.type` | String | `doc` hoặc `file`. Mã hiện tại ghi nhưng không đọc nó. | `StateManager.mjs:53`; giá trị từ `services/web/app/src/Features/ThirdPartyDataStore/TpdsUpdateSender.mjs:35,96` và `UpdateMerger.mjs:104,119` |
| `dropbox.id` | String | `id` của tệp trong siêu dữ liệu tệp Dropbox. Không đặt trên tombstone. | `StateManager.mjs:56` |
| `dropbox.pathLower` | String | Đường dẫn của tệp trong Dropbox, viết thường và không có dấu gạch chéo ở cuối. Được cập nhật khi tệp hoặc thư mục dự án của nó bị di chuyển. | `StateManager.mjs:14-16,57,91,99` |
| `dropbox.rev` | String | Bản sửa đổi Dropbox ở lần đồng bộ gần nhất. Lần tải lên tiếp theo gửi kèm nó, để tệp đã thay đổi trong Dropbox không bị ghi đè. | `StateManager.mjs:58`, `JobProcessor.mjs:114-122` |
| `dropbox.contentHash` | String | Hash nội dung Dropbox ở lần đồng bộ gần nhất. Tệp được liệt kê có cùng hash sẽ bị bỏ qua, vì đó là lần tải lên của chính chúng ta hoặc đã được áp dụng. | `StateManager.mjs:59`, `PullManager.mjs:147-149` |
| `tombstone` | Boolean | `true` đánh dấu một đường dẫn mà chính third-party-datastore đã xóa hoặc di chuyển đi trong Dropbox. Khi Dropbox báo lại việc xóa đó, nó không được áp dụng cho dự án. | `StateManager.mjs:100`, `PullManager.mjs:189-192` |
| `createdAt` | Date | Chỉ với tombstone: thời điểm tạo. Một lần pull hoàn tất sẽ xóa các tombstone được tạo trước khi nó bắt đầu. | `StateManager.mjs:101,115-121` |

Một tombstone chỉ có `overleaf.userId`, `dropbox.pathLower`, `tombstone` và `createdAt` (`StateManager.mjs:96-103`).

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:35-62` (`recordEntity`) | Xóa các tài liệu của người dùng có cùng `dropbox.id`, `dropbox.pathLower` hoặc `overleaf.id`, rồi chèn trạng thái mới. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:102-134` (`addEntity`) | Ghi lại một doc hoặc tệp sau khi tải nó từ Overleaf lên Dropbox (`:125-133`). |
| `services/third-party-datastore/app/js/PullManager.mjs:142-177` (`applyFile`) | Ghi lại một tệp Dropbox sau khi web đã áp dụng nó vào dự án (`:168-176`). |
| `StateManager.mjs:80-94` (`moveEntities`) | Viết lại `dropbox.pathLower` dưới một đường dẫn đã di chuyển: đổi tên dự án (`JobProcessor.mjs:195`) và di chuyển tệp hoặc thư mục (`JobProcessor.mjs:239`). |
| `StateManager.mjs:96-103` (`addTombstone`) | Sau một lần xóa (`JobProcessor.mjs:153`), đổi tên dự án (`:202`) hoặc di chuyển (`:240`) trong Dropbox. |
| `StateManager.mjs:72-78` (`removeEntities`) | Xóa các mục tại và dưới một đường dẫn, trừ tombstone: sau khi xóa từ Overleaf (`JobProcessor.mjs:152`) hoặc trong Dropbox (`PullManager.mjs:206`). |
| `StateManager.mjs:115-121` (`clearTombstones`) | Ở cuối một lần pull (`PullManager.mjs:31,69`). |
| `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:64-70` (`findEntityByPath`) | Lấy `dropbox.rev` trước khi tải lên (`JobProcessor.mjs:114`) và `dropbox.contentHash` trước khi áp dụng một tệp Dropbox (`PullManager.mjs:147`). |
| `StateManager.mjs:106-112` (`findTombstone`) | Kiểm tra một lần xóa được báo tại đường dẫn hoặc tại một trong các đường dẫn cha của nó (`PullManager.mjs:189`). |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | Liệt kê đường dẫn các tệp đã đồng bộ sau khi đặt lại con trỏ, để tệp không có trong danh sách được coi là đã xóa (`PullManager.mjs:74-85`). |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `_id_` | `_id: 1` | | default |
| `overleaf_userId_1_overleaf_projectId_1` | `overleaf.userId: 1, overleaf.projectId: 1` | | `tools/migrations/20250130104049_create_dropboxEntities_userId_projectId_index.mjs` |

`20220811111800_create_dropboxEntities_index.mjs` và `20220825160708_recreate_dropboxEntities.mjs` chỉ có thẻ `saas`, nên CE không có các chỉ mục duy nhất của chúng trên `(overleaf.userId, dropbox.id)` và `(overleaf.userId, overleaf.id)`, cũng không có chỉ mục hashed của chúng trên `dropbox.pathLower`.

#### Ghi chú

* Tính duy nhất chỉ đến từ thao tác xóa trước mỗi lần chèn trong `recordEntity` (`StateManager.mjs:38-45`). 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.
* Các truy vấn theo người dùng và đường dẫn (`findEntityByPath`, `findTombstone`, `removeEntities`) chỉ dùng chỉ mục cho `overleaf.userId`.


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