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

# Samlingen Project Invites

`projectInvites` innehåller de inbjudningar som en projektägare skickar från delningsdialogen. Ett dokument är en inbjudan till en e-postadress. Det tas bort när inbjudan accepteras eller återkallas, eller av Mongo när den löper ut. Schemat är `services/web/app/src/models/ProjectInvite.mjs`, och `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs` skriver det.

En inbjudan gör ingen till medlem. Medlemmarna finns i projektets `*_refs`-arrayer, se [Samlingen Projects](https://ayakaleaf-pro.mintlify.site/sv/dev/data-model/projects-collection.md).

#### Fält

| Fält | Typ | Betydelse | Källa |
| - | - | - | - |
| `_id` | ObjectId | Inbjudans id. Inbjudningsaviseringen för en befintlig användare använder nyckeln `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Adressen som inbjudan skickades till. När en inbjudan för en användare återkallas jämförs den med användarens bekräftade e-postadresser (`CollaboratorsInviteHandler.mjs:103-116`). Inte satt för en inbjudan via delningslänk. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | HMAC-SHA256 (nyckel `overleaf-token-invite`) av token i inbjudningslänken. Klartexttoken finns bara i e-postmeddelandet och aviseringen; uppslag hashar token från URL:en och jämför med detta fält. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Bara för inbjudningar via delningslänk: token, krypterad med `Settings.projectInviteEncryptorOptions`, så att ägaren kan se länken igen (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Användaren som skickade inbjudan. Vid accept skickas den vidare som användaren som lade till den nya medlemmen (`CollaboratorsInviteHandler.mjs:199-205`). Inte satt för en inbjudan via delningslänk. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Projektet som inbjudan gäller. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Åtkomst som den inbjudna får: `readOnly`, `readAndWrite` eller `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). En inbjudan via delningslänk kan också innehålla `false`, alltså ingen åtkomst. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Sätts av schemats standardvärde när inbjudan sparas. | `ProjectInvite.mjs:26` |
| `expires` | Date | Schemats standardvärde: 30 dagar efter skapandet. TTL-indexet tar bort inbjudan cirka 10 sekunder efter denna tidpunkt. `null` för en inbjudan via delningslänk, som aldrig löper ut. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` för en e-postinbjudan, som tas bort när den accepteras (`CollaboratorsInviteHandler.mjs:207-220`). `true` för en inbjudan via delningslänk, som finns kvar. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Bara för inbjudningar via delningslänk: gruppabonnemanget vars medlemmar får acceptera länken (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Vem skriver

| Kod | Vad den gör |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Skapar en e-postinbjudan och skickar sedan e-postmeddelandet och, för en befintlig användare, en avisering. Anropas av `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Tar bort en inbjudan och markerar dess avisering som läst. Anropas av `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Skicka igen: tar bort inbjudan och skapar en ny med en ny token (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Tar bort inbjudan som skickats till en av användarens bekräftade e-postadresser, när användaren går med via en token för länkdelning (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) eller får åtkomst efter en åtkomstbegäran (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Lägger till användaren i projektet och tar sedan bort inbjudan om den inte är `reusable`. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Skapar eller uppdaterar projektets enda återanvändbara inbjudan via delningslänk. Dessa routes kräver split testet `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`), som inte finns i `splitTestOverrides` (`services/web/config/settings.defaults.js:1371-1383`). De svarar därför 403 så länge det split testet inte är konfigurerat. |

#### Vem läser

| Kod | Vad den gör |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Listar väntande e-postinbjudningar för delningsdialogen (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Hoppar över återanvändbara inbjudningar. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | Räknar väntande e-postinbjudningar som inte är `readOnly`. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` lägger till dem bland redigerarna när den kontrollerar gränsen för medarbetare. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Hittar en inbjudan via hashen av token i URL:en, för inbjudningssidan och för att acceptera (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Hittar projektets inbjudan via delningslänk. |

#### Index

| Namn | Nycklar | Alternativ | 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` |

Migreringarna finns i `tools/migrations/`. Schemat deklarerar också TTL-indexet på `expires`, men Mongoose `autoIndex` är avstängt (`services/web/app/src/infrastructure/Mongoose.mjs:7`), så migreringen skapar det.

#### Anteckningar

* Om projektet inte har någon ledig redigerarplats när en `readAndWrite`- eller `review`-inbjudan accepteras går användaren med som läsbehörig och listas i projektets `pendingEditor_refs` eller `pendingReviewer_refs` (`CollaboratorsInviteHandler.mjs:162-205`).
* Äldre inbjudningar lagrade klartexttoken i ett fält `token`. Migreringen `20240524135408_add_token_hmac_project_invite_tokens.mjs` lade till `tokenHmac` och `20240531082910_remove_project_invite_tokens.mjs` tog bort `token`.
* Inget tar bort inbjudningarna för ett borttaget projekt; de finns kvar tills TTL-indexet tar bort dem.


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