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

`projectInvites` bevat de uitnodigingen die een projecteigenaar vanuit het deeldialoogvenster verstuurt. Eén document is één uitnodiging aan één e-mailadres. Het wordt verwijderd als de uitnodiging wordt geaccepteerd of ingetrokken, of door Mongo als die verloopt. Het schema is `services/web/app/src/models/ProjectInvite.mjs`, en `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs` schrijft het.

Een uitnodiging maakt niemand lid. Leden staan in de `*_refs`-arrays van een project, zie [Projects-collectie](https://ayakaleaf-pro.mintlify.site/nl/dev/data-model/projects-collection.md).

#### Velden

| Veld | Type | Betekenis | Bron |
| - | - | - | - |
| `_id` | ObjectId | Uitnodigings-id. De uitnodigingsmelding van een bestaande gebruiker gebruikt de sleutel `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Adres waarnaar de uitnodiging is verstuurd. Bij het intrekken van een uitnodiging voor een gebruiker wordt het vergeleken met de bevestigde e-mailadressen van de gebruiker (`CollaboratorsInviteHandler.mjs:103-116`). Niet ingesteld bij een uitnodiging via een deellink. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | HMAC-SHA256 (sleutel `overleaf-token-invite`) van het token in de uitnodigingslink. Het token in platte tekst staat alleen in de e-mail en de melding; zoekopdrachten hashen het token uit de URL en vergelijken het met dit veld. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Alleen bij uitnodigingen via een deellink: het token, versleuteld met `Settings.projectInviteEncryptorOptions`, zodat de eigenaar de link opnieuw kan zien (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Gebruiker die de uitnodiging heeft verstuurd. Bij accepteren wordt deze doorgegeven als de gebruiker die het nieuwe lid heeft toegevoegd (`CollaboratorsInviteHandler.mjs:199-205`). Niet ingesteld bij een uitnodiging via een deellink. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Project waarvoor de uitnodiging geldt. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Toegang die de genodigde krijgt: `readOnly`, `readAndWrite` of `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). Een uitnodiging via een deellink kan ook `false` bevatten, wat geen toegang betekent. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Gezet door de standaardwaarde van het schema bij het opslaan van de uitnodiging. | `ProjectInvite.mjs:26` |
| `expires` | Date | Standaardwaarde van het schema: 30 dagen na het aanmaken. De TTL-index verwijdert de uitnodiging ongeveer 10 seconden na dit tijdstip. `null` bij een uitnodiging via een deellink, die nooit verloopt. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` bij een e-mailuitnodiging, die bij accepteren wordt verwijderd (`CollaboratorsInviteHandler.mjs:207-220`). `true` bij een uitnodiging via een deellink, die blijft bestaan. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Alleen bij uitnodigingen via een deellink: het groepsabonnement waarvan de leden de link mogen accepteren (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Wie schrijft

| Code | Wat het doet |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Maakt een e-mailuitnodiging aan en verstuurt daarna de e-mail en, voor een bestaande gebruiker, een melding. Aangeroepen door `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Verwijdert één uitnodiging en markeert de melding ervan als gelezen. Aangeroepen door `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Opnieuw versturen: verwijdert de uitnodiging en maakt een nieuwe met een nieuw token (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Verwijdert de uitnodiging aan een van de bevestigde e-mailadressen van de gebruiker, wanneer de gebruiker deelneemt via een linkdelingstoken (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) of toegang krijgt na een toegangsverzoek (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Voegt de gebruiker toe aan het project en verwijdert daarna de uitnodiging, tenzij die `reusable` is. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Maken of werken de ene herbruikbare deellinkuitnodiging van een project bij. Deze routes vereisen de split test `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`), die niet in `splitTestOverrides` staat (`services/web/config/settings.defaults.js:1371-1383`). Ze antwoorden dus met 403 zolang die split test niet is ingesteld. |

#### Wie leest

| Code | Wat het doet |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Toont de openstaande e-mailuitnodigingen in het deeldialoogvenster (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Slaat herbruikbare uitnodigingen over. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | Telt openstaande e-mailuitnodigingen die niet `readOnly` zijn. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` telt ze op bij de bewerkers wanneer het de limiet voor medewerkers controleert. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Vindt een uitnodiging via de hash van het token in de URL, voor de uitnodigingspagina en voor accepteren (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Vindt de deellinkuitnodiging van een project. |

#### Indexen

| Naam | Sleutels | Opties | Migratie |
| - | - | - | - |
| `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` |

De migraties staan in `tools/migrations/`. Het schema declareert ook de TTL-index op `expires`, maar Mongoose-`autoIndex` staat uit (`services/web/app/src/infrastructure/Mongoose.mjs:7`), dus de migratie maakt hem aan.

#### Opmerkingen

* Als het project geen vrije bewerkersplaats meer heeft wanneer een `readAndWrite`- of `review`-uitnodiging wordt geaccepteerd, neemt de gebruiker deel met alleen-lezentoegang en staat hij in `pendingEditor_refs` of `pendingReviewer_refs` van het project (`CollaboratorsInviteHandler.mjs:162-205`).
* Oudere uitnodigingen sloegen het token in platte tekst op in een veld `token`. Migratie `20240524135408_add_token_hmac_project_invite_tokens.mjs` voegde `tokenHmac` toe en `20240531082910_remove_project_invite_tokens.mjs` verwijderde `token`.
* Niets verwijdert de uitnodigingen van een verwijderd project; ze blijven bestaan totdat de TTL-index ze verwijdert.


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