feat(esg): --timeout-seconds on external-system create/update (management command + CLI, additive contract)

Claude-Session: https://claude.ai/code/session_01MtdgwpEeCUn6cUA5f1LMPj

src/ZB.MOM.WW.ScadaBridge.CLI/Commands/ExternalSystemCommands.cs

@@ -49,6 +49,7 @@ public static class ExternalSystemCommands
         var endpointUrlOption = new Option<string>("--endpoint-url") { Description = "Endpoint URL", Required = true };
         var authTypeOption = new Option<string>("--auth-type") { Description = "Auth type", Required = true };
         var authConfigOption = new Option<string?>("--auth-config") { Description = "Auth configuration JSON" };
+        var timeoutOption = new Option<int?>("--timeout-seconds") { Description = "Per-system HTTP timeout in seconds (0 = use gateway default); omit to preserve" };
 
         var cmd = new Command("update") { Description = "Update an external system" };
         cmd.Add(idOption);
@@ -56,6 +57,7 @@ public static class ExternalSystemCommands
         cmd.Add(endpointUrlOption);
         cmd.Add(authTypeOption);
         cmd.Add(authConfigOption);
+        cmd.Add(timeoutOption);
         cmd.SetAction(async (ParseResult result) =>
         {
             var id = result.GetValue(idOption);
@@ -63,9 +65,10 @@ public static class ExternalSystemCommands
             var endpointUrl = result.GetValue(endpointUrlOption)!;
             var authType = result.GetValue(authTypeOption)!;
             var authConfig = result.GetValue(authConfigOption);
+            var timeoutSeconds = result.GetValue(timeoutOption);
             return await CommandHelpers.ExecuteCommandAsync(
                 result, urlOption, formatOption, usernameOption, passwordOption,
-                new UpdateExternalSystemCommand(id, name, endpointUrl, authType, authConfig));
+                new UpdateExternalSystemCommand(id, name, endpointUrl, authType, authConfig, timeoutSeconds));
         });
         return cmd;
     }
@@ -87,21 +90,24 @@ public static class ExternalSystemCommands
         var endpointUrlOption = new Option<string>("--endpoint-url") { Description = "Endpoint URL", Required = true };
         var authTypeOption = new Option<string>("--auth-type") { Description = "Auth type (ApiKey, BasicAuth)", Required = true };
         var authConfigOption = new Option<string?>("--auth-config") { Description = "Auth configuration JSON" };
+        var timeoutOption = new Option<int?>("--timeout-seconds") { Description = "Per-system HTTP timeout in seconds (0 = use gateway default)" };
 
         var cmd = new Command("create") { Description = "Create an external system" };
         cmd.Add(nameOption);
         cmd.Add(endpointUrlOption);
         cmd.Add(authTypeOption);
         cmd.Add(authConfigOption);
+        cmd.Add(timeoutOption);
         cmd.SetAction(async (ParseResult result) =>
         {
             var name = result.GetValue(nameOption)!;
             var endpointUrl = result.GetValue(endpointUrlOption)!;
             var authType = result.GetValue(authTypeOption)!;
             var authConfig = result.GetValue(authConfigOption);
+            var timeoutSeconds = result.GetValue(timeoutOption);
             return await CommandHelpers.ExecuteCommandAsync(
                 result, urlOption, formatOption, usernameOption, passwordOption,
-                new CreateExternalSystemCommand(name, endpointUrl, authType, authConfig));
+                new CreateExternalSystemCommand(name, endpointUrl, authType, authConfig, timeoutSeconds));
         });
         return cmd;
     }

src/ZB.MOM.WW.ScadaBridge.Commons/Messages/Management/ExternalSystemCommands.cs

@@ -2,8 +2,8 @@ namespace ZB.MOM.WW.ScadaBridge.Commons.Messages.Management;
 
 public record ListExternalSystemsCommand;
 public record GetExternalSystemCommand(int ExternalSystemId);
-public record CreateExternalSystemCommand(string Name, string EndpointUrl, string AuthType, string? AuthConfiguration);
-public record UpdateExternalSystemCommand(int ExternalSystemId, string Name, string EndpointUrl, string AuthType, string? AuthConfiguration);
+public record CreateExternalSystemCommand(string Name, string EndpointUrl, string AuthType, string? AuthConfiguration, int? TimeoutSeconds = null);
+public record UpdateExternalSystemCommand(int ExternalSystemId, string Name, string EndpointUrl, string AuthType, string? AuthConfiguration, int? TimeoutSeconds = null);
 public record DeleteExternalSystemCommand(int ExternalSystemId);
 
 // External System Methods

src/ZB.MOM.WW.ScadaBridge.ManagementService/ManagementActor.cs

@@ -1622,7 +1622,8 @@ public class ManagementActor : ReceiveActor
         var repo = sp.GetRequiredService<IExternalSystemRepository>();
         var def = new ExternalSystemDefinition(cmd.Name, cmd.EndpointUrl, cmd.AuthType)
         {
-            AuthConfiguration = cmd.AuthConfiguration
+            AuthConfiguration = cmd.AuthConfiguration,
+            TimeoutSeconds = cmd.TimeoutSeconds ?? 0
         };
         await repo.AddExternalSystemAsync(def);
         await repo.SaveChangesAsync();
@@ -1639,6 +1640,7 @@ public class ManagementActor : ReceiveActor
         def.EndpointUrl = cmd.EndpointUrl;
         def.AuthType = cmd.AuthType;
         def.AuthConfiguration = cmd.AuthConfiguration;
+        if (cmd.TimeoutSeconds is { } ts) def.TimeoutSeconds = ts;
         await repo.UpdateExternalSystemAsync(def);
         await repo.SaveChangesAsync();
         await AuditAsync(sp, user, "Update", "ExternalSystem", def.Id.ToString(), def.Name, def);