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

`deletedProjects` conserva un progetto dopo la sua eliminazione: un documento per ogni progetto eliminato, con una copia dell’intero documento del progetto e chi lo ha eliminato. Web la scrive in `services/web/app/src/Features/Project/ProjectDeleter.mjs`; lo schema è `services/web/app/src/models/DeletedProject.mjs`. Trascorso il ritardo di eliminazione definitiva, la scadenza distrugge i dati del progetto e svuota `project`, ma il record con `deleterData` rimane.

Un progetto nel cestino non si trova qui: spostarlo nel cestino aggiunge solo l’utente a `trashed` del progetto, vedi [Collezione Projects](https://ayakaleaf-pro.mintlify.site/it/dev/data-model/projects-collection.md).

#### Campi

| Campo | Tipo | Significato | Fonte |
| - | - | - | - |
| `_id` | ObjectId | Id del record, non l’id del progetto. | `DeletedProject.mjs:26` |
| `project` | Object | Copia del documento `projects` al momento dell’eliminazione, con lo schema del progetto. `null` quando il record è scaduto. | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | Chi ha eliminato il progetto e un riepilogo che resta dopo la scadenza. Le chiavi con valore `undefined` vengono omesse. | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | Momento dell’eliminazione. La scadenza avviene `projectHardDeletionDelay` dopo: 90 giorni, oppure `OVERLEAF_PROJECT_HARD_DELETION_DELAY` millisecondi (`services/web/config/settings.defaults.js:742-744`). | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | Utente che ha eliminato il progetto. Assente quando nessun utente lo ha fatto direttamente, vedi `deletedReason`. | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | Indirizzo IP di quella richiesta. Impostato a `null` alla scadenza. | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | Perché il progetto è stato eliminato, vedi la tabella sotto. I record più vecchi non lo hanno. | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | `_id` del progetto eliminato. Le ricerche di un singolo record lo usano. | `DeletedProject.mjs:11`, `ProjectDeleter.mjs:253` |
| `deleterData.deletedProjectOwnerId` | ObjectId | `owner_ref` del progetto. | `DeletedProject.mjs:12`, `ProjectDeleter.mjs:254` |
| `deleterData.deletedProjectCollaboratorIds` | Array of ObjectId | `collaberator_refs` del progetto. | `DeletedProject.mjs:13`, `ProjectDeleter.mjs:255` |
| `deleterData.deletedProjectReadOnlyIds` | Array of ObjectId | `readOnly_refs` del progetto. | `DeletedProject.mjs:14`, `ProjectDeleter.mjs:256` |
| `deleterData.deletedProjectReviewerIds` | Array of ObjectId | `reviewer_refs` del progetto. | `DeletedProject.mjs:15`, `ProjectDeleter.mjs:257` |
| `deleterData.deletedProjectReadWriteTokenAccessIds` | Array of ObjectId | `tokenAccessReadAndWrite_refs` del progetto. | `DeletedProject.mjs:16`, `ProjectDeleter.mjs:258-259` |
| `deleterData.deletedProjectReadOnlyTokenAccessIds` | Array of ObjectId | `tokenAccessReadOnly_refs` del progetto. | `DeletedProject.mjs:17`, `ProjectDeleter.mjs:267` |
| `deleterData.deletedProjectReadWriteToken` | String | `tokens.readAndWrite` del progetto, se ne aveva uno. | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | `tokens.readOnly` del progetto, se ne aveva uno. | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | `lastUpdated` del progetto. | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | `overleaf.id` del progetto, se impostato. | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | `overleaf.history.id` del progetto, se impostato. | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

Valori di `deletedReason` (`services/web/app/src/Features/Project/DeletedProjectReasons.mjs:1-8`):

| Valore | Impostato quando | `deleterId` |
| - | - | - |
| `user` | Un utente elimina il progetto dall’elenco dei progetti (`services/web/app/src/Features/Project/ProjectController.mjs:281-291`), oppure un amministratore lo elimina nel pannello di amministrazione (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`) | impostato |
| `account-deletion` | Viene eliminato l’account del proprietario (`ProjectDeleter.mjs:82-95`, chiamato da `services/web/app/src/Features/User/UserDeleter.mjs:66`) | assente |
| `zip-import-failure` | La creazione di un progetto da uno zip caricato non riesce (`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`) | assente |
| `clone-failure` | La copia di un progetto non riesce; la copia difettosa viene eliminata (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`) | assente |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | assente |
| `github-import-failure` | Definito, ma nulla in questo repository lo usa | |

#### Chi scrive

| Codice | Cosa fa |
| - | - |
| `ProjectDeleter.mjs:189-293` (`deleteProject`) | Esegue il flush del progetto, archivia i suoi doc fuori da Mongo, lo rimuove dai tag, fa l’upsert del record ed elimina il documento `projects`. |
| `ProjectDeleter.mjs:295-342` (`undeleteProject`) | Reinserisce il progetto con il nome `<name> (Restored)` (reso univoco per il proprietario) e non più archiviato, poi elimina il record. Fallisce con `project_too_old_to_restore` quando `project` è `null`. Chiamato dal pannello di amministrazione: ripristino di un progetto (`AdminProjectManager.mjs:497-515`) o ripristino di un utente eliminato con i progetti eliminati insieme all’account (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`). |
| `ProjectDeleter.mjs:344-416` (`expireDeletedProject`) | Distrugge i doc, la cronologia, la chat e il registro di audit del progetto e attiva l’hook `projectExpired`, poi imposta `project` e `deleterData.deleterIpAddress` a `null`. Se il progetto esiste di nuovo, elimina solo il record obsoleto. |
| `ProjectDeleter.mjs:97-146` (`expireDeletedProjectsAfterDuration`) | Fa scadere un lotto di record più vecchi del ritardo. Route `POST /internal/expire-deleted-projects-after-duration` (`services/web/app/src/router.mjs:842-846`), che il cron della Community Edition chiama ogni ora al minuto 20 quando `ENABLE_CRON_RESOURCE_DELETION` è `true` (`server-ce/cron/delete-projects.sh:10-23`, `server-ce/config/crontab-deletion:3`). Un singolo progetto: `POST /internal/project/:projectId/expire-deleted-project` (`router.mjs:852-856`), oppure Purge nel pannello di amministrazione (`AdminProjectManager.mjs:517-529`). |

#### Chi legge

| Codice | Cosa fa |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272` (modulo `admin-tools`) | Elenca i progetti eliminati non ancora scaduti. |
| `AdminProjectManager.mjs:418-454` | Mostra un progetto eliminato con il proprietario e chi lo ha eliminato. |
| `AdminProjectManager.mjs:178-191` | Trova progetti tramite un token di condivisione via link, inclusi quelli eliminati (`project.tokens.*`). |
| `AdminUserManager.mjs:678-684` | Trova i progetti da recuperare con un utente ripristinato: di proprietà dell’utente ed eliminati con motivo `account-deletion` o senza motivo. |

#### Indici

| Nome | Chiavi | Opzioni | Migrazione |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`, reso univoco da `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterdata_deletedProjectOwnerId_1` | `{ "deleterData.deletedProjectOwnerId": 1 }` | | `20200120163346_atlas_recommended_indexes.mjs` |
| `deleterData.deletedAt_1` | `{ "deleterData.deletedAt": 1 }` | parziale: `project` è un oggetto | `20250126195914_update_deleterData.deletedAt_index.mjs` (sostituisce l’indice semplice di `20190912145002_create_deletedProjects_indexes.mjs`) |

Le migrazioni si trovano in `tools/migrations/`.

#### Note

* I moduli che ascoltano `projectExpired` eliminano i propri dati del progetto: `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`) e `dropbox` (`services/web/modules/dropbox/index.mjs:54`).
* Un record scaduto non viene mai eliminato: `deleterData` resta per sempre, solo `project` e l’indirizzo IP vengono svuotati.
* 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.