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

تحتفظ `dropboxEntities` بمستند واحد لكل ملف نسخته مزامنة Dropbox بين مشروع وDropbox الخاص بمستخدم واحد، إضافة إلى سجلات tombstone قصيرة العمر. تنتمي المجموعة إلى مزامنة Dropbox: يكتبها third-party-datastore (`services/third-party-datastore/app/js/StateManager.mjs`) ويقرؤها، وتمسحها وحدة الويب `dropbox` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`). لا يوجد مخطط Mongoose.

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | يعيّنه برنامج التشغيل عند الإدراج. | `StateManager.mjs:46,97` |
| `overleaf.userId` | ObjectId | المستخدم الذي يوجد الملف في Dropbox الخاص به. يُعيَّن في كل مستند. | `StateManager.mjs:48,98` |
| `overleaf.projectId` | ObjectId | مشروع الـ doc أو الملف. يُعيَّن عندما يكون معروفًا؛ لا يوجد في سجلات tombstone. | `StateManager.mjs:49-51` |
| `overleaf.id` | ObjectId | قيمة `_id` للـ doc أو الملف في `rootFolder` الخاص بالمشروع. يُعيَّن عندما يكون معروفًا. | `StateManager.mjs:52` |
| `overleaf.type` | String | `doc` أو `file`. تكتبه الشيفرة الحالية لكنها لا تقرؤه. | `StateManager.mjs:53`؛ القيم من `services/web/app/src/Features/ThirdPartyDataStore/TpdsUpdateSender.mjs:35,96` و`UpdateMerger.mjs:104,119` |
| `dropbox.id` | String | قيمة `id` للملف في بيانات تعريف ملف Dropbox. لا يُعيَّن في سجلات tombstone. | `StateManager.mjs:56` |
| `dropbox.pathLower` | String | مسار الملف في Dropbox بأحرف صغيرة ومن دون شرطة مائلة في النهاية. يُحدَّث عند نقل الملف أو مجلد مشروعه. | `StateManager.mjs:14-16,57,91,99` |
| `dropbox.rev` | String | مراجعة Dropbox عند آخر مزامنة. يرسلها الرفع التالي، حتى لا يُستبدل ملف تغيّر في Dropbox. | `StateManager.mjs:58`، `JobProcessor.mjs:114-122` |
| `dropbox.contentHash` | String | تجزئة محتوى Dropbox عند آخر مزامنة. يُتخطّى الملف المدرج الذي له التجزئة نفسها، لأنه رفعنا نحن أو طُبّق بالفعل. | `StateManager.mjs:59`، `PullManager.mjs:147-149` |
| `tombstone` | Boolean | تشير `true` إلى مسار حذفه third-party-datastore بنفسه أو نقله بعيدًا في Dropbox. عندما يُبلغ Dropbox عن هذا الحذف، لا يُطبَّق على المشروع. | `StateManager.mjs:100`، `PullManager.mjs:189-192` |
| `createdAt` | Date | لسجلات tombstone فقط: وقت إنشائه. يزيل pull المكتمل سجلات tombstone التي أُنشئت قبل بدئه. | `StateManager.mjs:101,115-121` |

لا يحتوي سجل tombstone إلا على `overleaf.userId` و`dropbox.pathLower` و`tombstone` و`createdAt` (`StateManager.mjs:96-103`).

#### من يكتبها

| الشيفرة | ما تفعله |
| - | - |
| `services/third-party-datastore/app/js/StateManager.mjs:35-62` (`recordEntity`) | تحذف مستندات المستخدم التي لها نفس `dropbox.id` أو `dropbox.pathLower` أو `overleaf.id`، ثم تُدرج الحالة الجديدة. |
| `services/third-party-datastore/app/js/JobProcessor.mjs:102-134` (`addEntity`) | تسجّل doc أو ملفًا بعد رفعه من Overleaf إلى Dropbox (`:125-133`). |
| `services/third-party-datastore/app/js/PullManager.mjs:142-177` (`applyFile`) | تسجّل ملف Dropbox بعد أن يطبّقه web على المشروع (`:168-176`). |
| `StateManager.mjs:80-94` (`moveEntities`) | تعيد كتابة `dropbox.pathLower` تحت مسار منقول: إعادة تسمية المشروع (`JobProcessor.mjs:195`) ونقل ملف أو مجلد (`JobProcessor.mjs:239`). |
| `StateManager.mjs:96-103` (`addTombstone`) | بعد حذف (`JobProcessor.mjs:153`) أو إعادة تسمية مشروع (`:202`) أو نقل (`:240`) في Dropbox. |
| `StateManager.mjs:72-78` (`removeEntities`) | تحذف الإدخالات في المسار وما تحته، باستثناء سجلات tombstone: بعد حذف من Overleaf (`JobProcessor.mjs:152`) أو في Dropbox (`PullManager.mjs:206`). |
| `StateManager.mjs:115-121` (`clearTombstones`) | في نهاية pull (`PullManager.mjs:31,69`). |
| `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:64-70` (`findEntityByPath`) | تجلب `dropbox.rev` قبل الرفع (`JobProcessor.mjs:114`) و`dropbox.contentHash` قبل تطبيق ملف Dropbox (`PullManager.mjs:147`). |
| `StateManager.mjs:106-112` (`findTombstone`) | تتحقق من حذف مُبلَّغ عنه في المسار أو في أحد مساراته الأم (`PullManager.mjs:189`). |
| `StateManager.mjs:160-175` (`getSyncedPaths`) | تسرد مسارات الملفات المتزامنة بعد إعادة تعيين المؤشر، بحيث يُعدّ الملف الغائب عن القائمة محذوفًا (`PullManager.mjs:74-85`). |

#### الفهارس

| الاسم | المفاتيح | الخيارات | الترحيل |
| - | - | - | - |
| `_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` و`20220825160708_recreate_dropboxEntities.mjs` الوسم `saas` فقط، لذلك لا يحتوي CE على فهارسهما الفريدة على `(overleaf.userId, dropbox.id)` و`(overleaf.userId, overleaf.id)`، ولا على فهرس التجزئة على `dropbox.pathLower`.

#### ملاحظات

* لا يأتي التفرّد إلا من الحذف قبل كل إدراج في `recordEntity` (`StateManager.mjs:38-45`). يذكر التعليق في `StateManager.mjs:3-11` فهارس فريدة؛ لكنها غير موجودة في CE.
* تستخدم الاستعلامات حسب المستخدم والمسار (`findEntityByPath` و`findTombstone` و`removeEntities`) الفهرس لـ `overleaf.userId` فقط.


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