chore: improve match details

Author: Bulletdev

app/modules/analytics/controllers/champions_controller.rb

@@ -142,7 +142,8 @@ def build_match_summary(stat)
           date: stat.match.game_start&.strftime('%Y-%m-%d %H:%M'),
           victory: stat.match.victory?,
           game_duration: stat.match.game_duration.to_i,
-          role: stat.role
+          role: stat.role,
+          opponent_champion: stat.opponent_champion
         }
       end
 

app/modules/matches/jobs/sync_match_job.rb

@@ -115,15 +115,41 @@ def create_player_match_stats(match, participants, organization)
       puts "SyncMatchJob: Our players in match: #{our_participants.size}"
 
       team_totals = calculate_team_totals(participants, our_participants, is_competitive)
+      opponent_map = build_opponent_map(participants)
 
       participants.each do |participant_data|
         player = organization.players.find_by(riot_puuid: participant_data[:puuid])
         next unless player
 
-        create_stat_for_participant(match, player, participant_data, team_totals)
+        create_stat_for_participant(match, player, participant_data, team_totals, opponent_map)
       end
     end
 
+    # Builds a hash mapping each participant's puuid to the champion name of their
+    # lane opponent (same teamPosition on the opposing team).
+    # Returns an empty hash when the match has an unexpected team structure.
+    def build_opponent_map(participants)
+      by_team = participants.group_by { |p| p[:team_id] }
+      teams = by_team.keys
+      return {} unless teams.size == 2
+
+      result = {}
+      teams.each do |team_id|
+        other_team_id = teams.find { |t| t != team_id }
+        other_team = by_team[other_team_id] || []
+
+        by_team[team_id].each do |participant|
+          role = participant[:role]
+          next if role.blank?
+
+          opponent = other_team.find { |o| o[:role] == role }
+          result[participant[:puuid]] = opponent&.dig(:champion_name)
+        end
+      end
+
+      result
+    end
+
     def calculate_team_totals(participants, our_participants, is_competitive)
       source = is_competitive ? our_participants : participants
       source.group_by { |p| p[:team_id] }.transform_values do |team_participants|
@@ -137,7 +163,7 @@ def calculate_team_totals(participants, our_participants, is_competitive)
       end
     end
 
-    def create_stat_for_participant(match, player, participant_data, team_totals)
+    def create_stat_for_participant(match, player, participant_data, team_totals, opponent_map = {})
       team_stats = team_totals[participant_data[:team_id]]
       damage_share = calc_share(participant_data[:total_damage_dealt], team_stats&.dig(:total_damage))
       gold_share = calc_share(participant_data[:gold_earned], team_stats&.dig(:total_gold))
@@ -148,6 +174,7 @@ def create_stat_for_participant(match, player, participant_data, team_totals)
         player: player,
         role: normalize_role(participant_data[:role]),
         champion: participant_data[:champion_name],
+        opponent_champion: opponent_map[participant_data[:puuid]],
         kills: participant_data[:kills],
         deaths: participant_data[:deaths],
         assists: participant_data[:assists],
@@ -160,6 +187,8 @@ def create_stat_for_participant(match, player, participant_data, team_totals)
         wards_placed: participant_data[:wards_placed],
         wards_destroyed: participant_data[:wards_killed],
         first_blood: participant_data[:first_blood_kill],
+        first_tower: participant_data[:first_tower_kill],
+        control_wards_purchased: participant_data[:control_wards_purchased],
         double_kills: participant_data[:double_kills],
         triple_kills: participant_data[:triple_kills],
         quadra_kills: participant_data[:quadra_kills],

app/modules/riot_integration/services/riot_api_service.rb

@@ -238,6 +238,8 @@ def parse_participant(participant)
       summoner_spell_2_casts: participant['summoner2Casts'],
       cs_at_10: challenges['laneMinionsFirst10Minutes'],
       turret_plates_destroyed: challenges['turretPlatesTaken'],
+      first_tower_kill: participant['firstTowerKill'],
+      control_wards_purchased: participant['visionWardsBoughtInGame'],
       pings: extract_pings(participant)
     }
   end

db/migrate/20260420000004_add_opponent_champion_to_player_match_stats.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# Adds opponent_champion to player_match_stats for laning matchup context.
+# Populated during match sync by finding the participant on the opposing team
+# with the same teamPosition (role) as the tracked player.
+class AddOpponentChampionToPlayerMatchStats < ActiveRecord::Migration[7.1]
+  def change
+    add_column :player_match_stats, :opponent_champion, :string
+
+    add_index :player_match_stats, :opponent_champion,
+              name: 'idx_pms_opponent_champion'
+  end
+end