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

تحتفظ `deletedProjects` بالمشروع بعد حذفه: مستند واحد لكل مشروع محذوف، يتضمن نسخة من مستند المشروع بالكامل ومن حذفه. يكتبها web في `services/web/app/src/Features/Project/ProjectDeleter.mjs`؛ والمخطط هو `services/web/app/src/models/DeletedProject.mjs`. عند انقضاء مهلة الحذف النهائي، تُتلف عملية الانتهاء بيانات المشروع وتُفرغ `project`، لكن السجل الذي يحتوي على `deleterData` يبقى.

المشروع الموجود في سلة المهملات ليس هنا: النقل إلى سلة المهملات يضيف المستخدم فقط إلى `trashed` الخاص بالمشروع، راجع [مجموعة المشاريع (Projects)](https://ayakaleaf-pro.mintlify.site/ar/dev/data-model/projects-collection.md).

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | معرّف السجل، وليس معرّف المشروع. | `DeletedProject.mjs:26` |
| `project` | Object | نسخة من مستند `projects` وقت الحذف، بمخطط المشروع. تصبح `null` بعد انتهاء السجل. | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | من حذف المشروع، وملخص يبقى بعد الانتهاء. تُحذف المفاتيح التي قيمتها `undefined`. | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | وقت الحذف. يجري الانتهاء بعده بمقدار `projectHardDeletionDelay`: ‏90 يومًا، أو `OVERLEAF_PROJECT_HARD_DELETION_DELAY` ميلي ثانية (`services/web/config/settings.defaults.js:742-744`). | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | المستخدم الذي حذف المشروع. يغيب عندما لا يكون أي مستخدم قد حذفه مباشرة، راجع `deletedReason`. | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | عنوان IP لذلك الطلب. يُضبط على `null` عند الانتهاء. | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | سبب حذف المشروع، راجع الجدول أدناه. لا يوجد في السجلات القديمة. | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | ‏`_id` المشروع المحذوف. تستخدمه عمليات البحث عن سجل واحد. | `DeletedProject.mjs:11`, `ProjectDeleter.mjs:253` |
| `deleterData.deletedProjectOwnerId` | ObjectId | ‏`owner_ref` الخاص بالمشروع. | `DeletedProject.mjs:12`, `ProjectDeleter.mjs:254` |
| `deleterData.deletedProjectCollaboratorIds` | Array of ObjectId | ‏`collaberator_refs` الخاص بالمشروع. | `DeletedProject.mjs:13`, `ProjectDeleter.mjs:255` |
| `deleterData.deletedProjectReadOnlyIds` | Array of ObjectId | ‏`readOnly_refs` الخاص بالمشروع. | `DeletedProject.mjs:14`, `ProjectDeleter.mjs:256` |
| `deleterData.deletedProjectReviewerIds` | Array of ObjectId | ‏`reviewer_refs` الخاص بالمشروع. | `DeletedProject.mjs:15`, `ProjectDeleter.mjs:257` |
| `deleterData.deletedProjectReadWriteTokenAccessIds` | Array of ObjectId | ‏`tokenAccessReadAndWrite_refs` الخاص بالمشروع. | `DeletedProject.mjs:16`, `ProjectDeleter.mjs:258-259` |
| `deleterData.deletedProjectReadOnlyTokenAccessIds` | Array of ObjectId | ‏`tokenAccessReadOnly_refs` الخاص بالمشروع. | `DeletedProject.mjs:17`, `ProjectDeleter.mjs:267` |
| `deleterData.deletedProjectReadWriteToken` | String | ‏`tokens.readAndWrite` الخاص بالمشروع، إن وُجد. | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | ‏`tokens.readOnly` الخاص بالمشروع، إن وُجد. | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | ‏`lastUpdated` الخاص بالمشروع. | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | ‏`overleaf.id` الخاص بالمشروع، إن كان مضبوطًا. | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | ‏`overleaf.history.id` الخاص بالمشروع، إن كان مضبوطًا. | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

قيم `deletedReason` ‏(`services/web/app/src/Features/Project/DeletedProjectReasons.mjs:1-8`):

| القيمة | تُضبط عندما | `deleterId` |
| - | - | - |
| `user` | يحذف مستخدم المشروع من قائمة المشاريع (`services/web/app/src/Features/Project/ProjectController.mjs:281-291`)، أو يحذفه مسؤول في لوحة الإدارة (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`) | موجود |
| `account-deletion` | يُحذف حساب المالك (`ProjectDeleter.mjs:82-95`، ويُستدعى من `services/web/app/src/Features/User/UserDeleter.mjs:66`) | غائب |
| `zip-import-failure` | يفشل إنشاء مشروع من ملف zip مرفوع (`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`) | غائب |
| `clone-failure` | يفشل نسخ مشروع؛ وتُحذف النسخة التالفة (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`) | غائب |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | غائب |
| `github-import-failure` | معرَّف، لكن لا شيء في هذا المستودع يستخدمه | |

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

| الشيفرة | ما تفعله |
| - | - |
| `ProjectDeleter.mjs:189-293` (`deleteProject`) | تُجري flush للمشروع، وتؤرشف مستندات docs الخاصة به خارج Mongo، وتزيله من الوسوم، وتُجري upsert للسجل، وتحذف مستند `projects`. |
| `ProjectDeleter.mjs:295-342` (`undeleteProject`) | تُدرج المشروع مجددًا باسم `<name> (Restored)` (فريد للمالك) وغير مؤرشف، ثم تحذف السجل. تفشل بالخطأ `project_too_old_to_restore` بمجرد أن يصبح `project` مساويًا لـ `null`. تُستدعى من لوحة الإدارة: استعادة مشروع واحد (`AdminProjectManager.mjs:497-515`) أو استعادة مستخدم محذوف مع المشاريع التي حُذفت مع حسابه (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`). |
| `ProjectDeleter.mjs:344-416` (`expireDeletedProject`) | تُتلف مستندات docs والسجل التاريخي والدردشة وسجل تدقيق المشروع، وتُطلق الخطّاف `projectExpired`، ثم تضبط `project` و`deleterData.deleterIpAddress` على `null`. إذا عاد المشروع إلى الوجود، تحذف السجل القديم فقط. |
| `ProjectDeleter.mjs:97-146` (`expireDeletedProjectsAfterDuration`) | تُنهي دفعة من السجلات الأقدم من المهلة. المسار `POST /internal/expire-deleted-projects-after-duration` ‏(`services/web/app/src/router.mjs:842-846`)، الذي يستدعيه cron في Community Edition كل ساعة عند الدقيقة 20 عندما تكون `ENABLE_CRON_RESOURCE_DELETION` مساوية لـ `true` ‏(`server-ce/cron/delete-projects.sh:10-23`, `server-ce/config/crontab-deletion:3`). لمشروع واحد: `POST /internal/project/:projectId/expire-deleted-project` ‏(`router.mjs:852-856`)، أو Purge في لوحة الإدارة (`AdminProjectManager.mjs:517-529`). |

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

| الشيفرة | ما تفعله |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272` (الوحدة `admin-tools`) | تعرض المشاريع المحذوفة التي لم تنتهِ بعد. |
| `AdminProjectManager.mjs:418-454` | تعرض مشروعًا محذوفًا واحدًا مع مالكه ومن حذفه. |
| `AdminProjectManager.mjs:178-191` | تعثر على المشاريع عبر رمز مشاركة الرابط، بما فيها المحذوفة (`project.tokens.*`). |
| `AdminUserManager.mjs:678-684` | تعثر على المشاريع التي تُستعاد مع مستخدم مُستعاد: يملكها المستخدم وحُذفت بالسبب `account-deletion` أو بلا سبب. |

#### الفهارس

| الاسم | المفاتيح | الخيارات | الترحيل |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`، وجعله `20200210121103_uniqueify-deletedthings-indexes.mjs` فريدًا |
| `deleterdata_deletedProjectOwnerId_1` | `{ "deleterData.deletedProjectOwnerId": 1 }` | | `20200120163346_atlas_recommended_indexes.mjs` |
| `deleterData.deletedAt_1` | `{ "deleterData.deletedAt": 1 }` | جزئي: `project` كائن | `20250126195914_update_deleterData.deletedAt_index.mjs` (يحل محل الفهرس العادي من `20190912145002_create_deletedProjects_indexes.mjs`) |

توجد عمليات الترحيل في `tools/migrations/`.

#### ملاحظات

* تحذف الوحدات التي تستمع إلى `projectExpired` بياناتها الخاصة بالمشروع: `git-bridge` ‏(`services/web/modules/git-bridge/index.mjs:37`)، و`github-sync` ‏(`services/web/modules/github-sync/index.mjs:56`)، و`gitlab-sync` ‏(`services/web/modules/gitlab-sync/index.mjs:46`)، و`gitea-sync` ‏(`services/web/modules/gitea-sync/index.mjs:46`)، و`dropbox` ‏(`services/web/modules/dropbox/index.mjs:54`).
* لا يُحذف السجل المنتهي أبدًا: يبقى `deleterData` إلى الأبد، ولا يُفرَّغ إلا `project` وعنوان IP.
* يمنح Mongoose أيضًا `deleterData` معرّف `_id` خاصًا به، ولا يقرؤه شيء.


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