Clinical Sync Batch Engine: first commit

VigilCareClinicalAPI/Domains/Entities/ClinicalAlert.cs

@@ -13,6 +13,8 @@ public class ClinicalAlert
     public string? AcknowledgedBy { get; set; }
     public DateTimeOffset? ResolvedAt { get; set; }
     public DateTimeOffset TriggeredAt { get; set; }
+    public Guid? ClientAlertId { get; set; }
+    public bool SyncedFromGateway { get; set; }
 
     public Encounter Encounter { get; set; } = null!;
 }

VigilCareClinicalAPI/Domains/Entities/ClinicalSite.cs

@@ -0,0 +1,21 @@
+public class ClinicalSite
+{
+    public Guid Id { get; private set; }
+    public string SiteCode { get; private set; } = string.Empty;
+    public string Name { get; private set; } = string.Empty;
+    public string? Address { get; private set; }
+    public bool Active { get; private set; } = true;
+    public DateTimeOffset CreatedAt { get; private set; }
+
+    public ICollection<WardGateway> Gateways { get; private set; } = [];
+
+    private ClinicalSite() { }
+
+    public ClinicalSite(string siteCode, string name, string? address = null)
+    {
+        SiteCode = siteCode;
+        Name = name;
+        Address = address;
+        CreatedAt = DateTimeOffset.UtcNow;
+    }
+}

VigilCareClinicalAPI/Domains/Entities/ClinicalSyncBatch.cs

@@ -0,0 +1,30 @@
+public class ClinicalSyncBatch
+{
+    public Guid Id { get; private set; }
+    public Guid GatewayId { get; private set; }
+    public Guid SiteId { get; private set; }
+    public Guid BatchReference { get; private set; }
+    public ClinicalSyncBatchStatus Status { get; private set; } = ClinicalSyncBatchStatus.Received;
+    public string Payload { get; private set; } = "{}";
+    public DateTimeOffset SubmittedAt { get; private set; }
+    public DateTimeOffset? ProcessedAt { get; private set; }
+
+    public WardGateway Gateway { get; private set; } = null!;
+    public ICollection<ClinicalSyncConflict> Conflicts { get; private set; } = [];
+
+    private ClinicalSyncBatch() { }
+
+    public ClinicalSyncBatch(Guid gatewayId, Guid siteId, Guid batchReference, string payload)
+    {
+        GatewayId = gatewayId;
+        SiteId = siteId;
+        BatchReference = batchReference;
+        Payload = payload;
+        SubmittedAt = DateTimeOffset.UtcNow;
+    }
+
+    public void MarkProcessing() => Status = ClinicalSyncBatchStatus.Processing;
+    public void MarkApplied() { Status = ClinicalSyncBatchStatus.Applied; ProcessedAt = DateTimeOffset.UtcNow; }
+    public void MarkConflict() { Status = ClinicalSyncBatchStatus.Conflict; ProcessedAt = DateTimeOffset.UtcNow; }
+    public void MarkRejected() { Status = ClinicalSyncBatchStatus.Rejected; ProcessedAt = DateTimeOffset.UtcNow; }
+}

VigilCareClinicalAPI/Domains/Entities/ClinicalSyncConflict.cs

@@ -0,0 +1,22 @@
+public class ClinicalSyncConflict
+{
+    public Guid Id { get; private set; }
+    public Guid BatchId { get; private set; }
+    public Guid ClientRef { get; private set; }
+    public string ItemType { get; private set; } = string.Empty;
+    public string ConflictReason { get; private set; } = string.Empty;
+    public DateTimeOffset CreatedAt { get; private set; }
+
+    public ClinicalSyncBatch Batch { get; private set; } = null!;
+
+    private ClinicalSyncConflict() { }
+
+    public ClinicalSyncConflict(Guid batchId, Guid clientRef, string itemType, string conflictReason)
+    {
+        BatchId = batchId;
+        ClientRef = clientRef;
+        ItemType = itemType;
+        ConflictReason = conflictReason;
+        CreatedAt = DateTimeOffset.UtcNow;
+    }
+}

VigilCareClinicalAPI/Domains/Entities/WardGateway.cs

@@ -0,0 +1,44 @@
+public class WardGateway
+{
+    public Guid Id { get; private set; }
+    public Guid SiteId { get; private set; }
+    public string GatewayCode { get; private set; } = string.Empty;
+    public string Department { get; private set; } = string.Empty;
+    public GatewayStatus Status { get; private set; } = GatewayStatus.Offline;
+    public int ReportedBufferDepth { get; private set; }
+    public DateTimeOffset? LastHeartbeatAt { get; private set; }
+    public DateTimeOffset? LastSyncAt { get; private set; }
+    public DateTimeOffset CreatedAt { get; private set; }
+
+    public ClinicalSite Site { get; private set; } = null!;
+
+    private WardGateway() { }
+
+    public WardGateway(Guid siteId, string gatewayCode, string department)
+    {
+        SiteId = siteId;
+        GatewayCode = gatewayCode;
+        Department = department;
+        CreatedAt = DateTimeOffset.UtcNow;
+    }
+
+    public void RecordHeartbeat(GatewayStatus status, int bufferDepth, DateTimeOffset at)
+    {
+        Status = status;
+        ReportedBufferDepth = bufferDepth;
+        LastHeartbeatAt = at;
+    }
+
+    public void MarkSynced(DateTimeOffset at)
+    {
+        LastSyncAt = at;
+        ReportedBufferDepth = 0;
+        if (Status == GatewayStatus.Degraded)
+            Status = GatewayStatus.Online;
+    }
+
+    public void MarkOffline()
+    {
+        Status = GatewayStatus.Offline;
+    }
+}