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

`systemmessages` تحفظ اللافتات العامة للموقع التي ينشرها المسؤول لجميع المستخدمين المسجّلين دخولهم. كل مستند هو رسالة واحدة. المالك هو `web`؛ المخطط هو `services/web/app/src/models/SystemMessage.mjs` والشيفرة هي `services/web/app/src/Features/SystemMessages/SystemMessageManager.mjs`.

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | معرّف الرسالة. يتذكر المتصفح بهذا المعرّف الرسائل التي أغلقها المستخدم (`services/web/frontend/js/shared/components/system-message.tsx:10`). | `SystemMessage.mjs:5` |
| `content` | String | نص الرسالة، والافتراضي `''`. | `SystemMessage.mjs:7` |
| `__v` | Number | مفتاح إصدار Mongoose، يضيفه `message.save()`. | `SystemMessageManager.mjs:29-30` |

#### من يكتب فيها

| الشيفرة | ما الذي تفعله |
| - | - |
| `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`): تضيف رسالة واحدة. |
| `SystemMessageManager.mjs:22-26` (`clearMessages`) | `POST /admin/messages/clear` (`router.mjs:1155-1157`, `AdminController.mjs:161-168`): تحذف جميع الرسائل. لا توجد طريقة لحذف رسالة واحدة. |

#### من يقرأ منها

| الشيفرة | ما الذي تفعله |
| - | - |
| `SystemMessageManager.mjs:50-65` | تحتفظ كل عملية `web` بجميع الرسائل في الذاكرة وتعيد تحميلها كل 20 إلى 30 ثانية، وفور إنشائها أو مسحها بنفسها. |
| `services/web/app/src/Features/SystemMessages/SystemMessageController.mjs:6-24` | `GET /system/messages` (`router.mjs:331`): تُعيد الرسائل المخزّنة مؤقتًا للمستخدمين المسجّلين دخولهم. وما دام الموقع مغلقًا (`siteIsOpen` قيمته false) فإنها تُعيد بدلًا من ذلك إشعارًا ثابتًا غير مخزّن في Mongo. |
| `AdminController.mjs:83-84` | تعرض صفحة `/admin` الرسائل مباشرةً من Mongo. |

#### الفهارس

لا ينشئ أي ترحيل فهرسًا على `systemmessages`؛ يوجد فقط الفهرس الافتراضي `_id`.

#### ملاحظات

* عند ضبط `notifyOnSystemMessageChanges`، يُنشر الإنشاء أو المسح أيضًا على قناة Redis `refresh-system-messages`، فتعيد عمليات `web` الأخرى التحميل فورًا (`SystemMessageManager.mjs:9`، `:35-48`، `:75-87`). ومن دونه تلتقط التغيير في إعادة التحميل المجدولة التالية.


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