Platform / IntegrationTrung tâm thông báo
Notification Recipient Group
Quản lý nhóm người nhận thông báo (employee group, customer group, custom list). Dùng trong Notification Task.
Notification Recipient Group định nghĩa ai sẽ nhận thông báo khi event xảy ra. Notification Task gắn 1+ recipient group để biết list owner cần dispatch.
Vị trí menu admin
Route-only:
- List:
/notificationrecipientgroup. - Tạo:
/notificationrecipientgroup/add. - Sửa:
/notificationrecipientgroup/edit/id/{id}.
Component: features/notificationrecipientgroup/list/NotificationRecipientGroupList.tsx, form/NotificationRecipientGroupForm.tsx.
Giao diện danh sách
<PageDataTable> cột:
| Cột | Key | Width |
|---|---|---|
| ID | id | 70 |
| Tên | name | flex (link sửa) |
| Loại | type | 140 - render getType(type).label (employee group, customer group, custom...) |
| Trạng thái | status | 120 |
| Ngày tạo | date_created | 120 |
| Thao tác | trigger | 100 |
Filter: keyword + type + status.
Form (tạo/sửa)
<FormLayoutContainer> với section thông tin chung + cấu hình theo type:
- Tên (
name) - required. - Loại (
type) - dropdownNotificationRecipientGroupModel.getTypeList(). - Cấu hình theo loại:
- Employee group: chọn list employee/role/team (UI dynamic).
- Customer group: chọn customer segment, customer type, hoặc list cụ thể.
- Custom list: nhập email/phone tay.
- Ghi chú (
note) - TextArea. - Trạng thái (
status) - sidebar.
Submit
NotificationRecipientGroupRepository.saveRemote(payload). Lỗi hiển thị qua prefix notificationrecipientgroup:form.error.
Các lối đi từ trang
- Recipient group được Notification Task gọi qua field
recipient_group_id_list(multi-select). - Khi backend dispatch, recipient group lookup endpoint của owner (xem Notification Endpoint).
Lưu ý - Lỗi thường gặp
- Group rỗng người nhận sau dispatch: kiểm tra group này có member chưa, hoặc condition (segment/role) vẫn match user. Group customer dùng dynamic segment có thể trả 0 user nếu segment empty.
- Trùng người nhận giữa 2 group: Notification Task có thể dedupe theo owner_id - tuỳ implementation backend.
- Đổi loại group: nếu UI cho phép, có thể làm config cũ vô nghĩa - thường nên xoá tạo mới.
Ai được xem và chỉnh?
- Xem danh sách và form: mọi tài khoản đã đăng nhập (tuỳ màn có thể chỉ đọc).
- Thêm, sửa, xoá, lưu: người có quyền Cài đặt bán hàng (tên trong màn hình gán quyền có thể khác tùy công ty).