Allinea hub partite app nativa e API match al wizard semplificato.

Filtra le partite visibili lato client/server, corregge il parsing date Rails su Android, semplifica lo step Partita del wizard e restringe l'API ai campi effettivamente usati (campionato, set e scoring_rules).

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

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

@@ -8,6 +8,7 @@ module Api
         matches = @team.matches
           .includes(:team, :stream_sessions)
           .order(Arel.sql("scheduled_at ASC NULLS LAST"), created_at: :desc)
+          .select(&:coach_hub_visible?)
         render json: matches.map { |m| match_json(m) }
       end
 
@@ -21,7 +22,9 @@ module Api
       end
 
       def update
-        @match.update!(match_params)
+        attrs = match_params.to_h
+        normalize_scoring_rules!(attrs)
+        @match.update!(attrs)
         render json: match_json(@match)
       end
 
@@ -52,11 +55,19 @@ module Api
       def match_params
         params.require(:match).permit(
           :opponent_name, :location, :scheduled_at, :sport, :sets_to_win,
-          :category, :phase, roster_numbers: [],
+          :category,
           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")
+
+        rules = attrs["scoring_rules"]
+        attrs["scoring_rules"] = {} if rules.blank?
+      end
+
       def match_json(match, detail: false)
         active = active_session_for(match)
         {
@@ -69,11 +80,11 @@ module Api
           sport: match.sport,
           sets_to_win: match.sets_to_win,
           scoring_rules: match.scoring_rules.presence,
-          roster_numbers: match.roster_numbers,
           category: match.category,
-          phase: match.phase,
           active_session_id: active&.id,
-          active_session_status: active&.status
+          active_session_status: active&.status,
+          stream_completed: match.stream_completed?,
+          coach_hub_visible: match.coach_hub_visible?
         }
       end
 

backend/app/models/match.rb

@@ -6,6 +6,9 @@ class Match < ApplicationRecord
 
   validates :opponent_name, presence: true
   validates :sets_to_win, numericality: { greater_than: 0, less_than: 6 }
+  validate :scoring_rules_shape, if: -> { scoring_rules.present? }
+
+  # category: campionato / descrizione torneo (facoltativo, es. "Serie C").
 
   # Partite ancora da giocare in diretta (orario nel futuro).
   scope :scheduled_for_live, -> {
@@ -55,4 +58,37 @@ class Match < ApplicationRecord
   def broadcast_active?
     stream_sessions.where(status: ACTIVE_SESSION_STATUSES).exists?
   end
+
+  def stream_completed?
+    stream_sessions.where(status: %w[ended error]).exists?
+  end
+
+  # Hub app coach: dirette da riprendere o partite programmate future.
+  # Le bozze «Avversario» abbandonate (senza sessione) non compaiono.
+  def coach_hub_visible?
+    active = active_stream_session
+    return true if active&.resumable?
+    return true if active&.idle?
+
+    return false if stream_completed?
+
+    scheduled_upcoming?
+  end
+
+  private
+
+  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|
+      val = rules[key] || rules[key.to_sym]
+      next if val.blank?
+
+      unless val.is_a?(Integer) || val.to_s.match?(/\A\d+\z/)
+        errors.add(:scoring_rules, "#{key} non valido")
+        next
+      end
+      int_val = val.to_i
+      errors.add(:scoring_rules, "#{key} deve essere positivo") if int_val < 1
+    end
+  end
 end