> ## 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/uk/dev/data-model/projects-collection.md).

#### Поля

| Поле | Тип | Значення | Джерело |
| - | - | - | - |
| `_id` | ObjectId | Id запису, а не id проєкту. | `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`) | Скидає проєкт на диск, архівує його 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.