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/channels/concerns/cable_broadcastable.rb

@@ -3,7 +3,7 @@ module CableBroadcastable
 
   class_methods do
     def broadcast_message(session, data)
-      broadcast_to(session, method: "receive_message", data: data)
+      broadcast_to(session, data)
     end
   end
 end

backend/app/controllers/admin/sessions_controller.rb

@@ -22,5 +22,22 @@ module Admin
       Rails.logger.error("[admin] stop session #{@session.id}: #{e.class} #{e.message}")
       redirect_to admin_session_path(@session), alert: "Errore durante la chiusura: #{e.message}"
     end
+
+    def regia_link
+      @session = StreamSession.find(params[:id])
+      if @session.terminal?
+        redirect_to admin_session_path(@session), alert: "Sessione terminata: impossibile generare il link regia."
+        return
+      end
+
+      access = Sessions::RegiaAccess.new(@session)
+      token = access.issue_token!
+      redirect_to admin_session_path(@session),
+                  notice: "Link regia generato.",
+                  flash: {
+                    regia_url: access.url(token),
+                    regia_expires_at: @session.regia_token_expires_at&.iso8601
+                  }
+    end
   end
 end

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?,

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

@@ -100,13 +100,31 @@ module Api
       end
 
       def network_test
+        upload_mbps = params[:upload_mbps].to_f
+        preset = Sessions::SelectQuality.call(upload_mbps: upload_mbps)
+        @session.update!(
+          quality_preset: preset[:id],
+          target_bitrate: preset[:target_bitrate],
+          target_fps: preset[:target_fps]
+        )
         @session.stream_events.create!(
           event_type: "network_test",
-          metadata: params.permit(:download_mbps, :upload_mbps, :latency_ms, :network_type).to_h,
+          metadata: params.permit(:download_mbps, :upload_mbps, :latency_ms, :network_type)
+            .to_h.merge(
+              "quality_preset" => preset[:id],
+              "target_bitrate" => preset[:target_bitrate]
+            ),
           occurred_at: Time.current
         )
-        ready = params[:upload_mbps].to_f >= (@session.target_bitrate / 1_000_000.0 * 0.8)
-        render json: { ready: ready, target_upload_mbps: @session.target_bitrate / 1_000_000.0 }
+        target_upload = preset[:target_bitrate] / 1_000_000.0
+        ready = upload_mbps >= (target_upload * Sessions::SelectQuality::UPLOAD_HEADROOM)
+        render json: {
+          ready: ready,
+          target_upload_mbps: target_upload,
+          quality_preset: preset[:id],
+          target_bitrate: preset[:target_bitrate],
+          target_fps: preset[:target_fps]
+        }
       end
 
       def youtube_stats

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

@@ -1,6 +1,9 @@
 module Api
   module V1
     class TeamsController < BaseController
+      include Api::UrlHelper
+      include BrandingAttachments
+
       def index
         teams = current_user.streamable_teams
         render json: teams.map { |t| team_json(t) }
@@ -48,6 +51,7 @@ module Api
       def update
         team = current_user.manageable_teams.find(params[:id])
         team.update!(team_params)
+        attach_team_logo(team)
         render json: team_json(team)
       end
 
@@ -69,7 +73,19 @@ module Api
       private
 
       def team_params
-        params.require(:team).permit(:name, :sport, :logo_url)
+        p = params.require(:team).permit(:name, :sport, :logo_url, :primary_color, :secondary_color)
+        if p[:primary_color].present?
+          p[:primary_color] = normalize_hex_color(p[:primary_color], p[:primary_color])
+        end
+        if p[:secondary_color].present?
+          p[:secondary_color] = normalize_hex_color(p[:secondary_color], p[:secondary_color])
+        end
+        p
+      end
+
+      def attach_team_logo(team)
+        file = params[:logo_file]
+        team.logo_file.attach(file) if file.present?
       end
 
       def team_json(team, detail: false)
@@ -80,7 +96,7 @@ module Api
           id: team.id,
           name: team.name,
           sport: team.sport,
-          logo_url: team.effective_logo_url,
+          logo_url: api_absolute_url(team.effective_logo_url),
           primary_color: team.effective_primary_color,
           secondary_color: team.effective_secondary_color,
           club_id: team.club_id,

backend/app/controllers/concerns/api/url_helper.rb

@@ -0,0 +1,16 @@
+module Api
+  module UrlHelper
+    extend ActiveSupport::Concern
+
+    private
+
+    def api_absolute_url(path_or_url)
+      return nil if path_or_url.blank?
+      return path_or_url if path_or_url.match?(/\Ahttps?:\/\//i)
+
+      base = request.base_url
+      path = path_or_url.start_with?("/") ? path_or_url : "/#{path_or_url}"
+      "#{base}#{path}"
+    end
+  end
+end

backend/app/controllers/public/regia_controller.rb

@@ -6,7 +6,7 @@ module Public
     layout "regia"
 
     protect_from_forgery with: :null_session
-    skip_before_action :verify_authenticity_token, only: %i[score pause stop]
+    skip_before_action :verify_authenticity_token, only: %i[score pause resume stop]
 
     before_action :set_session_from_token
 
@@ -44,6 +44,13 @@ module Public
       render json: status_payload
     end
 
+    def resume
+      Sessions::Resume.new(@session).call
+      render json: status_payload
+    rescue Teams::EntitlementError => e
+      render json: status_payload.merge(error: e.message), status: :unprocessable_entity
+    end
+
     def stop
       Sessions::Stop.new(@session).call
       render json: status_payload
@@ -55,8 +62,7 @@ module Public
       @session = Sessions::RegiaAccess.find_session_by_token(params[:token])
       return if @session
 
-      render file: Rails.root.join("public/404.html"), status: :not_found, layout: false
-      throw :abort
+      head :not_found
     end
 
     def status_payload

backend/app/helpers/admin_helper.rb

@@ -19,4 +19,22 @@ module AdminHelper
     mins = minutes % 60
     hours.positive? ? "#{hours}h #{mins}m" : "#{mins} min"
   end
+
+  def admin_session_watch_links(session)
+    links = []
+    if session.matchlivetv_platform?
+      links << { label: "Pagina live", url: session.watch_page_url }
+    end
+    youtube = session.youtube_watch_url
+    links << { label: "YouTube", url: youtube } if youtube.present?
+    links
+  end
+
+  def admin_regia_expires_label(iso_time)
+    return if iso_time.blank?
+
+    Time.zone.parse(iso_time).strftime("%d/%m/%Y %H:%M")
+  rescue ArgumentError, TypeError
+    nil
+  end
 end

backend/app/helpers/public/live_helper.rb

@@ -61,6 +61,36 @@ module Public
       "#{match.team.name} #{score_state.home_points} - #{score_state.away_points} #{match.opponent_name}"
     end
 
+    def live_scorebug_columns(score_state)
+      unless score_state
+        return {
+          labels: ["1"],
+          home: ["0"],
+          away: ["0"],
+          live_index: 0
+        }
+      end
+
+      partials = Array(score_state.set_partials)
+      labels = partials.map { |p| (p["set"] || p[:set]).to_s }
+      home = partials.map { |p| (p["home"] || p[:home]).to_s }
+      away = partials.map { |p| (p["away"] || p[:away]).to_s }
+      labels << score_state.current_set.to_s
+      home << score_state.home_points.to_s
+      away << score_state.away_points.to_s
+      {
+        labels: labels,
+        home: home,
+        away: away,
+        live_index: labels.length - 1
+      }
+    end
+
+    def live_scorebug_team_label(name, max: 16)
+      n = name.to_s
+      n.length <= max ? n : "#{n[0, max - 1]}…"
+    end
+
     # Colore ospite sul tabellone: secondario società se leggibile su bianco, altrimenti blu visitatore.
     def live_scorebug_away_color(team)
       club = team.club

backend/app/models/match.rb

@@ -2,11 +2,16 @@ class Match < ApplicationRecord
   belongs_to :team
   has_many :stream_sessions, dependent: :destroy
 
+  has_one_attached :opponent_logo_file
+
   ACTIVE_SESSION_STATUSES = %w[live connecting reconnecting paused].freeze
+  DEFAULT_OPPONENT_COLOR = "#1E3A8A"
 
   validates :opponent_name, presence: true
   validates :sets_to_win, numericality: { greater_than: 0, less_than: 6 }
+  validates :opponent_primary_color, format: { with: Brandable::HEX_COLOR }, allow_blank: true
   validate :scoring_rules_shape, if: -> { scoring_rules.present? }
+  validate :opponent_logo_file_type, if: -> { opponent_logo_file.attached? }
 
   # category: campionato / descrizione torneo (facoltativo, es. "Serie C").
 
@@ -63,6 +68,16 @@ class Match < ApplicationRecord
     stream_sessions.where(status: %w[ended error]).exists?
   end
 
+  def opponent_logo_url
+    return unless opponent_logo_file.attached?
+
+    Rails.application.routes.url_helpers.rails_blob_path(opponent_logo_file, only_path: true)
+  end
+
+  def effective_opponent_primary_color
+    opponent_primary_color.presence || DEFAULT_OPPONENT_COLOR
+  end
+
   # Hub app coach: dirette da riprendere o partite programmate future.
   # Le bozze «Avversario» abbandonate (senza sessione) non compaiono.
   def coach_hub_visible?
@@ -77,6 +92,12 @@ class Match < ApplicationRecord
 
   private
 
+  def opponent_logo_file_type
+    return if opponent_logo_file.content_type.in?(%w[image/png image/jpeg image/webp])
+
+    errors.add(:opponent_logo_file, "deve essere PNG, JPEG o WebP")
+  end
+
   def scoring_rules_shape
     rules = scoring_rules.is_a?(Hash) ? scoring_rules : {}
     %w[points_per_set points_deciding_set min_point_lead].each do |key|

backend/app/models/stream_session.rb

@@ -131,6 +131,12 @@ class StreamSession < ApplicationRecord
     status.in?(%w[ended error])
   end
 
+  def regia_token_active?
+    regia_token_digest.present? &&
+      regia_token_expires_at&.future? &&
+      !terminal?
+  end
+
   def resumable?
     status.in?(%w[connecting live reconnecting paused])
   end

backend/app/services/sessions/regia_access.rb

@@ -13,7 +13,9 @@ module Sessions
 
     def rotate!
       token = SecureRandom.urlsafe_base64(24)
-      expires = [DEFAULT_TTL.from_now, session_end_cap].compact.min
+      expires = DEFAULT_TTL.from_now
+      cap = session_end_cap
+      expires = [expires, cap].min if cap&.future?
       @session.update!(
         regia_token_digest: digest(token),
         regia_token_expires_at: expires

backend/app/services/sessions/select_quality.rb

@@ -0,0 +1,29 @@
+module Sessions
+  # Sceglie il preset più alto supportato dall'upload misurato (test rete).
+  class SelectQuality
+    UPLOAD_HEADROOM = 0.8
+
+    PRESETS = [
+      { id: "1080p_30_4.5mbps", target_bitrate: 4_500_000, target_fps: 30 },
+      { id: "720p_30_4mbps", target_bitrate: 4_000_000, target_fps: 30 },
+      { id: "720p_30_2.5mbps", target_bitrate: 2_500_000, target_fps: 30 },
+      { id: "720p_30_1.5mbps", target_bitrate: 1_500_000, target_fps: 30 }
+    ].freeze
+
+    def self.call(upload_mbps:)
+      new(upload_mbps: upload_mbps).call
+    end
+
+    def initialize(upload_mbps:)
+      @upload_mbps = upload_mbps.to_f
+    end
+
+    def call
+      PRESETS.find { |preset| upload_sufficient?(preset) } || PRESETS.last
+    end
+
+    def upload_sufficient?(preset)
+      @upload_mbps >= (preset[:target_bitrate] / 1_000_000.0 * UPLOAD_HEADROOM)
+    end
+  end
+end

backend/app/views/admin/dashboard/index.html.erb

@@ -91,7 +91,7 @@
     <% if @active_sessions.any? %>
       <table class="admin-table">
         <thead>
-          <tr><th>Partita</th><th>Stato</th><th>Inizio</th><th></th></tr>
+          <tr><th>Partita</th><th>Stato</th><th>Inizio</th><th>Link</th><th></th></tr>
         </thead>
         <tbody id="active-sessions-body">
           <% @active_sessions.each do |s| %>
@@ -99,6 +99,12 @@
               <td><%= s.match.team.name %> vs <%= s.match.opponent_name %></td>
               <td><span class="badge badge--<%= s.status == 'live' ? 'live' : (s.status == 'paused' ? 'paused' : 'connecting') %>"><%= s.status %></span></td>
               <td class="muted"><%= s.started_at&.strftime("%d/%m %H:%M") || "—" %></td>
+              <td class="admin-link-compact">
+                <% admin_session_watch_links(s).each do |link| %>
+                  <%= link_to link[:label], link[:url], target: "_blank", rel: "noopener", class: "admin-link-chip" %>
+                <% end %>
+                <%= link_to "Regia", admin_session_path(s), class: "admin-link-chip admin-link-chip--regia" %>
+              </td>
               <td class="admin-actions">
                 <%= link_to "Dettaglio", admin_session_path(s) %>
                 <%= button_to "Termina", stop_admin_session_path(s), method: :post, class: "admin-btn admin-btn--danger admin-btn--sm", form: { data: { turbo_confirm: "Terminare questa sessione?" } } %>

backend/app/views/admin/sessions/_links.html.erb

@@ -0,0 +1,41 @@
+<% watch_links = admin_session_watch_links(session) %>
+<section class="admin-links-panel">
+  <h3>Link diretta</h3>
+  <% if watch_links.any? %>
+    <ul class="admin-link-list">
+      <% watch_links.each do |link| %>
+        <li>
+          <span class="admin-link-label"><%= link[:label] %></span>
+          <%= link_to link[:url], link[:url], target: "_blank", rel: "noopener", class: "admin-link-url" %>
+        </li>
+      <% end %>
+    </ul>
+  <% else %>
+    <p class="muted">Nessun link video disponibile per questa sessione.</p>
+  <% end %>
+
+  <h3>Link regia</h3>
+  <% if session.terminal? %>
+    <p class="muted">Sessione terminata — link regia non disponibile.</p>
+  <% else %>
+    <% if flash[:regia_url].present? %>
+      <p class="admin-link-generated">
+        <span class="admin-link-label">Regia</span>
+        <%= link_to flash[:regia_url], flash[:regia_url], target: "_blank", rel: "noopener", class: "admin-link-url" %>
+      </p>
+      <p><code class="admin-link-code"><%= flash[:regia_url] %></code></p>
+      <% if (expires = admin_regia_expires_label(flash[:regia_expires_at])) %>
+        <p class="muted">Valido fino a <%= expires %></p>
+      <% end %>
+    <% elsif session.regia_token_active? %>
+      <p class="muted">Esiste già un link regia attivo (l’URL non è recuperabile). Generane uno nuovo se serve condividerlo di nuovo.</p>
+    <% else %>
+      <p class="muted">Nessun link regia attivo. Genera un link da condividere con chi gestisce il punteggio.</p>
+    <% end %>
+    <%= button_to "Genera link regia",
+          regia_link_admin_session_path(session),
+          method: :post,
+          class: "admin-btn admin-btn--secondary admin-btn--sm",
+          form: { class: "admin-inline-form" } %>
+  <% end %>
+</section>

backend/app/views/admin/sessions/index.html.erb

@@ -1,12 +1,18 @@
 <h2>Stream Sessions</h2>
   <table class="admin-table">
-  <thead><tr><th>Match</th><th>Status</th><th>Disconnects</th><th></th></tr></thead>
+  <thead><tr><th>Match</th><th>Status</th><th>Disconnects</th><th>Link</th><th></th></tr></thead>
   <tbody>
     <% @sessions.each do |s| %>
       <tr>
         <td><%= s.match.team.name %> vs <%= s.match.opponent_name %></td>
         <td><span class="badge <%= s.status == 'live' ? 'badge--live' : 'badge--paused' %>"><%= s.status %></span></td>
         <td><%= s.disconnection_count %></td>
+        <td class="admin-link-compact">
+          <% admin_session_watch_links(s).each do |link| %>
+            <%= link_to link[:label], link[:url], target: "_blank", rel: "noopener", class: "admin-link-chip" %>
+          <% end %>
+          <%= link_to "Regia", admin_session_path(s), class: "admin-link-chip admin-link-chip--regia" %>
+        </td>
         <td><%= link_to "Dettaglio", admin_session_path(s) %></td>
       </tr>
     <% end %>

backend/app/views/admin/sessions/show.html.erb

@@ -10,8 +10,11 @@
   </p>
 <% end %>
 <p>Match: <%= @session.match.team.name %> vs <%= @session.match.opponent_name %></p>
+
+<%= render "admin/sessions/links", session: @session %>
+
 <% if @session.youtube_broadcast_id %>
-  <p>YouTube: <a href="https://studio.youtube.com/video/<%= @session.youtube_broadcast_id %>/livestreaming" target="_blank">Broadcast</a></p>
+  <p>YouTube Studio: <a href="https://studio.youtube.com/video/<%= @session.youtube_broadcast_id %>/livestreaming" target="_blank" rel="noopener">Broadcast</a></p>
 <% end %>
 <p>RTMP ingest: <code><%= @session.rtmp_ingest_url %></code></p>
 

backend/app/views/layouts/marketing_live.html.erb

@@ -7,7 +7,7 @@
     <%= render "shared/meta_tags" %>
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.2/css/all.min.css" integrity="sha512-SnH5WK+bZxgPHs44uWIX+LLJAJ9/2PkPKZ5QiAj6Ta86w+fsb2TkcmfRyVX3pBnMFcV7oQPJkl9QevSCWr3W6A==" crossorigin="anonymous" referrerpolicy="no-referrer">
     <link rel="stylesheet" href="/marketing.css?v=36">
-    <link rel="stylesheet" href="/live.css?v=22">
+    <link rel="stylesheet" href="/live.css?v=23">
     <%= yield :head %>
   </head>
   <body<% if MatchLiveTv.google_analytics_configured? %> data-ga-id="<%= MatchLiveTv.google_analytics_measurement_id %>"<% end %>>

backend/app/views/public/live/_scorebug.html.erb

@@ -0,0 +1,47 @@
+<% score = @session.score_state %>
+<% team = @match.team %>
+<% cols = live_scorebug_columns(score) %>
+<% home_color = team.effective_primary_color %>
+<% away_color = live_scorebug_away_color(team) %>
+<div class="live-player-overlays" id="live-overlays">
+  <div
+    id="live-scorebug"
+    class="live-scorebug"
+    style="--sb-home-primary: <%= home_color %>; --sb-away-primary: <%= away_color %>;"
+    data-home-name="<%= j live_scorebug_team_label(team.name) %>"
+    data-away-name="<%= j live_scorebug_team_label(@match.opponent_name) %>"
+  >
+    <table class="live-scorebug__table" aria-label="Tabellone">
+      <caption class="visually-hidden">Punteggio live</caption>
+      <thead>
+        <tr>
+          <th class="live-scorebug__corner" scope="col">Squadra</th>
+          <% cols[:labels].each do |label| %>
+            <th class="live-scorebug__col-set live-scorebug__col-h" scope="col"><%= label %></th>
+          <% end %>
+        </tr>
+      </thead>
+      <tbody>
+        <tr class="live-scorebug__row--home">
+          <th class="live-scorebug__team" scope="row"><%= live_scorebug_team_label(team.name) %></th>
+          <% cols[:home].each_with_index do |val, i| %>
+            <td class="live-scorebug__pts<%= " live-scorebug__pts--live-home" if i == cols[:live_index] %>"><%= val %></td>
+          <% end %>
+        </tr>
+        <tr class="live-scorebug__row--away">
+          <th class="live-scorebug__team" scope="row"><%= live_scorebug_team_label(@match.opponent_name) %></th>
+          <% cols[:away].each_with_index do |val, i| %>
+            <td class="live-scorebug__pts<%= " live-scorebug__pts--live-away" if i == cols[:live_index] %>"><%= val %></td>
+          <% end %>
+        </tr>
+      </tbody>
+    </table>
+    <div class="live-scorebug__brand" aria-hidden="true">
+      <span class="live-scorebug__brand-text">MATCH <span class="live-scorebug__brand-accent">LIVE TV</span></span>
+    </div>
+  </div>
+  <span
+    id="live-stream-badge"
+    class="live-ovl-badge live-ovl-badge--right <%= @stream_closed ? "badge-ended" : (@session.paused? ? "badge-wait" : (@on_air ? "badge-live" : "badge-wait")) %>"
+  ><%= @stream_closed ? "Terminata" : (@session.paused? ? "In pausa" : (@on_air ? "LIVE" : "In attesa")) %></span>
+</div>

backend/app/views/public/live/show.html.erb

@@ -1,7 +1,7 @@
 <% club_name = @match.team.club&.name %>
 <% content_for :title do %><%= club_name %> · <%= @match.team.name %> vs <%= @match.opponent_name %> — Diretta live<% end %>
 <% content_for :meta_description do %>Segui in diretta live <%= club_name %> — <%= @match.team.name %> vs <%= @match.opponent_name %><% if @match.location.present? %> — <%= @match.location %><% end %>. Guarda dal browser senza installare app.<% end %>
-<% content_for :robots, "noindex, follow" %>
+<% content_for :robots, @session.publicly_listed? ? "index, follow" : "noindex, nofollow" %>
 
 <% content_for :head do %>
   <% unless @stream_closed || @session.platform == "youtube" %>
@@ -41,7 +41,7 @@
 <% else %>
   <div class="live-player-wrap">
     <video id="player" controls playsinline muted autoplay poster="/images/copertina-canale.png"></video>
-    <%# Tabellone e watermark sono bruciati nel video dall'app mobile (overlay client-side). %>
+    <%= render "public/live/scorebug", match: @match, session: @session %>
     <button type="button" id="play-hint" class="live-play-hint" hidden>
       ▶ Avvia la diretta
     </button>
@@ -58,6 +58,88 @@
     const pausedMsg = document.getElementById("paused-msg");
     const awaitingMsg = document.getElementById("awaiting-msg");
     const playHint = document.getElementById("play-hint");
+    const scorebug = document.getElementById("live-scorebug");
+    const streamBadge = document.getElementById("live-stream-badge");
+    const homeName = "<%= j @match.team.name %>";
+    const awayName = "<%= j @match.opponent_name %>";
+
+    function abbrevName(name, max = 16) {
+      const n = String(name || "");
+      return n.length <= max ? n : `${n.slice(0, max - 1)}…`;
+    }
+
+    function scoreColumnsFromPayload(score) {
+      if (!score) return { labels: ["1"], home: ["0"], away: ["0"], liveIndex: 0 };
+      const partials = score.set_partials || score.setPartials || [];
+      const labels = partials.map((p) => String(p.set ?? p["set"] ?? ""));
+      const home = partials.map((p) => String(p.home ?? p["home"] ?? "0"));
+      const away = partials.map((p) => String(p.away ?? p["away"] ?? "0"));
+      const currentSet = score.current_set ?? score.currentSet ?? 1;
+      labels.push(String(currentSet));
+      home.push(String(score.home_points ?? score.homePoints ?? 0));
+      away.push(String(score.away_points ?? score.awayPoints ?? 0));
+      return { labels, home, away, liveIndex: labels.length - 1 };
+    }
+
+    function renderLiveScorebug(score) {
+      if (!scorebug) return;
+      const cols = scoreColumnsFromPayload(score);
+      const homeLabel = abbrevName(scorebug.dataset.homeName || homeName);
+      const awayLabel = abbrevName(scorebug.dataset.awayName || awayName);
+      const headCells = cols.labels
+        .map((label) => `<th class="live-scorebug__col-set live-scorebug__col-h" scope="col">${label}</th>`)
+        .join("");
+      const homeCells = cols.home
+        .map((val, i) => {
+          const live = i === cols.liveIndex ? " live-scorebug__pts--live-home" : "";
+          return `<td class="live-scorebug__pts${live}">${val}</td>`;
+        })
+        .join("");
+      const awayCells = cols.away
+        .map((val, i) => {
+          const live = i === cols.liveIndex ? " live-scorebug__pts--live-away" : "";
+          return `<td class="live-scorebug__pts${live}">${val}</td>`;
+        })
+        .join("");
+      scorebug.innerHTML = `
+        <table class="live-scorebug__table" aria-label="Tabellone">
+          <caption class="visually-hidden">Punteggio live</caption>
+          <thead><tr>
+            <th class="live-scorebug__corner" scope="col">Squadra</th>${headCells}
+          </tr></thead>
+          <tbody>
+            <tr class="live-scorebug__row--home">
+              <th class="live-scorebug__team" scope="row">${homeLabel}</th>${homeCells}
+            </tr>
+            <tr class="live-scorebug__row--away">
+              <th class="live-scorebug__team" scope="row">${awayLabel}</th>${awayCells}
+            </tr>
+          </tbody>
+        </table>
+        <div class="live-scorebug__brand" aria-hidden="true">
+          <span class="live-scorebug__brand-text">MATCH <span class="live-scorebug__brand-accent">LIVE TV</span></span>
+        </div>`;
+    }
+
+    function syncStreamBadge(data) {
+      if (!streamBadge) return;
+      if (data.stream_closed) {
+        streamBadge.textContent = "Terminata";
+        streamBadge.className = "live-ovl-badge live-ovl-badge--right badge-ended";
+        return;
+      }
+      const paused = !!(data.paused || data.status === "paused");
+      if (paused) {
+        streamBadge.textContent = "In pausa";
+        streamBadge.className = "live-ovl-badge live-ovl-badge--right badge-wait";
+      } else if (data.on_air) {
+        streamBadge.textContent = "LIVE";
+        streamBadge.className = "live-ovl-badge live-ovl-badge--right badge-live";
+      } else {
+        streamBadge.textContent = "In attesa";
+        streamBadge.className = "live-ovl-badge live-ovl-badge--right badge-wait";
+      }
+    }
 
     let hls = null;
     let playerStarted = false;
@@ -247,6 +329,9 @@
           return;
         }
 
+        renderLiveScorebug(data.score);
+        syncStreamBadge(data);
+
         const onAir = !!data.on_air;
         const sessionLive = !!data.live;
 

backend/app/views/public/regia/show.html.erb

@@ -12,6 +12,7 @@
      data-status-url="<%= j public_regia_status_path(params[:token]) %>"
      data-score-url="<%= j public_regia_score_path(params[:token]) %>"
      data-pause-url="<%= j public_regia_pause_path(params[:token]) %>"
+     data-resume-url="<%= j public_regia_resume_path(params[:token]) %>"
      data-stop-url="<%= j public_regia_stop_path(params[:token]) %>"
      data-cable-url="<%= j "/cable?regia_token=#{params[:token]}" %>"
      data-hls-url="<%= j @session.hls_playback_url %>"
@@ -20,13 +21,14 @@
      data-share-url="<%= j @share_url %>"
      data-share-title="<%= j @share_title %>"
      data-points-target="<%= Scoring::Rules.from_match(@match).points_target(@score.current_set) %>"
-     data-stream-closed="<%= @stream_closed %>">
+     data-stream-closed="<%= @stream_closed %>"
+     data-initial-paused="<%= @session.paused? %>">
 
   <header class="regia-header">
     <h1><%= @team.name %> vs <%= @match.opponent_name %></h1>
     <p>Regia · Set <%= @score.current_set %></p>
-    <span id="regia-badge" class="regia-badge <%= @on_air ? 'regia-badge--live' : (@stream_closed ? 'regia-badge--ended' : 'regia-badge--wait') %>">
-      <%= @stream_closed ? "Terminata" : (@on_air ? "In onda" : "In attesa") %>
+    <span id="regia-badge" class="regia-badge <%= @stream_closed ? 'regia-badge--ended' : (@session.paused? ? 'regia-badge--wait' : (@on_air ? 'regia-badge--live' : 'regia-badge--wait')) %>">
+      <%= @stream_closed ? "Terminata" : (@session.paused? ? "In pausa" : (@on_air ? "In onda" : "In attesa")) %>
     </span>
   </header>
 
@@ -76,7 +78,7 @@
   </section>
 
   <% unless @stream_closed %>
-    <button type="button" class="regia-btn regia-btn--outline" id="btn-pause">Metti in pausa</button>
+    <button type="button" class="regia-btn regia-btn--outline" id="btn-pause"><%= @session.paused? ? "Riprendi diretta" : "Metti in pausa" %></button>
     <button type="button" class="regia-btn regia-btn--danger" id="btn-stop">Chiudi diretta</button>
   <% end %>
 </div>
@@ -94,4 +96,4 @@
   </div>
 </div>
 
-<script src="/regia.js?v=2"></script>
+<script src="/regia.js?v=4"></script>

backend/config/routes.rb

@@ -85,7 +85,10 @@ Rails.application.routes.draw do
       resources :billing_invoices, only: %i[index new create edit update], controller: "billing_invoices"
     end
     resources :sessions, only: %i[index show] do
-      member { post :stop }
+      member do
+        post :stop
+        post :regia_link
+      end
     end
     get "youtube/platform", to: "youtube#platform", as: :youtube_platform
   end
@@ -105,6 +108,7 @@ Rails.application.routes.draw do
   get "regia/:token/status.json", to: "public/regia#status", as: :public_regia_status
   patch "regia/:token/score", to: "public/regia#score", as: :public_regia_score
   post "regia/:token/pause", to: "public/regia#pause", as: :public_regia_pause
+  post "regia/:token/resume", to: "public/regia#resume", as: :public_regia_resume
   post "regia/:token/stop", to: "public/regia#stop", as: :public_regia_stop
 
   root to: "public/pages#home"

backend/db/migrate/20260606200000_add_opponent_branding_to_matches.rb

@@ -0,0 +1,5 @@
+class AddOpponentBrandingToMatches < ActiveRecord::Migration[7.2]
+  def change
+    add_column :matches, :opponent_primary_color, :string
+  end
+end

backend/public/admin.css

@@ -233,6 +233,90 @@ body.admin-body {
   align-items: center;
 }
 
+.admin-links-panel {
+  margin: 1.25rem 0 1.5rem;
+  padding: 1rem 1.1rem;
+  background: var(--card-bg, #14141c);
+  border: 1px solid var(--card-border, #2a2a36);
+  border-radius: 8px;
+}
+
+.admin-links-panel h3 {
+  margin: 0 0 0.6rem;
+  font-size: 0.95rem;
+}
+
+.admin-links-panel h3 + h3 {
+  margin-top: 1.1rem;
+}
+
+.admin-link-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.admin-link-list li,
+.admin-link-generated {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem 0.75rem;
+  align-items: baseline;
+  margin-bottom: 0.45rem;
+}
+
+.admin-link-label {
+  min-width: 6.5rem;
+  color: var(--muted, #9ca3af);
+  font-size: 0.85rem;
+}
+
+.admin-link-url {
+  color: var(--red, #e53935);
+  word-break: break-all;
+}
+
+.admin-link-code {
+  display: block;
+  margin: 0.35rem 0 0.5rem;
+  padding: 0.45rem 0.6rem;
+  background: #0a0a0e;
+  border-radius: 6px;
+  font-size: 0.78rem;
+  word-break: break-all;
+}
+
+.admin-link-compact {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.35rem;
+}
+
+.admin-link-chip {
+  display: inline-block;
+  padding: 0.15rem 0.45rem;
+  border-radius: 999px;
+  background: #2a2a36;
+  color: #eee;
+  font-size: 0.72rem;
+  text-decoration: none;
+}
+
+.admin-link-chip:hover {
+  background: #3a3a48;
+  color: #fff;
+}
+
+.admin-link-chip--regia {
+  background: #3d2a00;
+  color: #f9a825;
+}
+
+.admin-inline-form {
+  display: inline-block;
+  margin-top: 0.35rem;
+}
+
 .admin-input {
   padding: 0.45rem 0.6rem;
   border: 1px solid #444;

backend/public/regia.js

@@ -7,6 +7,7 @@
     statusUrl: root.dataset.statusUrl,
     scoreUrl: root.dataset.scoreUrl,
     pauseUrl: root.dataset.pauseUrl,
+    resumeUrl: root.dataset.resumeUrl,
     stopUrl: root.dataset.stopUrl,
     cableUrl: root.dataset.cableUrl,
     hlsUrl: root.dataset.hlsUrl,
@@ -30,13 +31,15 @@
     modalConfirm: document.getElementById("modal-confirm"),
     modalCancel: document.getElementById("modal-cancel"),
     preview: document.getElementById("regia-preview"),
-    previewPlaceholder: document.getElementById("regia-preview-placeholder")
+    previewPlaceholder: document.getElementById("regia-preview-placeholder"),
+    btnPause: document.getElementById("btn-pause")
   };
 
   let pendingAction = null;
   let hls = null;
   let previewStarted = false;
   let wasPausedPreview = false;
+  let streamPaused = root.dataset.initialPaused === "true";
 
   function hlsUrlFresh() {
     const sep = cfg.hlsUrl.includes("?") ? "&" : "?";
@@ -108,7 +111,15 @@
     }
   }
 
+  function syncPauseButton(data) {
+    if (!els.btnPause) return;
+    const paused = !!(data.paused || data.status === "paused");
+    streamPaused = paused;
+    els.btnPause.textContent = paused ? "Riprendi diretta" : "Metti in pausa";
+  }
+
   function setBadge(data) {
+    syncPauseButton(data);
     if (data.stream_closed) {
       els.badge.textContent = "Terminata";
       els.badge.className = "regia-badge regia-badge--ended";
@@ -139,6 +150,8 @@
   }
 
   async function handleAction(action) {
+    const prevHome = els.homePoints?.textContent;
+    const prevAway = document.getElementById("away-points")?.textContent;
     try {
       const data = await postScore(action);
       applyScorePayload(data);
@@ -152,6 +165,9 @@
         openModal("Partita vinta", `${winner} ha vinto la partita. Chiudere la diretta?`, () => stopStream());
       }
     } catch (e) {
+      if (prevHome != null && els.homePoints) els.homePoints.textContent = prevHome;
+      const awayEl = document.getElementById("away-points");
+      if (prevAway != null && awayEl) awayEl.textContent = prevAway;
       toast(e.message || "Errore");
     }
   }
@@ -284,10 +300,19 @@
     showPreviewPlaceholder("Diretta terminata");
   }
 
-  async function pauseStream() {
-    await fetch(cfg.pauseUrl, { method: "POST", headers: { Accept: "application/json" } });
-    toast("Diretta in pausa — copertina in onda");
-    pollStatus();
+  async function togglePauseStream() {
+    const url = streamPaused ? cfg.resumeUrl : cfg.pauseUrl;
+    const res = await fetch(url, { method: "POST", headers: { Accept: "application/json" } });
+    if (!res.ok) {
+      const body = await res.json().catch(() => ({}));
+      throw new Error(body.error || (streamPaused ? "Errore ripresa diretta" : "Errore pausa diretta"));
+    }
+    const data = await res.json();
+    const wasPaused = streamPaused;
+    applyScorePayload(data);
+    setBadge(data);
+    syncPreviewFromStatus(data);
+    toast(wasPaused ? "Diretta ripresa" : "Diretta in pausa — copertina in onda");
   }
 
   async function stopStream() {
@@ -302,7 +327,7 @@
     return data;
   }
 
-  document.getElementById("btn-pause")?.addEventListener("click", () => pauseStream().catch((e) => toast(e.message)));
+  els.btnPause?.addEventListener("click", () => togglePauseStream().catch((e) => toast(e.message)));
   document.getElementById("btn-stop")?.addEventListener("click", () => stopStream().catch((e) => toast(e.message)));
 
   async function shareLink() {

backend/spec/requests/public/regia_spec.rb

@@ -22,4 +22,24 @@ RSpec.describe "Public regia", type: :request do
     expect(response).to have_http_status(:ok)
     expect(session.score_state.reload.home_points).to eq(1)
   end
+
+  it "mette in pausa e riprende la diretta" do
+    token = Sessions::RegiaAccess.new(session).issue_token!
+    post public_regia_pause_path(token)
+    expect(response).to have_http_status(:ok)
+    expect(session.reload.status).to eq("paused")
+
+    post public_regia_resume_path(token)
+    expect(response).to have_http_status(:ok)
+    expect(session.reload.status).to eq("connecting")
+  end
+
+  it "emette token valido anche oltre le 8 ore dalla partenza" do
+    session.update!(started_at: 9.hours.ago)
+    token = Sessions::RegiaAccess.new(session).issue_token!
+    session.reload
+    expect(session.regia_token_expires_at).to be > Time.current
+    get public_regia_path(token)
+    expect(response).to have_http_status(:ok)
+  end
 end