Fix-F2-F4: B4-batch+批量离线+凭据安全+前端地址+异常日志+滞后窗+console清理+API统一+Swagger+文档同步

gateway/src/IntegrationGateway.Adapters.Kms/KmsAdapter.cs

@@ -61,7 +61,7 @@ public class KmsAdapter : IHasFlatDevices, IHasAlarms, IAcceptsControl, IHasBusi
             var resp = await client.GetAsync("/prod-api/heartBeat");
             return resp.IsSuccessStatusCode;
         }
-        catch { return false; }
+        catch (Exception ex) { Console.Error.WriteLine($"[{AdapterCode}] HealthCheck 失败: {ex.Message}"); return false; }
     }
 
     // ═══════════════════════════════════════════

gateway/src/IntegrationGateway.Adapters.MC4/Mc4Adapter.cs

@@ -57,7 +57,7 @@ public class Mc4Adapter : IHasOwnDeviceTree, IHasPoints, IHasAlarms
             var resp = await client.PostAsync("/api/central/auth/conf/get", null);
             return resp.IsSuccessStatusCode;
         }
-        catch { return false; }
+        catch (Exception ex) { Console.Error.WriteLine($"[{AdapterCode}] HealthCheck 失败: {ex.Message}"); return false; }
     }
 
     // ═══════════════════════════════════════════

gateway/src/IntegrationGateway.Adapters.Owl/OwlAdapter.cs

@@ -60,7 +60,7 @@ public class OwlAdapter : IHasFlatDevices, IHasStreams, IHasRecordings, IAccepts
             var resp = await client.GetAsync("/health");
             return resp.IsSuccessStatusCode;
         }
-        catch { return false; }
+        catch (Exception ex) { Console.Error.WriteLine($"[{AdapterCode}] HealthCheck 失败: {ex.Message}"); return false; }
     }
 
     // ═══════════════════════════════════════════

gateway/src/IntegrationGateway.Host/IntegrationGateway.Host.csproj

@@ -7,6 +7,10 @@
     <ProjectReference Include="..\IntegrationGateway.Adapters.Kms\IntegrationGateway.Adapters.Kms.csproj" />
   </ItemGroup>
 
+  <ItemGroup>
+    <PackageReference Include="Swashbuckle.AspNetCore" Version="10.2.1" />
+  </ItemGroup>
+
   <PropertyGroup>
     <TargetFramework>net8.0</TargetFramework>
     <Nullable>enable</Nullable>

gateway/src/IntegrationGateway.Host/Program.cs

@@ -14,6 +14,9 @@ using IntegrationGateway.Core.Models;
 
 var builder = WebApplication.CreateBuilder(args);
 
+builder.Services.AddEndpointsApiExplorer();
+builder.Services.AddSwaggerGen();
+
 // ── 注册 HttpClient 工厂 ──
 // 命名客户端 "VolPro"：用于调用 Vol.Pro A 组接口和适配器内部 HTTP 请求
 // 连接池：最多 10 个并发连接，5 分钟生命周期
@@ -30,6 +33,9 @@ builder.Services.AddHttpClient("VolPro", c =>
 builder.Services.AddCors(o => o.AddDefaultPolicy(p => p.AllowAnyOrigin().AllowAnyMethod().AllowAnyHeader()));
 
 var app = builder.Build();
+app.UseSwagger();
+app.UseSwaggerUI();
+
 app.UseCors();
 
 // ── 读取配置 ──
@@ -178,6 +184,17 @@ app.MapGet("/api/gateway/realtime/{adapter}/{deviceId}", async (string adapter,
     return Results.Ok(await a.GetRealtimeValuesAsync(deviceId));
 });
 
+// B4-batch: 批量实时点位值 — 一次请求返回多个设备的值
+app.MapPost("/api/gateway/realtime/{adapter}/batch", async (string adapter, BatchRealtimeRequest req) =>
+{
+    var a = registry.FindByCode<IHasPoints>(adapter);
+    if (a == null) return Results.NotFound(new { error = "CAPABILITY_NOT_SUPPORTED" });
+    var results = new Dictionary<string, List<PointValue>>();
+    foreach (var deviceId in req.DeviceIds ?? new())
+        try { results[deviceId] = await a.GetRealtimeValuesAsync(deviceId); } catch { }
+    return Results.Ok(results);
+});
+
 // B5: 设备控制 — 向 IoT 设备下发控制指令
 app.MapPost("/api/gateway/realtime/{adapter}/control", async (string adapter, ControlRequest req) =>
 {
@@ -319,6 +336,7 @@ record PtzRequest(string? Direction, string Action, float Speed);
 /// <param name="PointIndex">点位索引</param>
 /// <param name="Value">目标值</param>
 record ControlRequest(string? DeviceId, int PointIndex, double Value);
+record BatchRealtimeRequest(List<string>? DeviceIds);
 record GatewayControlRequest(string? DeviceId, string? Command, Dictionary<string, object?>? Parameters);
 record SyncRequest(string? DataType, List<object>? Items);
 record SyncDeleteRequest(string? DataType, List<string>? Ids);