feat(historian): config-gated SqliteStoreAndForward→Wonderware sink (AddAlarmHistorian)

src/Server/ZB.MOM.WW.OtOpcUa.Runtime/Historian/AlarmHistorianOptions.cs

@@ -0,0 +1,32 @@
+namespace ZB.MOM.WW.OtOpcUa.Runtime.Historian;
+
+/// <summary>
+///     Binds the <c>AlarmHistorian</c> configuration section that gates the durable
+///     store-and-forward alarm sink. When <see cref="Enabled"/> is <c>true</c>,
+///     <c>AddAlarmHistorian</c> registers a <c>SqliteStoreAndForwardSink</c> (draining to the
+///     Wonderware named-pipe writer supplied by the Host) in place of the
+///     <c>NullAlarmHistorianSink</c> default; otherwise the Null default survives.
+/// </summary>
+public sealed class AlarmHistorianOptions
+{
+    /// <summary>The configuration section name this options class binds.</summary>
+    public const string SectionName = "AlarmHistorian";
+
+    /// <summary>
+    ///     When <c>true</c>, the durable SQLite store-and-forward sink is registered; when
+    ///     <c>false</c> (the default) the no-op <c>NullAlarmHistorianSink</c> stays in place.
+    /// </summary>
+    public bool Enabled { get; init; }
+
+    /// <summary>Filesystem path to the local SQLite store-and-forward queue database.</summary>
+    public string DatabasePath { get; init; } = "alarm-historian.db";
+
+    /// <summary>Named-pipe name the Wonderware historian sidecar listens on.</summary>
+    public string PipeName { get; init; } = "OtOpcUaHistorian";
+
+    /// <summary>Per-process shared secret the sidecar verifies in the Hello frame.</summary>
+    public string SharedSecret { get; init; } = "";
+
+    /// <summary>Maximum number of queued rows the drain worker forwards in a single batch.</summary>
+    public int BatchSize { get; init; } = 100;
+}