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

`deletedProjects` säilyttää projektin sen poistamisen jälkeen: yksi dokumentti jokaista poistettua projektia kohden, ja siinä kopio koko projektidokumentista sekä tieto siitä, kuka projektin poisti. Web kirjoittaa kokoelman tiedostossa `services/web/app/src/Features/Project/ProjectDeleter.mjs`; skeema on `services/web/app/src/models/DeletedProject.mjs`. Kun lopullisen poiston viive on kulunut, vanhentumiskäsittely tuhoaa projektin tiedot ja tyhjentää kentän `project`, mutta tietue, jossa on `deleterData`, säilyy.

Roskakorissa oleva projekti ei ole täällä: roskakoriin siirtäminen vain lisää käyttäjän projektin kenttään `trashed`, katso [Projects-kokoelma](https://ayakaleaf-pro.mintlify.site/fi/dev/data-model/projects-collection.md).

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Tietueen id, ei projektin id. | `DeletedProject.mjs:26` |
| `project` | Object | Kopio `projects`-dokumentista poistohetkellä, projektiskeemalla. `null`, kun tietue on vanhentunut. | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | Kuka projektin poisti, ja yhteenveto, joka säilyy vanhentumisen jälkeen. Avaimet, joiden arvo on `undefined`, jätetään pois. | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | Poiston aika. Vanhentuminen tapahtuu `projectHardDeletionDelay` sen jälkeen: 90 päivää tai `OVERLEAF_PROJECT_HARD_DELETION_DELAY` millisekuntia (`services/web/config/settings.defaults.js:742-744`). | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | Käyttäjä, joka poisti projektin. Puuttuu, kun mikään käyttäjä ei poistanut sitä suoraan, katso `deletedReason`. | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | Kyseisen pyynnön IP-osoite. Asetetaan arvoon `null` vanhentuessa. | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | Miksi projekti poistettiin, katso alla oleva taulukko. Vanhemmissa tietueissa sitä ei ole. | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | Poistetun projektin `_id`. Yksittäisen tietueen haut käyttävät sitä. | `DeletedProject.mjs:11`, `ProjectDeleter.mjs:253` |
| `deleterData.deletedProjectOwnerId` | ObjectId | Projektin `owner_ref`. | `DeletedProject.mjs:12`, `ProjectDeleter.mjs:254` |
| `deleterData.deletedProjectCollaboratorIds` | Array of ObjectId | Projektin `collaberator_refs`. | `DeletedProject.mjs:13`, `ProjectDeleter.mjs:255` |
| `deleterData.deletedProjectReadOnlyIds` | Array of ObjectId | Projektin `readOnly_refs`. | `DeletedProject.mjs:14`, `ProjectDeleter.mjs:256` |
| `deleterData.deletedProjectReviewerIds` | Array of ObjectId | Projektin `reviewer_refs`. | `DeletedProject.mjs:15`, `ProjectDeleter.mjs:257` |
| `deleterData.deletedProjectReadWriteTokenAccessIds` | Array of ObjectId | Projektin `tokenAccessReadAndWrite_refs`. | `DeletedProject.mjs:16`, `ProjectDeleter.mjs:258-259` |
| `deleterData.deletedProjectReadOnlyTokenAccessIds` | Array of ObjectId | Projektin `tokenAccessReadOnly_refs`. | `DeletedProject.mjs:17`, `ProjectDeleter.mjs:267` |
| `deleterData.deletedProjectReadWriteToken` | String | Projektin `tokens.readAndWrite`, jos sellainen oli. | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | Projektin `tokens.readOnly`, jos sellainen oli. | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | Projektin `lastUpdated`. | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | Projektin `overleaf.id`, jos asetettu. | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | Projektin `overleaf.history.id`, jos asetettu. | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

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

| Arvo | Asetetaan, kun | `deleterId` |
| - | - | - |
| `user` | Käyttäjä poistaa projektin projektiluettelosta (`services/web/app/src/Features/Project/ProjectController.mjs:281-291`) tai ylläpitäjä poistaa sen hallintapaneelissa (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`) | asetettu |
| `account-deletion` | Omistajan tili poistetaan (`ProjectDeleter.mjs:82-95`, kutsutaan tiedostosta `services/web/app/src/Features/User/UserDeleter.mjs:66`) | puuttuu |
| `zip-import-failure` | Projektin luominen ladatusta zip-tiedostosta epäonnistuu (`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`) | puuttuu |
| `clone-failure` | Projektin kopiointi epäonnistuu; rikkinäinen kopio poistetaan (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`) | puuttuu |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | puuttuu |
| `github-import-failure` | Määritelty, mutta mikään tässä repositoriossa ei käytä sitä | |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `ProjectDeleter.mjs:189-293` (`deleteProject`) | Tekee projektille flushin, arkistoi sen docsit pois Mongosta, poistaa sen tunnisteista, tekee tietueelle upsertin ja poistaa `projects`-dokumentin. |
| `ProjectDeleter.mjs:295-342` (`undeleteProject`) | Lisää projektin uudelleen nimellä `<name> (Restored)` (tehty omistajalle yksilölliseksi) eikä enää arkistoituna, ja poistaa sitten tietueen. Epäonnistuu virheellä `project_too_old_to_restore`, kun `project` on `null`. Kutsutaan hallintapaneelista: yhden projektin palautus (`AdminProjectManager.mjs:497-515`) tai poistetun käyttäjän palautus yhdessä tilin mukana poistettujen projektien kanssa (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`). |
| `ProjectDeleter.mjs:344-416` (`expireDeletedProject`) | Tuhoaa projektin docsit, historian, keskustelun ja projektin tarkastuslokin, laukaisee koukun `projectExpired` ja asettaa sitten `project`- ja `deleterData.deleterIpAddress`-kentät arvoon `null`. Jos projekti on taas olemassa, poistaa vain vanhentuneen tietueen. |
| `ProjectDeleter.mjs:97-146` (`expireDeletedProjectsAfterDuration`) | Vanhentaa erän viivettä vanhempia tietueita. Reitti `POST /internal/expire-deleted-projects-after-duration` (`services/web/app/src/router.mjs:842-846`), jota Community Editionin cron kutsuu joka tunti minuutilla 20, kun `ENABLE_CRON_RESOURCE_DELETION` on `true` (`server-ce/cron/delete-projects.sh:10-23`, `server-ce/config/crontab-deletion:3`). Yksi projekti: `POST /internal/project/:projectId/expire-deleted-project` (`router.mjs:852-856`) tai Purge hallintapaneelissa (`AdminProjectManager.mjs:517-529`). |

#### Kuka lukee

| Koodi | Mitä se tekee |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272` (moduuli `admin-tools`) | Listaa poistetut projektit, jotka eivät ole vanhentuneet. |
| `AdminProjectManager.mjs:418-454` | Näyttää yhden poistetun projektin omistajan ja poistajan kanssa. |
| `AdminProjectManager.mjs:178-191` | Etsii projekteja linkkijakotunnisteen perusteella, myös poistettuja (`project.tokens.*`). |
| `AdminUserManager.mjs:678-684` | Etsii projektit, jotka palautetaan palautetun käyttäjän mukana: käyttäjän omistamat ja syyllä `account-deletion` tai ilman syytä poistetut. |

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`, yksilölliseksi muuttanut `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterdata_deletedProjectOwnerId_1` | `{ "deleterData.deletedProjectOwnerId": 1 }` | | `20200120163346_atlas_recommended_indexes.mjs` |
| `deleterData.deletedAt_1` | `{ "deleterData.deletedAt": 1 }` | osittainen: `project` on objekti | `20250126195914_update_deleterData.deletedAt_index.mjs` (korvaa tavallisen indeksin tiedostosta `20190912145002_create_deletedProjects_indexes.mjs`) |

Migraatiot ovat hakemistossa `tools/migrations/`.

#### Huomautukset

* Moduulit, jotka kuuntelevat tapahtumaa `projectExpired`, poistavat omat tietonsa projektista: `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`) ja `dropbox` (`services/web/modules/dropbox/index.mjs:54`).
* Vanhentunutta tietuetta ei koskaan poisteta: `deleterData` säilyy pysyvästi, vain `project` ja IP-osoite tyhjennetään.
* Mongoose antaa myös kentälle `deleterData` oman `_id`:n, jota mikään ei lue.


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