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

# Collection Project Invites

`projectInvites` contient les invitations qu'un propriétaire de projet envoie depuis la boîte de dialogue de partage. Un document correspond à une invitation pour une adresse e-mail. Il est supprimé quand l'invitation est acceptée ou révoquée, ou par Mongo quand elle expire. Le schéma est `services/web/app/src/models/ProjectInvite.mjs`, et `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs` l'écrit.

Une invitation ne fait de personne un membre. Les membres se trouvent dans les tableaux `*_refs` d'un projet, voir [Collection Projects](https://ayakaleaf-pro.mintlify.site/fr/dev/data-model/projects-collection.md).

#### Champs

| Champ | Type | Signification | Source |
| - | - | - | - |
| `_id` | ObjectId | Identifiant de l'invitation. La notification d'invitation d'un utilisateur existant utilise la clé `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Adresse à laquelle l'invitation a été envoyée. La révocation d'une invitation pour un utilisateur la compare aux adresses confirmées de l'utilisateur (`CollaboratorsInviteHandler.mjs:103-116`). Non définie pour une invitation par lien de partage. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | HMAC-SHA256 (clé `overleaf-token-invite`) du jeton du lien d'invitation. Le jeton en clair ne figure que dans l'e-mail et la notification ; les recherches hachent le jeton de l'URL et le comparent à ce champ. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Invitations par lien de partage uniquement : le jeton, chiffré avec `Settings.projectInviteEncryptorOptions`, pour que le propriétaire puisse revoir le lien (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Utilisateur qui a envoyé l'invitation. À l'acceptation, il est transmis comme l'utilisateur qui a ajouté le nouveau membre (`CollaboratorsInviteHandler.mjs:199-205`). Non défini pour une invitation par lien de partage. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Projet concerné par l'invitation. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Accès accordé à la personne invitée : `readOnly`, `readAndWrite` ou `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). Une invitation par lien de partage peut aussi contenir `false`, c'est-à-dire aucun accès. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Défini par la valeur par défaut du schéma à l'enregistrement de l'invitation. | `ProjectInvite.mjs:26` |
| `expires` | Date | Valeur par défaut du schéma : 30 jours après la création. L'index TTL supprime l'invitation environ 10 secondes après cette date. `null` pour une invitation par lien de partage, qui n'expire jamais. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` pour une invitation par e-mail, supprimée à l'acceptation (`CollaboratorsInviteHandler.mjs:207-220`). `true` pour une invitation par lien de partage, qui reste. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Invitations par lien de partage uniquement : l'abonnement de groupe dont les membres peuvent accepter le lien (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Qui écrit

| Code | Rôle |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Crée une invitation par e-mail, puis envoie l'e-mail et, pour un utilisateur existant, une notification. Appelé par `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Supprime une invitation et marque sa notification comme lue. Appelé par `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Renvoi : supprime l'invitation et en crée une nouvelle avec un nouveau jeton (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Supprime l'invitation envoyée à l'une des adresses confirmées de l'utilisateur, quand l'utilisateur rejoint via un jeton de partage par lien (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) ou obtient l'accès après une demande d'accès (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Ajoute l'utilisateur au projet, puis supprime l'invitation sauf si elle est `reusable`. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Créent ou mettent à jour l'unique invitation réutilisable par lien de partage d'un projet. Ces routes exigent le split test `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`), qui n'est pas dans `splitTestOverrides` (`services/web/config/settings.defaults.js:1371-1383`). Elles répondent donc 403 tant que ce split test n'est pas configuré. |

#### Qui lit

| Code | Rôle |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Liste les invitations par e-mail en attente pour la boîte de dialogue de partage (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Ignore les invitations réutilisables. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | Compte les invitations par e-mail en attente qui ne sont pas `readOnly`. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` les ajoute aux éditeurs lorsqu'il vérifie la limite de collaborateurs. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Trouve une invitation par le hachage du jeton de l'URL, pour la page d'invitation et pour l'acceptation (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Trouve l'invitation par lien de partage d'un projet. |

#### Index

| Nom | Clés | Options | Migration |
| - | - | - | - |
| `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` |

Les migrations se trouvent dans `tools/migrations/`. Le schéma déclare aussi l'index TTL sur `expires`, mais l'`autoIndex` de Mongoose est désactivé (`services/web/app/src/infrastructure/Mongoose.mjs:7`), c'est donc la migration qui le crée.

#### Remarques

* Si le projet n'a plus de place d'éditeur quand une invitation `readAndWrite` ou `review` est acceptée, l'utilisateur rejoint en lecture seule et figure dans `pendingEditor_refs` ou `pendingReviewer_refs` du projet (`CollaboratorsInviteHandler.mjs:162-205`).
* Les anciennes invitations stockaient le jeton en clair dans un champ `token`. La migration `20240524135408_add_token_hmac_project_invite_tokens.mjs` a ajouté `tokenHmac` et `20240531082910_remove_project_invite_tokens.mjs` a supprimé `token`.
* Rien ne supprime les invitations d'un projet supprimé ; elles restent jusqu'à ce que l'index TTL les supprime.


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