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

# Collezione Deleted Users

`deletedUsers` conserva un account utente dopo la sua eliminazione: un documento per ogni account eliminato, con una copia dell’intero documento utente e chi lo ha eliminato. Web la scrive in `services/web/app/src/Features/User/UserDeleter.mjs`; lo schema è `services/web/app/src/models/DeletedUser.mjs`. Trascorso il ritardo di eliminazione definitiva, la scadenza rimuove la copia dell’utente, ma il record con `deleterData` rimane.

L’eliminazione di un utente elimina anche i progetti di sua proprietà; finiscono in [Collezione Deleted Projects](https://ayakaleaf-pro.mintlify.site/it/dev/data-model/deleted-projects-collection.md) con il motivo `account-deletion`.

#### Campi

| Campo | Tipo | Significato | Fonte |
| - | - | - | - |
| `_id` | ObjectId | Id del record, non l’id dell’utente. | `DeletedUser.mjs:21` |
| `user` | Object | Copia del documento `users` al momento dell’eliminazione, con lo schema utente, vedi [Collezione Users](https://ayakaleaf-pro.mintlify.site/it/dev/data-model/users-collection.md). Rimossa alla scadenza. | `DeletedUser.mjs:24`, `UserDeleter.mjs:192-196,104,106` |
| `deleterData` | Object | Chi ha eliminato l’account e un riepilogo che resta dopo la scadenza. | `DeletedUser.mjs:7-19,23` |
| `deleterData.deletedAt` | Date | Momento dell’eliminazione. La scadenza avviene `userHardDeletionDelay` dopo: 90 giorni, oppure `OVERLEAF_USER_HARD_DELETION_DELAY` millisecondi (`services/web/config/settings.defaults.js:739-741`). | `DeletedUser.mjs:10`, `UserDeleter.mjs:198` |
| `deleterData.deleterId` | ObjectId | Utente che ha eliminato l’account: l’utente stesso nella pagina delle impostazioni dell’account, oppure l’amministratore nel pannello di amministrazione. Assente quando lo ha eliminato lo script `delete-user`. | `DeletedUser.mjs:8`, `UserDeleter.mjs:199` |
| `deleterData.deleterIpAddress` | String | Indirizzo IP di quella richiesta; `0.0.0.0` dallo script `delete-user` (`services/web/modules/server-ce-scripts/scripts/delete-user.mjs:40-44`). Rimosso alla scadenza. | `DeletedUser.mjs:9`, `UserDeleter.mjs:200,105` |
| `deleterData.deletedUserId` | ObjectId | `_id` dell’utente eliminato. Il core cerca i record tramite questo valore. | `DeletedUser.mjs:11`, `UserDeleter.mjs:201` |
| `deleterData.deletedUserLastLoggedIn` | Date | `lastLoggedIn` dell’utente. | `DeletedUser.mjs:12`, `UserDeleter.mjs:202` |
| `deleterData.deletedUserSignUpDate` | Date | `signUpDate` dell’utente. | `DeletedUser.mjs:13`, `UserDeleter.mjs:203` |
| `deleterData.deletedUserLoginCount` | Number | `loginCount` dell’utente. | `DeletedUser.mjs:14`, `UserDeleter.mjs:204` |
| `deleterData.deletedUserReferralId` | String | `referal_id` dell’utente. | `DeletedUser.mjs:15`, `UserDeleter.mjs:205` |
| `deleterData.deletedUserReferredUsers` | Array of ObjectId | `refered_users` dell’utente. | `DeletedUser.mjs:16`, `UserDeleter.mjs:206` |
| `deleterData.deletedUserReferredUserCount` | Number | `refered_user_count` dell’utente. | `DeletedUser.mjs:17`, `UserDeleter.mjs:207` |
| `deleterData.deletedUserOverleafId` | Number | `overleaf.id` dell’utente, se impostato. | `DeletedUser.mjs:18`, `UserDeleter.mjs:208` |

#### Chi scrive

| Codice | Cosa fa |
| - | - |
| `UserDeleter.mjs:37-80` (`deleteUser`) | Aggiunge una voce di registro di audit `delete-account`, ripulisce l’utente e attiva l’hook `deleteUser`, fa l’upsert del record (`_createDeletedUser`, `UserDeleter.mjs:192-213`), elimina i progetti dell’utente, invia l’e-mail di avviso di sicurezza se non viene saltata ed elimina il documento `users`. Chiamanti: la pagina delle impostazioni dell’account (`services/web/app/src/Features/User/UserController.mjs:280-284`), il pannello di amministrazione (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:604-612`) e lo script `delete-user` (`delete-user.mjs:40-45`). |
| `UserDeleter.mjs:93-115` (`expireDeletedUser`) | Attiva l’hook `expireDeletedUser`, elimina i dati di onboarding dell’utente, poi rimuove `user` e `deleterData.deleterIpAddress`. |
| `UserDeleter.mjs:117-161` (`expireDeletedUsersAfterDuration`) | Fa scadere ogni record più vecchio del ritardo ed elimina le `userAuditLogEntries` dell’utente. Route `POST /internal/expire-deleted-users-after-duration` (`services/web/app/src/router.mjs:847-851`), che il cron della Community Edition chiama ogni ora al minuto 15 quando `ENABLE_CRON_RESOURCE_DELETION` è `true` (`server-ce/cron/delete-users.sh:10-23`, `server-ce/config/crontab-deletion:2`). Un singolo utente: `POST /internal/users/:userId/expire` (`router.mjs:857-861`). |
| `AdminUserManager.mjs:630-649` (`purgeDeletedUser`, modulo `admin-tools`) | Purge nel pannello di amministrazione: esegue `expireDeletedUser` ed elimina le voci del registro di audit dell’utente. |
| `AdminUserManager.mjs:651-696` (`restoreDeletedUser`, modulo `admin-tools`) | Ripristino nel pannello di amministrazione: ricrea il documento `users` da `user` (rifiutato se l’e-mail è già in uso), elimina il record e ripristina i progetti eliminati insieme all’account. |

#### Chi legge

| Codice | Cosa fa |
| - | - |
| `services/web/modules/admin-tools/app/src/AdminUserListManager.mjs:195-213,263-275` | Elenca e conta gli utenti eliminati per il pannello di amministrazione, filtrando su `user.*`. |
| `AdminUserListManager.mjs:428-452` | Mostra un utente eliminato non ancora scaduto, con chi lo ha eliminato. |
| `AdminUserListManager.mjs:456-480` | Indica il proprietario di una riga in altri elenchi di amministrazione, anche quando il proprietario è eliminato. |
| `AdminUserListManager.mjs:175-183` | Raccoglie gli id dei provider di accesso, anche dagli utenti eliminati. |
| `AdminUserManager.mjs:623-627,631-634,652` | Legge il record quando un amministratore elimina, purga o ripristina un utente; questi lo cercano tramite `user._id`. |

#### Indici

| Nome | Chiavi | Opzioni | Migrazione |
| - | - | - | - |
| `deleterData.deleteUserId_1` | `{ "deleterData.deletedUserId": 1 }` | unique | `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterData_deletedAt_user_1` | `{ "deleterData.deletedAt": 1 }` | parziale: `user` è un oggetto | `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 }` | parziale: `user.emails.email` esiste | `20250321112055_create_deletedUsers_email_indexes.mjs` |

Le migrazioni si trovano in `tools/migrations/`. Il nome dell’indice dice `deleteUserId`, ma la chiave è `deletedUserId`.

#### Note

* I moduli che ascoltano `expireDeletedUser` eliminano i propri dati dell’utente: `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`).
* Un record scaduto non viene mai eliminato: `deleterData` resta per sempre, solo `user` e l’indirizzo IP vengono rimossi.
* I token di accesso personali dell’utente non vengono eliminati con l’account, vedi [Collezione OAuth Access Tokens](https://ayakaleaf-pro.mintlify.site/it/dev/data-model/oauth-access-tokens-collection.md).
* Mongoose assegna anche a `deleterData` un proprio `_id`, che nulla legge.


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