cbee0f9a50
Closes 4 more arena-colosseum spec shapes (6/16 → 10/16): the dual-prefix
battle URLs (colosseum_battle/* and colosseum_rank_battle/*) for both
do_matching and per-match finish, plus the bracket-end /finish + /retire
pair on /arena_colosseum.
* ColosseumProgressionService: pure-logic decisions for win-threshold
advancement, 3008 promotion trigger, and per-round reward bundles.
Extends ColosseumRoundsConfig with FinishRewards/RetireRewards per
round + a top-level ChampionRewards list.
* MatchContextBuilder.BuildForColosseumAsync: lifts the registered deck
via IDeckRepository (NOT viewer-graph) per project_ef_nav_include_pitfall.
* ArenaColosseumBattleController: dual route prefixes off one controller
via explicit absolute [HttpPost("/...")] routes — does NOT extend
SVSimController's [Route("[controller]")]. Same pattern as FreeBattle.
URL-vs-IsRankMatching mismatch returns 400 with a phase-mismatch error;
no-deck triggers the standard 3001 matchmaking-illegal state. 3008
flips run.IsRankMatching exactly once via the progression service.
* /arena_colosseum/finish + /retire share FinishResponse (rewards +
reward_list + colosseum_status). Champion finish appends ChampionRewards
and surfaces colosseum_status.is_champion = true. Both delete the run
row after granting via IInventoryTransaction.GrantAsync.
* DI: ModePolicy entries for "colosseum_battle" and "colosseum_rank_battle".
* Tests: 8 progression-service unit tests (pure logic), 5 battle-controller
HTTP tests, 5 bracket-terminate HTTP tests, 2 full-bracket E2E walks
(champion path + retire mid-round). Full suite: 1331/1331.
40 lines
2.2 KiB
C#
40 lines
2.2 KiB
C#
using SVSim.Database.Enums;
|
|
using SVSim.Database.Models;
|
|
using SVSim.Database.Models.Config;
|
|
|
|
namespace SVSim.EmulatedEntrypoint.Services.ArenaColosseum;
|
|
|
|
/// <summary>
|
|
/// Pure-logic decisions for the Colosseum bracket lifecycle. Reads a
|
|
/// <see cref="ViewerArenaColosseumRun"/> + <see cref="ColosseumRoundsConfig"/> snapshot and
|
|
/// returns advancement / promotion / reward decisions. Side-effectful (debits, grants,
|
|
/// run-row writes) live on the controllers — this service just computes.
|
|
/// </summary>
|
|
public interface IColosseumProgressionService
|
|
{
|
|
/// <summary>True when the node signal <c>matching_state == 3008</c> indicates the run
|
|
/// has been promoted to the ranked bracket and we haven't already flipped the flag.
|
|
/// Subsequent battle URLs route to <c>colosseum_rank_battle/*</c>.</summary>
|
|
bool ShouldPromoteToRankMatching(ViewerArenaColosseumRun run, int matchingState);
|
|
|
|
/// <summary>Triggered post-match-finish when wins/losses cross thresholds. Returns the
|
|
/// next round id (or current if no change), whether the bracket has ended, and the
|
|
/// champion flag for the final-round-cleared case.</summary>
|
|
AdvancementDecision DecideAdvancement(ViewerArenaColosseumRun run, ColosseumRoundsConfig rounds);
|
|
|
|
/// <summary>Bundle to grant on <c>/retire</c>. Reads
|
|
/// <see cref="ColosseumRoundsConfig.RoundEntry.RetireRewards"/> for the run's
|
|
/// <see cref="ViewerArenaColosseumRun.RoundId"/>. Empty when no matching round.</summary>
|
|
IReadOnlyList<ColosseumRoundsConfig.RewardEntry> BuildRetireRewards(
|
|
ViewerArenaColosseumRun run, ColosseumRoundsConfig rounds);
|
|
|
|
/// <summary>Bundle to grant on <c>/finish</c>. Combines the current round's
|
|
/// <see cref="ColosseumRoundsConfig.RoundEntry.FinishRewards"/> with
|
|
/// <see cref="ColosseumRoundsConfig.ChampionRewards"/> when the run is a champion.</summary>
|
|
IReadOnlyList<ColosseumRoundsConfig.RewardEntry> BuildFinishRewards(
|
|
ViewerArenaColosseumRun run, ColosseumRoundsConfig rounds);
|
|
}
|
|
|
|
/// <summary>Output of <see cref="IColosseumProgressionService.DecideAdvancement"/>.</summary>
|
|
public sealed record AdvancementDecision(int NextRoundId, bool IsBracketEnd, bool IsChampion);
|