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

`notifications` inneholder varslene som vises øverst på en brukers prosjektoversikt. Ett dokument er ett varsel for én bruker, identifisert med sin `key`. Bare tjenesten `notifications` rører samlingen (`services/notifications/app/js/Notifications.js`); `web` og `third-party-datastore` kaller HTTP-API-et dens. Det finnes ikke noe Mongoose-skjema.

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Varselets id. `web` markerer et varsel som lest med denne id-en. | `Notifications.js:58-65` |
| `user_id` | ObjectId | Brukeren som ser varselet. | `Notifications.js:26` |
| `key` | String | Identifiserer varselet, for eksempel `project-invite-<inviteId>`. Upserten beholder ett dokument per `user_id` og `key`; det finnes ingen unik indeks. | `Notifications.js:27`, `:51-55` |
| `templateKey` | String | Hvilket varsel frontend viser. Fjernes når varselet leses eller avvises; dokumentet blir værende. | `Notifications.js:29`, `:63`, `:72`, `:78` |
| `messageOpts` | Object | Verdier for varselteksten, avhengig av `templateKey` (for en prosjektinvitasjon: `userName`, `projectName`, `projectId`, `token`). Fjernes når brukeren avviser varselet via id. | `Notifications.js:28`, `:63` |
| `expires` | Date | Valgfritt. TTL-indeksen sletter dokumentet etter dette tidspunktet. | `Notifications.js:35-50` |

#### Hvem skriver

| Kode | Hva den gjør |
| - | - |
| `Notifications.js:20-56` (`addNotification`) | `POST /user/:user_id` (`services/notifications/app.ts:29`). Upsert på `user_id` + `key`. Hvis et dokument med den nøkkelen allerede finnes, skrives det bare på nytt når kalleren sender `forceCreate`. |
| `Notifications.js:58-65` (`removeNotificationId`) | `DELETE /user/:user_id/notification/:notification_id` (`app.ts:31-34`): fjerner `templateKey` og `messageOpts`. |
| `Notifications.js:67-80` | `DELETE /user/:user_id` og `DELETE /key/:key` (`app.ts:35-36`): fjerner `templateKey` etter nøkkel. |
| `Notifications.js:87-100` | `DELETE /key/:key/bulk` (`app.ts:38-41`) sletter uleste varsler med en nøkkel; `deleteNotificationByKeyOnly` sletter ett dokument etter nøkkel. |
| `services/web/app/src/Features/Notifications/NotificationsHandler.mjs:33-66` | `web`-siden av `addNotification`. Sender `forceCreate: true` med mindre kalleren sender `false`. |
| `services/third-party-datastore/app/js/QueueWorker.mjs:46-58` | Dropbox-synkroniseringen vår: når den kobler fra en Dropbox-konto, sender den varselet `dropbox-unlinked` direkte. |

Varsler som CE og modulene våre oppretter:

| `key` | `templateKey` | Opprettes i |
| - | - | - |
| `project-invite-<inviteId>` | `notification_project_invite`, utløper med invitasjonen | `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:40-42`, bygges i `services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:100-122`. Bare når den inviterte e-postadressen tilhører en eksisterende bruker. |
| `tpdsFileLimit-<userId>` | `notification_tpds_file_limit` | `services/web/app/src/Features/ThirdPartyDataStore/TpdsController.mjs:118-124` (en Dropbox-oppdatering ville ført et prosjekt over filgrensen), `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` eller `dropbox_unlinked_because_suspended` | `services/third-party-datastore/app/js/QueueWorker.mjs:20-25`, `:46-58` (Dropbox-synkroniseringen vår) |

`NotificationsBuilder.mjs` bygger også nøkler for gruppeinvitasjoner, institusjonstilknytninger, abonnementer og gamle feilsøkingsprosjekter. Kallerne deres ligger i abonnements- og institusjonskoden, og sjekken av gamle feilsøkingsprosjekter kjører bare med `isSaas` (`services/web/app/src/Features/Project/ProjectListController.mjs:234-236`).

#### Hvem leser

| Kode | Hva den gjør |
| - | - |
| `Notifications.js:4-10` (`getUserNotifications`) | `GET /user/:user_id` (`app.ts:30`). Returnerer bare brukerens dokumenter som fortsatt har en `templateKey`. |
| `services/web/app/src/Features/Project/ProjectListController.mjs:367` | Laster inn varslene for prosjektoversikten. |
| `services/web/app/src/Features/Notifications/NotificationsController.mjs` | `GET /notifications`, `DELETE /notifications/:notificationId` og `GET /user/notification/:notificationId` (`services/web/app/src/router.mjs:922-937`). |
| `services/web/modules/dropbox/app/src/DropboxHandler.mjs:128-131` | Dropbox-modulen vår: når en bruker kobler til Dropbox igjen, markeres `dropbox-unlinked` og `dropboxDuplicateProjectNames-<userId>` som lest. |

#### Indekser

| Navn | Nøkler | Alternativer | Migrering |
| - | - | - | - |
| `expires_1` | `{ expires: 1 }` | TTL, `expireAfterSeconds: 10` | `tools/migrations/20190912145014_create_notifications_indexes.mjs` |
| `key_1` | `{ key: 1 }` | | samme |
| `user_id_1` | `{ user_id: 1 }` | | samme |

#### Merknader

* Et lest varsel slettes ikke: bare `templateKey` forsvinner. Fordi dokumentet fortsatt har nøkkelen, gjør en senere `addNotification` uten `forceCreate` for samme nøkkel ingenting (`Notifications.js:21-24`).
* Rutene `/key/:key` virker bare på nøkkelen, på tvers av brukere (`Notifications.js:76-100`).
* Hvis `web` ikke har `apis.notifications.url`, verken oppretter eller leser den varsler (`NotificationsHandler.mjs:17`, `:41`).


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