"""Regression tests for the materialized RCON AdminLog pipeline.""" from __future__ import annotations import gc import os import tempfile import unittest from pathlib import Path from app.historical_storage import upsert_historical_match from app.payloads import build_recent_historical_matches_payload from app.rcon_admin_log_materialization import ( get_materialized_rcon_match_detail, materialize_rcon_admin_log, summarize_rcon_materialization_status, ) from app.rcon_admin_log_storage import persist_rcon_admin_log_entries from app.rcon_historical_read_model import ( get_rcon_historical_match_detail, list_rcon_historical_recent_activity, ) from app.scoreboard_origins import resolve_trusted_scoreboard_match_url class RconMaterializationPipelineTests(unittest.TestCase): def test_materializes_match_result_and_player_stats_idempotently(self) -> None: with tempfile.TemporaryDirectory() as tmpdir: db_path = Path(tmpdir) / "historical.sqlite3" _persist_admin_log_fixture(db_path) first = materialize_rcon_admin_log(db_path=db_path) second = materialize_rcon_admin_log(db_path=db_path) detail = get_materialized_rcon_match_detail( server_key="comunidad-hispana-01", match_key="comunidad-hispana-01:100:500:stmariedumontwarfare", db_path=db_path, ) status = summarize_rcon_materialization_status(db_path=db_path) self.assertEqual(first["matches_materialized"], 1) self.assertEqual(second["matches_materialized"], 0) self.assertEqual(second["matches_updated"], 1) self.assertIsNotNone(detail) match = detail["match"] self.assertEqual(match["allied_score"], 5) self.assertEqual(match["axis_score"], 0) self.assertEqual(match["winner"], "allied") players = {row["player_name"]: row for row in detail["players"]} self.assertEqual(players["Alpha"]["kills"], 1) self.assertEqual(players["Alpha"]["teamkills"], 1) self.assertEqual(players["Bravo"]["deaths"], 1) self.assertEqual(players["Charlie"]["deaths_by_teamkill"], 1) self.assertEqual(status["materialized_matches"], 1) self.assertEqual(status["matches_with_player_stats"], 1) gc.collect() def test_match_detail_read_model_hides_raw_player_ids(self) -> None: with tempfile.TemporaryDirectory() as tmpdir: db_path = Path(tmpdir) / "historical.sqlite3" previous_storage_path = os.environ.get("HLL_BACKEND_STORAGE_PATH") os.environ["HLL_BACKEND_STORAGE_PATH"] = str(db_path) try: _persist_admin_log_fixture(db_path) materialize_rcon_admin_log(db_path=db_path) detail = get_rcon_historical_match_detail( server_key="comunidad-hispana-01", match_id="comunidad-hispana-01:100:500:stmariedumontwarfare", ) finally: _restore_env("HLL_BACKEND_STORAGE_PATH", previous_storage_path) self.assertIsNotNone(detail) self.assertEqual(detail["result_source"], "admin-log-match-ended") self.assertEqual(detail["result"]["allied_score"], 5) self.assertEqual(detail["timestamp_confidence"], "absolute") players = {row["player_name"]: row for row in detail["players"]} self.assertNotIn("player_id", players["Alpha"]) self.assertIn("kd_ratio", players["Alpha"]) self.assertEqual(players["Alpha"]["steam_id_64"], "76561198000000001") self.assertEqual(players["Alpha"]["platform"], "steam") self.assertEqual( players["Alpha"]["external_profile_links"]["hellor"], "https://hellor.pro/player/76561198000000001", ) self.assertEqual(players["Charlie"]["platform"], "unknown") self.assertNotIn("steam_id_64", players["Charlie"]) self.assertNotIn("external_profile_links", players["Charlie"]) gc.collect() def test_match_detail_marks_equal_materialized_timestamps_as_server_time_only(self) -> None: with tempfile.TemporaryDirectory() as tmpdir: db_path = Path(tmpdir) / "historical.sqlite3" previous_storage_path = os.environ.get("HLL_BACKEND_STORAGE_PATH") os.environ["HLL_BACKEND_STORAGE_PATH"] = str(db_path) try: persist_rcon_admin_log_entries( target={ "target_key": "comunidad-hispana-01", "external_server_id": "comunidad-hispana-01", }, entries=[ { "timestamp": "2026-05-01T12:00:00Z", "message": "[1 min (100)] MATCH START ST MARIE DU MONT Warfare", }, { "timestamp": "2026-05-01T12:00:00Z", "message": "[91 min (5500)] MATCH ENDED `ST MARIE DU MONT Warfare` ALLIED (5 - 0) AXIS", }, ], db_path=db_path, ) materialize_rcon_admin_log(db_path=db_path) detail = get_rcon_historical_match_detail( server_key="comunidad-hispana-01", match_id="comunidad-hispana-01:100:5500:stmariedumontwarfare", ) finally: _restore_env("HLL_BACKEND_STORAGE_PATH", previous_storage_path) self.assertIsNotNone(detail) self.assertIsNone(detail["started_at"]) self.assertIsNone(detail["ended_at"]) self.assertEqual(detail["closed_at"], "2026-05-01T12:00:00Z") self.assertEqual(detail["timestamp_confidence"], "server-time-only") self.assertEqual(detail["duration_seconds"], 5400) gc.collect() def test_equal_timestamp_materialized_detail_uses_closed_at_window_for_scoreboard_link(self) -> None: with tempfile.TemporaryDirectory() as tmpdir: db_path = Path(tmpdir) / "historical.sqlite3" previous_storage_path = os.environ.get("HLL_BACKEND_STORAGE_PATH") os.environ["HLL_BACKEND_STORAGE_PATH"] = str(db_path) try: upsert_historical_match( server_slug="comunidad-hispana-02", match_payload={ "id": "1779183861", "creation_time": "2026-05-01T10:30:00Z", "start": "2026-05-01T10:30:00Z", "end": "2026-05-01T12:00:00Z", "map": {"name": "ST MARIE DU MONT Warfare"}, "result": {"allied": 5, "axis": 0}, "player_stats": [], }, db_path=db_path, ) persist_rcon_admin_log_entries( target={ "target_key": "comunidad-hispana-02", "external_server_id": "comunidad-hispana-02", }, entries=[ { "timestamp": "2026-05-01T12:00:00Z", "message": "[1 min (100)] MATCH START ST MARIE DU MONT Warfare", }, { "timestamp": "2026-05-01T12:00:00Z", "message": "[91 min (5500)] MATCH ENDED `ST MARIE DU MONT Warfare` ALLIED (5 - 0) AXIS", }, ], db_path=db_path, ) materialize_rcon_admin_log(db_path=db_path) detail = get_rcon_historical_match_detail( server_key="comunidad-hispana-02", match_id="comunidad-hispana-02:100:5500:stmariedumontwarfare", ) finally: _restore_env("HLL_BACKEND_STORAGE_PATH", previous_storage_path) self.assertIsNotNone(detail) self.assertIsNone(detail["started_at"]) self.assertIsNone(detail["ended_at"]) self.assertEqual(detail["duration_seconds"], 5400) self.assertEqual( detail["match_url"], "https://scoreboard.comunidadhll.es:5443/games/1779183861", ) gc.collect() def test_match_detail_adds_safe_profile_summary_when_snapshot_exists(self) -> None: with tempfile.TemporaryDirectory() as tmpdir: db_path = Path(tmpdir) / "historical.sqlite3" previous_storage_path = os.environ.get("HLL_BACKEND_STORAGE_PATH") os.environ["HLL_BACKEND_STORAGE_PATH"] = str(db_path) try: _persist_admin_log_fixture(db_path) persist_rcon_admin_log_entries( target={ "target_key": "comunidad-hispana-01", "external_server_id": "comunidad-hispana-01", }, entries=[ { "timestamp": "2026-05-01T10:30:00Z", "message": ( "[31 min (300)] MESSAGE: player [Alpha(76561198000000001)], " "content [─ Alpha ─\n" "▒ Totales ▒\n" "sesiones : 12\n" "partidas jugadas : 9\n" "bajas : 141 (6 TKs)\n" "muertes : 268 (5 TKs)\n" "K/D : 0.53\n" "▒ Armas favoritas ▒\n" "M1 Garand : 31]" ), } ], db_path=db_path, ) materialize_rcon_admin_log(db_path=db_path) detail = get_rcon_historical_match_detail( server_key="comunidad-hispana-01", match_id="comunidad-hispana-01:100:500:stmariedumontwarfare", ) finally: _restore_env("HLL_BACKEND_STORAGE_PATH", previous_storage_path) self.assertIsNotNone(detail) players = {row["player_name"]: row for row in detail["players"]} self.assertIn("profile_summary", players["Alpha"]) self.assertNotIn("profile_summary", players["Bravo"]) profile_summary = players["Alpha"]["profile_summary"] self.assertEqual(profile_summary["sessions"], 12) self.assertEqual(profile_summary["matches_played"], 9) self.assertEqual(profile_summary["totals"]["kills"], 141) self.assertEqual(profile_summary["favorite_weapons"], {"M1 Garand": 31}) self.assertNotIn("raw_content", profile_summary) self.assertNotIn("player_id", players["Alpha"]) gc.collect() def test_recent_matches_prefer_materialized_rcon_over_scoreboard_fallback(self) -> None: with tempfile.TemporaryDirectory() as tmpdir: db_path = Path(tmpdir) / "historical.sqlite3" previous_storage_path = os.environ.get("HLL_BACKEND_STORAGE_PATH") os.environ["HLL_BACKEND_STORAGE_PATH"] = str(db_path) try: _persist_admin_log_fixture(db_path) materialize_rcon_admin_log(db_path=db_path) _persist_scoreboard_match(db_path) payload = build_recent_historical_matches_payload( limit=5, server_slug="comunidad-hispana-01", ) recent = list_rcon_historical_recent_activity( server_key="comunidad-hispana-01", limit=5, ) finally: _restore_env("HLL_BACKEND_STORAGE_PATH", previous_storage_path) self.assertEqual(payload["data"]["selected_source"], "rcon") self.assertEqual(payload["data"]["items"][0]["result_source"], "admin-log-match-ended") self.assertEqual(recent[0]["result_source"], "admin-log-match-ended") self.assertNotEqual(payload["data"]["selected_source"], "public-scoreboard") gc.collect() def test_recent_materialized_detail_id_resolves_through_detail_read_model(self) -> None: with tempfile.TemporaryDirectory() as tmpdir: db_path = Path(tmpdir) / "historical.sqlite3" previous_storage_path = os.environ.get("HLL_BACKEND_STORAGE_PATH") os.environ["HLL_BACKEND_STORAGE_PATH"] = str(db_path) try: _persist_admin_log_fixture(db_path) materialize_rcon_admin_log(db_path=db_path) recent = list_rcon_historical_recent_activity( server_key="comunidad-hispana-01", limit=1, )[0] detail = get_rcon_historical_match_detail( server_key="comunidad-hispana-01", match_id=str(recent["internal_detail_match_id"]), ) finally: _restore_env("HLL_BACKEND_STORAGE_PATH", previous_storage_path) self.assertIsNotNone(detail) self.assertEqual(detail["match_id"], recent["internal_detail_match_id"]) gc.collect() def test_public_scoreboard_fallback_used_only_without_rcon_activity(self) -> None: with tempfile.TemporaryDirectory() as tmpdir: db_path = Path(tmpdir) / "historical.sqlite3" previous_storage_path = os.environ.get("HLL_BACKEND_STORAGE_PATH") os.environ["HLL_BACKEND_STORAGE_PATH"] = str(db_path) try: _persist_scoreboard_match(db_path) payload = build_recent_historical_matches_payload( limit=5, server_slug="comunidad-hispana-01", ) finally: _restore_env("HLL_BACKEND_STORAGE_PATH", previous_storage_path) self.assertTrue(payload["data"]["fallback_used"]) self.assertEqual(payload["data"]["selected_source"], "public-scoreboard") self.assertEqual(payload["data"]["items"][0]["result_source"], "public-scoreboard-fallback") gc.collect() def test_safe_scoreboard_match_url_allowlist_for_active_origins(self) -> None: self.assertEqual( resolve_trusted_scoreboard_match_url( "https://scoreboard.comunidadhll.es/games/1561515", "comunidad-hispana-01", ), "https://scoreboard.comunidadhll.es/games/1561515", ) self.assertEqual( resolve_trusted_scoreboard_match_url( "https://scoreboard.comunidadhll.es:5443/games/222", "comunidad-hispana-02", ), "https://scoreboard.comunidadhll.es:5443/games/222", ) self.assertIsNone( resolve_trusted_scoreboard_match_url( "https://example.com/games/222", "comunidad-hispana-02", ) ) self.assertIsNone( resolve_trusted_scoreboard_match_url( "https://scoreboard.comunidadhll.es:5443/admin/222", "comunidad-hispana-02", ) ) def _persist_admin_log_fixture(db_path: Path) -> None: persist_rcon_admin_log_entries( target={ "target_key": "comunidad-hispana-01", "external_server_id": "comunidad-hispana-01", }, entries=[ { "timestamp": "2026-05-01T10:00:00Z", "message": "[1 min (100)] MATCH START ST MARIE DU MONT Warfare", }, { "timestamp": "2026-05-01T10:05:00Z", "message": "[6 min (150)] CONNECTED Alpha (76561198000000001)", }, { "timestamp": "2026-05-01T10:06:00Z", "message": "[7 min (160)] TEAMSWITCH Alpha (None > Allies)", }, { "timestamp": "2026-05-01T10:10:00Z", "message": ( "[11 min (200)] KILL: Alpha(Allies/76561198000000001) -> " "Bravo(Axis/76561198000000002) with M1 Garand" ), }, { "timestamp": "2026-05-01T10:12:00Z", "message": ( "[13 min (220)] KILL: Alpha(Allies/76561198000000001) -> " "Charlie(Allies/nonsteam-local) with M1 Garand" ), }, { "timestamp": "2026-05-01T11:20:00Z", "message": "[81 min (500)] MATCH ENDED `ST MARIE DU MONT Warfare` ALLIED (5 - 0) AXIS", }, ], db_path=db_path, ) def _persist_scoreboard_match(db_path: Path) -> None: upsert_historical_match( server_slug="comunidad-hispana-01", match_payload={ "id": "1561515", "creation_time": "2026-05-01T10:00:00Z", "start": "2026-05-01T10:00:00Z", "end": "2026-05-01T11:20:00Z", "map": {"name": "ST MARIE DU MONT Warfare"}, "result": {"allied": 2, "axis": 3}, "player_stats": [], }, db_path=db_path, ) def _restore_env(name: str, previous_value: str | None) -> None: if previous_value is None: os.environ.pop(name, None) else: os.environ[name] = previous_value if __name__ == "__main__": unittest.main()