be1003c53e
Adds the four tables Streams B/C/F consume — Script (generation-scoped source code), VirtualTag (generation-scoped calculated-tag config), ScriptedAlarm (generation-scoped alarm config), and ScriptedAlarmState (logical-id-keyed persistent runtime state). ## New entities (net10, EF Core) - Script — stable logical ScriptId carries across generations; SourceHash is the compile-cache key (matches Core.Scripting's CompiledScriptCache). - VirtualTag — mandatory EquipmentId FK (plan decision #2, unified Equipment tree); ChangeTriggered/TimerIntervalMs + Historize flags; check constraints enforce "at least one trigger" + "timer >= 50ms". - ScriptedAlarm — required AlarmType ('AlarmCondition'/'LimitAlarm'/'OffNormalAlarm'/ 'DiscreteAlarm'); Severity 1..1000 range check; HistorizeToAveva default true per plan decision #15. - ScriptedAlarmState — keyed ONLY on ScriptedAlarmId (NOT generation-scoped) per plan decision #14 — ack state + audit trail must follow alarm identity across Modified generations. CommentsJson has ISJSON check for GxP audit. ## Migration EF-generated 20260420231641_AddPhase7ScriptingTables covers all 4 tables + indexes + check constraints + FKs to ConfigGeneration. sp_PublishGeneration required no changes — it only flips Draft->Published status; the new entities already carry GenerationId so they publish atomically with the rest of the config. ## Tests — 12/12 (design-time model introspection) Phase7ScriptingEntitiesTests covers: table registration, column maxlength + column types, unique indexes (Generation+LogicalId, Generation+EquipmentPath for VirtualTag and ScriptedAlarm), secondary indexes (SourceHash for cache lookup), check constraints (trigger-required, timer-min, severity-range, alarm-type-enum, CommentsJson-IsJson), ScriptedAlarmState PK is alarm-id not generation-scoped, ScriptedAlarm defaults (HistorizeToAveva=true, Retain=true, Severity=500, Enabled=true), DbSets wired, and the generated migration type exists for rollforward.
60 lines
2.7 KiB
C#
60 lines
2.7 KiB
C#
namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
|
|
|
|
/// <summary>
|
|
/// Per Phase 7 plan decisions #5, #13, #15 — a scripted OPC UA Part 9 alarm whose
|
|
/// condition is the predicate <see cref="Script"/> referenced by
|
|
/// <see cref="PredicateScriptId"/>. Materialized by <c>Core.ScriptedAlarms</c> as a
|
|
/// concrete <c>AlarmConditionType</c> subtype per <see cref="AlarmType"/>.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// <para>
|
|
/// Message tokens (<c>{TagPath}</c>) resolved at emission time per plan decision #13.
|
|
/// <see cref="HistorizeToAveva"/> (plan decision #15) gates whether transitions
|
|
/// route through the Core.AlarmHistorian SQLite queue + Galaxy.Host to the Aveva
|
|
/// Historian alarm schema.
|
|
/// </para>
|
|
/// </remarks>
|
|
public sealed class ScriptedAlarm
|
|
{
|
|
public Guid ScriptedAlarmRowId { get; set; }
|
|
public long GenerationId { get; set; }
|
|
|
|
/// <summary>Stable logical id — drives <c>AlarmConditionType.ConditionName</c>.</summary>
|
|
public required string ScriptedAlarmId { get; set; }
|
|
|
|
/// <summary>Logical FK to <see cref="Equipment.EquipmentId"/> — owner of this alarm.</summary>
|
|
public required string EquipmentId { get; set; }
|
|
|
|
/// <summary>Operator-facing alarm name.</summary>
|
|
public required string Name { get; set; }
|
|
|
|
/// <summary>Concrete Part 9 type — "AlarmCondition" / "LimitAlarm" / "OffNormalAlarm" / "DiscreteAlarm".</summary>
|
|
public required string AlarmType { get; set; }
|
|
|
|
/// <summary>Numeric severity 1..1000 per OPC UA Part 9 (usual bands: 1-250 Low, 251-500 Medium, 501-750 High, 751-1000 Critical).</summary>
|
|
public int Severity { get; set; } = 500;
|
|
|
|
/// <summary>Template with <c>{TagPath}</c> tokens resolved at emission time.</summary>
|
|
public required string MessageTemplate { get; set; }
|
|
|
|
/// <summary>Logical FK to <see cref="Script.ScriptId"/> — predicate script returning <c>bool</c>.</summary>
|
|
public required string PredicateScriptId { get; set; }
|
|
|
|
/// <summary>
|
|
/// Plan decision #15 — when true, transitions route through the SQLite store-and-forward
|
|
/// queue to the Aveva Historian. Defaults on for scripted alarms because they are the
|
|
/// primary motivation for the historian sink; operator can disable per alarm.
|
|
/// </summary>
|
|
public bool HistorizeToAveva { get; set; } = true;
|
|
|
|
/// <summary>
|
|
/// OPC UA Part 9 <c>Retain</c> flag — whether the alarm keeps active-state between
|
|
/// sessions. Most plant alarms are retained; one-shot event-style alarms are not.
|
|
/// </summary>
|
|
public bool Retain { get; set; } = true;
|
|
|
|
public bool Enabled { get; set; } = true;
|
|
|
|
public ConfigGeneration? Generation { get; set; }
|
|
}
|