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

`notifications` uchovává upozornění zobrazená v horní části nástěnky projektů uživatele. Jeden dokument je jedno upozornění pro jednoho uživatele, identifikované svým `key`. S kolekcí přímo pracuje jen služba `notifications` (`services/notifications/app/js/Notifications.js`); `web` a `third-party-datastore` volají její HTTP API. Schéma Mongoose neexistuje.

#### Pole

| Pole | Typ | Význam | Zdroj |
| - | - | - | - |
| `_id` | ObjectId | Id upozornění. `web` podle tohoto id označí upozornění jako přečtené. | `Notifications.js:58-65` |
| `user_id` | ObjectId | Uživatel, který upozornění vidí. | `Notifications.js:26` |
| `key` | String | Identifikuje upozornění, například `project-invite-<inviteId>`. Upsert udržuje jeden dokument na `user_id` a `key`; jedinečný index neexistuje. | `Notifications.js:27`, `:51-55` |
| `templateKey` | String | Které upozornění frontend vykreslí. Odstraní se, když je upozornění přečteno nebo zavřeno; dokument zůstává. | `Notifications.js:29`, `:63`, `:72`, `:78` |
| `messageOpts` | Object | Hodnoty pro text upozornění podle `templateKey` (u pozvánky do projektu: `userName`, `projectName`, `projectId`, `token`). Odstraní se, když uživatel upozornění zavře podle id. | `Notifications.js:28`, `:63` |
| `expires` | Date | Volitelné. Index TTL dokument po tomto čase smaže. | `Notifications.js:35-50` |

#### Kdo zapisuje

| Kód | Co dělá |
| - | - |
| `Notifications.js:20-56` (`addNotification`) | `POST /user/:user_id` (`services/notifications/app.ts:29`). Provede upsert podle `user_id` + `key`. Pokud dokument s tímto klíčem už existuje, zapíše se znovu jen tehdy, když volající pošle `forceCreate`. |
| `Notifications.js:58-65` (`removeNotificationId`) | `DELETE /user/:user_id/notification/:notification_id` (`app.ts:31-34`): odstraní `templateKey` a `messageOpts`. |
| `Notifications.js:67-80` | `DELETE /user/:user_id` a `DELETE /key/:key` (`app.ts:35-36`): odstraní `templateKey` podle klíče. |
| `Notifications.js:87-100` | `DELETE /key/:key/bulk` (`app.ts:38-41`) smaže nepřečtená upozornění s klíčem; `deleteNotificationByKeyOnly` smaže jeden dokument podle klíče. |
| `services/web/app/src/Features/Notifications/NotificationsHandler.mjs:33-66` | Strana `web` pro `addNotification`. Posílá `forceCreate: true`, pokud volající nepředá `false`. |
| `services/third-party-datastore/app/js/QueueWorker.mjs:46-58` | Naše synchronizace s Dropboxem: když odpojí účet Dropbox, odešle upozornění `dropbox-unlinked` přímo. |

Upozornění, která vytvářejí CE a naše moduly:

| `key` | `templateKey` | Místo vytvoření |
| - | - | - |
| `project-invite-<inviteId>` | `notification_project_invite`, vyprší spolu s pozvánkou | `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:40-42`, sestavuje se v `services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:100-122`. Jen když pozvaný e-mail patří existujícímu uživateli. |
| `tpdsFileLimit-<userId>` | `notification_tpds_file_limit` | `services/web/app/src/Features/ThirdPartyDataStore/TpdsController.mjs:118-124` (aktualizace z Dropboxu by projekt dostala přes limit souborů), `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` nebo `dropbox_unlinked_because_suspended` | `services/third-party-datastore/app/js/QueueWorker.mjs:20-25`, `:46-58` (naše synchronizace s Dropboxem) |

`NotificationsBuilder.mjs` sestavuje také klíče pro skupinové pozvánky, institucionální příslušnost, předplatná a staré ladicí projekty. Jejich volající jsou v kódu předplatných a institucí a kontrola starých ladicích projektů běží jen při `isSaas` (`services/web/app/src/Features/Project/ProjectListController.mjs:234-236`).

#### Kdo čte

| Kód | Co dělá |
| - | - |
| `Notifications.js:4-10` (`getUserNotifications`) | `GET /user/:user_id` (`app.ts:30`). Vrací jen ty dokumenty uživatele, které ještě mají `templateKey`. |
| `services/web/app/src/Features/Project/ProjectListController.mjs:367` | Načítá upozornění pro nástěnku projektů. |
| `services/web/app/src/Features/Notifications/NotificationsController.mjs` | `GET /notifications`, `DELETE /notifications/:notificationId` a `GET /user/notification/:notificationId` (`services/web/app/src/router.mjs:922-937`). |
| `services/web/modules/dropbox/app/src/DropboxHandler.mjs:128-131` | Náš modul Dropbox: když uživatel Dropbox znovu propojí, označí `dropbox-unlinked` a `dropboxDuplicateProjectNames-<userId>` jako přečtené. |

#### Indexy

| Název | Klíče | Volby | Migrace |
| - | - | - | - |
| `expires_1` | `{ expires: 1 }` | TTL, `expireAfterSeconds: 10` | `tools/migrations/20190912145014_create_notifications_indexes.mjs` |
| `key_1` | `{ key: 1 }` | | tatáž |
| `user_id_1` | `{ user_id: 1 }` | | tatáž |

#### Poznámky

* Přečtené upozornění se nesmaže: zmizí jen `templateKey`. Protože dokument stále obsahuje klíč, pozdější `addNotification` bez `forceCreate` pro stejný klíč nic neudělá (`Notifications.js:21-24`).
* Trasy `/key/:key` pracují jen s klíčem, napříč všemi uživateli (`Notifications.js:76-100`).
* Pokud `web` nemá `apis.notifications.url`, upozornění nevytváří ani nečte (`NotificationsHandler.mjs:17`, `:41`).


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