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

# Coleção Deleted Users

`deletedUsers` mantém uma conta de usuário depois que ela é excluída: um documento por conta excluída, com uma cópia do documento completo do usuário e quem a excluiu. O web a escreve em `services/web/app/src/Features/User/UserDeleter.mjs`; o esquema é `services/web/app/src/models/DeletedUser.mjs`. Quando o prazo de exclusão definitiva termina, a expiração remove a cópia do usuário, mas o registro com `deleterData` permanece.

Excluir um usuário também exclui os projetos que ele possui; eles vão para [Coleção Deleted Projects](https://ayakaleaf-pro.mintlify.site/pt/dev/data-model/deleted-projects-collection.md) com o motivo `account-deletion`.

#### Campos

| Campo | Tipo | Significado | Origem |
| - | - | - | - |
| `_id` | ObjectId | Id do registro, não o id do usuário. | `DeletedUser.mjs:21` |
| `user` | Object | Cópia do documento de `users` no momento da exclusão, com o esquema de usuário, veja [Coleção Users](https://ayakaleaf-pro.mintlify.site/pt/dev/data-model/users-collection.md). Removida na expiração. | `DeletedUser.mjs:24`, `UserDeleter.mjs:192-196,104,106` |
| `deleterData` | Object | Quem excluiu a conta e um resumo que permanece após a expiração. | `DeletedUser.mjs:7-19,23` |
| `deleterData.deletedAt` | Date | Momento da exclusão. A expiração ocorre `userHardDeletionDelay` depois: 90 dias, ou `OVERLEAF_USER_HARD_DELETION_DELAY` milissegundos (`services/web/config/settings.defaults.js:739-741`). | `DeletedUser.mjs:10`, `UserDeleter.mjs:198` |
| `deleterData.deleterId` | ObjectId | Usuário que excluiu a conta: o próprio usuário na página de configurações da conta, ou o admin no painel de administração. Ausente quando o script `delete-user` a excluiu. | `DeletedUser.mjs:8`, `UserDeleter.mjs:199` |
| `deleterData.deleterIpAddress` | String | Endereço IP dessa requisição; `0.0.0.0` a partir do script `delete-user` (`services/web/modules/server-ce-scripts/scripts/delete-user.mjs:40-44`). Removido na expiração. | `DeletedUser.mjs:9`, `UserDeleter.mjs:200,105` |
| `deleterData.deletedUserId` | ObjectId | `_id` do usuário excluído. O núcleo busca os registros por ele. | `DeletedUser.mjs:11`, `UserDeleter.mjs:201` |
| `deleterData.deletedUserLastLoggedIn` | Date | `lastLoggedIn` do usuário. | `DeletedUser.mjs:12`, `UserDeleter.mjs:202` |
| `deleterData.deletedUserSignUpDate` | Date | `signUpDate` do usuário. | `DeletedUser.mjs:13`, `UserDeleter.mjs:203` |
| `deleterData.deletedUserLoginCount` | Number | `loginCount` do usuário. | `DeletedUser.mjs:14`, `UserDeleter.mjs:204` |
| `deleterData.deletedUserReferralId` | String | `referal_id` do usuário. | `DeletedUser.mjs:15`, `UserDeleter.mjs:205` |
| `deleterData.deletedUserReferredUsers` | Array of ObjectId | `refered_users` do usuário. | `DeletedUser.mjs:16`, `UserDeleter.mjs:206` |
| `deleterData.deletedUserReferredUserCount` | Number | `refered_user_count` do usuário. | `DeletedUser.mjs:17`, `UserDeleter.mjs:207` |
| `deleterData.deletedUserOverleafId` | Number | `overleaf.id` do usuário, quando definido. | `DeletedUser.mjs:18`, `UserDeleter.mjs:208` |

#### Quem escreve

| Código | O que faz |
| - | - |
| `UserDeleter.mjs:37-80` (`deleteUser`) | Adiciona uma entrada de log de auditoria `delete-account`, limpa o usuário e dispara o hook `deleteUser`, faz o upsert do registro (`_createDeletedUser`, `UserDeleter.mjs:192-213`), exclui os projetos do usuário, envia o e-mail de alerta de segurança, a menos que seja ignorado, e exclui o documento de `users`. Chamadores: a página de configurações da conta (`services/web/app/src/Features/User/UserController.mjs:280-284`), o painel de administração (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:604-612`) e o script `delete-user` (`delete-user.mjs:40-45`). |
| `UserDeleter.mjs:93-115` (`expireDeletedUser`) | Dispara o hook `expireDeletedUser`, exclui os dados de onboarding do usuário e então remove `user` e `deleterData.deleterIpAddress`. |
| `UserDeleter.mjs:117-161` (`expireDeletedUsersAfterDuration`) | Faz expirar todo registro mais antigo que o prazo e exclui as `userAuditLogEntries` do usuário. Rota `POST /internal/expire-deleted-users-after-duration` (`services/web/app/src/router.mjs:847-851`), que o cron da Community Edition chama a cada hora no minuto 15 quando `ENABLE_CRON_RESOURCE_DELETION` é `true` (`server-ce/cron/delete-users.sh:10-23`, `server-ce/config/crontab-deletion:2`). Um único usuário: `POST /internal/users/:userId/expire` (`router.mjs:857-861`). |
| `AdminUserManager.mjs:630-649` (`purgeDeletedUser`, módulo `admin-tools`) | Purge no painel de administração: executa `expireDeletedUser` e exclui as entradas do log de auditoria do usuário. |
| `AdminUserManager.mjs:651-696` (`restoreDeletedUser`, módulo `admin-tools`) | Restaurar no painel de administração: cria novamente o documento de `users` a partir de `user` (recusado se o e-mail estiver em uso), exclui o registro e restaura os projetos excluídos com a conta. |

#### Quem lê

| Código | O que faz |
| - | - |
| `services/web/modules/admin-tools/app/src/AdminUserListManager.mjs:195-213,263-275` | Lista e conta os usuários excluídos para o painel de administração, filtrando por `user.*`. |
| `AdminUserListManager.mjs:428-452` | Mostra um usuário excluído que não expirou, com quem o excluiu. |
| `AdminUserListManager.mjs:456-480` | Nomeia o proprietário de uma linha em outras listas de administração, também quando o proprietário foi excluído. |
| `AdminUserListManager.mjs:175-183` | Coleta os ids de provedores de login, inclusive de usuários excluídos. |
| `AdminUserManager.mjs:623-627,631-634,652` | Lê o registro quando um admin exclui, purga ou restaura um usuário; esses trechos o buscam por `user._id`. |

#### Índices

| Nome | Chaves | Opções | Migração |
| - | - | - | - |
| `deleterData.deleteUserId_1` | `{ "deleterData.deletedUserId": 1 }` | unique | `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterData_deletedAt_user_1` | `{ "deleterData.deletedAt": 1 }` | parcial: `user` é um objeto | `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 }` | parcial: `user.emails.email` existe | `20250321112055_create_deletedUsers_email_indexes.mjs` |

As migrações ficam em `tools/migrations/`. O nome do índice diz `deleteUserId`, mas a chave é `deletedUserId`.

#### Notas

* Os módulos que escutam `expireDeletedUser` excluem seus próprios dados do usuário: `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`) e `gitea-sync` (`services/web/modules/gitea-sync/index.mjs:56`).
* Um registro expirado nunca é excluído: `deleterData` permanece para sempre, apenas `user` e o endereço IP são removidos.
* Os tokens de acesso pessoal do usuário não são excluídos com a conta, veja [Coleção OAuth Access Tokens](https://ayakaleaf-pro.mintlify.site/pt/dev/data-model/oauth-access-tokens-collection.md).
* O Mongoose também dá a `deleterData` seu próprio `_id`, que nada lê.


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