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

# Project Invites -kokoelma

`projectInvites` sisältää kutsut, jotka projektin omistaja lähettää jakamisikkunasta. Yksi dokumentti on yksi kutsu yhteen sähköpostiosoitteeseen. Se poistetaan, kun kutsu hyväksytään tai perutaan, tai Mongo poistaa sen, kun se vanhenee. Skeema on `services/web/app/src/models/ProjectInvite.mjs`, ja sitä kirjoittaa `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs`.

Kutsu ei tee kenestäkään jäsentä. Jäsenet ovat projektin `*_refs`-taulukoissa, katso [Projects-kokoelma](https://ayakaleaf-pro.mintlify.site/fi/dev/data-model/projects-collection.md).

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Kutsun id. Olemassa olevan käyttäjän kutsuilmoitus käyttää avainta `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Osoite, johon kutsu lähetettiin. Kun käyttäjän kutsu perutaan, sitä verrataan käyttäjän vahvistettuihin osoitteisiin (`CollaboratorsInviteHandler.mjs:103-116`). Ei asetettu jakolinkkikutsussa. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | Kutsulinkin tunnuksen HMAC-SHA256 (avain `overleaf-token-invite`). Selväkielinen tunnus on vain sähköpostissa ja ilmoituksessa; haut tiivistävät URL:n tunnuksen ja vertaavat sitä tähän kenttään. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Vain jakolinkkikutsuissa: tunnus salattuna asetuksella `Settings.projectInviteEncryptorOptions`, jotta omistaja voi nähdä linkin uudelleen (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Kutsun lähettänyt käyttäjä. Hyväksynnässä se välitetään käyttäjänä, joka lisäsi uuden jäsenen (`CollaboratorsInviteHandler.mjs:199-205`). Ei asetettu jakolinkkikutsussa. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Projekti, jota kutsu koskee. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Kutsutun saama käyttöoikeus: `readOnly`, `readAndWrite` tai `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). Jakolinkkikutsu voi sisältää myös arvon `false`, eli ei käyttöoikeutta. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Skeeman oletusarvo asettaa sen, kun kutsu tallennetaan. | `ProjectInvite.mjs:26` |
| `expires` | Date | Skeeman oletusarvo: 30 päivää luonnin jälkeen. TTL-indeksi poistaa kutsun noin 10 sekuntia tämän ajan jälkeen. `null` jakolinkkikutsussa, joka ei koskaan vanhene. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` sähköpostikutsussa, joka poistetaan hyväksyttäessä (`CollaboratorsInviteHandler.mjs:207-220`). `true` jakolinkkikutsussa, joka säilyy. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Vain jakolinkkikutsuissa: ryhmätilaus, jonka jäsenet saavat hyväksyä linkin (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Luo sähköpostikutsun ja lähettää sitten sähköpostin sekä olemassa olevalle käyttäjälle ilmoituksen. Kutsuja: `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Poistaa yhden kutsun ja merkitsee sen ilmoituksen luetuksi. Kutsuja: `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Uudelleenlähetys: poistaa kutsun ja luo uuden uudella tunnuksella (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Poistaa käyttäjän johonkin vahvistettuun osoitteeseen lähetetyn kutsun, kun käyttäjä liittyy linkkijaon tunnuksella (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) tai saa käyttöoikeuden käyttöoikeuspyynnön jälkeen (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Lisää käyttäjän projektiin ja poistaa sitten kutsun, ellei se ole `reusable`. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Luovat tai päivittävät projektin ainoan uudelleenkäytettävän jakolinkkikutsun. Nämä reitit vaativat split testin `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`), joka ei ole asetuksessa `splitTestOverrides` (`services/web/config/settings.defaults.js:1371-1383`). Siksi ne vastaavat 403, ellei split testiä ole määritetty. |

#### Kuka lukee

| Koodi | Mitä se tekee |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Listaa odottavat sähköpostikutsut jakamisikkunaan (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Ohittaa uudelleenkäytettävät kutsut. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | Laskee odottavat sähköpostikutsut, jotka eivät ole `readOnly`. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` lisää ne muokkaajiin tarkistaessaan yhteistyökumppanirajan. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Etsii kutsun URL:n tunnuksen tiivisteellä kutsusivua ja hyväksymistä varten (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Etsii projektin jakolinkkikutsun. |

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `expires_1` | `{ expires: 1 }` | TTL, `expireAfterSeconds: 10` | `20190912145023_create_projectInvites_indexes.mjs` |
| `projectId_1` | `{ projectId: 1 }` | | `20190912145023_create_projectInvites_indexes.mjs` |
| `tokenHmac_1` | `{ tokenHmac: 1 }` | | `20240524135408_add_token_hmac_project_invite_tokens.mjs` |

Migraatiot ovat hakemistossa `tools/migrations/`. Skeema määrittelee myös TTL-indeksin kentälle `expires`, mutta Mongoosen `autoIndex` on pois päältä (`services/web/app/src/infrastructure/Mongoose.mjs:7`), joten migraatio luo sen.

#### Huomautukset

* Jos projektissa ei ole vapaata muokkaajapaikkaa, kun `readAndWrite`- tai `review`-kutsu hyväksytään, käyttäjä liittyy vain lukuoikeuksin ja hänet listataan projektin kenttään `pendingEditor_refs` tai `pendingReviewer_refs` (`CollaboratorsInviteHandler.mjs:162-205`).
* Vanhemmat kutsut tallensivat selväkielisen tunnuksen kenttään `token`. Migraatio `20240524135408_add_token_hmac_project_invite_tokens.mjs` lisäsi kentän `tokenHmac` ja `20240531082910_remove_project_invite_tokens.mjs` poisti kentän `token`.
* Mikään ei poista poistetun projektin kutsuja; ne säilyvät, kunnes TTL-indeksi poistaa ne.


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