Fix build and code structure improvements. New but essential UI functionality. CI improvements. Documentation improvements. AI module improvements.

src/Router/__Libraries/StellaOps.Router.Common/Models/HeartbeatPayload.cs

@@ -0,0 +1,34 @@
+using StellaOps.Router.Common.Enums;
+
+namespace StellaOps.Router.Common.Models;
+
+/// <summary>
+/// Payload for the Heartbeat frame sent periodically by microservices.
+/// </summary>
+public sealed record HeartbeatPayload
+{
+    /// <summary>
+    /// Gets the instance ID.
+    /// </summary>
+    public required string InstanceId { get; init; }
+
+    /// <summary>
+    /// Gets the health status.
+    /// </summary>
+    public required InstanceHealthStatus Status { get; init; }
+
+    /// <summary>
+    /// Gets the current in-flight request count.
+    /// </summary>
+    public int InFlightRequestCount { get; init; }
+
+    /// <summary>
+    /// Gets the error rate (0.0 to 1.0).
+    /// </summary>
+    public double ErrorRate { get; init; }
+
+    /// <summary>
+    /// Gets the timestamp when this heartbeat was created.
+    /// </summary>
+    public DateTime TimestampUtc { get; init; } = DateTime.UtcNow;
+}