Resolve #415

src/Gameboard.Api.Tests.Unit/Tests/Features/Challenges/ChallengeSyncServiceTests.cs

@@ -27,6 +27,7 @@ public async Task GetExpiredChallengesForSync_WithPlayerWithNullishEndDate_DoesN
         var store = BuildTestableStore(challenge);
         var sut = new ChallengeSyncService
         (
+            A.Fake<IActingUserService>(),
             A.Fake<ConsoleActorMap>(),
             A.Fake<IGameEngineService>(),
             A.Fake<ILogger<IChallengeSyncService>>(),
@@ -59,6 +60,7 @@ public async Task GetExpiredChallengesForSync_WithPlayerSessionEndInFuture_DoesN
         var store = BuildTestableStore(challenge);
         var sut = new ChallengeSyncService
         (
+            A.Fake<IActingUserService>(),
             A.Fake<ConsoleActorMap>(),
             A.Fake<IGameEngineService>(),
             A.Fake<ILogger<IChallengeSyncService>>(),
@@ -91,6 +93,7 @@ public async Task GetExpiredChallengesForSync_WithChallengeAlreadySynced_DoesNot
         var store = BuildTestableStore(challenge);
         var sut = new ChallengeSyncService
         (
+            A.Fake<IActingUserService>(),
             A.Fake<ConsoleActorMap>(),
             A.Fake<IGameEngineService>(),
             A.Fake<ILogger<IChallengeSyncService>>(),
@@ -123,6 +126,7 @@ public async Task GetExpiredChallengesForSync_WithNonNullishEndDate_DoesNotSync(
         var store = BuildTestableStore(challenge);
         var sut = new ChallengeSyncService
         (
+            A.Fake<IActingUserService>(),
             A.Fake<ConsoleActorMap>(),
             A.Fake<IGameEngineService>(),
             A.Fake<ILogger<IChallengeSyncService>>(),
@@ -155,6 +159,7 @@ public async Task GetExpiredChallengesForSync_WithAllRequiredCriteriaAndNullishE
         var store = BuildTestableStore(challenge);
         var sut = new ChallengeSyncService
         (
+            A.Fake<IActingUserService>(),
             A.Fake<ConsoleActorMap>(),
             A.Fake<IGameEngineService>(),
             A.Fake<ILogger<IChallengeSyncService>>(),

src/Gameboard.Api/Features/Challenge/ChallengeController.cs

@@ -194,6 +194,10 @@ await Hub.Clients.Group(result.TeamId).ChallengeEvent
         return result;
     }
 
+    [HttpPut("/api/challenge/{challengeId}/sync")]
+    public Task<GameEngineGameState> Sync([FromRoute] string challengeId, CancellationToken cancellationToken)
+        => _mediator.Send(new SyncChallengeCommand(challengeId), cancellationToken);
+
     /// <summary>
     /// Grade a challenge
     /// </summary>

src/Gameboard.Api/Features/Challenge/Requests/SyncChallenge/SyncChallenge.cs

@@ -0,0 +1,27 @@
+using System.Threading;
+using System.Threading.Tasks;
+using Gameboard.Api.Features.GameEngine;
+using Gameboard.Api.Features.Users;
+using Gameboard.Api.Structure.MediatR;
+using MediatR;
+
+namespace Gameboard.Api.Features.Challenges;
+
+public record SyncChallengeCommand(string ChallengeId) : IRequest<GameEngineGameState>;
+
+internal sealed class SyncChallengeHandler
+(
+    IChallengeSyncService challengeSyncService,
+    IValidatorService validator
+) : IRequestHandler<SyncChallengeCommand, GameEngineGameState>
+{
+    public async Task<GameEngineGameState> Handle(SyncChallengeCommand request, CancellationToken cancellationToken)
+    {
+        await validator
+            .Auth(c => c.Require(PermissionKey.Admin_View))
+            .AddEntityExistsValidator<Data.Challenge>(request.ChallengeId)
+            .Validate(cancellationToken);
+
+        return await challengeSyncService.Sync(request.ChallengeId, cancellationToken);
+    }
+}

src/Gameboard.Api/Features/Challenge/Services/ChallengeSyncService.cs

@@ -16,6 +16,7 @@ namespace Gameboard.Api.Features.Challenges;
 
 public interface IChallengeSyncService
 {
+    Task<GameEngineGameState> Sync(string challengeId, CancellationToken cancellationToken);
     Task Sync(Data.Challenge challenge, GameEngineGameState challengeState, string actingUserId, CancellationToken cancellationToken);
     Task SyncExpired(CancellationToken cancellationToken);
 }
@@ -25,6 +26,7 @@ public interface IChallengeSyncService
 /// </summary>
 internal class ChallengeSyncService
 (
+    IActingUserService actingUser,
     ConsoleActorMap consoleActorMap,
     IGameEngineService gameEngine,
     ILogger<IChallengeSyncService> logger,
@@ -33,13 +35,31 @@ internal class ChallengeSyncService
     IStore store
 ) : IChallengeSyncService
 {
+    private readonly IActingUserService _actingUser = actingUser;
     private readonly ConsoleActorMap _consoleActorMap = consoleActorMap;
     private readonly IGameEngineService _gameEngine = gameEngine;
     private readonly ILogger<IChallengeSyncService> _logger = logger;
     private readonly IMapper _mapper = mapper;
     private readonly INowService _now = now;
     private readonly IStore _store = store;
 
+    public async Task<GameEngineGameState> Sync(string challengeId, CancellationToken cancellationToken)
+    {
+        var challenge = await _store
+            .WithNoTracking<Data.Challenge>()
+            .SingleOrDefaultAsync(c => c.Id == challengeId, cancellationToken);
+
+        if (challenge is null)
+        {
+            return null;
+        }
+
+        var state = await _gameEngine.GetChallengeState(GameEngineType.TopoMojo, challenge.State);
+        await Sync(challenge, state, _actingUser.Get()?.Id, cancellationToken);
+
+        return await _gameEngine.GetChallengeState(GameEngineType.TopoMojo, challenge.State);
+    }
+
     public Task Sync(Data.Challenge challenge, GameEngineGameState state, string actingUserId, CancellationToken cancellationToken)
         => Sync(cancellationToken, new SyncEntry(actingUserId, challenge, state));
 

src/Gameboard.Api/Features/Reports/Queries/EnrollmentReport/EnrollmentReportService.cs

@@ -16,8 +16,7 @@ public interface IEnrollmentReportService
     Task<EnrollmentReportStatSummary> GetSummaryStats(EnrollmentReportParameters parameters, CancellationToken cancellationToken);
 }
 
-internal class EnrollmentReportService(
-    IReportsService reportsService,
+internal class EnrollmentReportService(IReportsService reportsService,
     IStore store
     ) : IEnrollmentReportService
 {
@@ -32,8 +31,8 @@ IStore store
         var seriesCriteria = _reportsService.ParseMultiSelectCriteria(parameters.Series);
         var sponsorCriteria = _reportsService.ParseMultiSelectCriteria(parameters.Sponsors);
         var trackCriteria = _reportsService.ParseMultiSelectCriteria(parameters.Tracks);
-        DateTimeOffset? enrollDateStart = parameters.EnrollDateStart.HasValue ? parameters.EnrollDateStart.Value.ToEndDate().ToUniversalTime() : null;
-        DateTimeOffset? enrollDateEnd = parameters.EnrollDateEnd.HasValue ? parameters.EnrollDateEnd.Value.ToEndDate().ToUniversalTime() : null;
+        var enrollDateStart = parameters.EnrollDateStart.HasValue ? parameters.EnrollDateStart.Value.ToEndDate().ToUniversalTime() : default(DateTimeOffset?);
+        var enrollDateEnd = parameters.EnrollDateEnd.HasValue ? parameters.EnrollDateEnd.Value.ToEndDate().ToUniversalTime() : default(DateTimeOffset?);
 
         // the fundamental unit of reporting here is really the player record (an "enrollment"), so resolve enrollments that
         // meet the filter criteria (and have at least one challenge completed in competitive mode)