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

# Kolekcja Deleted Projects

`deletedProjects` przechowuje projekt po jego usunięciu: jeden dokument na każdy usunięty projekt, z kopią całego dokumentu projektu i informacją, kto go usunął. Web zapisuje kolekcję w `services/web/app/src/Features/Project/ProjectDeleter.mjs`; schemat to `services/web/app/src/models/DeletedProject.mjs`. Po upływie terminu trwałego usunięcia proces wygaszania niszczy dane projektu i opróżnia `project`, ale rekord z `deleterData` pozostaje.

Projektu w koszu tu nie ma: przeniesienie do kosza tylko dodaje użytkownika do `trashed` projektu, zobacz [Kolekcja projektów](https://ayakaleaf-pro.mintlify.site/pl/dev/data-model/projects-collection.md).

#### Pola

| Pole | Typ | Znaczenie | Źródło |
| - | - | - | - |
| `_id` | ObjectId | Id rekordu, a nie id projektu. | `DeletedProject.mjs:26` |
| `project` | Object | Kopia dokumentu `projects` z chwili usunięcia, ze schematem projektu. `null` po wygaśnięciu rekordu. | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | Kto usunął projekt oraz podsumowanie, które pozostaje po wygaśnięciu. Klucze o wartości `undefined` są pomijane. | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | Czas usunięcia. Wygaszanie następuje `projectHardDeletionDelay` później: po 90 dniach lub po `OVERLEAF_PROJECT_HARD_DELETION_DELAY` milisekundach (`services/web/config/settings.defaults.js:742-744`). | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | Użytkownik, który usunął projekt. Brak, gdy żaden użytkownik nie zrobił tego bezpośrednio, zobacz `deletedReason`. | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | Adres IP tego żądania. Przy wygaśnięciu ustawiany na `null`. | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | Dlaczego projekt został usunięty, zobacz tabelę poniżej. Starsze rekordy go nie mają. | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | `_id` usuniętego projektu. Wyszukiwanie pojedynczego rekordu go używa. | `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, jeśli go miał. | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | `tokens.readOnly` projektu, jeśli go miał. | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | `lastUpdated` projektu. | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | `overleaf.id` projektu, jeśli ustawione. | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | `overleaf.history.id` projektu, jeśli ustawione. | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

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

| Wartość | Ustawiana, gdy | `deleterId` |
| - | - | - |
| `user` | Użytkownik usuwa projekt z listy projektów (`services/web/app/src/Features/Project/ProjectController.mjs:281-291`) lub administrator usuwa go w panelu administracyjnym (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`) | ustawione |
| `account-deletion` | Konto właściciela zostaje usunięte (`ProjectDeleter.mjs:82-95`, wywoływane z `services/web/app/src/Features/User/UserDeleter.mjs:66`) | brak |
| `zip-import-failure` | Utworzenie projektu z przesłanego pliku zip się nie powiedzie (`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`) | brak |
| `clone-failure` | Kopiowanie projektu się nie powiedzie; uszkodzona kopia zostaje usunięta (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`) | brak |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | brak |
| `github-import-failure` | Zdefiniowane, ale nic w tym repozytorium go nie używa | |

#### Kto zapisuje

| Kod | Co robi |
| - | - |
| `ProjectDeleter.mjs:189-293` (`deleteProject`) | Wykonuje flush projektu, archiwizuje jego docs poza Mongo, usuwa go z tagów, wykonuje upsert rekordu i usuwa dokument `projects`. |
| `ProjectDeleter.mjs:295-342` (`undeleteProject`) | Ponownie wstawia projekt pod nazwą `<name> (Restored)` (unikalną dla właściciela) i już niezarchiwizowany, a następnie usuwa rekord. Kończy się błędem `project_too_old_to_restore`, gdy `project` ma wartość `null`. Wywoływane z panelu administracyjnego: przywrócenie jednego projektu (`AdminProjectManager.mjs:497-515`) lub przywrócenie usuniętego użytkownika wraz z projektami usuniętymi razem z kontem (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`). |
| `ProjectDeleter.mjs:344-416` (`expireDeletedProject`) | Niszczy docs, historię, czat i dziennik audytu projektu, wywołuje hook `projectExpired`, a następnie ustawia `project` i `deleterData.deleterIpAddress` na `null`. Jeśli projekt znów istnieje, usuwa tylko nieaktualny rekord. |
| `ProjectDeleter.mjs:97-146` (`expireDeletedProjectsAfterDuration`) | Wygasza partię rekordów starszych niż termin. Trasa `POST /internal/expire-deleted-projects-after-duration` (`services/web/app/src/router.mjs:842-846`), którą cron Community Edition wywołuje co godzinę w 20. minucie, gdy `ENABLE_CRON_RESOURCE_DELETION` ma wartość `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`) lub Purge w panelu administracyjnym (`AdminProjectManager.mjs:517-529`). |

#### Kto odczytuje

| Kod | Co robi |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272` (moduł `admin-tools`) | Wyświetla listę usuniętych projektów, które jeszcze nie wygasły. |
| `AdminProjectManager.mjs:418-454` | Pokazuje jeden usunięty projekt z właścicielem i osobą, która go usunęła. |
| `AdminProjectManager.mjs:178-191` | Znajduje projekty po tokenie udostępniania przez link, także usunięte (`project.tokens.*`). |
| `AdminUserManager.mjs:678-684` | Znajduje projekty przywracane razem z przywróconym użytkownikiem: należące do użytkownika i usunięte z powodem `account-deletion` lub bez powodu. |

#### Indeksy

| Nazwa | Klucze | Opcje | Migracja |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`, uczyniony unikalnym przez `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterdata_deletedProjectOwnerId_1` | `{ "deleterData.deletedProjectOwnerId": 1 }` | | `20200120163346_atlas_recommended_indexes.mjs` |
| `deleterData.deletedAt_1` | `{ "deleterData.deletedAt": 1 }` | częściowy: `project` jest obiektem | `20250126195914_update_deleterData.deletedAt_index.mjs` (zastępuje zwykły indeks z `20190912145002_create_deletedProjects_indexes.mjs`) |

Migracje znajdują się w `tools/migrations/`.

#### Uwagi

* Moduły nasłuchujące `projectExpired` usuwają własne dane 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`) i `dropbox` (`services/web/modules/dropbox/index.mjs:54`).
* Wygasły rekord nigdy nie jest usuwany: `deleterData` pozostaje na zawsze, opróżniane są tylko `project` i adres IP.
* Mongoose nadaje też `deleterData` własne `_id`, którego nic nie odczytuje.


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