Introduce typed API responses and align workflow outputs

Endpoints/AdminWorkflowService.cs

@@ -27,11 +27,7 @@ internal sealed class AdminWorkflowService(AppDbContext db)
         await db.SaveChangesAsync();
         await tx.CommitAsync();
         var currentState = await db.AppState.AsNoTracking().FirstAsync();
-        return Results.Ok(new
-        {
-            currentState.ResultsOpen,
-            currentState.UpdatedAt
-        });
+        return Results.Ok(new AdminResultsStateResponse(currentState.ResultsOpen, currentState.UpdatedAt));
     }
 
     public async Task<IResult> GetVoteStatusAsync()
@@ -45,12 +41,7 @@ internal sealed class AdminWorkflowService(AppDbContext db)
 
         var waiting = voters.Where(v => !v.Finalized).Select(v => v.Name).ToList();
         var ready = waiting.Count == 0;
-        return Results.Ok(new
-        {
-            voters,
-            ready,
-            waiting
-        });
+        return Results.Ok(new VoteStatusResponse(voters, ready, waiting));
     }
 
     public async Task<IResult> GrantJokerAsync(GrantJokerRequest request)
@@ -67,11 +58,7 @@ internal sealed class AdminWorkflowService(AppDbContext db)
         player.VotesFinal = false;
         await db.SaveChangesAsync();
 
-        return Results.Ok(new
-        {
-            player.Id,
-            player.HasJoker
-        });
+        return Results.Ok(new AdminGrantJokerResponse(player.Id, player.HasJoker));
     }
 
     public async Task<IResult> DeletePlayerAsync(Guid playerId)
@@ -98,7 +85,7 @@ internal sealed class AdminWorkflowService(AppDbContext db)
         await db.SaveChangesAsync();
         await tx.CommitAsync();
 
-        return Results.Ok(new { DeletedPlayerId = playerId });
+        return Results.Ok(new AdminDeletePlayerResponse(playerId));
     }
 
     public async Task<IResult> LinkSuggestionsAsync(Player adminPlayer, LinkSuggestionsRequest request)
@@ -153,12 +140,7 @@ internal sealed class AdminWorkflowService(AppDbContext db)
 
         await tx.CommitAsync();
 
-        return Results.Ok(new
-        {
-            RootId = targetRoot,
-            LinkedSuggestionIds = affectedIds,
-            UnfinalizedPlayers = await db.Players.CountAsync()
-        });
+        return Results.Ok(new AdminLinkSuggestionsResponse(targetRoot, affectedIds, await db.Players.CountAsync()));
     }
 
     public async Task<IResult> UnlinkSuggestionsAsync(Player adminPlayer, UnlinkSuggestionsRequest request)
@@ -170,19 +152,11 @@ internal sealed class AdminWorkflowService(AppDbContext db)
         var suggestions = await db.Suggestions.ToListAsync();
         var target = suggestions.FirstOrDefault(s => s.Id == request.SuggestionId);
         if (target is null)
-            return Results.Ok(new
-            {
-                UnlinkedSuggestionIds = Array.Empty<int>(),
-                UnfinalizedPlayers = 0
-            });
+            return Results.Ok(new AdminUnlinkSuggestionsResponse(Array.Empty<int>(), 0));
 
         var rootIndex = EndpointHelpers.BuildLinkRoots(suggestions.Select(s => (s.Id, s.ParentSuggestionId)));
         if (!rootIndex.TryGetValue(target.Id, out var rootId))
-            return Results.Ok(new
-            {
-                UnlinkedSuggestionIds = Array.Empty<int>(),
-                UnfinalizedPlayers = 0
-            });
+            return Results.Ok(new AdminUnlinkSuggestionsResponse(Array.Empty<int>(), 0));
 
         var groupIds = rootIndex.Where(kv => kv.Value == rootId).Select(kv => kv.Key).ToList();
 
@@ -201,11 +175,7 @@ internal sealed class AdminWorkflowService(AppDbContext db)
 
         await tx.CommitAsync();
 
-        return Results.Ok(new
-        {
-            UnlinkedSuggestionIds = groupIds,
-            UnfinalizedPlayers = await db.Players.CountAsync()
-        });
+        return Results.Ok(new AdminUnlinkSuggestionsResponse(groupIds, await db.Players.CountAsync()));
     }
 
     public async Task<IResult> ResetAsync()
@@ -222,12 +192,7 @@ internal sealed class AdminWorkflowService(AppDbContext db)
         await db.SaveChangesAsync();
         await tx.CommitAsync();
 
-        return Results.Ok(new
-        {
-            Phase = Phase.Suggest,
-            state.ResultsOpen,
-            state.UpdatedAt
-        });
+        return Results.Ok(new AdminResetStateResponse(Phase.Suggest, state.ResultsOpen, state.UpdatedAt));
     }
 
     public async Task<IResult> FactoryResetAsync()
@@ -245,11 +210,6 @@ internal sealed class AdminWorkflowService(AppDbContext db)
 
         await tx.CommitAsync();
 
-        return Results.Ok(new
-        {
-            Phase = Phase.Suggest,
-            fresh.ResultsOpen,
-            fresh.UpdatedAt
-        });
+        return Results.Ok(new AdminResetStateResponse(Phase.Suggest, fresh.ResultsOpen, fresh.UpdatedAt));
     }
 }