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