Storefront Data Contract

Hughzeez Storefront Data Contract

Purpose: Keep storefront work aligned with the platform plugin and analytics engine plugin.

Storefront Rules

  • Storefront must only display canonical platform data.
  • Storefront must not compute analytics.
  • Storefront must not bind to source-specific player IDs.
  • WooCommerce controls commerce and upgrade purchase flow.

Canonical Team Fields

  • team_id
  • team_name
  • team_logo
  • league_name
  • division_name
  • wins
  • losses
  • points
  • goals_for
  • goals_against
  • roster
  • recent_games
  • upcoming_games

Canonical Player Fields

  • player_id
  • player_name
  • player_photo
  • jersey_number
  • position
  • goals
  • assists
  • points
  • penalty_minutes
  • game_log

Analytics Engine Fields

  • team_strength_score
  • offensive_rating
  • defensive_rating
  • momentum_score
  • player_rating
  • offensive_impact
  • defensive_impact
  • discipline_score
  • consistency_score

WooCommerce / Upgrade Gating

Use WooCommerce products/subscriptions to unlock analytics access. Free analytics teasers can appear publicly, but premium sections should check access and show upgrade prompts when locked.