LBS-1051: TradeAssist (historical note)

Status: Implemented (historical record) Component: Ballr SuperCoach

This is a historical "as-built" note for the original TradeAssist work (LBS-1051). The class names, paths, and request/response shapes it once described have since been renamed and moved, so they are not reproduced here. For the live API, use the current reference docs below.

Current reference docs

The TradeAssist API is documented accurately in two sibling docs. Use these for the authoritative request/response shapes and handlers:

• Get TradeAssist Input by Team ID — the GetTradeAssistInputByTeamId query (diagnostic; returns the raw modelling input for a saved team).
• TradeAssist by Roster — the GetTradeAssistByRoster query (returns enriched trade recommendations for a roster supplied in the request).

The handlers live under src/Apps/Ballr.WebApi/Integration/SuperCoachTeam/Queries/, and the modelling call is made through IModelingService / ModelingService.

What LBS-1051 delivered

LBS-1051 introduced AI-assisted trade recommendations for NRL SuperCoach teams. It added query handlers that build a modelling input from a team's roster, call an external modelling service for recommended trades, and enrich the results with internal player details (display name, position, team, current price, projected score). Supporting work covered SuperCoach team and player-stats lookups across the main and Foundry document stores, mapping between internal participant IDs and external (FoxSports) player IDs, and round-aware data selection (last completed round for stats, upcoming round for the modelling input). Access requires the Member role and team-ownership validation.