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

# Notifications-kokoelma

`notifications` sisältää ilmoitukset, jotka näytetään käyttäjän projektinäkymän yläosassa. Yksi dokumentti on yksi ilmoitus yhdelle käyttäjälle, ja se tunnistetaan avaimellaan `key`. Vain palvelu `notifications` käsittelee kokoelmaa (`services/notifications/app/js/Notifications.js`); `web` ja `third-party-datastore` kutsuvat sen HTTP-rajapintaa. Mongoose-skeemaa ei ole.

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Ilmoituksen id. `web` merkitsee ilmoituksen luetuksi tällä id:llä. | `Notifications.js:58-65` |
| `user_id` | ObjectId | Käyttäjä, joka näkee ilmoituksen. | `Notifications.js:26` |
| `key` | String | Tunnistaa ilmoituksen, esimerkiksi `project-invite-<inviteId>`. Upsert säilyttää yhden dokumentin kutakin `user_id`- ja `key`-paria kohden; yksilöivää indeksiä ei ole. | `Notifications.js:27`, `:51-55` |
| `templateKey` | String | Mikä ilmoitus käyttöliittymässä näytetään. Poistetaan, kun ilmoitus luetaan tai suljetaan; dokumentti säilyy. | `Notifications.js:29`, `:63`, `:72`, `:78` |
| `messageOpts` | Object | Ilmoitustekstin arvot kentän `templateKey` mukaan (projektikutsussa: `userName`, `projectName`, `projectId`, `token`). Poistetaan, kun käyttäjä sulkee ilmoituksen id:n perusteella. | `Notifications.js:28`, `:63` |
| `expires` | Date | Valinnainen. TTL-indeksi poistaa dokumentin tämän ajan jälkeen. | `Notifications.js:35-50` |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `Notifications.js:20-56` (`addNotification`) | `POST /user/:user_id` (`services/notifications/app.ts:29`). Tekee upsertin parille `user_id` + `key`. Jos dokumentti tällä avaimella on jo olemassa, se kirjoitetaan uudelleen vain, kun kutsuja lähettää `forceCreate`. |
| `Notifications.js:58-65` (`removeNotificationId`) | `DELETE /user/:user_id/notification/:notification_id` (`app.ts:31-34`): poistaa kentät `templateKey` ja `messageOpts`. |
| `Notifications.js:67-80` | `DELETE /user/:user_id` ja `DELETE /key/:key` (`app.ts:35-36`): poistavat kentän `templateKey` avaimen perusteella. |
| `Notifications.js:87-100` | `DELETE /key/:key/bulk` (`app.ts:38-41`) poistaa lukemattomat ilmoitukset, joilla on avain; `deleteNotificationByKeyOnly` poistaa yhden dokumentin avaimen perusteella. |
| `services/web/app/src/Features/Notifications/NotificationsHandler.mjs:33-66` | `addNotification`-toiminnon `web`-puoli. Lähettää `forceCreate: true`, ellei kutsuja välitä arvoa `false`. |
| `services/third-party-datastore/app/js/QueueWorker.mjs:46-58` | Dropbox-synkronointimme: kun se irrottaa Dropbox-tilin, se lähettää ilmoituksen `dropbox-unlinked` suoraan. |

Ilmoitukset, joita CE ja moduulimme luovat:

| `key` | `templateKey` | Luontipaikka |
| - | - | - |
| `project-invite-<inviteId>` | `notification_project_invite`, vanhenee kutsun mukana | `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:40-42`, muodostetaan tiedostossa `services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:100-122`. Vain, kun kutsuttu sähköpostiosoite kuuluu olemassa olevalle käyttäjälle. |
| `tpdsFileLimit-<userId>` | `notification_tpds_file_limit` | `services/web/app/src/Features/ThirdPartyDataStore/TpdsController.mjs:118-124` (Dropbox-päivitys veisi projektin yli tiedostorajan), `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` tai `dropbox_unlinked_because_suspended` | `services/third-party-datastore/app/js/QueueWorker.mjs:20-25`, `:46-58` (Dropbox-synkronointimme) |

`NotificationsBuilder.mjs` muodostaa avaimia myös ryhmäkutsuille, organisaatiojäsenyyksille, tilauksille ja vanhoille virheenkorjausprojekteille. Niiden kutsujat ovat tilaus- ja organisaatiokoodissa, ja vanhojen virheenkorjausprojektien tarkistus suoritetaan vain, kun `isSaas` on voimassa (`services/web/app/src/Features/Project/ProjectListController.mjs:234-236`).

#### Kuka lukee

| Koodi | Mitä se tekee |
| - | - |
| `Notifications.js:4-10` (`getUserNotifications`) | `GET /user/:user_id` (`app.ts:30`). Palauttaa vain ne käyttäjän dokumentit, joilla on vielä `templateKey`. |
| `services/web/app/src/Features/Project/ProjectListController.mjs:367` | Lataa projektinäkymän ilmoitukset. |
| `services/web/app/src/Features/Notifications/NotificationsController.mjs` | `GET /notifications`, `DELETE /notifications/:notificationId` ja `GET /user/notification/:notificationId` (`services/web/app/src/router.mjs:922-937`). |
| `services/web/modules/dropbox/app/src/DropboxHandler.mjs:128-131` | Dropbox-moduulimme: kun käyttäjä yhdistää Dropboxin uudelleen, se merkitsee ilmoitukset `dropbox-unlinked` ja `dropboxDuplicateProjectNames-<userId>` luetuiksi. |

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `expires_1` | `{ expires: 1 }` | TTL, `expireAfterSeconds: 10` | `tools/migrations/20190912145014_create_notifications_indexes.mjs` |
| `key_1` | `{ key: 1 }` | | sama |
| `user_id_1` | `{ user_id: 1 }` | | sama |

#### Huomioita

* Luettua ilmoitusta ei poisteta: vain `templateKey` häviää. Koska dokumentissa on yhä avain, myöhempi `addNotification` ilman `forceCreate`-arvoa samalle avaimelle ei tee mitään (`Notifications.js:21-24`).
* Reitit `/key/:key` toimivat pelkän avaimen perusteella kaikille käyttäjille (`Notifications.js:76-100`).
* Jos `web`-palvelulla ei ole asetusta `apis.notifications.url`, se ei luo eikä lue ilmoituksia (`NotificationsHandler.mjs:17`, `:41`).


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