feature: Explainable Alerts

VigilCareClinicalAPI/Domains/Entities/ClinicalAlert.cs

@@ -16,6 +16,7 @@ public class ClinicalAlert
     public Guid? ClientAlertId { get; set; }
     public bool SyncedFromGateway { get; set; }
     public bool FeedbackReceived { get; set; }
+    public AlertExplanation? Explanation { get; set; }
 
     public Encounter Encounter { get; set; } = null!;
     public List<AlertFeedback> Feedbacks { get; set; } = new();

VigilCareClinicalAPI/Domains/ValueObjects/AlertExplanation.cs

@@ -0,0 +1,7 @@
+public class AlertExplanation
+{
+    public List<ScoreContributor> ScoreContributors { get; set; } = new();
+    public TrendContext? Trend { get; set; }
+    public MedicationContext? MedicationContext { get; set; }
+    public string NarrativeSummary { get; set; } = string.Empty;
+}

VigilCareClinicalAPI/Domains/ValueObjects/MedicationContext.cs

@@ -0,0 +1,8 @@
+public class MedicationContext
+{
+    public string DrugName { get; set; } = null!;
+    public string Dose { get; set; } = null!;
+    public string Route { get; set; } = null!;
+    public DateTimeOffset AdministeredAt { get; set; }
+    public string? RelevanceNote { get; set; }
+}

VigilCareClinicalAPI/Domains/ValueObjects/ScoreContributor.cs

@@ -0,0 +1,7 @@
+public class ScoreContributor
+{
+    public string Parameter { get; set; } = null!;
+    public int Points { get; set; }
+    public string? RawValue { get; set; }
+    public string? NormalRange { get; set; }
+}

VigilCareClinicalAPI/Domains/ValueObjects/TrendContext.cs

@@ -0,0 +1,7 @@
+public class TrendContext
+{
+    public string Parameter { get; set; } = null!;
+    public double PercentChange { get; set; }
+    public TimeSpan Duration { get; set; }
+    public string Direction { get; set; } = null!;
+}