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

# Kolekce Deleted Projects

`deletedProjects` uchovává projekt po jeho smazání: jeden dokument na každý smazaný projekt, s kopií celého dokumentu projektu a informací, kdo jej smazal. Web kolekci zapisuje v `services/web/app/src/Features/Project/ProjectDeleter.mjs`; schéma je `services/web/app/src/models/DeletedProject.mjs`. Po uplynutí lhůty pro trvalé smazání proces vypršení zničí data projektu a vyprázdní `project`, ale záznam s `deleterData` zůstane.

Projekt v koši tu není: přesunutí do koše jen přidá uživatele do `trashed` projektu, viz [Kolekce Projects](https://ayakaleaf-pro.mintlify.site/cs/dev/data-model/projects-collection.md).

#### Pole

| Pole | Typ | Význam | Zdroj |
| - | - | - | - |
| `_id` | ObjectId | Id záznamu, nikoli id projektu. | `DeletedProject.mjs:26` |
| `project` | Object | Kopie dokumentu `projects` v okamžiku smazání se schématem projektu. `null`, jakmile záznam vyprší. | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | Kdo projekt smazal, a souhrn, který zůstává i po vypršení. Klíče s hodnotou `undefined` se vynechávají. | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | Čas smazání. Vypršení proběhne `projectHardDeletionDelay` poté: 90 dní, nebo `OVERLEAF_PROJECT_HARD_DELETION_DELAY` milisekund (`services/web/config/settings.defaults.js:742-744`). | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | Uživatel, který projekt smazal. Chybí, pokud jej žádný uživatel nesmazal přímo, viz `deletedReason`. | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | IP adresa daného požadavku. Při vypršení se nastaví na `null`. | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | Proč byl projekt smazán, viz tabulka níže. Starší záznamy jej nemají. | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | `_id` smazaného projektu. Vyhledávání jednoho záznamu jej používá. | `DeletedProject.mjs:11`, `ProjectDeleter.mjs:253` |
| `deleterData.deletedProjectOwnerId` | ObjectId | `owner_ref` projektu. | `DeletedProject.mjs:12`, `ProjectDeleter.mjs:254` |
| `deleterData.deletedProjectCollaboratorIds` | Array of ObjectId | `collaberator_refs` projektu. | `DeletedProject.mjs:13`, `ProjectDeleter.mjs:255` |
| `deleterData.deletedProjectReadOnlyIds` | Array of ObjectId | `readOnly_refs` projektu. | `DeletedProject.mjs:14`, `ProjectDeleter.mjs:256` |
| `deleterData.deletedProjectReviewerIds` | Array of ObjectId | `reviewer_refs` projektu. | `DeletedProject.mjs:15`, `ProjectDeleter.mjs:257` |
| `deleterData.deletedProjectReadWriteTokenAccessIds` | Array of ObjectId | `tokenAccessReadAndWrite_refs` projektu. | `DeletedProject.mjs:16`, `ProjectDeleter.mjs:258-259` |
| `deleterData.deletedProjectReadOnlyTokenAccessIds` | Array of ObjectId | `tokenAccessReadOnly_refs` projektu. | `DeletedProject.mjs:17`, `ProjectDeleter.mjs:267` |
| `deleterData.deletedProjectReadWriteToken` | String | `tokens.readAndWrite` projektu, pokud jej měl. | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | `tokens.readOnly` projektu, pokud jej měl. | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | `lastUpdated` projektu. | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | `overleaf.id` projektu, pokud je nastaveno. | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | `overleaf.history.id` projektu, pokud je nastaveno. | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

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

| Hodnota | Nastaví se, když | `deleterId` |
| - | - | - |
| `user` | Uživatel smaže projekt ze seznamu projektů (`services/web/app/src/Features/Project/ProjectController.mjs:281-291`) nebo jej smaže administrátor v administrátorském panelu (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`) | nastaveno |
| `account-deletion` | Je smazán účet vlastníka (`ProjectDeleter.mjs:82-95`, voláno z `services/web/app/src/Features/User/UserDeleter.mjs:66`) | chybí |
| `zip-import-failure` | Vytvoření projektu z nahraného zipu selže (`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`) | chybí |
| `clone-failure` | Kopírování projektu selže; poškozená kopie se smaže (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`) | chybí |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | chybí |
| `github-import-failure` | Definováno, ale nic v tomto repozitáři to nepoužívá | |

#### Kdo zapisuje

| Kód | Co dělá |
| - | - |
| `ProjectDeleter.mjs:189-293` (`deleteProject`) | Provede flush projektu, archivuje jeho docs mimo Mongo, odebere jej ze štítků, provede upsert záznamu a smaže dokument `projects`. |
| `ProjectDeleter.mjs:295-342` (`undeleteProject`) | Znovu vloží projekt pod názvem `<name> (Restored)` (jedinečným pro vlastníka) a už nearchivovaný, pak smaže záznam. Selže s `project_too_old_to_restore`, jakmile je `project` `null`. Volá se z administrátorského panelu: obnovení jednoho projektu (`AdminProjectManager.mjs:497-515`) nebo obnovení smazaného uživatele s projekty smazanými spolu s účtem (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`). |
| `ProjectDeleter.mjs:344-416` (`expireDeletedProject`) | Zničí docs, historii, chat a auditní protokol projektu a spustí hook `projectExpired`, pak nastaví `project` a `deleterData.deleterIpAddress` na `null`. Pokud projekt znovu existuje, smaže jen zastaralý záznam. |
| `ProjectDeleter.mjs:97-146` (`expireDeletedProjectsAfterDuration`) | Nechá vypršet dávku záznamů starších než lhůta. Trasa `POST /internal/expire-deleted-projects-after-duration` (`services/web/app/src/router.mjs:842-846`), kterou cron Community Edition volá každou hodinu ve 20. minutě, když je `ENABLE_CRON_RESOURCE_DELETION` `true` (`server-ce/cron/delete-projects.sh:10-23`, `server-ce/config/crontab-deletion:3`). Jeden projekt: `POST /internal/project/:projectId/expire-deleted-project` (`router.mjs:852-856`) nebo Purge v administrátorském panelu (`AdminProjectManager.mjs:517-529`). |

#### Kdo čte

| Kód | Co dělá |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272` (modul `admin-tools`) | Vypíše smazané projekty, které ještě nevypršely. |
| `AdminProjectManager.mjs:418-454` | Zobrazí jeden smazaný projekt s vlastníkem a tím, kdo jej smazal. |
| `AdminProjectManager.mjs:178-191` | Najde projekty podle tokenu pro sdílení odkazem, včetně smazaných (`project.tokens.*`). |
| `AdminUserManager.mjs:678-684` | Najde projekty, které se vrátí s obnoveným uživatelem: vlastněné uživatelem a smazané s důvodem `account-deletion` nebo bez důvodu. |

#### Indexy

| Název | Klíče | Volby | Migrace |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`, jedinečným jej učinila `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterdata_deletedProjectOwnerId_1` | `{ "deleterData.deletedProjectOwnerId": 1 }` | | `20200120163346_atlas_recommended_indexes.mjs` |
| `deleterData.deletedAt_1` | `{ "deleterData.deletedAt": 1 }` | částečný: `project` je objekt | `20250126195914_update_deleterData.deletedAt_index.mjs` (nahrazuje prostý index z `20190912145002_create_deletedProjects_indexes.mjs`) |

Migrace jsou v `tools/migrations/`.

#### Poznámky

* Moduly, které naslouchají `projectExpired`, mažou svá vlastní data projektu: `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`) a `dropbox` (`services/web/modules/dropbox/index.mjs:54`).
* Záznam, který vypršel, se nikdy nesmaže: `deleterData` zůstává natrvalo, vyprázdní se jen `project` a IP adresa.
* Mongoose přidělí `deleterData` také vlastní `_id`, které nic nečte.


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