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

# مجموعة Project Invites

تحتوي `projectInvites` على الدعوات التي يرسلها مالك المشروع من مربع حوار المشاركة. كل مستند هو دعوة واحدة إلى عنوان بريد واحد. يُحذف المستند عند قبول الدعوة أو إلغائها، أو يحذفه Mongo عند انتهاء صلاحيتها. المخطط موجود في `services/web/app/src/models/ProjectInvite.mjs`، وتكتبه `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs`.

لا تجعل الدعوة أحداً عضواً. الأعضاء موجودون في مصفوفات `*_refs` الخاصة بالمشروع، انظر [مجموعة المشاريع (Projects)](https://ayakaleaf-pro.mintlify.site/ar/dev/data-model/projects-collection.md).

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | معرّف الدعوة. يستخدم إشعار الدعوة لمستخدم موجود المفتاح `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | العنوان الذي أُرسلت إليه الدعوة. عند إلغاء دعوة لمستخدم، يُقارن بعناوين البريد المؤكدة لديه (`CollaboratorsInviteHandler.mjs:103-116`). لا يُعيَّن في دعوة رابط المشاركة. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | HMAC-SHA256 (المفتاح `overleaf-token-invite`) للرمز الموجود في رابط الدعوة. الرمز الصريح موجود في البريد والإشعار فقط؛ تجزّئ عمليات البحث الرمز من عنوان URL وتطابقه مع هذا الحقل. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | لدعوات رابط المشاركة فقط: الرمز مشفّراً باستخدام `Settings.projectInviteEncryptorOptions`، حتى يتمكن المالك من رؤية الرابط مجدداً (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | المستخدم الذي أرسل الدعوة. عند القبول يُمرَّر بوصفه المستخدم الذي أضاف العضو الجديد (`CollaboratorsInviteHandler.mjs:199-205`). لا يُعيَّن في دعوة رابط المشاركة. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | المشروع الذي تخصه الدعوة. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | الوصول الذي يحصل عليه المدعو: `readOnly` أو `readAndWrite` أو `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). قد تحتوي دعوة رابط المشاركة أيضاً على `false`، أي بلا وصول. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | تعيّنه القيمة الافتراضية للمخطط عند حفظ الدعوة. | `ProjectInvite.mjs:26` |
| `expires` | Date | القيمة الافتراضية للمخطط: بعد 30 يوماً من الإنشاء. يزيل فهرس TTL الدعوة بعد نحو 10 ثوانٍ من هذا الوقت. `null` لدعوة رابط المشاركة، التي لا تنتهي صلاحيتها أبداً. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` لدعوة البريد، التي تُحذف عند قبولها (`CollaboratorsInviteHandler.mjs:207-220`). `true` لدعوة رابط المشاركة، التي تبقى. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | لدعوات رابط المشاركة فقط: الاشتراك الجماعي الذي يحق لأعضائه قبول الرابط (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

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

| الشيفرة | ما تفعله |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | تنشئ دعوة بريد، ثم ترسل البريد، وترسل إشعاراً للمستخدم الموجود. يستدعيها `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | تحذف دعوة واحدة وتعلّم إشعارها كمقروء. يستدعيها `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | إعادة الإرسال: تحذف الدعوة وتنشئ دعوة جديدة برمز جديد (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | تحذف الدعوة المرسلة إلى أحد عناوين البريد المؤكدة للمستخدم، عندما ينضم المستخدم عبر رمز مشاركة بالرابط (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) أو يُمنح الوصول بعد طلب وصول (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | تضيف المستخدم إلى المشروع، ثم تحذف الدعوة ما لم تكن `reusable`. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | تنشئ أو تحدّث دعوة رابط المشاركة الوحيدة القابلة لإعادة الاستخدام في المشروع. تتطلب هذه المسارات split test `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`)، وهو غير موجود في `splitTestOverrides` (`services/web/config/settings.defaults.js:1371-1383`). لذلك تجيب بالرمز 403 ما لم يُعدّ هذا الـ split test. |

#### من يقرأ منها

| الشيفرة | ما تفعله |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | تسرد دعوات البريد المعلّقة لمربع حوار المشاركة (`GET /project/:Project_id/invites`، `CollaboratorsRouter.mjs:127-132`). تتخطى الدعوات القابلة لإعادة الاستخدام. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | تعدّ دعوات البريد المعلّقة التي ليست `readOnly`. يضيفها `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` إلى المحررين عند التحقق من حد المتعاونين. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | تجد الدعوة بتجزئة الرمز الموجود في عنوان URL، لصفحة الدعوة وللقبول (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | تجد دعوة رابط المشاركة الخاصة بالمشروع. |

#### الفهارس

| الاسم | المفاتيح | الخيارات | الترحيل |
| - | - | - | - |
| `expires_1` | `{ expires: 1 }` | TTL، `expireAfterSeconds: 10` | `20190912145023_create_projectInvites_indexes.mjs` |
| `projectId_1` | `{ projectId: 1 }` | | `20190912145023_create_projectInvites_indexes.mjs` |
| `tokenHmac_1` | `{ tokenHmac: 1 }` | | `20240524135408_add_token_hmac_project_invite_tokens.mjs` |

الترحيلات موجودة في `tools/migrations/`. يعلن المخطط أيضاً فهرس TTL على `expires`، لكن `autoIndex` في Mongoose معطّل (`services/web/app/src/infrastructure/Mongoose.mjs:7`)، لذا ينشئه الترحيل.

#### ملاحظات

* إذا لم يبقَ في المشروع مكان شاغر لمحرر عند قبول دعوة `readAndWrite` أو `review`، ينضم المستخدم بصلاحية القراءة فقط ويُدرج في `pendingEditor_refs` أو `pendingReviewer_refs` الخاصة بالمشروع (`CollaboratorsInviteHandler.mjs:162-205`).
* كانت الدعوات الأقدم تخزّن الرمز الصريح في حقل `token`. أضاف الترحيل `20240524135408_add_token_hmac_project_invite_tokens.mjs` الحقل `tokenHmac`، وأزال `20240531082910_remove_project_invite_tokens.mjs` الحقل `token`.
* لا شيء يحذف دعوات مشروع محذوف؛ تبقى حتى يزيلها فهرس TTL.


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