feat(commons): native alarm source entities + ResolvedNativeAlarmSource

2026-05-29 15:43:24 -04:00
parent ea14ace150
commit 913441972e
6 changed files with 126 additions and 0 deletions
@@ -0,0 +1,37 @@
+namespace ZB.MOM.WW.ScadaBridge.Commons.Entities.Templates;
+
+/// <summary>
+/// A template-defined binding to a native alarm source: a data connection plus
+/// a source reference (OPC UA SourceNode/notifier nodeId, or MxAccess
+/// object/area). At deploy time the instance subscribes and mirrors all
+/// conditions discovered under the source. Inheritance/lock semantics mirror
+/// <see cref="TemplateAlarm"/>.
+/// </summary>
+public class TemplateNativeAlarmSource
+{
+    /// <summary>Database primary key.</summary>
+    public int Id { get; set; }
+    /// <summary>Foreign key to the owning <see cref="Template"/>.</summary>
+    public int TemplateId { get; set; }
+    /// <summary>Unique source binding name within the template.</summary>
+    public string Name { get; set; }
+    /// <summary>Optional human-readable description.</summary>
+    public string? Description { get; set; }
+    /// <summary>Name of the data connection that owns the alarm feed.</summary>
+    public string ConnectionName { get; set; } = string.Empty;
+    /// <summary>Source reference (OPC UA SourceNode/notifier nodeId, or MxAccess object/area).</summary>
+    public string SourceReference { get; set; } = string.Empty;
+    /// <summary>Optional condition filter; null = mirror all conditions under the source.</summary>
+    public string? ConditionFilter { get; set; }
+    /// <summary>When true, this binding cannot be overridden in derived templates.</summary>
+    public bool IsLocked { get; set; }
+    /// <summary>True when copied from a base template and not yet overridden on the derived template.</summary>
+    public bool IsInherited { get; set; }
+    /// <summary>Set on a base binding; when true derived templates may not override it.</summary>
+    public bool LockedInDerived { get; set; }
+
+    /// <summary>Initializes a new binding with the specified name.</summary>
+    /// <param name="name">The unique binding name within the template.</param>
+    public TemplateNativeAlarmSource(string name) =>
+        Name = name ?? throw new ArgumentNullException(nameof(name));
+}