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

# Collection Deleted Projects

`deletedProjects` conserve un projet après sa suppression : un document par projet supprimé, avec une copie du document de projet complet et l’auteur de la suppression. Web l’écrit dans `services/web/app/src/Features/Project/ProjectDeleter.mjs` ; le schéma est `services/web/app/src/models/DeletedProject.mjs`. Une fois le délai de suppression définitive écoulé, l’expiration détruit les données du projet et vide `project`, mais l’enregistrement avec `deleterData` reste.

Un projet dans la corbeille n’est pas ici : la mise à la corbeille ajoute seulement l’utilisateur à `trashed` du projet, voir [Collection Projects](https://ayakaleaf-pro.mintlify.site/fr/dev/data-model/projects-collection.md).

#### Champs

| Champ | Type | Signification | Source |
| - | - | - | - |
| `_id` | ObjectId | Id de l’enregistrement, pas l’id du projet. | `DeletedProject.mjs:26` |
| `project` | Object | Copie du document `projects` au moment de la suppression, avec le schéma de projet. `null` une fois l’enregistrement expiré. | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | Qui a supprimé le projet, et un résumé qui reste après l’expiration. Les clés dont la valeur est `undefined` sont omises. | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | Date de la suppression. L’expiration a lieu `projectHardDeletionDelay` après : 90 jours, ou `OVERLEAF_PROJECT_HARD_DELETION_DELAY` millisecondes (`services/web/config/settings.defaults.js:742-744`). | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | Utilisateur qui a supprimé le projet. Absent quand aucun utilisateur ne l’a fait directement, voir `deletedReason`. | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | Adresse IP de cette requête. Mise à `null` à l’expiration. | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | Pourquoi le projet a été supprimé, voir le tableau ci-dessous. Les anciens enregistrements n’en ont pas. | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | `_id` du projet supprimé. Les recherches d’un enregistrement l’utilisent. | `DeletedProject.mjs:11`, `ProjectDeleter.mjs:253` |
| `deleterData.deletedProjectOwnerId` | ObjectId | `owner_ref` du projet. | `DeletedProject.mjs:12`, `ProjectDeleter.mjs:254` |
| `deleterData.deletedProjectCollaboratorIds` | Array of ObjectId | `collaberator_refs` du projet. | `DeletedProject.mjs:13`, `ProjectDeleter.mjs:255` |
| `deleterData.deletedProjectReadOnlyIds` | Array of ObjectId | `readOnly_refs` du projet. | `DeletedProject.mjs:14`, `ProjectDeleter.mjs:256` |
| `deleterData.deletedProjectReviewerIds` | Array of ObjectId | `reviewer_refs` du projet. | `DeletedProject.mjs:15`, `ProjectDeleter.mjs:257` |
| `deleterData.deletedProjectReadWriteTokenAccessIds` | Array of ObjectId | `tokenAccessReadAndWrite_refs` du projet. | `DeletedProject.mjs:16`, `ProjectDeleter.mjs:258-259` |
| `deleterData.deletedProjectReadOnlyTokenAccessIds` | Array of ObjectId | `tokenAccessReadOnly_refs` du projet. | `DeletedProject.mjs:17`, `ProjectDeleter.mjs:267` |
| `deleterData.deletedProjectReadWriteToken` | String | `tokens.readAndWrite` du projet, s’il en avait un. | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | `tokens.readOnly` du projet, s’il en avait un. | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | `lastUpdated` du projet. | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | `overleaf.id` du projet, s’il est défini. | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | `overleaf.history.id` du projet, s’il est défini. | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

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

| Valeur | Définie quand | `deleterId` |
| - | - | - |
| `user` | Un utilisateur supprime le projet depuis la liste des projets (`services/web/app/src/Features/Project/ProjectController.mjs:281-291`), ou un admin le supprime dans le panneau d’administration (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`) | défini |
| `account-deletion` | Le compte du propriétaire est supprimé (`ProjectDeleter.mjs:82-95`, appelé depuis `services/web/app/src/Features/User/UserDeleter.mjs:66`) | absent |
| `zip-import-failure` | La création d’un projet à partir d’un zip téléversé échoue (`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`) | absent |
| `clone-failure` | La copie d’un projet échoue ; la copie défectueuse est supprimée (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`) | absent |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | absent |
| `github-import-failure` | Défini, mais rien dans ce dépôt ne l’utilise | |

#### Qui écrit

| Code | Rôle |
| - | - |
| `ProjectDeleter.mjs:189-293` (`deleteProject`) | Vide le projet vers le stockage, archive ses docs hors de Mongo, le retire des tags, fait un upsert de l’enregistrement et supprime le document `projects`. |
| `ProjectDeleter.mjs:295-342` (`undeleteProject`) | Réinsère le projet sous le nom `<name> (Restored)` (rendu unique pour le propriétaire) et non archivé, puis supprime l’enregistrement. Échoue avec `project_too_old_to_restore` une fois que `project` vaut `null`. Appelé depuis le panneau d’administration : restaurer un projet (`AdminProjectManager.mjs:497-515`) ou restaurer un utilisateur supprimé avec les projets supprimés en même temps que le compte (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`). |
| `ProjectDeleter.mjs:344-416` (`expireDeletedProject`) | Détruit les docs, l’historique, le chat et le journal d’audit du projet et déclenche le hook `projectExpired`, puis met `project` et `deleterData.deleterIpAddress` à `null`. Si le projet existe de nouveau, supprime seulement l’enregistrement obsolète. |
| `ProjectDeleter.mjs:97-146` (`expireDeletedProjectsAfterDuration`) | Fait expirer un lot d’enregistrements plus anciens que le délai. Route `POST /internal/expire-deleted-projects-after-duration` (`services/web/app/src/router.mjs:842-846`), que le cron de la Community Edition appelle toutes les heures à la minute 20 quand `ENABLE_CRON_RESOURCE_DELETION` vaut `true` (`server-ce/cron/delete-projects.sh:10-23`, `server-ce/config/crontab-deletion:3`). Un seul projet : `POST /internal/project/:projectId/expire-deleted-project` (`router.mjs:852-856`), ou Purge dans le panneau d’administration (`AdminProjectManager.mjs:517-529`). |

#### Qui lit

| Code | Rôle |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272` (module `admin-tools`) | Liste les projets supprimés qui n’ont pas expiré. |
| `AdminProjectManager.mjs:418-454` | Affiche un projet supprimé avec son propriétaire et l’auteur de la suppression. |
| `AdminProjectManager.mjs:178-191` | Trouve des projets par un jeton de partage par lien, y compris les projets supprimés (`project.tokens.*`). |
| `AdminUserManager.mjs:678-684` | Trouve les projets à restaurer avec un utilisateur restauré : appartenant à l’utilisateur et supprimés avec la raison `account-deletion` ou sans raison. |

#### Index

| Nom | Clés | Options | Migration |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`, rendu unique par `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterdata_deletedProjectOwnerId_1` | `{ "deleterData.deletedProjectOwnerId": 1 }` | | `20200120163346_atlas_recommended_indexes.mjs` |
| `deleterData.deletedAt_1` | `{ "deleterData.deletedAt": 1 }` | partiel : `project` est un objet | `20250126195914_update_deleterData.deletedAt_index.mjs` (remplace l’index simple de `20190912145002_create_deletedProjects_indexes.mjs`) |

Les migrations se trouvent dans `tools/migrations/`.

#### Remarques

* Les modules qui écoutent `projectExpired` suppriment leurs propres données du projet : `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`) et `dropbox` (`services/web/modules/dropbox/index.mjs:54`).
* Un enregistrement expiré n’est jamais supprimé : `deleterData` reste définitivement, seuls `project` et l’adresse IP sont vidés.
* Mongoose donne aussi à `deleterData` son propre `_id`, que rien ne lit.


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