Playtime from PlaytimeHistory's database (SAW_PT_DSN)

A public Playtime tab and player-drawer playtime, and staff-only figures
(who's on, staff activity, disconnect reasons, countries, names, sessions)
for @css/generic on the staff panel and on the public site when signed in.
Hidden unless SAW_PT_DSN is set and its tables are there.

internal/playtime/testdata/schema.sql

@@ -0,0 +1,141 @@
+-- A copy of PlaytimeHistory's Migrations/001_CreateTables.sql (plugins/PlaytimeHistory, 0.1.0), for
+-- playtime_db_test.go. Keep it in step with the plugin's migrations.
+
+-- All times are UTC. Tables are prefixed pt_ so they can share a database if ever needed.
+
+CREATE TABLE IF NOT EXISTS `pt_servers` (
+    `id` int NOT NULL,
+    `address` varchar(64) NOT NULL DEFAULT '',
+    `hostname` varchar(128) NOT NULL DEFAULT '',
+    `first_seen` datetime NOT NULL,
+    `last_seen` datetime NOT NULL,
+    PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- One row per connection, opened on join and closed on leave or map change.
+-- end_kind: 0 open, 1 disconnect, 2 map change, 3 plugin unload, 4 stale (closed at its last
+-- heartbeat after the server died).
+CREATE TABLE IF NOT EXISTS `pt_sessions` (
+    `id` bigint unsigned NOT NULL AUTO_INCREMENT,
+    `session_key` char(32) NOT NULL,
+    `steamid64` bigint unsigned NOT NULL,
+    `server_id` int NOT NULL,
+    `nickname` varchar(128) NOT NULL,
+    `started_at` datetime NOT NULL,
+    `ended_at` datetime NULL,
+    `heartbeat_at` datetime NOT NULL,
+    `duration_seconds` int unsigned NULL,
+    `end_kind` tinyint NOT NULL DEFAULT 0,
+    `connect_map` varchar(64) NOT NULL,
+    `disconnect_map` varchar(64) NULL,
+    `disconnect_reason` smallint NULL,
+    `disconnect_reason_name` varchar(64) NULL,
+    `players_online` smallint unsigned NOT NULL,
+    `max_players` smallint unsigned NOT NULL,
+    `country_iso` char(2) NULL,
+    `country_name` varchar(64) NULL,
+    `city` varchar(128) NULL,
+    `kills` int NULL,
+    `deaths` int NULL,
+    `assists` int NULL,
+    `headshots` int NULL,
+    `damage` int NULL,
+    `mvp` int NULL,
+    `score` int NULL,
+    `rounds_played` smallint unsigned NULL,
+    `ping_avg` smallint unsigned NULL,
+    `ping_min` smallint unsigned NULL,
+    `ping_max` smallint unsigned NULL,
+    `ping_samples` int unsigned NULL,
+    `plugin_version` varchar(32) NOT NULL,
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uq_session_key` (`session_key`),
+    KEY `ix_steamid_started` (`steamid64`, `started_at`),
+    KEY `ix_server_started` (`server_id`, `started_at`),
+    KEY `ix_started` (`started_at`),
+    KEY `ix_server_open` (`server_id`, `ended_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- A stretch of a session where the player's team and alive/dead state didn't change.
+-- team: 0 unassigned, 1 spectator, 2 T, 3 CT. alive: NULL when not on T/CT.
+CREATE TABLE IF NOT EXISTS `pt_segments` (
+    `id` bigint unsigned NOT NULL AUTO_INCREMENT,
+    `segment_key` char(32) NOT NULL,
+    `session_key` char(32) NOT NULL,
+    `steamid64` bigint unsigned NOT NULL,
+    `server_id` int NOT NULL,
+    `map` varchar(64) NOT NULL,
+    `team` tinyint NOT NULL,
+    `alive` tinyint NULL,
+    `started_at` datetime NOT NULL,
+    `ended_at` datetime NULL,
+    `heartbeat_at` datetime NOT NULL,
+    `seconds` int unsigned NULL,
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uq_segment_key` (`segment_key`),
+    KEY `ix_steamid_started` (`steamid64`, `started_at`),
+    KEY `ix_started` (`started_at`),
+    KEY `ix_session` (`session_key`),
+    KEY `ix_server_open` (`server_id`, `ended_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- Running totals, added to in the same transaction that closes a segment or session.
+-- spec_seconds covers both spectator and unassigned. total_seconds includes it only when the
+-- plugin's CountSpectatorTime is on.
+CREATE TABLE IF NOT EXISTS `pt_players` (
+    `steamid64` bigint unsigned NOT NULL,
+    `first_seen` datetime NOT NULL,
+    `last_seen` datetime NOT NULL,
+    `sessions_count` int unsigned NOT NULL DEFAULT 0,
+    `total_seconds` bigint unsigned NOT NULL DEFAULT 0,
+    `t_seconds` bigint unsigned NOT NULL DEFAULT 0,
+    `ct_seconds` bigint unsigned NOT NULL DEFAULT 0,
+    `spec_seconds` bigint unsigned NOT NULL DEFAULT 0,
+    `alive_seconds` bigint unsigned NOT NULL DEFAULT 0,
+    `dead_seconds` bigint unsigned NOT NULL DEFAULT 0,
+    `last_nickname` varchar(128) NOT NULL,
+    `last_country` char(2) NULL,
+    `last_server_id` int NOT NULL,
+    PRIMARY KEY (`steamid64`),
+    KEY `ix_total` (`total_seconds`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS `pt_nicknames` (
+    `steamid64` bigint unsigned NOT NULL,
+    `nickname` varchar(128) NOT NULL,
+    `first_seen` datetime NOT NULL,
+    `last_seen` datetime NOT NULL,
+    `times_seen` int unsigned NOT NULL DEFAULT 1,
+    PRIMARY KEY (`steamid64`, `nickname`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+CREATE TABLE IF NOT EXISTS `pt_online_snapshots` (
+    `id` bigint unsigned NOT NULL AUTO_INCREMENT,
+    `server_id` int NOT NULL,
+    `taken_at` datetime NOT NULL,
+    `players` smallint unsigned NOT NULL,
+    `bots` smallint unsigned NOT NULL,
+    `max_players` smallint unsigned NOT NULL,
+    `map` varchar(64) NOT NULL,
+    PRIMARY KEY (`id`),
+    KEY `ix_server_taken` (`server_id`, `taken_at`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+
+-- Segments split at the hour boundaries: one row per segment per UTC hour it touches. Closed
+-- segments only; filter on hour_start (and steamid64) when reading.
+CREATE VIEW IF NOT EXISTS `pt_segments_hourly` AS
+WITH RECURSIVE h AS (
+    SELECT s.steamid64, s.server_id, s.map, s.team, s.alive, s.ended_at,
+           CAST(DATE_FORMAT(s.started_at, '%Y-%m-%d %H:00:00') AS DATETIME) AS hour_start,
+           s.started_at AS piece_start
+    FROM pt_segments s
+    WHERE s.ended_at IS NOT NULL AND s.ended_at > s.started_at
+    UNION ALL
+    SELECT steamid64, server_id, map, team, alive, ended_at,
+           hour_start + INTERVAL 1 HOUR, hour_start + INTERVAL 1 HOUR
+    FROM h
+    WHERE hour_start + INTERVAL 1 HOUR < ended_at
+)
+SELECT steamid64, server_id, map, team, alive, hour_start,
+       TIMESTAMPDIFF(SECOND, piece_start, LEAST(ended_at, hour_start + INTERVAL 1 HOUR)) AS seconds
+FROM h;