> ## 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/uk/dev/data-model/deleted-projects-collection.md) з причиною `account-deletion`.

#### Поля

| Поле | Тип | Значення | Джерело |
| - | - | - | - |
| `_id` | ObjectId | Id запису, а не id користувача. | `DeletedUser.mjs:21` |
| `user` | Object | Копія документа `users` на момент видалення зі схемою користувача, див. [Колекція Users](https://ayakaleaf-pro.mintlify.site/uk/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` | Збирає id постачальників входу, зокрема видалених користувачів. |
| `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/uk/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.