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

# Koleksi Notifications

`notifications` menyimpan pemberitahuan yang ditampilkan di bagian atas dasbor proyek pengguna. Satu dokumen adalah satu pemberitahuan untuk satu pengguna, yang diidentifikasi oleh `key`-nya. Hanya layanan `notifications` yang mengakses koleksi ini (`services/notifications/app/js/Notifications.js`); `web` dan `third-party-datastore` memanggil API HTTP-nya. Tidak ada skema Mongoose.

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Id pemberitahuan. `web` menandai pemberitahuan sebagai sudah dibaca dengan id ini. | `Notifications.js:58-65` |
| `user_id` | ObjectId | Pengguna yang melihat pemberitahuan. | `Notifications.js:26` |
| `key` | String | Mengidentifikasi pemberitahuan, misalnya `project-invite-<inviteId>`. Upsert menjaga satu dokumen per `user_id` dan `key`; tidak ada indeks unik. | `Notifications.js:27`, `:51-55` |
| `templateKey` | String | Pemberitahuan mana yang dirender frontend. Dihapus saat pemberitahuan dibaca atau ditutup; dokumennya tetap ada. | `Notifications.js:29`, `:63`, `:72`, `:78` |
| `messageOpts` | Object | Nilai untuk teks pemberitahuan, bergantung pada `templateKey` (untuk undangan proyek: `userName`, `projectName`, `projectId`, `token`). Dihapus saat pengguna menutup pemberitahuan berdasarkan id. | `Notifications.js:28`, `:63` |
| `expires` | Date | Opsional. Indeks TTL menghapus dokumen setelah waktu ini. | `Notifications.js:35-50` |

#### Siapa yang menulis

| Kode | Fungsinya |
| - | - |
| `Notifications.js:20-56` (`addNotification`) | `POST /user/:user_id` (`services/notifications/app.ts:29`). Melakukan upsert berdasarkan `user_id` + `key`. Jika dokumen dengan kunci itu sudah ada, dokumen hanya ditulis ulang saat pemanggil mengirim `forceCreate`. |
| `Notifications.js:58-65` (`removeNotificationId`) | `DELETE /user/:user_id/notification/:notification_id` (`app.ts:31-34`): menghapus `templateKey` dan `messageOpts`. |
| `Notifications.js:67-80` | `DELETE /user/:user_id` dan `DELETE /key/:key` (`app.ts:35-36`): menghapus `templateKey` berdasarkan kunci. |
| `Notifications.js:87-100` | `DELETE /key/:key/bulk` (`app.ts:38-41`) menghapus pemberitahuan yang belum dibaca dengan suatu kunci; `deleteNotificationByKeyOnly` menghapus satu dokumen berdasarkan kunci. |
| `services/web/app/src/Features/Notifications/NotificationsHandler.mjs:33-66` | Sisi `web` dari `addNotification`. Mengirim `forceCreate: true` kecuali pemanggil meneruskan `false`. |
| `services/third-party-datastore/app/js/QueueWorker.mjs:46-58` | Sinkronisasi Dropbox kami: saat memutus tautan akun Dropbox, ia langsung mengirim pemberitahuan `dropbox-unlinked`. |

Pemberitahuan yang dibuat oleh CE dan modul kami:

| `key` | `templateKey` | Dibuat di |
| - | - | - |
| `project-invite-<inviteId>` | `notification_project_invite`, kedaluwarsa bersama undangan | `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:40-42`, disusun di `services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:100-122`. Hanya jika email yang diundang milik pengguna yang sudah ada. |
| `tpdsFileLimit-<userId>` | `notification_tpds_file_limit` | `services/web/app/src/Features/ThirdPartyDataStore/TpdsController.mjs:118-124` (pembaruan Dropbox akan membuat proyek melampaui batas file), `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` atau `dropbox_unlinked_because_suspended` | `services/third-party-datastore/app/js/QueueWorker.mjs:20-25`, `:46-58` (sinkronisasi Dropbox kami) |

`NotificationsBuilder.mjs` juga menyusun kunci untuk undangan grup, afiliasi institusi, langganan, dan proyek debug lama. Pemanggilnya ada di kode langganan dan institusi, dan pemeriksaan proyek debug lama hanya berjalan saat `isSaas` (`services/web/app/src/Features/Project/ProjectListController.mjs:234-236`).

#### Siapa yang membaca

| Kode | Fungsinya |
| - | - |
| `Notifications.js:4-10` (`getUserNotifications`) | `GET /user/:user_id` (`app.ts:30`). Hanya mengembalikan dokumen pengguna yang masih memiliki `templateKey`. |
| `services/web/app/src/Features/Project/ProjectListController.mjs:367` | Memuat pemberitahuan untuk dasbor proyek. |
| `services/web/app/src/Features/Notifications/NotificationsController.mjs` | `GET /notifications`, `DELETE /notifications/:notificationId` dan `GET /user/notification/:notificationId` (`services/web/app/src/router.mjs:922-937`). |
| `services/web/modules/dropbox/app/src/DropboxHandler.mjs:128-131` | Modul Dropbox kami: saat pengguna menautkan Dropbox lagi, menandai `dropbox-unlinked` dan `dropboxDuplicateProjectNames-<userId>` sebagai sudah dibaca. |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `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 |

#### Catatan

* Pemberitahuan yang sudah dibaca tidak dihapus: hanya `templateKey` yang hilang. Karena dokumen masih menyimpan kuncinya, `addNotification` berikutnya tanpa `forceCreate` untuk kunci yang sama tidak melakukan apa pun (`Notifications.js:21-24`).
* Rute `/key/:key` hanya bekerja berdasarkan kunci, untuk semua pengguna (`Notifications.js:76-100`).
* Jika `web` tidak memiliki `apis.notifications.url`, ia tidak membuat maupun membaca pemberitahuan (`NotificationsHandler.mjs:17`, `:41`).


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