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

# Collection System Messages

`systemmessages` lưu các banner toàn trang mà quản trị viên đăng cho tất cả người dùng đã đăng nhập. Mỗi tài liệu là một tin nhắn. `web` sở hữu collection này; schema là `services/web/app/src/models/SystemMessage.mjs` và mã là `services/web/app/src/Features/SystemMessages/SystemMessageManager.mjs`.

#### Trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Id tin nhắn. Trình duyệt dùng id này để nhớ người dùng đã đóng những tin nhắn nào (`services/web/frontend/js/shared/components/system-message.tsx:10`). | `SystemMessage.mjs:5` |
| `content` | String | Nội dung tin nhắn, mặc định `''`. | `SystemMessage.mjs:7` |
| `__v` | Number | Khóa phiên bản của Mongoose, được thêm bởi `message.save()`. | `SystemMessageManager.mjs:29-30` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `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`): thêm một tin nhắn. |
| `SystemMessageManager.mjs:22-26` (`clearMessages`) | `POST /admin/messages/clear` (`router.mjs:1155-1157`, `AdminController.mjs:161-168`): xóa tất cả tin nhắn. Không có cách xóa riêng một tin nhắn. |

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `SystemMessageManager.mjs:50-65` | Mỗi tiến trình `web` giữ mọi tin nhắn trong bộ nhớ và tải lại chúng mỗi 20 đến 30 giây, cũng như ngay sau khi chính nó tạo hoặc xóa. |
| `services/web/app/src/Features/SystemMessages/SystemMessageController.mjs:6-24` | `GET /system/messages` (`router.mjs:331`): trả về các tin nhắn đã lưu đệm cho người dùng đã đăng nhập. Khi trang đang đóng (`siteIsOpen` là false), nó trả về một thông báo cố định thay thế, thông báo này không được lưu trong Mongo. |
| `AdminController.mjs:83-84` | Trang `/admin` liệt kê tin nhắn trực tiếp từ Mongo. |

#### Chỉ mục

Không migration nào tạo chỉ mục trên `systemmessages`; chỉ có chỉ mục `_id` mặc định.

#### Ghi chú

* Khi đặt `notifyOnSystemMessageChanges`, thao tác tạo hoặc xóa cũng được phát trên kênh Redis `refresh-system-messages`, nên các tiến trình `web` khác tải lại ngay (`SystemMessageManager.mjs:9`, `:35-48`, `:75-87`). Nếu không đặt, chúng nhận thay đổi ở lần tải lại định kỳ tiếp theo.


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