@digiforce-nc/plugin-workflow-notification

Plugin đăng ký node gửi thông báo qua notification-manager trong workflow, mở rộng plugin-workflow. Gửi thông báo đến người dùng qua bất kỳ kênh nào đã đăng ký (in-app, email, SMS, ...).

Plugin này làm gì?

Node Notification sử dụng notification-manager để gửi thông báo qua các kênh đã cấu hình. Khác với node Mailer (chỉ SMTP) hoặc Telegram (chỉ Telegram), Notification gửi qua hệ thống thông báo tập trung - hỗ trợ đa kênh và quản lý thống nhất.

Ưu điểm so với gửi trực tiếp (Mailer, Telegram):

Đa kênh: Một node gửi qua nhiều kênh cùng lúc
Quản lý tập trung: Tất cả thông báo đi qua notification-manager
Mở rộng: Thêm kênh mới mà không sửa workflow

Cấu hình

Tham số	Kiểu	Mô tả
`recipients`	`array`	Danh sách user/role nhận thông báo
`channels`	`array`	Kênh gửi: `in-app`, `email`, `sms`, ...
`title`	`string`	Tiêu đề thông báo (hỗ trợ template biến)
`content`	`string`	Nội dung thông báo (hỗ trợ template biến)
`sendAll`	`boolean`	Gửi qua tất cả kênh đã đăng ký

Input / Output

Hướng	Dữ liệu	Mô tả
Input	`recipients`	Người nhận (user ID, role, hoặc biến workflow)
Input	`title, content`	Nội dung thông báo (template với biến)
Output	`sent`	Số thông báo đã gửi thành công
Output	`failed`	Số thông báo gửi thất bại
Output	`channels`	Chi tiết kết quả theo từng kênh

Tính năng chính

#	Tính năng	Chi tiết
1	Đa kênh	Gửi qua in-app, email, SMS, và các kênh custom
2	Template	Nội dung sử dụng biến từ workflow context
3	Notification Manager	Tích hợp hệ thống thông báo tập trung
4	Chọn kênh	Cấu hình gửi qua kênh cụ thể hoặc tất cả
5	Không chặn	Gửi thông báo rồi tiếp tục, không chờ phản hồi

Trường hợp sử dụng

#	Kịch bản	Mô tả
1	Thông báo đa kênh	Gửi cả in-app lẫn email khi đơn hàng được tạo
2	Cảnh báo hệ thống	Push notification cho admin khi phát hiện bất thường
3	Nhắc nhở deadline	Gửi notification cho assignee trước deadline 1 ngày
4	Welcome notification	Gửi thông báo chào mừng user mới qua in-app

Lưu ý quan trọng

Yêu cầu plugin-notification-manager phải được cài và cấu hình
Kênh phải được đăng ký trong notification-manager trước khi dùng
Gửi đa kênh là fire-and-forget - lỗi 1 kênh không ảnh hưởng kênh khác
Template biến giống nhau cho tất cả kênh - không tùy chỉnh nội dung theo kênh
Để gửi email phức tạp (attachment, HTML), dùng Mailer node thay vì Notification

Dependencies

Package	Vai trò
`@digiforce-nc/plugin-workflow`	Workflow engine (peer)
`@digiforce-nc/plugin-notification-manager`	Quản lý kênh thông báo (peer)
`@digiforce-nc/server`	Server framework (peer)