GameList/Endpoints/StateWorkflowService.cs

using GameList.Contracts;
using GameList.Data;
using GameList.Domain;
using Microsoft.EntityFrameworkCore;

namespace GameList.Endpoints;

internal sealed class StateWorkflowService(AppDbContext db)
{
    public async Task<IResult> GetStateAsync(Player player)
    {
        var state = await db.AppState.AsNoTracking().FirstAsync();
        var phase = EndpointHelpers.GetCurrentPhase(player.CurrentPhase, state.ResultsOpen);
        var summary = new StateSummaryResponse(
            phase,
            player.VotesFinal,
            player.HasJoker,
            state.ResultsOpen,
            state.UpdatedAt,
            await db.Players.CountAsync(),
            await db.Suggestions.CountAsync(),
            await db.Votes.CountAsync()
        );
        return Results.Ok(summary);
    }

    public async Task<IResult> GetMeAsync(Player player)
    {
        var state = await db.AppState.AsNoTracking().FirstAsync();
        var phase = EndpointHelpers.GetCurrentPhase(player.CurrentPhase, state.ResultsOpen);
        return Results.Ok(new MeResponse(
            player.Id,
            player.Username,
            player.DisplayName,
            player.IsAdmin,
            phase,
            player.VotesFinal,
            player.HasJoker
        ));
    }

    public async Task<IResult> NextPhaseAsync(Player player)
    {
        var appState = await db.AppState.FirstAsync();
        var shouldSave = EndpointHelpers.ReconcilePlayerPhase(player, appState.ResultsOpen);

        try
        {
            var next = NextPhase(player.CurrentPhase);

            if (next == Phase.Vote)
            {
                var hasSuggestions = await db.Suggestions.AnyAsync(s => s.PlayerId == player.Id);
                if (!hasSuggestions)
                    return EndpointHelpers.BadRequestError("Add at least one suggestion before entering the Vote phase.");
            }

            if (next == Phase.Results && !appState.ResultsOpen)
                return EndpointHelpers.BadRequestError("Results are locked until the admin enables them.");

            player.CurrentPhase = next;
            player.VotesFinal = false; // moving forward clears any prior finalize
            shouldSave = true;
            return Results.Ok(new PhaseTransitionResponse(player.CurrentPhase, appState.ResultsOpen));
        }
        finally
        {
            if (shouldSave)
                await db.SaveChangesAsync();
        }
    }

    public async Task<IResult> PrevPhaseAsync(Player player)
    {
        if (!player.IsAdmin)
            return EndpointHelpers.BadRequestError("Only admins can move backward.");

        var appState = await db.AppState.FirstAsync();
        _ = EndpointHelpers.ReconcilePlayerPhase(player, appState.ResultsOpen);

        player.CurrentPhase = PrevPhase(player.CurrentPhase);
        player.VotesFinal = false;
        await db.SaveChangesAsync();
        return Results.Ok(new PhaseTransitionResponse(player.CurrentPhase, appState.ResultsOpen));
    }

    private static Phase NextPhase(Phase current) => current switch
    {
        Phase.Suggest => Phase.Vote,
        _             => Phase.Results
    };

    private static Phase PrevPhase(Phase current) => current switch
    {
        Phase.Results => Phase.Vote,
        _             => Phase.Suggest
    };
}