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

# Kolekcja Notifications

`notifications` przechowuje powiadomienia wyświetlane u góry pulpitu projektów użytkownika. Jeden dokument to jedno powiadomienie dla jednego użytkownika, identyfikowane przez `key`. Bezpośrednio z kolekcji korzysta tylko usługa `notifications` (`services/notifications/app/js/Notifications.js`); `web` i `third-party-datastore` wywołują jej API HTTP. Nie ma schematu Mongoose.

#### Pola

| Pole | Typ | Znaczenie | Źródło |
| - | - | - | - |
| `_id` | ObjectId | Id powiadomienia. `web` oznacza powiadomienie jako przeczytane za pomocą tego id. | `Notifications.js:58-65` |
| `user_id` | ObjectId | Użytkownik, który widzi powiadomienie. | `Notifications.js:26` |
| `key` | String | Identyfikuje powiadomienie, na przykład `project-invite-<inviteId>`. Upsert utrzymuje jeden dokument na `user_id` i `key`; nie ma indeksu unikalnego. | `Notifications.js:27`, `:51-55` |
| `templateKey` | String | Które powiadomienie wyświetla frontend. Usuwane, gdy powiadomienie zostanie przeczytane lub zamknięte; dokument pozostaje. | `Notifications.js:29`, `:63`, `:72`, `:78` |
| `messageOpts` | Object | Wartości do tekstu powiadomienia, zależne od `templateKey` (dla zaproszenia do projektu: `userName`, `projectName`, `projectId`, `token`). Usuwane, gdy użytkownik zamknie powiadomienie po id. | `Notifications.js:28`, `:63` |
| `expires` | Date | Opcjonalne. Indeks TTL usuwa dokument po tym czasie. | `Notifications.js:35-50` |

#### Kto zapisuje

| Kod | Co robi |
| - | - |
| `Notifications.js:20-56` (`addNotification`) | `POST /user/:user_id` (`services/notifications/app.ts:29`). Wykonuje upsert według `user_id` + `key`. Jeśli dokument z tym kluczem już istnieje, jest zapisywany ponownie tylko wtedy, gdy wywołujący wyśle `forceCreate`. |
| `Notifications.js:58-65` (`removeNotificationId`) | `DELETE /user/:user_id/notification/:notification_id` (`app.ts:31-34`): usuwa `templateKey` i `messageOpts`. |
| `Notifications.js:67-80` | `DELETE /user/:user_id` i `DELETE /key/:key` (`app.ts:35-36`): usuwają `templateKey` według klucza. |
| `Notifications.js:87-100` | `DELETE /key/:key/bulk` (`app.ts:38-41`) usuwa nieprzeczytane powiadomienia z danym kluczem; `deleteNotificationByKeyOnly` usuwa jeden dokument według klucza. |
| `services/web/app/src/Features/Notifications/NotificationsHandler.mjs:33-66` | Strona `web` dla `addNotification`. Wysyła `forceCreate: true`, chyba że wywołujący przekaże `false`. |
| `services/third-party-datastore/app/js/QueueWorker.mjs:46-58` | Nasza synchronizacja z Dropbox: gdy odłącza konto Dropbox, bezpośrednio publikuje powiadomienie `dropbox-unlinked`. |

Powiadomienia tworzone przez CE i nasze moduły:

| `key` | `templateKey` | Miejsce utworzenia |
| - | - | - |
| `project-invite-<inviteId>` | `notification_project_invite`, wygasa razem z zaproszeniem | `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:40-42`, budowane w `services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:100-122`. Tylko gdy zaproszony adres e-mail należy do istniejącego użytkownika. |
| `tpdsFileLimit-<userId>` | `notification_tpds_file_limit` | `services/web/app/src/Features/ThirdPartyDataStore/TpdsController.mjs:118-124` (aktualizacja z Dropbox przekroczyłaby limit plików projektu), `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` lub `dropbox_unlinked_because_suspended` | `services/third-party-datastore/app/js/QueueWorker.mjs:20-25`, `:46-58` (nasza synchronizacja z Dropbox) |

`NotificationsBuilder.mjs` buduje też klucze dla zaproszeń do grup, afiliacji instytucjonalnych, subskrypcji i starych projektów debugowania. Ich wywołania znajdują się w kodzie subskrypcji i instytucji, a sprawdzanie starych projektów debugowania działa tylko przy `isSaas` (`services/web/app/src/Features/Project/ProjectListController.mjs:234-236`).

#### Kto odczytuje

| Kod | Co robi |
| - | - |
| `Notifications.js:4-10` (`getUserNotifications`) | `GET /user/:user_id` (`app.ts:30`). Zwraca tylko te dokumenty użytkownika, które nadal mają `templateKey`. |
| `services/web/app/src/Features/Project/ProjectListController.mjs:367` | Wczytuje powiadomienia dla pulpitu projektów. |
| `services/web/app/src/Features/Notifications/NotificationsController.mjs` | `GET /notifications`, `DELETE /notifications/:notificationId` i `GET /user/notification/:notificationId` (`services/web/app/src/router.mjs:922-937`). |
| `services/web/modules/dropbox/app/src/DropboxHandler.mjs:128-131` | Nasz moduł Dropbox: gdy użytkownik ponownie połączy Dropbox, oznacza `dropbox-unlinked` i `dropboxDuplicateProjectNames-<userId>` jako przeczytane. |

#### Indeksy

| Nazwa | Klucze | Opcje | Migracja |
| - | - | - | - |
| `expires_1` | `{ expires: 1 }` | TTL, `expireAfterSeconds: 10` | `tools/migrations/20190912145014_create_notifications_indexes.mjs` |
| `key_1` | `{ key: 1 }` | | ta sama |
| `user_id_1` | `{ user_id: 1 }` | | ta sama |

#### Uwagi

* Przeczytane powiadomienie nie jest usuwane: znika tylko `templateKey`. Ponieważ dokument nadal zawiera klucz, późniejsze `addNotification` bez `forceCreate` dla tego samego klucza nic nie robi (`Notifications.js:21-24`).
* Trasy `/key/:key` działają tylko według klucza, dla wszystkich użytkowników (`Notifications.js:76-100`).
* Jeśli `web` nie ma `apis.notifications.url`, nie tworzy ani nie odczytuje powiadomień (`NotificationsHandler.mjs:17`, `:41`).


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