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

`projectInvites` enthält die Einladungen, die ein Projekteigentümer über den Teilen-Dialog verschickt. Ein Dokument ist eine Einladung an eine E-Mail-Adresse. Es wird gelöscht, wenn die Einladung angenommen oder widerrufen wird, oder von Mongo, wenn sie abläuft. Das Schema ist `services/web/app/src/models/ProjectInvite.mjs`, und `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs` schreibt es.

Eine Einladung macht niemanden zum Mitglied. Mitglieder stehen in den `*_refs`-Arrays eines Projekts, siehe [Projects-Collection](https://ayakaleaf-pro.mintlify.site/de/dev/data-model/projects-collection.md).

#### Felder

| Feld | Typ | Bedeutung | Quelle |
| - | - | - | - |
| `_id` | ObjectId | Einladungs-ID. Die Einladungsbenachrichtigung eines bestehenden Benutzers verwendet den Schlüssel `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Adresse, an die die Einladung ging. Beim Widerrufen einer Einladung für einen Benutzer wird sie mit den bestätigten E-Mail-Adressen des Benutzers abgeglichen (`CollaboratorsInviteHandler.mjs:103-116`). Bei einer Freigabelink-Einladung nicht gesetzt. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | HMAC-SHA256 (Schlüssel `overleaf-token-invite`) des Tokens im Einladungslink. Das Klartext-Token steht nur in der E-Mail und der Benachrichtigung; Abfragen hashen das Token aus der URL und vergleichen es mit diesem Feld. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Nur bei Freigabelink-Einladungen: das Token, verschlüsselt mit `Settings.projectInviteEncryptorOptions`, damit der Eigentümer den Link erneut sehen kann (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Benutzer, der die Einladung verschickt hat. Beim Annehmen wird er als der Benutzer weitergegeben, der das neue Mitglied hinzugefügt hat (`CollaboratorsInviteHandler.mjs:199-205`). Bei einer Freigabelink-Einladung nicht gesetzt. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Projekt, für das die Einladung gilt. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Zugriff, den der Eingeladene erhält: `readOnly`, `readAndWrite` oder `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). Eine Freigabelink-Einladung kann auch `false` enthalten, also keinen Zugriff. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Wird beim Speichern der Einladung durch den Schema-Standardwert gesetzt. | `ProjectInvite.mjs:26` |
| `expires` | Date | Schema-Standardwert: 30 Tage nach der Erstellung. Der TTL-Index entfernt die Einladung etwa 10 Sekunden nach diesem Zeitpunkt. `null` bei einer Freigabelink-Einladung, die nie abläuft. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` bei einer E-Mail-Einladung, die beim Annehmen gelöscht wird (`CollaboratorsInviteHandler.mjs:207-220`). `true` bei einer Freigabelink-Einladung, die bestehen bleibt. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Nur bei Freigabelink-Einladungen: das Gruppenabonnement, dessen Mitglieder den Link annehmen dürfen (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Wer schreibt

| Code | Funktion |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Erstellt eine E-Mail-Einladung und sendet dann die E-Mail sowie, für einen bestehenden Benutzer, eine Benachrichtigung. Aufgerufen von `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Löscht eine Einladung und markiert ihre Benachrichtigung als gelesen. Aufgerufen von `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Erneut senden: löscht die Einladung und erstellt eine neue mit einem neuen Token (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Löscht die Einladung an eine der bestätigten E-Mail-Adressen des Benutzers, wenn der Benutzer über ein Linkfreigabe-Token beitritt (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) oder nach einer Zugriffsanfrage Zugriff erhält (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Fügt den Benutzer zum Projekt hinzu und löscht dann die Einladung, sofern sie nicht `reusable` ist. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Erstellen oder aktualisieren die eine wiederverwendbare Freigabelink-Einladung eines Projekts. Diese Routen erfordern den Split-Test `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`), der nicht in `splitTestOverrides` steht (`services/web/config/settings.defaults.js:1371-1383`). Sie antworten daher mit 403, solange dieser Split-Test nicht eingerichtet ist. |

#### Wer liest

| Code | Funktion |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Listet die offenen E-Mail-Einladungen für den Teilen-Dialog auf (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Überspringt wiederverwendbare Einladungen. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | Zählt offene E-Mail-Einladungen, die nicht `readOnly` sind. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` rechnet sie zu den Bearbeitern, wenn es das Mitarbeiterlimit prüft. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Findet eine Einladung über den Hash des Tokens in der URL, für die Einladungsseite und zum Annehmen (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Findet die Freigabelink-Einladung eines Projekts. |

#### Indizes

| Name | Schlüssel | Optionen | 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` |

Die Migrationen liegen in `tools/migrations/`. Das Schema deklariert auch den TTL-Index auf `expires`, aber Mongoose-`autoIndex` ist deaktiviert (`services/web/app/src/infrastructure/Mongoose.mjs:7`), daher legt die Migration ihn an.

#### Hinweise

* Wenn das Projekt beim Annehmen einer `readAndWrite`- oder `review`-Einladung keinen freien Bearbeiterplatz mehr hat, tritt der Benutzer mit Lesezugriff bei und wird in `pendingEditor_refs` oder `pendingReviewer_refs` des Projekts geführt (`CollaboratorsInviteHandler.mjs:162-205`).
* Ältere Einladungen speicherten das Klartext-Token in einem Feld `token`. Die Migration `20240524135408_add_token_hmac_project_invite_tokens.mjs` fügte `tokenHmac` hinzu, und `20240531082910_remove_project_invite_tokens.mjs` entfernte `token`.
* Nichts löscht die Einladungen eines gelöschten Projekts; sie bleiben, bis der TTL-Index sie entfernt.


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