CenIT.NotifyLib 1.1.0

NotifyLib v1.1.0

Giới thiệu

NotifyLib là thư viện C# (.NET Framework 4.8) hỗ trợ gửi thông báo đa kênh như Email, SMS/ZNS, Firebase, có thể mở rộng thêm các kênh khác.
Thư viện được thiết kế theo kiến trúc DI + Strategy + Retry + Pipeline, hỗ trợ gửi song song, fallback, retry theo từng recipient, tránh spam notify.

Tính năng chính

• Gửi đa kênh: Email, SMS/ZNS, Firebase
• Gửi nhiều channel cùng lúc
• Strategy gửi:
  • Fallback
  • ParallelAll
  • ParallelFirst
• Retry per recipient
• Log chi tiết từng lần retry
• Trả kết quả gửi (NotifyExecutionReport)
• Observer/Event NotifyCompleted
• JSON Config auto-load
• Dễ mở rộng thêm notifier mới

Cài đặt

• .NET Framework 4.8
• Thêm project NotifyLib vào solution
• Tham chiếu từ Web / API / Console App

Cấu hình (appsettings.json)

{
  "Email": {
    "Enable": true,
    "SmtpServer": "",
    "Port": 587,
    "EnableSsl": false,
    "User": "",
    "Password": "",
    "From": ""
  },
  "Firebase": {
    "Enable": false,
    "ProjectId": "",
    "ApiUrl": "",
    "ServiceAccountJson": ""
  },
  //"Zalo": { // Tạm ẩn do chưa có thông tin
  //  "ServiceUrl": null,
  //  "OAId": null,
  //  "Enable": false
  //},
  "ZNS": {
    "ServiceUrl": "",
    "AppId": "",
    "SecrectKey": "",
    "AccessToken": "",
    "RefreshToken": "",
    "Enable": true
  },
  "Sms": {
    "Enable": true,
    "ServiceUrl": "",
    "AgentId": "",
    "UserService": "",
    "UserPassService": "",
    "LabelId": "",
    "ContractId": "",
    "ContractTypeId": "",
    "UserName": ""
  },
  "ChannelPolicy": [
    {
      "Channel": "Email",
      "Priority": 1,
      "Enable": true
    },
    {
      "Channel": "Firebase",
      "Priority": 2,
      "Enable": false
    },
    //{
    //  "Channel": "Zalo",
    //  "Priority": 3,
    //  "Enable": false
    //},
    {
      "Channel": "Sms",
      "Priority": 4,
      "Enable": true
    },
    {
      "Channel": "ZNS",
      "Priority": 5,
      "Enable": true
    }
  ]
}

Sử dụng cơ bản

Khởi tạo DI

var services = new ServiceCollection();
services.AddNotifyByJsonPath("notify.json");
var provider = services.BuildServiceProvider();

var notify = provider.GetRequiredService<NotifyService>();

Gửi notify đa kênh

var report = notifyService.Send(new NotifyContext
{
    SendMode = NotifySendMode.ParallelAll,
    Channels = new Dictionary<string, object>
    {
        {
            ChannelTypes.EMAIL,
            new EmailNotifyData
            {
                Recipients = new [] { "user@mail.com" },
                Subject = "Test",
                BodyHtml = "Hello"
            }
        },
        {
            ChannelTypes.SMS,
            new SmsNotifyData
            {
                Recipients = new List<string> {"0843466804", "0974463353" },
                TemplateId = "5431422",
                Params = new List<string>{ "AAAAA", "https://asdasf.com/" }
            }
        }
    }
});

Versioning

• v1.1.0
  • Chỉnh sửa hàm load config Notify từ path
  • Bổ sung hàm load config Notify từ chuỗi json
  • Fixbug

License