76 lines
3.7 KiB
C#
76 lines
3.7 KiB
C#
using ScadaLink.Commons.Types.Enums;
|
|
|
|
namespace ScadaLink.Commons.Entities.Notifications;
|
|
|
|
/// <summary>
|
|
/// A single notification queued in the central outbox. Created at a site (where the
|
|
/// <see cref="NotificationId"/> GUID is generated) and forwarded to the central cluster
|
|
/// for delivery, retry, and audit. The lifecycle is tracked by <see cref="Status"/>.
|
|
/// </summary>
|
|
public class Notification
|
|
{
|
|
/// <summary>GUID primary key, generated at the originating site.</summary>
|
|
public string NotificationId { get; set; }
|
|
public NotificationType Type { get; set; }
|
|
public string ListName { get; set; }
|
|
public string Subject { get; set; }
|
|
public string Body { get; set; }
|
|
|
|
/// <summary>JSON extensibility hook for channel-specific payload data.</summary>
|
|
public string? TypeData { get; set; }
|
|
public NotificationStatus Status { get; set; } = NotificationStatus.Pending;
|
|
public int RetryCount { get; set; }
|
|
public string? LastError { get; set; }
|
|
|
|
/// <summary>Resolved delivery targets snapshotted at delivery time, for audit.</summary>
|
|
public string? ResolvedTargets { get; set; }
|
|
public string SourceSiteId { get; set; }
|
|
|
|
/// <summary>
|
|
/// The cluster node on which the notification was emitted — `node-a` / `node-b`
|
|
/// for site rows (qualified by <see cref="SourceSiteId"/>), `central-a` / `central-b`
|
|
/// for central-originated rows. Carried from the site on the
|
|
/// <see cref="Commons.Messages.Notification.NotificationSubmit"/> and persisted at
|
|
/// central; nullable so rows submitted before the column existed don't block ingest.
|
|
/// </summary>
|
|
public string? SourceNode { get; set; }
|
|
public string? SourceInstanceId { get; set; }
|
|
public string? SourceScript { get; set; }
|
|
|
|
/// <summary>
|
|
/// The originating script execution's <c>ExecutionId</c> (Audit Log #23). Carried from
|
|
/// the site on the <see cref="Commons.Messages.Notification.NotificationSubmit"/> so the
|
|
/// central dispatcher can stamp the same id onto its <c>NotifyDeliver</c> audit rows,
|
|
/// correlating them with the site-emitted <c>NotifySend</c> row. Null for notifications
|
|
/// submitted before the column existed, or raised outside a script-execution context.
|
|
/// </summary>
|
|
public Guid? OriginExecutionId { get; set; }
|
|
|
|
/// <summary>
|
|
/// The originating routed script execution's <c>ParentExecutionId</c> (Audit Log #23).
|
|
/// Carried from the site on the <see cref="Commons.Messages.Notification.NotificationSubmit"/>
|
|
/// so the central dispatcher can stamp the same parent id onto its <c>NotifyDeliver</c>
|
|
/// audit rows, correlating them with the site-emitted <c>NotifySend</c> row. Null for
|
|
/// non-routed runs, or for notifications submitted before the column existed.
|
|
/// </summary>
|
|
public Guid? OriginParentExecutionId { get; set; }
|
|
public DateTimeOffset SiteEnqueuedAt { get; set; }
|
|
|
|
/// <summary>Central ingest time.</summary>
|
|
public DateTimeOffset CreatedAt { get; set; }
|
|
public DateTimeOffset? LastAttemptAt { get; set; }
|
|
public DateTimeOffset? NextAttemptAt { get; set; }
|
|
public DateTimeOffset? DeliveredAt { get; set; }
|
|
|
|
public Notification(string notificationId, NotificationType type, string listName,
|
|
string subject, string body, string sourceSiteId)
|
|
{
|
|
NotificationId = notificationId ?? throw new ArgumentNullException(nameof(notificationId));
|
|
Type = type;
|
|
ListName = listName ?? throw new ArgumentNullException(nameof(listName));
|
|
Subject = subject ?? throw new ArgumentNullException(nameof(subject));
|
|
Body = body ?? throw new ArgumentNullException(nameof(body));
|
|
SourceSiteId = sourceSiteId ?? throw new ArgumentNullException(nameof(sourceSiteId));
|
|
}
|
|
}
|