comunidadhll/docs/HISTORICAL_MATCH_KILLS_PER_MINUTE_ANALYSIS.md

Historical Match Kills Per Minute Analysis

Scope

This analysis covers the player table inside historico-partida.html for historical match detail.

Question

Can the UI add a Kills por minuto column now without reintroducing false KPM?

Short Answer

No.

Why It Cannot Be Implemented Honestly Yet

The current historical match detail payload exposes player combat totals and match-level timing, but it does not expose a trustworthy player-level active time.

Available today:

• per player:
  • kills
  • deaths
  • teamkills
  • kd_ratio or enough data to derive it
  • top_weapons
  • most_killed
  • death_by
• per match:
  • duration_seconds
  • started_at
  • ended_at

Missing for real KPM:

• player_active_seconds
• real played minutes per player
• presence intervals
• a quality flag that tells whether playtime is exact, observed, estimated or unknown

Data Review

build_historical_match_detail_payload() serves item from the RCON historical read model when available.

historico-partida.js currently renders the player table with:

• Jugador
• Equipo
• Kills
• Muertes
• TK
• KD

There is no frontend or payload field for honest KPM.

Important Constraint

Real KPM must mean:

kills / (player_active_seconds / 60)

It must not mean:

kills / match_duration_minutes

unless the product intentionally introduces a different metric with a clearly different label.

Existing Design Reference

docs/REAL_KPM_PLAYER_ACTIVE_SECONDS_DESIGN.md already documents the correct long-term direction:

• materialize player_active_seconds
• carry a playtime quality classification
• compute KPM in backend read models and snapshots
• never compute real KPM in frontend JavaScript

Recommendation

Do not add the column now.

Safe next step:

1. Add real player_active_seconds to the historical player detail model.
2. Expose it in the match detail payload.
3. Add Kills por minuto only when backed by that field.

Optional weaker alternative, only with explicit product approval:

• Kills/min partida
• clearly labeled as match-duration-based
• never presented as player KPM