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

# Colección Deleted Projects

`deletedProjects` conserva un proyecto después de eliminarlo: un documento por proyecto eliminado, con una copia del documento completo del proyecto y quién lo eliminó. Web la escribe en `services/web/app/src/Features/Project/ProjectDeleter.mjs`; el esquema es `services/web/app/src/models/DeletedProject.mjs`. Cuando pasa el plazo de eliminación definitiva, la expiración destruye los datos del proyecto y vacía `project`, pero el registro con `deleterData` permanece.

Un proyecto en la papelera no está aquí: enviarlo a la papelera solo añade el usuario a `trashed` del proyecto, consulta [Colección Projects](https://ayakaleaf-pro.mintlify.site/es/dev/data-model/projects-collection.md).

#### Campos

| Campo | Tipo | Significado | Origen |
| - | - | - | - |
| `_id` | ObjectId | Id del registro, no el id del proyecto. | `DeletedProject.mjs:26` |
| `project` | Object | Copia del documento de `projects` en el momento de la eliminación, con el esquema de proyecto. `null` una vez que el registro ha expirado. | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | Quién eliminó el proyecto y un resumen que permanece tras la expiración. Se omiten las claves cuyo valor es `undefined`. | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | Momento de la eliminación. La expiración se ejecuta `projectHardDeletionDelay` después: 90 días, o `OVERLEAF_PROJECT_HARD_DELETION_DELAY` milisegundos (`services/web/config/settings.defaults.js:742-744`). | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | Usuario que eliminó el proyecto. Falta cuando ningún usuario lo hizo directamente, consulta `deletedReason`. | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | Dirección IP de esa solicitud. Se pone a `null` al expirar. | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | Por qué se eliminó el proyecto, consulta la tabla siguiente. Los registros antiguos no lo tienen. | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | `_id` del proyecto eliminado. Las búsquedas de un registro lo usan. | `DeletedProject.mjs:11`, `ProjectDeleter.mjs:253` |
| `deleterData.deletedProjectOwnerId` | ObjectId | `owner_ref` del proyecto. | `DeletedProject.mjs:12`, `ProjectDeleter.mjs:254` |
| `deleterData.deletedProjectCollaboratorIds` | Array of ObjectId | `collaberator_refs` del proyecto. | `DeletedProject.mjs:13`, `ProjectDeleter.mjs:255` |
| `deleterData.deletedProjectReadOnlyIds` | Array of ObjectId | `readOnly_refs` del proyecto. | `DeletedProject.mjs:14`, `ProjectDeleter.mjs:256` |
| `deleterData.deletedProjectReviewerIds` | Array of ObjectId | `reviewer_refs` del proyecto. | `DeletedProject.mjs:15`, `ProjectDeleter.mjs:257` |
| `deleterData.deletedProjectReadWriteTokenAccessIds` | Array of ObjectId | `tokenAccessReadAndWrite_refs` del proyecto. | `DeletedProject.mjs:16`, `ProjectDeleter.mjs:258-259` |
| `deleterData.deletedProjectReadOnlyTokenAccessIds` | Array of ObjectId | `tokenAccessReadOnly_refs` del proyecto. | `DeletedProject.mjs:17`, `ProjectDeleter.mjs:267` |
| `deleterData.deletedProjectReadWriteToken` | String | `tokens.readAndWrite` del proyecto, si tenía uno. | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | `tokens.readOnly` del proyecto, si tenía uno. | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | `lastUpdated` del proyecto. | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | `overleaf.id` del proyecto, si está definido. | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | `overleaf.history.id` del proyecto, si está definido. | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

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

| Valor | Se establece cuando | `deleterId` |
| - | - | - |
| `user` | Un usuario elimina el proyecto desde la lista de proyectos (`services/web/app/src/Features/Project/ProjectController.mjs:281-291`), o un administrador lo elimina en el panel de administración (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`) | definido |
| `account-deletion` | Se elimina la cuenta del propietario (`ProjectDeleter.mjs:82-95`, llamado desde `services/web/app/src/Features/User/UserDeleter.mjs:66`) | falta |
| `zip-import-failure` | Falla la creación de un proyecto a partir de un zip subido (`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`) | falta |
| `clone-failure` | Falla la copia de un proyecto; se elimina la copia defectuosa (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`) | falta |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | falta |
| `github-import-failure` | Definido, pero nada en este repositorio lo usa | |

#### Quién escribe

| Código | Qué hace |
| - | - |
| `ProjectDeleter.mjs:189-293` (`deleteProject`) | Vuelca el proyecto, archiva sus docs fuera de Mongo, lo quita de las etiquetas, hace un upsert del registro y elimina el documento de `projects`. |
| `ProjectDeleter.mjs:295-342` (`undeleteProject`) | Vuelve a insertar el proyecto con el nombre `<name> (Restored)` (único para el propietario) y sin archivar, y luego elimina el registro. Falla con `project_too_old_to_restore` una vez que `project` es `null`. Se llama desde el panel de administración: restaurar un proyecto (`AdminProjectManager.mjs:497-515`) o restaurar un usuario eliminado con los proyectos eliminados junto con la cuenta (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`). |
| `ProjectDeleter.mjs:344-416` (`expireDeletedProject`) | Destruye los docs, el historial, el chat y el registro de auditoría del proyecto y dispara el hook `projectExpired`; luego pone `project` y `deleterData.deleterIpAddress` a `null`. Si el proyecto vuelve a existir, solo elimina el registro obsoleto. |
| `ProjectDeleter.mjs:97-146` (`expireDeletedProjectsAfterDuration`) | Hace expirar un lote de registros más antiguos que el plazo. Ruta `POST /internal/expire-deleted-projects-after-duration` (`services/web/app/src/router.mjs:842-846`), que el cron de la Community Edition llama cada hora en el minuto 20 cuando `ENABLE_CRON_RESOURCE_DELETION` es `true` (`server-ce/cron/delete-projects.sh:10-23`, `server-ce/config/crontab-deletion:3`). Un solo proyecto: `POST /internal/project/:projectId/expire-deleted-project` (`router.mjs:852-856`), o Purge en el panel de administración (`AdminProjectManager.mjs:517-529`). |

#### Quién lee

| Código | Qué hace |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272` (módulo `admin-tools`) | Lista los proyectos eliminados que no han expirado. |
| `AdminProjectManager.mjs:418-454` | Muestra un proyecto eliminado con su propietario y quien lo eliminó. |
| `AdminProjectManager.mjs:178-191` | Encuentra proyectos por un token de enlace compartido, incluidos los eliminados (`project.tokens.*`). |
| `AdminUserManager.mjs:678-684` | Encuentra los proyectos que se recuperan con un usuario restaurado: propiedad del usuario y eliminados con el motivo `account-deletion` o sin motivo. |

#### Índices

| Nombre | Claves | Opciones | Migración |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`, hecho único por `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterdata_deletedProjectOwnerId_1` | `{ "deleterData.deletedProjectOwnerId": 1 }` | | `20200120163346_atlas_recommended_indexes.mjs` |
| `deleterData.deletedAt_1` | `{ "deleterData.deletedAt": 1 }` | parcial: `project` es un objeto | `20250126195914_update_deleterData.deletedAt_index.mjs` (sustituye al índice simple de `20190912145002_create_deletedProjects_indexes.mjs`) |

Las migraciones están en `tools/migrations/`.

#### Notas

* Los módulos que escuchan `projectExpired` eliminan sus propios datos del proyecto: `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`) y `dropbox` (`services/web/modules/dropbox/index.mjs:54`).
* Un registro expirado nunca se elimina: `deleterData` permanece para siempre, solo se vacían `project` y la dirección IP.
* Mongoose también da a `deleterData` su propio `_id`, que nada lee.


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