Stabilizza regia, live web e sync punteggi app nativa.

Corregge scadenza token regia oltre le 8h, tabellone HTML sulla pagina live,
pulsanti pausa/ripresa in regia, link admin e broadcast ActionCable diretto.
App Android: overlay branding, sync score da regia via WebSocket con reconnect e poll.

Co-authored-by: Cursor <cursoragent@cursor.com>

backend/app/controllers/api/v1/matches_controller.rb

@@ -1,6 +1,9 @@
 module Api
   module V1
     class MatchesController < BaseController
+      include Api::UrlHelper
+      include BrandingAttachments
+
       before_action :set_team, only: %i[index create]
       before_action :set_match, only: %i[show update destroy]
 
@@ -14,6 +17,7 @@ module Api
 
       def create
         match = @team.matches.create!(match_params)
+        attach_opponent_logo(match)
         render json: match_json(match), status: :created
       end
 
@@ -24,7 +28,9 @@ module Api
       def update
         attrs = match_params.to_h
         normalize_scoring_rules!(attrs)
+        normalize_opponent_color!(attrs)
         @match.update!(attrs)
+        attach_opponent_logo(@match)
         render json: match_json(@match)
       end
 
@@ -49,18 +55,17 @@ module Api
 
       def set_match
         team_ids = current_user.streamable_teams.map(&:id)
-        @match = Match.where(team_id: team_ids).find(params[:id])
+        @match = Match.includes(:team).where(team_id: team_ids).find(params[:id])
       end
 
       def match_params
         params.require(:match).permit(
           :opponent_name, :location, :scheduled_at, :sport, :sets_to_win,
-          :category,
+          :category, :opponent_primary_color,
           scoring_rules: %i[points_per_set points_deciding_set min_point_lead]
         )
       end
 
-      # Regolamento standard: scoring_rules assente o {} → default FIPAV lato Scoring::Rules.
       def normalize_scoring_rules!(attrs)
         return unless attrs.key?("scoring_rules")
 
@@ -68,12 +73,27 @@ module Api
         attrs["scoring_rules"] = {} if rules.blank?
       end
 
+      def normalize_opponent_color!(attrs)
+        return unless attrs.key?("opponent_primary_color")
+
+        attrs["opponent_primary_color"] = normalize_hex_color(
+          attrs["opponent_primary_color"],
+          Match::DEFAULT_OPPONENT_COLOR
+        )
+      end
+
+      def attach_opponent_logo(match)
+        file = params[:opponent_logo_file]
+        match.opponent_logo_file.attach(file) if file.present?
+      end
+
       def match_json(match, detail: false)
         active = active_session_for(match)
+        team = match.team
         {
           id: match.id,
           team_id: match.team_id,
-          team_name: match.team.name,
+          team_name: team.name,
           opponent_name: match.opponent_name,
           location: match.location,
           scheduled_at: match.scheduled_at,
@@ -81,6 +101,11 @@ module Api
           sets_to_win: match.sets_to_win,
           scoring_rules: match.scoring_rules.presence,
           category: match.category,
+          home_primary_color: team.effective_primary_color,
+          home_secondary_color: team.effective_secondary_color,
+          home_logo_url: api_absolute_url(team.effective_logo_url),
+          opponent_primary_color: match.effective_opponent_primary_color,
+          opponent_logo_url: api_absolute_url(match.opponent_logo_url),
           active_session_id: active&.id,
           active_session_status: active&.status,
           stream_completed: match.stream_completed?,