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

src/Router/__Libraries/StellaOps.Router.AspNet/StellaRouterOptionsBase.cs

@@ -0,0 +1,84 @@
+using StellaOps.Router.Common.Enums;
+
+namespace StellaOps.Router.AspNet;
+
+/// <summary>
+/// Base configuration options for Stella Router integration that can be embedded
+/// in any WebService's options class. Services should include a property of this type
+/// named "Router" to enable Router integration.
+/// </summary>
+/// <example>
+/// <code>
+/// public class MyServiceOptions
+/// {
+///     public StellaRouterOptionsBase? Router { get; set; }
+/// }
+/// </code>
+/// </example>
+public class StellaRouterOptionsBase
+{
+    /// <summary>
+    /// Enable Stella Router integration. When true, ASP.NET endpoints
+    /// are automatically registered with the Router for discovery and dispatch.
+    /// Default: false.
+    /// </summary>
+    public bool Enabled { get; set; }
+
+    /// <summary>
+    /// Deployment region for this service instance.
+    /// Default: "default".
+    /// </summary>
+    public string Region { get; set; } = "default";
+
+    /// <summary>
+    /// Default request timeout in seconds.
+    /// Default: 30 seconds.
+    /// </summary>
+    public int DefaultTimeoutSeconds { get; set; } = 30;
+
+    /// <summary>
+    /// Heartbeat interval in seconds for health reporting.
+    /// Default: 10 seconds.
+    /// </summary>
+    public int HeartbeatIntervalSeconds { get; set; } = 10;
+
+    /// <summary>
+    /// Gateway endpoints to connect to for endpoint registration.
+    /// </summary>
+    public IList<StellaRouterGatewayOptionsBase> Gateways { get; set; } = new List<StellaRouterGatewayOptionsBase>();
+}
+
+/// <summary>
+/// Base configuration for a Router gateway connection.
+/// </summary>
+public class StellaRouterGatewayOptionsBase
+{
+    /// <summary>
+    /// Gateway host.
+    /// Default: "localhost".
+    /// </summary>
+    public string Host { get; set; } = "localhost";
+
+    /// <summary>
+    /// Gateway port.
+    /// Default: 9100.
+    /// </summary>
+    public int Port { get; set; } = 9100;
+
+    /// <summary>
+    /// Transport type (InMemory, Tcp, Tls, Messaging).
+    /// Default: InMemory.
+    /// </summary>
+    public TransportType TransportType { get; set; } = TransportType.InMemory;
+
+    /// <summary>
+    /// Enable TLS for TCP transport.
+    /// Default: false.
+    /// </summary>
+    public bool UseTls { get; set; }
+
+    /// <summary>
+    /// TLS certificate path (if UseTls is true).
+    /// </summary>
+    public string? CertificatePath { get; set; }
+}