Data Normalization & Mapping

SharedServices/mapping/
├── __init__.py                    # Exports LeagueNormalizer, MarketResultMapper
├── league_normalizer.py           # League name normalization
├── market_mapper.py               # Market to API stat mapping
├── canonical_markets.py           # Canonical market definitions
├── market_result_mapper.py        # Legacy result mapping
└── fixture_matching_utils.py      # Fixture matching utilities

# Remove threshold suffixes
UnifiedMarketMapper.normalize_market_name("Player Goals 0.5+")
# Returns: "Player Goals"

UnifiedMarketMapper.normalize_market_name("Match Total - Corners")
# Returns: "Corners"

result = UnifiedMarketMapper.calculate_bet_result(
    actual_value=2.0,
    threshold=1.5,
    direction='over',
    market_name='Player Goals'
)
print(result)  # Output: "won"

result = UnifiedMarketMapper.calculate_bet_result(
    actual_value=1.5,
    threshold=1.5,
    direction='over'
)
print(result)  # Output: "refund" (exact hit)

# Handicap markets use tuple input (home_score, away_score)
result = UnifiedMarketMapper.calculate_bet_result(
    actual_value=(2, 1),  # Home 2 - Away 1
    threshold=-0.5,       # Away +0.5
    direction='away',
    market_name='Corner Handicap'
)
print(result)  # Output: "won" (Away covered)

# 1.25 handicap splits into 1.0 and 1.5
result = UnifiedMarketMapper.calculate_bet_result(
    actual_value=(3, 1),  # Home 3 - Away 1
    threshold=1.25,
    direction='home',
    market_name='Corners Spread'
)
print(result)  # Output: "won" (both 1.0 and 1.5 covered)

# Partial win scenario
result = UnifiedMarketMapper.calculate_bet_result(
    actual_value=(2, 1),  # Home 2 - Away 1
    threshold=1.25,
    direction='home'
)
print(result)  # Output: "half_win" (1.0 won, 1.5 push)

MARKET_NAME_NORMALIZATION = {
    # Goals
    "Anytime Goalscorer": "Player Goals",
    "Multi Scorers": "Player Goals",
    
    # Assists
    "Player To Assist": "Player Assists",
    
    # Score or Assist
    "Player to Score or Assist": "Player Score or Assist",
    
    # Cards
    "Anytime Booked": "Player Yellow Card",
    "To Be Booked First": "Player First Card",
    
    # And more...
}

from PROPPR.SharedServices.mapping import UnifiedMarketMapper

# Check if market is supported
is_supported = UnifiedMarketMapper.is_supported_market(
    market_name="Player Goals",
    is_player_bet=True
)
print(is_supported)  # True

# Get all supported markets
player_markets = UnifiedMarketMapper.get_supported_markets(is_player_bet=True)
team_markets = UnifiedMarketMapper.get_supported_markets(is_player_bet=False)

print(f"Player markets: {len(player_markets)}")
print(f"Team markets: {len(team_markets)}")

# Previously untrackable (now all trackable via shotmap/events):
# - First/Last Goalscorer (via get_first/last_goalscorer_id)
# - Inside/Outside Box (via shotmap isFromInsideBox)
# - Header (via shotmap shotType)
# - Penalty/Free Kick/Corner (via shotmap situation)

UNTRACKABLE_MARKETS = []  # Empty - all markets now trackable

'location' values:
- 'home': Home team stat
- 'away': Away team stat
- 'total': Combined (home + away)
- 'dynamic': Determined from alert metadata
- 'handicap_comparison': Handicap calculation