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

# Collezione System Messages

`systemmessages` contiene i banner dell'intero sito che un amministratore pubblica per tutti gli utenti connessi. Un documento è un messaggio. Ne è proprietario `web`; lo schema è `services/web/app/src/models/SystemMessage.mjs` e il codice è `services/web/app/src/Features/SystemMessages/SystemMessageManager.mjs`.

#### Campi

| Campo | Tipo | Significato | Fonte |
| - | - | - | - |
| `_id` | ObjectId | Id del messaggio. Il browser ricorda tramite questo id quali messaggi l'utente ha chiuso (`services/web/frontend/js/shared/components/system-message.tsx:10`). | `SystemMessage.mjs:5` |
| `content` | String | Testo del messaggio, predefinito `''`. | `SystemMessage.mjs:7` |
| `__v` | Number | Chiave di versione di Mongoose, aggiunta da `message.save()`. | `SystemMessageManager.mjs:29-30` |

#### Chi la scrive

| Codice | Cosa fa |
| - | - |
| `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`): aggiunge un messaggio. |
| `SystemMessageManager.mjs:22-26` (`clearMessages`) | `POST /admin/messages/clear` (`router.mjs:1155-1157`, `AdminController.mjs:161-168`): elimina tutti i messaggi. Non è possibile eliminarne uno solo. |

#### Chi la legge

| Codice | Cosa fa |
| - | - |
| `SystemMessageManager.mjs:50-65` | Ogni processo `web` tiene tutti i messaggi in memoria e li ricarica ogni 20-30 secondi, oltre che subito dopo una propria creazione o cancellazione. |
| `services/web/app/src/Features/SystemMessages/SystemMessageController.mjs:6-24` | `GET /system/messages` (`router.mjs:331`): restituisce i messaggi in cache agli utenti connessi. Mentre il sito è chiuso (`siteIsOpen` false) restituisce invece un avviso fisso, che non è salvato in Mongo. |
| `AdminController.mjs:83-84` | La pagina `/admin` elenca i messaggi direttamente da Mongo. |

#### Indici

Nessuna migrazione crea un indice su `systemmessages`; esiste solo l'indice predefinito `_id`.

#### Note

* Con `notifyOnSystemMessageChanges` impostato, una creazione o una cancellazione viene pubblicata anche sul canale Redis `refresh-system-messages`, così gli altri processi `web` ricaricano subito (`SystemMessageManager.mjs:9`, `:35-48`, `:75-87`). Senza, recepiscono la modifica al successivo ricaricamento programmato.


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