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

# Kolekce Project Invites

`projectInvites` obsahuje pozvánky, které vlastník projektu posílá z dialogu sdílení. Jeden dokument je jedna pozvánka na jednu e-mailovou adresu. Smaže se, když je pozvánka přijata nebo odvolána, případně ho smaže Mongo, když vyprší. Schéma je `services/web/app/src/models/ProjectInvite.mjs` a zapisuje ho `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs`.

Pozvánka z nikoho nedělá člena. Členové jsou v polích `*_refs` projektu, viz [Kolekce Projects](https://ayakaleaf-pro.mintlify.site/cs/dev/data-model/projects-collection.md).

#### Pole

| Pole | Typ | Význam | Zdroj |
| - | - | - | - |
| `_id` | ObjectId | Id pozvánky. Oznámení o pozvánce pro existujícího uživatele používá klíč `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Adresa, na kterou byla pozvánka odeslána. Při odvolání pozvánky pro uživatele se porovnává s jeho potvrzenými e-maily (`CollaboratorsInviteHandler.mjs:103-116`). U pozvánky přes odkaz pro sdílení není nastavena. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | HMAC-SHA256 (klíč `overleaf-token-invite`) tokenu v odkazu pozvánky. Čitelný token je jen v e-mailu a oznámení; vyhledávání token z URL zahashuje a porovná s tímto polem. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Jen u pozvánek přes odkaz pro sdílení: token zašifrovaný pomocí `Settings.projectInviteEncryptorOptions`, aby vlastník mohl odkaz znovu zobrazit (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Uživatel, který pozvánku odeslal. Při přijetí se předá jako uživatel, který přidal nového člena (`CollaboratorsInviteHandler.mjs:199-205`). U pozvánky přes odkaz pro sdílení není nastaven. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Projekt, kterého se pozvánka týká. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Přístup, který pozvaný získá: `readOnly`, `readAndWrite` nebo `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). Pozvánka přes odkaz pro sdílení může obsahovat i `false`, tedy žádný přístup. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Nastaví ho výchozí hodnota schématu při uložení pozvánky. | `ProjectInvite.mjs:26` |
| `expires` | Date | Výchozí hodnota schématu: 30 dní po vytvoření. TTL index pozvánku odstraní asi 10 sekund po tomto čase. `null` u pozvánky přes odkaz pro sdílení, která nikdy nevyprší. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` u e-mailové pozvánky, která se po přijetí smaže (`CollaboratorsInviteHandler.mjs:207-220`). `true` u pozvánky přes odkaz pro sdílení, která zůstává. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Jen u pozvánek přes odkaz pro sdílení: skupinové předplatné, jehož členové smějí odkaz přijmout (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Kdo zapisuje

| Kód | Co dělá |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Vytvoří e-mailovou pozvánku, pak odešle e-mail a u existujícího uživatele i oznámení. Volá ho `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Smaže jednu pozvánku a označí její oznámení jako přečtené. Volá ho `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Opětovné odeslání: smaže pozvánku a vytvoří novou s novým tokenem (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Smaže pozvánku odeslanou na jeden z potvrzených e-mailů uživatele, když se uživatel připojí přes token sdílení odkazem (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) nebo získá přístup po žádosti o přístup (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Přidá uživatele do projektu a pak pozvánku smaže, pokud není `reusable`. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Vytvoří nebo aktualizují jedinou opakovaně použitelnou pozvánku přes odkaz pro sdílení v projektu. Tyto trasy vyžadují split test `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`), který není v `splitTestOverrides` (`services/web/config/settings.defaults.js:1371-1383`). Proto odpovídají 403, dokud tento split test není nastaven. |

#### Kdo čte

| Kód | Co dělá |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Vypíše čekající e-mailové pozvánky pro dialog sdílení (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Přeskakuje opakovaně použitelné pozvánky. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | Spočítá čekající e-mailové pozvánky, které nejsou `readOnly`. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` je přičítá k editorům při kontrole limitu spolupracovníků. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Najde pozvánku podle hashe tokenu v URL, pro stránku pozvánky a pro přijetí (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Najde pozvánku přes odkaz pro sdílení v projektu. |

#### Indexy

| Název | Klíče | Volby | Migrace |
| - | - | - | - |
| `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` |

Migrace jsou v `tools/migrations/`. Schéma také deklaruje TTL index na `expires`, ale `autoIndex` v Mongoose je vypnutý (`services/web/app/src/infrastructure/Mongoose.mjs:7`), takže ho vytváří migrace.

#### Poznámky

* Pokud projekt při přijetí pozvánky `readAndWrite` nebo `review` nemá volné místo editora, uživatel se připojí jen pro čtení a je uveden v `pendingEditor_refs` nebo `pendingReviewer_refs` projektu (`CollaboratorsInviteHandler.mjs:162-205`).
* Starší pozvánky ukládaly čitelný token do pole `token`. Migrace `20240524135408_add_token_hmac_project_invite_tokens.mjs` přidala `tokenHmac` a `20240531082910_remove_project_invite_tokens.mjs` odstranila `token`.
* Nic nemaže pozvánky smazaného projektu; zůstávají, dokud je neodstraní TTL index.


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