更新nuget&&添加swagger

src/Jiaowu.Api/Controllers/OperationsController.cs

@@ -79,6 +79,38 @@ public sealed class OperationsController(
         CancellationToken cancellationToken) =>
         Ok(await healthService.CheckAsync(cancellationToken));
 
+    [HttpGet("swagger")]
+    public async Task<ActionResult<SwaggerDocumentationSettings>> GetSwaggerSettings(
+        CancellationToken cancellationToken) =>
+        Ok(new SwaggerDocumentationSettings(await IsSwaggerEnabledAsync(cancellationToken)));
+
+    [HttpPut("swagger")]
+    public async Task<ActionResult<SwaggerDocumentationSettings>> UpdateSwaggerSettings(
+        UpdateSwaggerDocumentationSettings request,
+        CancellationToken cancellationToken)
+    {
+        var setting = await db.SystemFeatureSettings.SingleOrDefaultAsync(
+            x => x.Key == SystemFeatureKeys.SwaggerDocumentation,
+            cancellationToken);
+        if (setting is null)
+        {
+            setting = new SystemFeatureSetting
+            {
+                Key = SystemFeatureKeys.SwaggerDocumentation,
+                IsEnabled = request.IsEnabled
+            };
+            db.SystemFeatureSettings.Add(setting);
+        }
+        else
+        {
+            setting.IsEnabled = request.IsEnabled;
+            setting.UpdatedAt = DateTime.UtcNow;
+        }
+
+        await db.SaveChangesAsync(cancellationToken);
+        return Ok(new SwaggerDocumentationSettings(setting.IsEnabled));
+    }
+
     [HttpGet("audit-logs")]
     public async Task<ActionResult<PagedResult<AuditLogItem>>> GetAuditLogs(
         [FromQuery] int page = 1,
@@ -519,9 +551,15 @@ public sealed class OperationsController(
                 cancellationToken) +
         await db.ExamPublishJobs.AsNoTracking()
             .CountAsync(
-                x => x.Status == ExamPublishJobStatus.Failed &&
-                     x.CreatedAt >= from,
-                cancellationToken);
+            x => x.Status == ExamPublishJobStatus.Failed &&
+            x.CreatedAt >= from,
+            cancellationToken);
+
+    private async Task<bool> IsSwaggerEnabledAsync(CancellationToken cancellationToken) =>
+        await db.SystemFeatureSettings.AsNoTracking()
+            .Where(x => x.Key == SystemFeatureKeys.SwaggerDocumentation)
+            .Select(x => (bool?)x.IsEnabled)
+            .SingleOrDefaultAsync(cancellationToken) ?? false;
 
     private ActionResult? ValidatePaging(int page, int pageSize)
     {
@@ -604,3 +642,7 @@ public sealed record OperationsSummary(
 public sealed record CreateBackupRequest([MaxLength(200)] string? Note);
 
 public sealed record RestoreDrillRequest([Required] string Confirmation);
+
+public sealed record SwaggerDocumentationSettings(bool IsEnabled);
+
+public sealed record UpdateSwaggerDocumentationSettings(bool IsEnabled);