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

`notifications` guarda los avisos que se muestran en la parte superior del panel de proyectos de un usuario. Un documento es un aviso para un usuario, identificado por su `key`. Solo el servicio `notifications` accede a la colección (`services/notifications/app/js/Notifications.js`); `web` y `third-party-datastore` llaman a su API HTTP. No hay esquema de Mongoose.

#### Campos

| Campo | Tipo | Significado | Fuente |
| - | - | - | - |
| `_id` | ObjectId | Id del aviso. `web` marca un aviso como leído mediante este id. | `Notifications.js:58-65` |
| `user_id` | ObjectId | El usuario que ve el aviso. | `Notifications.js:26` |
| `key` | String | Identifica el aviso, por ejemplo `project-invite-<inviteId>`. El upsert mantiene un documento por `user_id` y `key`; no hay índice único. | `Notifications.js:27`, `:51-55` |
| `templateKey` | String | Qué aviso representa el frontend. Se elimina cuando el aviso se lee o se descarta; el documento permanece. | `Notifications.js:29`, `:63`, `:72`, `:78` |
| `messageOpts` | Object | Valores para el texto del aviso, según `templateKey` (para una invitación a un proyecto: `userName`, `projectName`, `projectId`, `token`). Se elimina cuando el usuario descarta el aviso por su id. | `Notifications.js:28`, `:63` |
| `expires` | Date | Opcional. El índice TTL elimina el documento después de esta fecha. | `Notifications.js:35-50` |

#### Quién escribe

| Código | Qué hace |
| - | - |
| `Notifications.js:20-56` (`addNotification`) | `POST /user/:user_id` (`services/notifications/app.ts:29`). Hace upsert por `user_id` + `key`. Si ya existe un documento con esa clave, solo se vuelve a escribir cuando el llamador envía `forceCreate`. |
| `Notifications.js:58-65` (`removeNotificationId`) | `DELETE /user/:user_id/notification/:notification_id` (`app.ts:31-34`): elimina `templateKey` y `messageOpts`. |
| `Notifications.js:67-80` | `DELETE /user/:user_id` y `DELETE /key/:key` (`app.ts:35-36`): eliminan `templateKey` por clave. |
| `Notifications.js:87-100` | `DELETE /key/:key/bulk` (`app.ts:38-41`) elimina los avisos no leídos con una clave; `deleteNotificationByKeyOnly` elimina un documento por clave. |
| `services/web/app/src/Features/Notifications/NotificationsHandler.mjs:33-66` | Lado `web` de `addNotification`. Envía `forceCreate: true` salvo que el llamador pase `false`. |
| `services/third-party-datastore/app/js/QueueWorker.mjs:46-58` | Nuestra sincronización con Dropbox: cuando desvincula una cuenta de Dropbox, publica directamente el aviso `dropbox-unlinked`. |

Avisos que crean CE y nuestros módulos:

| `key` | `templateKey` | Se crea en |
| - | - | - |
| `project-invite-<inviteId>` | `notification_project_invite`, caduca con la invitación | `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:40-42`, construido en `services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:100-122`. Solo cuando el correo invitado pertenece a un usuario existente. |
| `tpdsFileLimit-<userId>` | `notification_tpds_file_limit` | `services/web/app/src/Features/ThirdPartyDataStore/TpdsController.mjs:118-124` (una actualización de Dropbox haría que un proyecto superara el límite de archivos), `NotificationsBuilder.mjs:175-195` |
| `dropboxDuplicateProjectNames-<userId>` | `notification_dropbox_duplicate_project_names` | `services/web/app/src/Features/ThirdPartyDataStore/TpdsUpdateHandler.mjs:160-169`, `NotificationsBuilder.mjs:10-30` |
| `dropbox-unlinked` | `dropbox_unlinked_because_access_denied`, `dropbox_unlinked_because_full` o `dropbox_unlinked_because_suspended` | `services/third-party-datastore/app/js/QueueWorker.mjs:20-25`, `:46-58` (nuestra sincronización con Dropbox) |

`NotificationsBuilder.mjs` también construye claves para invitaciones de grupo, afiliaciones institucionales, suscripciones y proyectos de depuración antiguos. Sus llamadores están en el código de suscripciones e instituciones, y la comprobación de proyectos de depuración antiguos solo se ejecuta con `isSaas` (`services/web/app/src/Features/Project/ProjectListController.mjs:234-236`).

#### Quién lee

| Código | Qué hace |
| - | - |
| `Notifications.js:4-10` (`getUserNotifications`) | `GET /user/:user_id` (`app.ts:30`). Devuelve solo los documentos del usuario que aún tienen `templateKey`. |
| `services/web/app/src/Features/Project/ProjectListController.mjs:367` | Carga los avisos para el panel de proyectos. |
| `services/web/app/src/Features/Notifications/NotificationsController.mjs` | `GET /notifications`, `DELETE /notifications/:notificationId` y `GET /user/notification/:notificationId` (`services/web/app/src/router.mjs:922-937`). |
| `services/web/modules/dropbox/app/src/DropboxHandler.mjs:128-131` | Nuestro módulo de Dropbox: cuando un usuario vuelve a vincular Dropbox, marca `dropbox-unlinked` y `dropboxDuplicateProjectNames-<userId>` como leídos. |

#### Índices

| Nombre | Claves | Opciones | Migración |
| - | - | - | - |
| `expires_1` | `{ expires: 1 }` | TTL, `expireAfterSeconds: 10` | `tools/migrations/20190912145014_create_notifications_indexes.mjs` |
| `key_1` | `{ key: 1 }` | | la misma |
| `user_id_1` | `{ user_id: 1 }` | | la misma |

#### Notas

* Un aviso leído no se elimina: solo desaparece `templateKey`. Como el documento conserva la clave, un `addNotification` posterior sin `forceCreate` para la misma clave no hace nada (`Notifications.js:21-24`).
* Las rutas `/key/:key` actúan solo sobre la clave, para todos los usuarios (`Notifications.js:76-100`).
* Si `web` no tiene `apis.notifications.url`, no crea ni lee avisos (`NotificationsHandler.mjs:17`, `:41`).


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