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

# Colección Project Invites

`projectInvites` contiene las invitaciones que el propietario de un proyecto envía desde el diálogo de compartir. Un documento es una invitación a una dirección de correo. Se borra cuando la invitación se acepta o se revoca, o lo borra Mongo cuando caduca. El esquema es `services/web/app/src/models/ProjectInvite.mjs`, y lo escribe `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs`.

Una invitación no convierte a nadie en miembro. Los miembros están en los arrays `*_refs` de un proyecto, ver [Colección Projects](https://ayakaleaf-pro.mintlify.site/es/dev/data-model/projects-collection.md).

#### Campos

| Campo | Tipo | Significado | Origen |
| - | - | - | - |
| `_id` | ObjectId | Id de la invitación. La notificación de invitación de un usuario existente usa la clave `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Dirección a la que se envió la invitación. Al revocar una invitación para un usuario, se compara con los correos confirmados del usuario (`CollaboratorsInviteHandler.mjs:103-116`). No se establece en una invitación por enlace para compartir. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | HMAC-SHA256 (clave `overleaf-token-invite`) del token del enlace de invitación. El token en claro solo está en el correo y en la notificación; las búsquedas aplican hash al token de la URL y lo comparan con este campo. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Solo en invitaciones por enlace para compartir: el token, cifrado con `Settings.projectInviteEncryptorOptions`, para que el propietario pueda volver a ver el enlace (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Usuario que envió la invitación. Al aceptarla, se pasa como el usuario que añadió al nuevo miembro (`CollaboratorsInviteHandler.mjs:199-205`). No se establece en una invitación por enlace para compartir. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Proyecto al que corresponde la invitación. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Acceso que recibe la persona invitada: `readOnly`, `readAndWrite` o `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). Una invitación por enlace para compartir también puede contener `false`, es decir, sin acceso. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Lo establece el valor predeterminado del esquema al guardar la invitación. | `ProjectInvite.mjs:26` |
| `expires` | Date | Valor predeterminado del esquema: 30 días después de la creación. El índice TTL elimina la invitación unos 10 segundos después de esta fecha. `null` en una invitación por enlace para compartir, que nunca caduca. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` en una invitación por correo, que se borra al aceptarla (`CollaboratorsInviteHandler.mjs:207-220`). `true` en una invitación por enlace para compartir, que se mantiene. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Solo en invitaciones por enlace para compartir: la suscripción de grupo cuyos miembros pueden aceptar el enlace (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Quién escribe

| Código | Qué hace |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Crea una invitación por correo y luego envía el correo y, para un usuario existente, una notificación. Lo llama `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Borra una invitación y marca su notificación como leída. Lo llama `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Reenviar: borra la invitación y crea una nueva con un token nuevo (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Borra la invitación enviada a uno de los correos confirmados del usuario, cuando el usuario se une mediante un token de enlace para compartir (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) o recibe acceso tras una solicitud de acceso (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Añade al usuario al proyecto y luego borra la invitación salvo que sea `reusable`. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Crean o actualizan la única invitación reutilizable por enlace para compartir de un proyecto. Estas rutas requieren el split test `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`), que no está en `splitTestOverrides` (`services/web/config/settings.defaults.js:1371-1383`). Por eso responden 403 mientras no se configure ese split test. |

#### Quién lee

| Código | Qué hace |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Lista las invitaciones por correo pendientes para el diálogo de compartir (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Omite las invitaciones reutilizables. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | Cuenta las invitaciones por correo pendientes que no son `readOnly`. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` las suma a los editores al comprobar el límite de colaboradores. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Busca una invitación por el hash del token de la URL, para la página de invitación y para aceptarla (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Busca la invitación por enlace para compartir de un proyecto. |

#### Índices

| Nombre | Claves | Opciones | Migración |
| - | - | - | - |
| `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` |

Las migraciones están en `tools/migrations/`. El esquema también declara el índice TTL de `expires`, pero el `autoIndex` de Mongoose está desactivado (`services/web/app/src/infrastructure/Mongoose.mjs:7`), así que lo crea la migración.

#### Notas

* Si el proyecto no tiene ninguna plaza de editor libre cuando se acepta una invitación `readAndWrite` o `review`, el usuario se une con acceso de solo lectura y figura en `pendingEditor_refs` o `pendingReviewer_refs` del proyecto (`CollaboratorsInviteHandler.mjs:162-205`).
* Las invitaciones antiguas guardaban el token en claro en un campo `token`. La migración `20240524135408_add_token_hmac_project_invite_tokens.mjs` añadió `tokenHmac` y `20240531082910_remove_project_invite_tokens.mjs` eliminó `token`.
* Nada borra las invitaciones de un proyecto eliminado; permanecen hasta que el índice TTL las elimina.


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