> ## 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` (`services/web/modules/dropbox/app/src/DropboxHandler.mjs`) وتمسحها. لا يوجد مخطط Mongoose.

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | يعيّنه برنامج التشغيل عند الإدراج. | `StateManager.mjs:144` |
| `userId` | ObjectId | مستخدم Overleaf الذي يوجد المجلد في Dropbox الخاص به. | `StateManager.mjs:145` |
| `projectId` | ObjectId | المشروع الذي تتم مزامنته إلى المجلد. | `StateManager.mjs:146` |
| `dropboxId` | String | قيمة `id` للمجلد في بيانات تعريف مجلد Dropbox. | `StateManager.mjs:147`، `JobProcessor.mjs:82-87`، `PullManager.mjs:138` |
| `pathLower` | String | مسار المجلد في Dropbox بأحرف صغيرة ومن دون شرطة مائلة في النهاية. تقع مجلدات المشاريع في المستوى الأعلى، مجلد لكل مشروع، مثل `/thesis (1)` عندما رقّمه Dropbox بجوار `Thesis` لمشروع آخر. | `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`) | تنشئ المجلد في Dropbox وتسجّله عندما يطلب web مجلد مشروع جديد أو مشروع أُضيف إليه المستخدم (`createProject`، `:245-251`)، أو يرسل ملفًا لمشروع ليس له مجلد بعد (`addEntity`، `:113`). |
| `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.