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

# System Messages -kokoelma

`systemmessages` sisältää koko sivuston bannerit, jotka ylläpitäjä julkaisee kaikille kirjautuneille käyttäjille. Yksi dokumentti on yksi viesti. Omistaja on `web`; skeema on `services/web/app/src/models/SystemMessage.mjs` ja koodi on `services/web/app/src/Features/SystemMessages/SystemMessageManager.mjs`.

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Viestin id. Selain muistaa tämän id:n avulla, mitkä viestit käyttäjä on sulkenut (`services/web/frontend/js/shared/components/system-message.tsx:10`). | `SystemMessage.mjs:5` |
| `content` | String | Viestin teksti, oletus `''`. | `SystemMessage.mjs:7` |
| `__v` | Number | Mongoosen versioavain, jonka `message.save()` lisää. | `SystemMessageManager.mjs:29-30` |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `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`): lisää yhden viestin. |
| `SystemMessageManager.mjs:22-26` (`clearMessages`) | `POST /admin/messages/clear` (`router.mjs:1155-1157`, `AdminController.mjs:161-168`): poistaa kaikki viestit. Yksittäistä viestiä ei voi poistaa. |

#### Kuka lukee

| Koodi | Mitä se tekee |
| - | - |
| `SystemMessageManager.mjs:50-65` | Jokainen `web`-prosessi pitää kaikki viestit muistissa ja lataa ne uudelleen 20-30 sekunnin välein sekä heti oman luonnin tai tyhjennyksen jälkeen. |
| `services/web/app/src/Features/SystemMessages/SystemMessageController.mjs:6-24` | `GET /system/messages` (`router.mjs:331`): palauttaa välimuistissa olevat viestit kirjautuneille käyttäjille. Kun sivusto on suljettu (`siteIsOpen` on false), se palauttaa sen sijaan kiinteän ilmoituksen, jota ei tallenneta Mongoon. |
| `AdminController.mjs:83-84` | Sivu `/admin` listaa viestit suoraan Mongosta. |

#### Indeksit

Mikään migraatio ei luo indeksiä kokoelmaan `systemmessages`; vain oletusindeksi `_id` on olemassa.

#### Huomioita

* Kun `notifyOnSystemMessageChanges` on asetettu, luonti tai tyhjennys julkaistaan myös Redis-kanavalla `refresh-system-messages`, jolloin muut `web`-prosessit lataavat viestit heti uudelleen (`SystemMessageManager.mjs:9`, `:35-48`, `:75-87`). Ilman sitä ne huomaavat muutoksen seuraavassa ajastetussa latauksessa.


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