> ## 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 System Messages

`systemmessages` menyimpan banner seluruh situs yang diposting admin untuk semua pengguna yang sudah login. Satu dokumen adalah satu pesan. Pemiliknya adalah `web`; skemanya `services/web/app/src/models/SystemMessage.mjs` dan kodenya `services/web/app/src/Features/SystemMessages/SystemMessageManager.mjs`.

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Id pesan. Browser mengingat pesan mana yang sudah ditutup pengguna melalui id ini (`services/web/frontend/js/shared/components/system-message.tsx:10`). | `SystemMessage.mjs:5` |
| `content` | String | Teks pesan, default `''`. | `SystemMessage.mjs:7` |
| `__v` | Number | Kunci versi Mongoose, ditambahkan oleh `message.save()`. | `SystemMessageManager.mjs:29-30` |

#### Siapa yang menulis

| Kode | Fungsinya |
| - | - |
| `SystemMessageManager.mjs:28-33` (`createMessage`) | `POST /admin/messages` (`services/web/app/src/router.mjs:1150-1152`, `services/web/app/src/Features/ServerAdmin/AdminController.mjs:151-159`): menambahkan satu pesan. |
| `SystemMessageManager.mjs:22-26` (`clearMessages`) | `POST /admin/messages/clear` (`router.mjs:1155-1157`, `AdminController.mjs:161-168`): menghapus semua pesan. Tidak ada cara untuk menghapus satu pesan saja. |

#### Siapa yang membaca

| Kode | Fungsinya |
| - | - |
| `SystemMessageManager.mjs:50-65` | Setiap proses `web` menyimpan semua pesan di memori dan memuatnya ulang setiap 20 hingga 30 detik, serta segera setelah ia sendiri membuat atau menghapusnya. |
| `services/web/app/src/Features/SystemMessages/SystemMessageController.mjs:6-24` | `GET /system/messages` (`router.mjs:331`): mengembalikan pesan dari cache kepada pengguna yang sudah login. Selama situs ditutup (`siteIsOpen` bernilai false), ia mengembalikan pemberitahuan tetap sebagai gantinya, yang tidak disimpan di Mongo. |
| `AdminController.mjs:83-84` | Halaman `/admin` menampilkan pesan langsung dari Mongo. |

#### Indeks

Tidak ada migrasi yang membuat indeks pada `systemmessages`; hanya indeks default `_id` yang ada.

#### Catatan

* Jika `notifyOnSystemMessageChanges` diatur, pembuatan atau penghapusan juga dipublikasikan di kanal Redis `refresh-system-messages`, sehingga proses `web` lain langsung memuat ulang (`SystemMessageManager.mjs:9`, `:35-48`, `:75-87`). Tanpa pengaturan itu, perubahan diambil pada pemuatan ulang terjadwal berikutnya.


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