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

# Deleted-Projects-Collection

`deletedProjects` bewahrt ein Projekt nach dem Löschen auf: ein Dokument pro gelöschtem Projekt, mit einer Kopie des gesamten Projektdokuments und der Angabe, wer es gelöscht hat. Web schreibt die Collection in `services/web/app/src/Features/Project/ProjectDeleter.mjs`; das Schema ist `services/web/app/src/models/DeletedProject.mjs`. Wenn die Frist bis zum endgültigen Löschen abgelaufen ist, vernichtet der Ablauf die Daten des Projekts und leert `project`, der Eintrag mit `deleterData` bleibt aber bestehen.

Ein Projekt im Papierkorb steht nicht hier: Beim Verschieben in den Papierkorb wird nur der Benutzer zu `trashed` des Projekts hinzugefügt, siehe [Projects-Collection](https://ayakaleaf-pro.mintlify.site/de/dev/data-model/projects-collection.md).

#### Felder

| Feld | Typ | Bedeutung | Quelle |
| - | - | - | - |
| `_id` | ObjectId | ID des Eintrags, nicht die Projekt-ID. | `DeletedProject.mjs:26` |
| `project` | Object | Kopie des `projects`-Dokuments zum Zeitpunkt des Löschens, mit dem Projektschema. `null`, sobald der Eintrag abgelaufen ist. | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | Wer das Projekt gelöscht hat, und eine Zusammenfassung, die nach dem Ablauf erhalten bleibt. Schlüssel mit dem Wert `undefined` werden weggelassen. | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | Zeitpunkt des Löschens. Der Ablauf erfolgt `projectHardDeletionDelay` danach: 90 Tage oder `OVERLEAF_PROJECT_HARD_DELETION_DELAY` Millisekunden (`services/web/config/settings.defaults.js:742-744`). | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | Benutzer, der das Projekt gelöscht hat. Fehlt, wenn kein Benutzer es direkt gelöscht hat, siehe `deletedReason`. | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | IP-Adresse dieser Anfrage. Wird beim Ablauf auf `null` gesetzt. | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | Warum das Projekt gelöscht wurde, siehe die Tabelle unten. Ältere Einträge haben keinen Grund. | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | `_id` des gelöschten Projekts. Abfragen eines einzelnen Eintrags verwenden es. | `DeletedProject.mjs:11`, `ProjectDeleter.mjs:253` |
| `deleterData.deletedProjectOwnerId` | ObjectId | `owner_ref` des Projekts. | `DeletedProject.mjs:12`, `ProjectDeleter.mjs:254` |
| `deleterData.deletedProjectCollaboratorIds` | Array of ObjectId | `collaberator_refs` des Projekts. | `DeletedProject.mjs:13`, `ProjectDeleter.mjs:255` |
| `deleterData.deletedProjectReadOnlyIds` | Array of ObjectId | `readOnly_refs` des Projekts. | `DeletedProject.mjs:14`, `ProjectDeleter.mjs:256` |
| `deleterData.deletedProjectReviewerIds` | Array of ObjectId | `reviewer_refs` des Projekts. | `DeletedProject.mjs:15`, `ProjectDeleter.mjs:257` |
| `deleterData.deletedProjectReadWriteTokenAccessIds` | Array of ObjectId | `tokenAccessReadAndWrite_refs` des Projekts. | `DeletedProject.mjs:16`, `ProjectDeleter.mjs:258-259` |
| `deleterData.deletedProjectReadOnlyTokenAccessIds` | Array of ObjectId | `tokenAccessReadOnly_refs` des Projekts. | `DeletedProject.mjs:17`, `ProjectDeleter.mjs:267` |
| `deleterData.deletedProjectReadWriteToken` | String | `tokens.readAndWrite` des Projekts, falls vorhanden. | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | `tokens.readOnly` des Projekts, falls vorhanden. | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | `lastUpdated` des Projekts. | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | `overleaf.id` des Projekts, falls gesetzt. | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | `overleaf.history.id` des Projekts, falls gesetzt. | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

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

| Wert | Gesetzt, wenn | `deleterId` |
| - | - | - |
| `user` | Ein Benutzer das Projekt in der Projektliste löscht (`services/web/app/src/Features/Project/ProjectController.mjs:281-291`) oder ein Admin es im Admin-Panel löscht (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`) | gesetzt |
| `account-deletion` | Das Konto des Eigentümers gelöscht wird (`ProjectDeleter.mjs:82-95`, aufgerufen von `services/web/app/src/Features/User/UserDeleter.mjs:66`) | fehlt |
| `zip-import-failure` | Das Erstellen eines Projekts aus einer hochgeladenen ZIP-Datei fehlschlägt (`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`) | fehlt |
| `clone-failure` | Das Kopieren eines Projekts fehlschlägt; die fehlerhafte Kopie wird gelöscht (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`) | fehlt |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | fehlt |
| `github-import-failure` | Definiert, aber nichts in diesem Repository verwendet ihn | |

#### Wer schreibt

| Code | Funktion |
| - | - |
| `ProjectDeleter.mjs:189-293` (`deleteProject`) | Leert den Puffer des Projekts, archiviert seine Docs aus Mongo heraus, entfernt es aus Tags, legt den Eintrag per Upsert an und löscht das `projects`-Dokument. |
| `ProjectDeleter.mjs:295-342` (`undeleteProject`) | Fügt das Projekt unter dem Namen `<name> (Restored)` (für den Eigentümer eindeutig gemacht) und nicht mehr archiviert wieder ein und löscht dann den Eintrag. Schlägt mit `project_too_old_to_restore` fehl, sobald `project` `null` ist. Aufgerufen aus dem Admin-Panel: ein Projekt wiederherstellen (`AdminProjectManager.mjs:497-515`) oder einen gelöschten Benutzer mit den zusammen mit dem Konto gelöschten Projekten wiederherstellen (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`). |
| `ProjectDeleter.mjs:344-416` (`expireDeletedProject`) | Vernichtet Docs, Verlauf, Chat und Projekt-Audit-Log des Projekts, löst den Hook `projectExpired` aus und setzt dann `project` und `deleterData.deleterIpAddress` auf `null`. Existiert das Projekt wieder, wird nur der veraltete Eintrag gelöscht. |
| `ProjectDeleter.mjs:97-146` (`expireDeletedProjectsAfterDuration`) | Lässt einen Stapel von Einträgen ablaufen, die älter als die Frist sind. Route `POST /internal/expire-deleted-projects-after-duration` (`services/web/app/src/router.mjs:842-846`), die der Cron der Community Edition stündlich zur Minute 20 aufruft, wenn `ENABLE_CRON_RESOURCE_DELETION` `true` ist (`server-ce/cron/delete-projects.sh:10-23`, `server-ce/config/crontab-deletion:3`). Ein einzelnes Projekt: `POST /internal/project/:projectId/expire-deleted-project` (`router.mjs:852-856`) oder Purge im Admin-Panel (`AdminProjectManager.mjs:517-529`). |

#### Wer liest

| Code | Funktion |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272` (Modul `admin-tools`) | Listet die gelöschten Projekte auf, die noch nicht abgelaufen sind. |
| `AdminProjectManager.mjs:418-454` | Zeigt ein gelöschtes Projekt mit Eigentümer und löschendem Benutzer an. |
| `AdminProjectManager.mjs:178-191` | Findet Projekte anhand eines Link-Sharing-Tokens, gelöschte eingeschlossen (`project.tokens.*`). |
| `AdminUserManager.mjs:678-684` | Findet die Projekte, die mit einem wiederhergestellten Benutzer zurückgeholt werden: im Besitz des Benutzers und mit dem Grund `account-deletion` oder ohne Grund gelöscht. |

#### Indizes

| Name | Schlüssel | Optionen | Migration |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`, eindeutig gemacht durch `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterdata_deletedProjectOwnerId_1` | `{ "deleterData.deletedProjectOwnerId": 1 }` | | `20200120163346_atlas_recommended_indexes.mjs` |
| `deleterData.deletedAt_1` | `{ "deleterData.deletedAt": 1 }` | partiell: `project` ist ein Objekt | `20250126195914_update_deleterData.deletedAt_index.mjs` (ersetzt den einfachen Index aus `20190912145002_create_deletedProjects_indexes.mjs`) |

Die Migrationen liegen in `tools/migrations/`.

#### Hinweise

* Module, die auf `projectExpired` hören, löschen ihre eigenen Daten des Projekts: `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`) und `dropbox` (`services/web/modules/dropbox/index.mjs:54`).
* Ein abgelaufener Eintrag wird nie gelöscht: `deleterData` bleibt dauerhaft erhalten, nur `project` und die IP-Adresse werden geleert.
* Mongoose gibt `deleterData` außerdem eine eigene `_id`, die nichts liest.


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