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

# Colección System Messages

`systemmessages` guarda los banners de todo el sitio que un administrador publica para todos los usuarios conectados. Un documento es un mensaje. `web` es su propietario; el esquema es `services/web/app/src/models/SystemMessage.mjs` y el código es `services/web/app/src/Features/SystemMessages/SystemMessageManager.mjs`.

#### Campos

| Campo | Tipo | Significado | Fuente |
| - | - | - | - |
| `_id` | ObjectId | Id del mensaje. El navegador recuerda con este id qué mensajes cerró el usuario (`services/web/frontend/js/shared/components/system-message.tsx:10`). | `SystemMessage.mjs:5` |
| `content` | String | Texto del mensaje, por defecto `''`. | `SystemMessage.mjs:7` |
| `__v` | Number | Clave de versión de Mongoose, añadida por `message.save()`. | `SystemMessageManager.mjs:29-30` |

#### Quién escribe

| Código | Qué hace |
| - | - |
| `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`): añade un mensaje. |
| `SystemMessageManager.mjs:22-26` (`clearMessages`) | `POST /admin/messages/clear` (`router.mjs:1155-1157`, `AdminController.mjs:161-168`): elimina todos los mensajes. No hay forma de eliminar uno solo. |

#### Quién lee

| Código | Qué hace |
| - | - |
| `SystemMessageManager.mjs:50-65` | Cada proceso `web` mantiene todos los mensajes en memoria y los recarga cada 20 a 30 segundos, y justo después de su propia creación o borrado. |
| `services/web/app/src/Features/SystemMessages/SystemMessageController.mjs:6-24` | `GET /system/messages` (`router.mjs:331`): devuelve los mensajes en caché a los usuarios conectados. Mientras el sitio está cerrado (`siteIsOpen` en false), devuelve en su lugar un aviso fijo, que no se guarda en Mongo. |
| `AdminController.mjs:83-84` | La página `/admin` lista los mensajes directamente desde Mongo. |

#### Índices

Ninguna migración crea un índice en `systemmessages`; solo existe el índice `_id` predeterminado.

#### Notas

* Con `notifyOnSystemMessageChanges` definido, una creación o un borrado también se publica en el canal de Redis `refresh-system-messages`, de modo que los demás procesos `web` recargan al instante (`SystemMessageManager.mjs:9`, `:35-48`, `:75-87`). Sin él, recogen el cambio en su siguiente recarga programada.


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