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

# Collezione Project Invites

`projectInvites` contiene gli inviti che il proprietario di un progetto invia dalla finestra di condivisione. Un documento è un invito a un indirizzo email. Viene eliminato quando l'invito viene accettato o revocato, oppure da Mongo quando scade. Lo schema è `services/web/app/src/models/ProjectInvite.mjs`, e lo scrive `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs`.

Un invito non rende nessuno membro. I membri si trovano negli array `*_refs` di un progetto, vedi [Collezione Projects](https://ayakaleaf-pro.mintlify.site/it/dev/data-model/projects-collection.md).

#### Campi

| Campo | Tipo | Significato | Fonte |
| - | - | - | - |
| `_id` | ObjectId | Id dell'invito. La notifica di invito di un utente esistente usa la chiave `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Indirizzo a cui è stato inviato l'invito. Quando si revoca un invito per un utente, viene confrontato con le email confermate dell'utente (`CollaboratorsInviteHandler.mjs:103-116`). Non impostato in un invito tramite link di condivisione. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | HMAC-SHA256 (chiave `overleaf-token-invite`) del token nel link di invito. Il token in chiaro è solo nell'email e nella notifica; le ricerche applicano l'hash al token dell'URL e lo confrontano con questo campo. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Solo negli inviti tramite link di condivisione: il token, cifrato con `Settings.projectInviteEncryptorOptions`, così il proprietario può rivedere il link (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Utente che ha inviato l'invito. All'accettazione viene passato come l'utente che ha aggiunto il nuovo membro (`CollaboratorsInviteHandler.mjs:199-205`). Non impostato in un invito tramite link di condivisione. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Progetto a cui si riferisce l'invito. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Accesso che riceve l'invitato: `readOnly`, `readAndWrite` o `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). Un invito tramite link di condivisione può contenere anche `false`, cioè nessun accesso. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Impostato dal valore predefinito dello schema quando l'invito viene salvato. | `ProjectInvite.mjs:26` |
| `expires` | Date | Valore predefinito dello schema: 30 giorni dopo la creazione. L'indice TTL rimuove l'invito circa 10 secondi dopo questo momento. `null` in un invito tramite link di condivisione, che non scade mai. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` in un invito via email, che viene eliminato all'accettazione (`CollaboratorsInviteHandler.mjs:207-220`). `true` in un invito tramite link di condivisione, che resta. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Solo negli inviti tramite link di condivisione: l'abbonamento di gruppo i cui membri possono accettare il link (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Chi scrive

| Codice | Cosa fa |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Crea un invito via email, poi invia l'email e, per un utente esistente, una notifica. Chiamato da `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Elimina un invito e segna la sua notifica come letta. Chiamato da `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Reinvio: elimina l'invito e ne crea uno nuovo con un nuovo token (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Elimina l'invito inviato a una delle email confermate dell'utente, quando l'utente si unisce tramite un token di condivisione via link (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) o riceve l'accesso dopo una richiesta di accesso (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Aggiunge l'utente al progetto, poi elimina l'invito a meno che non sia `reusable`. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Creano o aggiornano l'unico invito riutilizzabile tramite link di condivisione di un progetto. Queste route richiedono lo split test `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`), che non è in `splitTestOverrides` (`services/web/config/settings.defaults.js:1371-1383`). Rispondono quindi 403 finché quello split test non viene configurato. |

#### Chi legge

| Codice | Cosa fa |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Elenca gli inviti via email in sospeso per la finestra di condivisione (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Salta gli inviti riutilizzabili. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | Conta gli inviti via email in sospeso che non sono `readOnly`. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` li somma agli editor quando verifica il limite di collaboratori. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Trova un invito tramite l'hash del token nell'URL, per la pagina di invito e per l'accettazione (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Trova l'invito tramite link di condivisione di un progetto. |

#### Indici

| Nome | Chiavi | Opzioni | Migrazione |
| - | - | - | - |
| `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` |

Le migrazioni si trovano in `tools/migrations/`. Lo schema dichiara anche l'indice TTL su `expires`, ma l'`autoIndex` di Mongoose è disattivato (`services/web/app/src/infrastructure/Mongoose.mjs:7`), quindi lo crea la migrazione.

#### Note

* Se il progetto non ha più posti da editor liberi quando viene accettato un invito `readAndWrite` o `review`, l'utente si unisce in sola lettura ed è elencato in `pendingEditor_refs` o `pendingReviewer_refs` del progetto (`CollaboratorsInviteHandler.mjs:162-205`).
* Gli inviti più vecchi salvavano il token in chiaro in un campo `token`. La migrazione `20240524135408_add_token_hmac_project_invite_tokens.mjs` ha aggiunto `tokenHmac` e `20240531082910_remove_project_invite_tokens.mjs` ha rimosso `token`.
* Niente elimina gli inviti di un progetto eliminato; restano finché l'indice TTL non li rimuove.


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