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

`deletedUsers` bewahrt ein Benutzerkonto nach dem Löschen auf: ein Dokument pro gelöschtem Konto, mit einer Kopie des gesamten Benutzerdokuments und der Angabe, wer es gelöscht hat. Web schreibt die Collection in `services/web/app/src/Features/User/UserDeleter.mjs`; das Schema ist `services/web/app/src/models/DeletedUser.mjs`. Wenn die Frist bis zum endgültigen Löschen abgelaufen ist, entfernt der Ablauf die Kopie des Benutzers, der Eintrag mit `deleterData` bleibt aber bestehen.

Beim Löschen eines Benutzers werden auch die Projekte gelöscht, die ihm gehören; sie landen mit dem Grund `account-deletion` in [Deleted-Projects-Collection](https://ayakaleaf-pro.mintlify.site/de/dev/data-model/deleted-projects-collection.md).

#### Felder

| Feld | Typ | Bedeutung | Quelle |
| - | - | - | - |
| `_id` | ObjectId | ID des Eintrags, nicht die Benutzer-ID. | `DeletedUser.mjs:21` |
| `user` | Object | Kopie des `users`-Dokuments zum Zeitpunkt des Löschens, mit dem Benutzerschema, siehe [Users-Collection](https://ayakaleaf-pro.mintlify.site/de/dev/data-model/users-collection.md). Wird beim Ablauf entfernt. | `DeletedUser.mjs:24`, `UserDeleter.mjs:192-196,104,106` |
| `deleterData` | Object | Wer das Konto gelöscht hat, und eine Zusammenfassung, die nach dem Ablauf erhalten bleibt. | `DeletedUser.mjs:7-19,23` |
| `deleterData.deletedAt` | Date | Zeitpunkt des Löschens. Der Ablauf erfolgt `userHardDeletionDelay` danach: 90 Tage oder `OVERLEAF_USER_HARD_DELETION_DELAY` Millisekunden (`services/web/config/settings.defaults.js:739-741`). | `DeletedUser.mjs:10`, `UserDeleter.mjs:198` |
| `deleterData.deleterId` | ObjectId | Benutzer, der das Konto gelöscht hat: der Benutzer selbst auf der Seite mit den Kontoeinstellungen oder der Admin im Admin-Panel. Fehlt, wenn das Skript `delete-user` es gelöscht hat. | `DeletedUser.mjs:8`, `UserDeleter.mjs:199` |
| `deleterData.deleterIpAddress` | String | IP-Adresse dieser Anfrage; `0.0.0.0` beim Skript `delete-user` (`services/web/modules/server-ce-scripts/scripts/delete-user.mjs:40-44`). Wird beim Ablauf entfernt. | `DeletedUser.mjs:9`, `UserDeleter.mjs:200,105` |
| `deleterData.deletedUserId` | ObjectId | `_id` des gelöschten Benutzers. Der Kern sucht Einträge darüber. | `DeletedUser.mjs:11`, `UserDeleter.mjs:201` |
| `deleterData.deletedUserLastLoggedIn` | Date | `lastLoggedIn` des Benutzers. | `DeletedUser.mjs:12`, `UserDeleter.mjs:202` |
| `deleterData.deletedUserSignUpDate` | Date | `signUpDate` des Benutzers. | `DeletedUser.mjs:13`, `UserDeleter.mjs:203` |
| `deleterData.deletedUserLoginCount` | Number | `loginCount` des Benutzers. | `DeletedUser.mjs:14`, `UserDeleter.mjs:204` |
| `deleterData.deletedUserReferralId` | String | `referal_id` des Benutzers. | `DeletedUser.mjs:15`, `UserDeleter.mjs:205` |
| `deleterData.deletedUserReferredUsers` | Array of ObjectId | `refered_users` des Benutzers. | `DeletedUser.mjs:16`, `UserDeleter.mjs:206` |
| `deleterData.deletedUserReferredUserCount` | Number | `refered_user_count` des Benutzers. | `DeletedUser.mjs:17`, `UserDeleter.mjs:207` |
| `deleterData.deletedUserOverleafId` | Number | `overleaf.id` des Benutzers, falls gesetzt. | `DeletedUser.mjs:18`, `UserDeleter.mjs:208` |

#### Wer schreibt

| Code | Funktion |
| - | - |
| `UserDeleter.mjs:37-80` (`deleteUser`) | Fügt einen Audit-Log-Eintrag `delete-account` hinzu, räumt den Benutzer auf und löst den Hook `deleteUser` aus, legt den Eintrag per Upsert an (`_createDeletedUser`, `UserDeleter.mjs:192-213`), löscht die Projekte des Benutzers, sendet die Sicherheitswarnung per E-Mail, sofern nicht übersprungen, und löscht das `users`-Dokument. Aufrufer: die Seite mit den Kontoeinstellungen (`services/web/app/src/Features/User/UserController.mjs:280-284`), das Admin-Panel (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:604-612`) und das Skript `delete-user` (`delete-user.mjs:40-45`). |
| `UserDeleter.mjs:93-115` (`expireDeletedUser`) | Löst den Hook `expireDeletedUser` aus, löscht die Onboarding-Daten des Benutzers und entfernt dann `user` und `deleterData.deleterIpAddress`. |
| `UserDeleter.mjs:117-161` (`expireDeletedUsersAfterDuration`) | Lässt jeden Eintrag ablaufen, der älter als die Frist ist, und löscht die `userAuditLogEntries` des Benutzers. Route `POST /internal/expire-deleted-users-after-duration` (`services/web/app/src/router.mjs:847-851`), die der Cron der Community Edition stündlich zur Minute 15 aufruft, wenn `ENABLE_CRON_RESOURCE_DELETION` `true` ist (`server-ce/cron/delete-users.sh:10-23`, `server-ce/config/crontab-deletion:2`). Ein einzelner Benutzer: `POST /internal/users/:userId/expire` (`router.mjs:857-861`). |
| `AdminUserManager.mjs:630-649` (`purgeDeletedUser`, Modul `admin-tools`) | Purge im Admin-Panel: führt `expireDeletedUser` aus und löscht die Audit-Log-Einträge des Benutzers. |
| `AdminUserManager.mjs:651-696` (`restoreDeletedUser`, Modul `admin-tools`) | Wiederherstellen im Admin-Panel: legt das `users`-Dokument aus `user` neu an (abgelehnt, wenn die E-Mail-Adresse vergeben ist), löscht den Eintrag und stellt die zusammen mit dem Konto gelöschten Projekte wieder her. |

#### Wer liest

| Code | Funktion |
| - | - |
| `services/web/modules/admin-tools/app/src/AdminUserListManager.mjs:195-213,263-275` | Listet und zählt gelöschte Benutzer für das Admin-Panel, gefiltert nach `user.*`. |
| `AdminUserListManager.mjs:428-452` | Zeigt einen gelöschten, noch nicht abgelaufenen Benutzer mit dem löschenden Benutzer an. |
| `AdminUserListManager.mjs:456-480` | Nennt den Eigentümer einer Zeile in anderen Admin-Listen, auch wenn der Eigentümer gelöscht ist. |
| `AdminUserListManager.mjs:175-183` | Sammelt die IDs der Login-Anbieter, auch von gelöschten Benutzern. |
| `AdminUserManager.mjs:623-627,631-634,652` | Liest den Eintrag, wenn ein Admin einen Benutzer löscht, endgültig entfernt oder wiederherstellt; diese Stellen suchen ihn über `user._id`. |

#### Indizes

| Name | Schlüssel | Optionen | Migration |
| - | - | - | - |
| `deleterData.deleteUserId_1` | `{ "deleterData.deletedUserId": 1 }` | unique | `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterData_deletedAt_user_1` | `{ "deleterData.deletedAt": 1 }` | partiell: `user` ist ein Objekt | `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 }` | partiell: `user.emails.email` existiert | `20250321112055_create_deletedUsers_email_indexes.mjs` |

Die Migrationen liegen in `tools/migrations/`. Der Indexname lautet `deleteUserId`, der Schlüssel aber `deletedUserId`.

#### Hinweise

* Module, die auf `expireDeletedUser` hören, löschen ihre eigenen Daten des Benutzers: `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`) und `gitea-sync` (`services/web/modules/gitea-sync/index.mjs:56`).
* Ein abgelaufener Eintrag wird nie gelöscht: `deleterData` bleibt dauerhaft erhalten, nur `user` und die IP-Adresse werden entfernt.
* Die persönlichen Zugriffstoken des Benutzers werden nicht mit dem Konto gelöscht, siehe [OAuth-Access-Tokens-Collection](https://ayakaleaf-pro.mintlify.site/de/dev/data-model/oauth-access-tokens-collection.md).
* Mongoose gibt `deleterData` außerdem eine eigene `_id`, die nichts liest.


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