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

`projectInvites` inneholder invitasjonene som en prosjekteier sender fra delingsdialogen. Ett dokument er én invitasjon til én e-postadresse. Det slettes når invitasjonen godtas eller trekkes tilbake, eller av Mongo når den utløper. Skjemaet er `services/web/app/src/models/ProjectInvite.mjs`, og `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs` skriver det.

En invitasjon gjør ingen til medlem. Medlemmene ligger i prosjektets `*_refs`-arrayer, se [Prosjektsamlingen](https://ayakaleaf-pro.mintlify.site/no/dev/data-model/projects-collection.md).

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Invitasjonens id. Invitasjonsvarselet for en eksisterende bruker bruker nøkkelen `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Adressen invitasjonen ble sendt til. Når en invitasjon for en bruker trekkes tilbake, sammenlignes den med brukerens bekreftede e-postadresser (`CollaboratorsInviteHandler.mjs:103-116`). Ikke satt for en invitasjon via delingslenke. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | HMAC-SHA256 (nøkkel `overleaf-token-invite`) av tokenet i invitasjonslenken. Klartekst-tokenet finnes bare i e-posten og varselet; oppslag hasher tokenet fra URL-en og sammenligner med dette feltet. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Bare for invitasjoner via delingslenke: tokenet, kryptert med `Settings.projectInviteEncryptorOptions`, slik at eieren kan se lenken igjen (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Brukeren som sendte invitasjonen. Ved godtakelse sendes den videre som brukeren som la til det nye medlemmet (`CollaboratorsInviteHandler.mjs:199-205`). Ikke satt for en invitasjon via delingslenke. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Prosjektet invitasjonen gjelder. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Tilgangen den inviterte får: `readOnly`, `readAndWrite` eller `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). En invitasjon via delingslenke kan også inneholde `false`, altså ingen tilgang. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Settes av skjemaets standardverdi når invitasjonen lagres. | `ProjectInvite.mjs:26` |
| `expires` | Date | Skjemaets standardverdi: 30 dager etter opprettelse. TTL-indeksen fjerner invitasjonen omtrent 10 sekunder etter dette tidspunktet. `null` for en invitasjon via delingslenke, som aldri utløper. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` for en e-postinvitasjon, som slettes når den godtas (`CollaboratorsInviteHandler.mjs:207-220`). `true` for en invitasjon via delingslenke, som blir værende. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Bare for invitasjoner via delingslenke: gruppeabonnementet der medlemmene kan godta lenken (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Hvem skriver

| Kode | Hva den gjør |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Oppretter en e-postinvitasjon og sender deretter e-posten og, for en eksisterende bruker, et varsel. Kalles av `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Sletter én invitasjon og markerer varselet som lest. Kalles av `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Send på nytt: sletter invitasjonen og oppretter en ny med et nytt token (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Sletter invitasjonen sendt til en av brukerens bekreftede e-postadresser, når brukeren blir med via et token for lenkedeling (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) eller får tilgang etter en tilgangsforespørsel (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Legger brukeren til i prosjektet og sletter deretter invitasjonen, med mindre den er `reusable`. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Oppretter eller oppdaterer prosjektets ene gjenbrukbare invitasjon via delingslenke. Disse rutene krever split testen `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`), som ikke står i `splitTestOverrides` (`services/web/config/settings.defaults.js:1371-1383`). De svarer derfor 403 så lenge den split testen ikke er satt opp. |

#### Hvem leser

| Kode | Hva den gjør |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Lister ventende e-postinvitasjoner for delingsdialogen (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Hopper over gjenbrukbare invitasjoner. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | Teller ventende e-postinvitasjoner som ikke er `readOnly`. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` legger dem til redaktørene når den sjekker grensen for samarbeidspartnere. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Finner en invitasjon via hashen av tokenet i URL-en, for invitasjonssiden og for godtakelse (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Finner prosjektets invitasjon via delingslenke. |

#### Indekser

| Navn | Nøkler | Alternativer | Migrering |
| - | - | - | - |
| `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` |

Migreringene ligger i `tools/migrations/`. Skjemaet deklarerer også TTL-indeksen på `expires`, men Mongoose `autoIndex` er slått av (`services/web/app/src/infrastructure/Mongoose.mjs:7`), så migreringen oppretter den.

#### Merknader

* Hvis prosjektet ikke har ledig redaktørplass når en `readAndWrite`- eller `review`-invitasjon godtas, blir brukeren med som lesebruker og står i prosjektets `pendingEditor_refs` eller `pendingReviewer_refs` (`CollaboratorsInviteHandler.mjs:162-205`).
* Eldre invitasjoner lagret klartekst-tokenet i et felt `token`. Migreringen `20240524135408_add_token_hmac_project_invite_tokens.mjs` la til `tokenHmac` og `20240531082910_remove_project_invite_tokens.mjs` fjernet `token`.
* Ingenting sletter invitasjonene til et slettet prosjekt; de blir værende til TTL-indeksen fjerner dem.


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