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

# مجموعة جهات الاتصال (Contacts)

`contacts` تتذكر المستخدمين الذين عمل معهم المستخدم، كي يقترحهم مربع حوار المشاركة. مستند واحد لكل مستخدم. المالك هو `web`، دون مخطط Mongoose؛ والشيفرة هي `services/web/app/src/Features/Contacts/ContactManager.mjs`.

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | معرّف المستند، تنشئه عملية upsert. | `ContactManager.mjs:5-12` |
| `user_id` | ObjectId | المستخدم صاحب جهات الاتصال هذه. مستند واحد لكل مستخدم. | `ContactManager.mjs:6` |
| `contacts` | Object | خريطة مفاتيحها معرّف مستخدم جهة الاتصال (كسلسلة نصية). | `ContactManager.mjs:8-9` |
| `contacts.<userId>.n` | Number | عدد المرات التي جُمع فيها المستخدمان معًا. | `ContactManager.mjs:8` |
| `contacts.<userId>.ts` | Date | آخر مرة حدث فيها ذلك. | `ContactManager.mjs:9` |

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

| الشيفرة | ما الذي تفعله |
| - | - |
| `ContactManager.mjs:4-13` (`touchContact`), `:23-28` (`addContact`) | تُجري upsert لمستندَي المستخدمين كليهما: `$inc` على `n` و`$set` لـ `ts`. |
| `services/web/app/src/Features/Collaborators/CollaboratorsHandler.mjs:155-157` | تستدعي `addUserIdToProject` الدالة `addContact` عندما يُمرَّر إليها المستخدم الذي يضيف: عند قبول دعوة (الداعي والمدعو، `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:199-205`) وعند نقل الملكية (المالك الجديد والسابق، `services/web/app/src/Features/Collaborators/OwnershipTransferHandler.mjs:138-144`). الانضمام عبر رابط مشاركة لا يمرّر مستخدمًا مضيفًا (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:386-388`، `:632-634`)، لذا لا يضيف جهة اتصال. |

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

| الشيفرة | ما الذي تفعله |
| - | - |
| `ContactManager.mjs:15-21`, `:30-42` | `getContactIds`: ترتّب حسب `n` ثم حسب `ts`، كلاهما من الأعلى إلى الأدنى. |
| `services/web/app/src/Features/Contacts/ContactController.mjs:19-59` | `GET /user/contacts` (`services/web/app/src/Features/Contacts/ContactRouter.mjs:22-26`): تُعيد أول 50 كمستخدمين، دون الحسابات المؤقتة، بالإضافة إلى ما تضيفه الوحدات عبر الخطاف `getContacts`. |

#### الفهارس

| الاسم | المفاتيح | الخيارات | الترحيل |
| - | - | - | - |
| `user_id_1` | `{ user_id: 1 }` | unique | `tools/migrations/20190912145001_create_contacts_indexes.mjs` |

#### ملاحظات

* جهات الاتصال متبادلة: إضافة B إلى مشروع A تجعل B جهة اتصال لـ A وتجعل A جهة اتصال لـ B.
* لا شيء يزيل جهة اتصال أو المستند، ولا حتى حذف المستخدم.


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