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

# Coleção Deleted Projects

`deletedProjects` mantém um projeto depois que ele é excluído: um documento por projeto excluído, com uma cópia do documento completo do projeto e quem o excluiu. O web a escreve em `services/web/app/src/Features/Project/ProjectDeleter.mjs`; o esquema é `services/web/app/src/models/DeletedProject.mjs`. Quando o prazo de exclusão definitiva termina, a expiração destrói os dados do projeto e esvazia `project`, mas o registro com `deleterData` permanece.

Um projeto na lixeira não fica aqui: mover para a lixeira apenas adiciona o usuário a `trashed` do projeto, veja [Coleção Projects](https://ayakaleaf-pro.mintlify.site/pt/dev/data-model/projects-collection.md).

#### Campos

| Campo | Tipo | Significado | Origem |
| - | - | - | - |
| `_id` | ObjectId | Id do registro, não o id do projeto. | `DeletedProject.mjs:26` |
| `project` | Object | Cópia do documento de `projects` no momento da exclusão, com o esquema de projeto. `null` quando o registro expira. | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | Quem excluiu o projeto e um resumo que permanece após a expiração. Chaves com valor `undefined` são omitidas. | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | Momento da exclusão. A expiração ocorre `projectHardDeletionDelay` depois: 90 dias, ou `OVERLEAF_PROJECT_HARD_DELETION_DELAY` milissegundos (`services/web/config/settings.defaults.js:742-744`). | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | Usuário que excluiu o projeto. Ausente quando nenhum usuário o fez diretamente, veja `deletedReason`. | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | Endereço IP dessa requisição. Definido como `null` na expiração. | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | Por que o projeto foi excluído, veja a tabela abaixo. Registros antigos não têm. | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | `_id` do projeto excluído. As buscas de um registro o usam. | `DeletedProject.mjs:11`, `ProjectDeleter.mjs:253` |
| `deleterData.deletedProjectOwnerId` | ObjectId | `owner_ref` do projeto. | `DeletedProject.mjs:12`, `ProjectDeleter.mjs:254` |
| `deleterData.deletedProjectCollaboratorIds` | Array of ObjectId | `collaberator_refs` do projeto. | `DeletedProject.mjs:13`, `ProjectDeleter.mjs:255` |
| `deleterData.deletedProjectReadOnlyIds` | Array of ObjectId | `readOnly_refs` do projeto. | `DeletedProject.mjs:14`, `ProjectDeleter.mjs:256` |
| `deleterData.deletedProjectReviewerIds` | Array of ObjectId | `reviewer_refs` do projeto. | `DeletedProject.mjs:15`, `ProjectDeleter.mjs:257` |
| `deleterData.deletedProjectReadWriteTokenAccessIds` | Array of ObjectId | `tokenAccessReadAndWrite_refs` do projeto. | `DeletedProject.mjs:16`, `ProjectDeleter.mjs:258-259` |
| `deleterData.deletedProjectReadOnlyTokenAccessIds` | Array of ObjectId | `tokenAccessReadOnly_refs` do projeto. | `DeletedProject.mjs:17`, `ProjectDeleter.mjs:267` |
| `deleterData.deletedProjectReadWriteToken` | String | `tokens.readAndWrite` do projeto, se ele tinha um. | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | `tokens.readOnly` do projeto, se ele tinha um. | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | `lastUpdated` do projeto. | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | `overleaf.id` do projeto, quando definido. | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | `overleaf.history.id` do projeto, quando definido. | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

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

| Valor | Definido quando | `deleterId` |
| - | - | - |
| `user` | Um usuário exclui o projeto na lista de projetos (`services/web/app/src/Features/Project/ProjectController.mjs:281-291`), ou um admin o exclui no painel de administração (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`) | definido |
| `account-deletion` | A conta do proprietário é excluída (`ProjectDeleter.mjs:82-95`, chamado de `services/web/app/src/Features/User/UserDeleter.mjs:66`) | ausente |
| `zip-import-failure` | A criação de um projeto a partir de um zip enviado falha (`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`) | ausente |
| `clone-failure` | A cópia de um projeto falha; a cópia com defeito é excluída (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`) | ausente |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | ausente |
| `github-import-failure` | Definido, mas nada neste repositório o usa | |

#### Quem escreve

| Código | O que faz |
| - | - |
| `ProjectDeleter.mjs:189-293` (`deleteProject`) | Faz o flush do projeto, arquiva seus docs para fora do Mongo, remove-o das tags, faz o upsert do registro e exclui o documento de `projects`. |
| `ProjectDeleter.mjs:295-342` (`undeleteProject`) | Insere o projeto novamente com o nome `<name> (Restored)` (tornado único para o proprietário) e não mais arquivado, depois exclui o registro. Falha com `project_too_old_to_restore` quando `project` é `null`. Chamado pelo painel de administração: restaurar um projeto (`AdminProjectManager.mjs:497-515`) ou restaurar um usuário excluído com os projetos excluídos junto com a conta (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`). |
| `ProjectDeleter.mjs:344-416` (`expireDeletedProject`) | Destrói os docs, o histórico, o chat e o log de auditoria do projeto e dispara o hook `projectExpired`, depois define `project` e `deleterData.deleterIpAddress` como `null`. Se o projeto existir novamente, apenas exclui o registro obsoleto. |
| `ProjectDeleter.mjs:97-146` (`expireDeletedProjectsAfterDuration`) | Faz expirar um lote de registros mais antigos que o prazo. Rota `POST /internal/expire-deleted-projects-after-duration` (`services/web/app/src/router.mjs:842-846`), que o cron da Community Edition chama a cada hora no minuto 20 quando `ENABLE_CRON_RESOURCE_DELETION` é `true` (`server-ce/cron/delete-projects.sh:10-23`, `server-ce/config/crontab-deletion:3`). Um único projeto: `POST /internal/project/:projectId/expire-deleted-project` (`router.mjs:852-856`), ou Purge no painel de administração (`AdminProjectManager.mjs:517-529`). |

#### Quem lê

| Código | O que faz |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272` (módulo `admin-tools`) | Lista os projetos excluídos que não expiraram. |
| `AdminProjectManager.mjs:418-454` | Mostra um projeto excluído com seu proprietário e quem o excluiu. |
| `AdminProjectManager.mjs:178-191` | Encontra projetos por um token de compartilhamento por link, incluindo os excluídos (`project.tokens.*`). |
| `AdminUserManager.mjs:678-684` | Encontra os projetos a recuperar com um usuário restaurado: pertencentes ao usuário e excluídos com o motivo `account-deletion` ou sem motivo. |

#### Índices

| Nome | Chaves | Opções | Migração |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`, tornado ú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` é um objeto | `20250126195914_update_deleterData.deletedAt_index.mjs` (substitui o índice simples de `20190912145002_create_deletedProjects_indexes.mjs`) |

As migrações ficam em `tools/migrations/`.

#### Notas

* Os módulos que escutam `projectExpired` excluem seus próprios dados do projeto: `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`).
* Um registro expirado nunca é excluído: `deleterData` permanece para sempre, apenas `project` e o endereço IP são esvaziados.
* O Mongoose também dá a `deleterData` seu próprio `_id`, que nada lê.


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