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

# مجموعة Deleted Users

تحتفظ `deletedUsers` بحساب المستخدم بعد حذفه: مستند واحد لكل حساب محذوف، يتضمن نسخة من مستند المستخدم بالكامل ومن حذفه. يكتبها web في `services/web/app/src/Features/User/UserDeleter.mjs`؛ والمخطط هو `services/web/app/src/models/DeletedUser.mjs`. عند انقضاء مهلة الحذف النهائي، تزيل عملية الانتهاء نسخة المستخدم، لكن السجل الذي يحتوي على `deleterData` يبقى.

حذف المستخدم يحذف أيضًا المشاريع التي يملكها؛ فتنتقل إلى [مجموعة Deleted Projects](https://ayakaleaf-pro.mintlify.site/ar/dev/data-model/deleted-projects-collection.md) بالسبب `account-deletion`.

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | معرّف السجل، وليس معرّف المستخدم. | `DeletedUser.mjs:21` |
| `user` | Object | نسخة من مستند `users` وقت الحذف، بمخطط المستخدم، راجع [مجموعة المستخدمين (Users)](https://ayakaleaf-pro.mintlify.site/ar/dev/data-model/users-collection.md). تُزال عند الانتهاء. | `DeletedUser.mjs:24`, `UserDeleter.mjs:192-196,104,106` |
| `deleterData` | Object | من حذف الحساب، وملخص يبقى بعد الانتهاء. | `DeletedUser.mjs:7-19,23` |
| `deleterData.deletedAt` | Date | وقت الحذف. يجري الانتهاء بعده بمقدار `userHardDeletionDelay`: ‏90 يومًا، أو `OVERLEAF_USER_HARD_DELETION_DELAY` ميلي ثانية (`services/web/config/settings.defaults.js:739-741`). | `DeletedUser.mjs:10`, `UserDeleter.mjs:198` |
| `deleterData.deleterId` | ObjectId | المستخدم الذي حذف الحساب: المستخدم نفسه في صفحة إعدادات الحساب، أو المسؤول في لوحة الإدارة. يغيب عندما يكون السكربت `delete-user` هو من حذفه. | `DeletedUser.mjs:8`, `UserDeleter.mjs:199` |
| `deleterData.deleterIpAddress` | String | عنوان IP لذلك الطلب؛ ‏`0.0.0.0` من السكربت `delete-user` ‏(`services/web/modules/server-ce-scripts/scripts/delete-user.mjs:40-44`). يُزال عند الانتهاء. | `DeletedUser.mjs:9`, `UserDeleter.mjs:200,105` |
| `deleterData.deletedUserId` | ObjectId | ‏`_id` المستخدم المحذوف. تبحث النواة عن السجلات به. | `DeletedUser.mjs:11`, `UserDeleter.mjs:201` |
| `deleterData.deletedUserLastLoggedIn` | Date | ‏`lastLoggedIn` الخاص بالمستخدم. | `DeletedUser.mjs:12`, `UserDeleter.mjs:202` |
| `deleterData.deletedUserSignUpDate` | Date | ‏`signUpDate` الخاص بالمستخدم. | `DeletedUser.mjs:13`, `UserDeleter.mjs:203` |
| `deleterData.deletedUserLoginCount` | Number | ‏`loginCount` الخاص بالمستخدم. | `DeletedUser.mjs:14`, `UserDeleter.mjs:204` |
| `deleterData.deletedUserReferralId` | String | ‏`referal_id` الخاص بالمستخدم. | `DeletedUser.mjs:15`, `UserDeleter.mjs:205` |
| `deleterData.deletedUserReferredUsers` | Array of ObjectId | ‏`refered_users` الخاص بالمستخدم. | `DeletedUser.mjs:16`, `UserDeleter.mjs:206` |
| `deleterData.deletedUserReferredUserCount` | Number | ‏`refered_user_count` الخاص بالمستخدم. | `DeletedUser.mjs:17`, `UserDeleter.mjs:207` |
| `deleterData.deletedUserOverleafId` | Number | ‏`overleaf.id` الخاص بالمستخدم، إن كان مضبوطًا. | `DeletedUser.mjs:18`, `UserDeleter.mjs:208` |

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

| الشيفرة | ما تفعله |
| - | - |
| `UserDeleter.mjs:37-80` (`deleteUser`) | تضيف إدخال سجل تدقيق `delete-account`، وتنظّف بيانات المستخدم وتُطلق الخطّاف `deleteUser`، وتُجري upsert للسجل (`_createDeletedUser`، ‏`UserDeleter.mjs:192-213`)، وتحذف مشاريع المستخدم، وترسل بريد التنبيه الأمني ما لم يُتخطَّ، وتحذف مستند `users`. الجهات المستدعية: صفحة إعدادات الحساب (`services/web/app/src/Features/User/UserController.mjs:280-284`)، ولوحة الإدارة (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:604-612`)، والسكربت `delete-user` ‏(`delete-user.mjs:40-45`). |
| `UserDeleter.mjs:93-115` (`expireDeletedUser`) | تُطلق الخطّاف `expireDeletedUser`، وتحذف بيانات التهيئة الأولى للمستخدم، ثم تزيل `user` و`deleterData.deleterIpAddress`. |
| `UserDeleter.mjs:117-161` (`expireDeletedUsersAfterDuration`) | تُنهي كل سجل أقدم من المهلة وتحذف `userAuditLogEntries` الخاصة بالمستخدم. المسار `POST /internal/expire-deleted-users-after-duration` ‏(`services/web/app/src/router.mjs:847-851`)، الذي يستدعيه cron في Community Edition كل ساعة عند الدقيقة 15 عندما تكون `ENABLE_CRON_RESOURCE_DELETION` مساوية لـ `true` ‏(`server-ce/cron/delete-users.sh:10-23`, `server-ce/config/crontab-deletion:2`). لمستخدم واحد: `POST /internal/users/:userId/expire` ‏(`router.mjs:857-861`). |
| `AdminUserManager.mjs:630-649` (`purgeDeletedUser`، الوحدة `admin-tools`) | ‏Purge في لوحة الإدارة: تشغّل `expireDeletedUser` وتحذف إدخالات سجل تدقيق المستخدم. |
| `AdminUserManager.mjs:651-696` (`restoreDeletedUser`، الوحدة `admin-tools`) | الاستعادة في لوحة الإدارة: تعيد إنشاء مستند `users` من `user` (وتُرفض إذا كان البريد مستخدمًا)، وتحذف السجل، وتستعيد المشاريع التي حُذفت مع الحساب. |

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

| الشيفرة | ما تفعله |
| - | - |
| `services/web/modules/admin-tools/app/src/AdminUserListManager.mjs:195-213,263-275` | تعرض المستخدمين المحذوفين وتحصيهم للوحة الإدارة، مع التصفية حسب `user.*`. |
| `AdminUserListManager.mjs:428-452` | تعرض مستخدمًا محذوفًا واحدًا لم ينتهِ، مع من حذفه. |
| `AdminUserListManager.mjs:456-480` | تذكر مالك الصف في قوائم الإدارة الأخرى، حتى عندما يكون المالك محذوفًا. |
| `AdminUserListManager.mjs:175-183` | تجمع معرّفات موفري تسجيل الدخول، ومنها معرّفات المستخدمين المحذوفين. |
| `AdminUserManager.mjs:623-627,631-634,652` | تقرأ السجل عندما يحذف مسؤول مستخدمًا أو يُطهّره أو يستعيده؛ وتبحث عنه عبر `user._id`. |

#### الفهارس

| الاسم | المفاتيح | الخيارات | الترحيل |
| - | - | - | - |
| `deleterData.deleteUserId_1` | `{ "deleterData.deletedUserId": 1 }` | unique | `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterData_deletedAt_user_1` | `{ "deleterData.deletedAt": 1 }` | جزئي: `user` كائن | `20250116090001_deletedUsers_non_expired_index.mjs` |
| `user.email_1` | `{ "user.email": 1 }` | | `20250321112055_create_deletedUsers_email_indexes.mjs` |
| `user.emails.email_1` | `{ "user.emails.email": 1 }` | جزئي: `user.emails.email` موجود | `20250321112055_create_deletedUsers_email_indexes.mjs` |

توجد عمليات الترحيل في `tools/migrations/`. يقول اسم الفهرس `deleteUserId`، لكن المفتاح هو `deletedUserId`.

#### ملاحظات

* تحذف الوحدات التي تستمع إلى `expireDeletedUser` بياناتها الخاصة بالمستخدم: `dropbox` ‏(`services/web/modules/dropbox/index.mjs:62`)، و`github-sync` ‏(`services/web/modules/github-sync/index.mjs:66`)، و`gitlab-sync` ‏(`services/web/modules/gitlab-sync/index.mjs:56`)، و`gitea-sync` ‏(`services/web/modules/gitea-sync/index.mjs:56`).
* لا يُحذف السجل المنتهي أبدًا: يبقى `deleterData` إلى الأبد، ولا يُزال إلا `user` وعنوان IP.
* لا تُحذف رموز الوصول الشخصية للمستخدم مع الحساب، راجع [مجموعة OAuth Access Tokens](https://ayakaleaf-pro.mintlify.site/ar/dev/data-model/oauth-access-tokens-collection.md).
* يمنح Mongoose أيضًا `deleterData` معرّف `_id` خاصًا به، ولا يقرؤه شيء.


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