Implement real player active time intervals and historical KPM

backend/app/config.py

@@ -47,6 +47,7 @@ DEFAULT_RCON_HISTORICAL_CAPTURE_MAX_RETRIES = 2
 DEFAULT_RCON_HISTORICAL_CAPTURE_RETRY_DELAY_SECONDS = 15
 DEFAULT_RCON_CURRENT_MATCH_CAPTURE_INTERVAL_SECONDS = 5
 DEFAULT_RCON_CURRENT_MATCH_WRITER_LOCK_TIMEOUT_SECONDS = 4.0
+DEFAULT_KPM_MIN_ACTIVE_SECONDS = 60
 DEFAULT_RCON_BACKFILL_CHUNK_HOURS = 6
 DEFAULT_RCON_BACKFILL_SLEEP_SECONDS = 1.0
 DEFAULT_RCON_BACKFILL_MAX_DAYS_BACK = 45
@@ -677,6 +678,15 @@ def get_rcon_current_match_writer_lock_timeout_seconds() -> float:
     )
 
 
+def get_kpm_min_active_seconds() -> int:
+    """Return the minimum observed active seconds required before KPM is considered valid."""
+    return _read_int_env(
+        "HLL_KPM_MIN_ACTIVE_SECONDS",
+        str(DEFAULT_KPM_MIN_ACTIVE_SECONDS),
+        minimum=1,
+    )
+
+
 def get_rcon_backfill_chunk_hours() -> int:
     """Return the AdminLog backfill chunk size in hours."""
     return _read_int_env(