Add analytics API implementations and validation tests

- Introduced fake implementations for various analytics APIs including Game, Global, Map, Player, and Server analytics.
- Created the DashboardAnalyticsApi and associated methods for retrieving dashboard analytics data.
- Implemented validation logic for analytics query parameters in AnalyticsQueryValidator.
- Added unit tests for validating analytics query parameters, ensuring correct behavior for time windows and bucket limits.

Author: frasermolyneux

src/XtremeIdiots.Portal.Repository.Abstractions.V1/Constants/V1/Analytics/AnalyticsBucket.cs

@@ -0,0 +1,8 @@
+namespace XtremeIdiots.Portal.Repository.Abstractions.Constants.V1.Analytics;
+
+public enum AnalyticsBucket
+{
+    FifteenMinutes,
+    OneHour,
+    OneDay
+}

src/XtremeIdiots.Portal.Repository.Abstractions.V1/Constants/V1/Analytics/AnalyticsQueryDefaults.cs

@@ -0,0 +1,12 @@
+namespace XtremeIdiots.Portal.Repository.Abstractions.Constants.V1.Analytics;
+
+public static class AnalyticsQueryDefaults
+{
+    public const int DefaultTop = 10;
+    public const int MinTop = 1;
+    public const int MaxTop = 100;
+
+    public const int FifteenMinuteMaxDays = 3;
+    public const int OneHourMaxDays = 31;
+    public const int OneDayMaxDays = 366;
+}

src/XtremeIdiots.Portal.Repository.Abstractions.V1/Interfaces/V1/IDashboardAnalyticsApi.cs

@@ -0,0 +1,13 @@
+using MX.Api.Abstractions;
+
+using XtremeIdiots.Portal.Repository.Abstractions.Constants.V1.Analytics;
+using XtremeIdiots.Portal.Repository.Abstractions.Models.V1.Analytics.Dashboard;
+
+namespace XtremeIdiots.Portal.Repository.Abstractions.Interfaces.V1;
+
+public interface IDashboardAnalyticsApi
+{
+    Task<ApiResult<DashboardSummaryDto>> GetSummary(DateTime fromUtc, DateTime toUtc, CancellationToken cancellationToken = default);
+    Task<ApiResult<DashboardTrendsDto>> GetTrends(DateTime fromUtc, DateTime toUtc, AnalyticsBucket bucket, CancellationToken cancellationToken = default);
+    Task<ApiResult<DashboardCompositionDto>> GetComposition(DateTime fromUtc, DateTime toUtc, int top = AnalyticsQueryDefaults.DefaultTop, CancellationToken cancellationToken = default);
+}

src/XtremeIdiots.Portal.Repository.Abstractions.V1/Interfaces/V1/IGameAnalyticsApi.cs

@@ -0,0 +1,16 @@
+using MX.Api.Abstractions;
+
+using XtremeIdiots.Portal.Repository.Abstractions.Constants.V1;
+using XtremeIdiots.Portal.Repository.Abstractions.Constants.V1.Analytics;
+using XtremeIdiots.Portal.Repository.Abstractions.Models.V1.Analytics.Games;
+
+namespace XtremeIdiots.Portal.Repository.Abstractions.Interfaces.V1;
+
+public interface IGameAnalyticsApi
+{
+    Task<ApiResult<GameOverviewDto>> GetOverview(GameType gameType, DateTime fromUtc, DateTime toUtc, CancellationToken cancellationToken = default);
+    Task<ApiResult<GameTimeseriesDto>> GetTimeseries(GameType gameType, DateTime fromUtc, DateTime toUtc, AnalyticsBucket bucket, CancellationToken cancellationToken = default);
+    Task<ApiResult<GameServerBreakdownDto>> GetServerBreakdown(GameType gameType, DateTime fromUtc, DateTime toUtc, int top = AnalyticsQueryDefaults.DefaultTop, CancellationToken cancellationToken = default);
+    Task<ApiResult<GamePlayerBreakdownDto>> GetPlayerBreakdown(GameType gameType, DateTime fromUtc, DateTime toUtc, int top = AnalyticsQueryDefaults.DefaultTop, CancellationToken cancellationToken = default);
+    Task<ApiResult<GameMapBreakdownDto>> GetMapBreakdown(GameType gameType, DateTime fromUtc, DateTime toUtc, int top = AnalyticsQueryDefaults.DefaultTop, CancellationToken cancellationToken = default);
+}

src/XtremeIdiots.Portal.Repository.Abstractions.V1/Interfaces/V1/IGlobalAnalyticsApi.cs

@@ -0,0 +1,17 @@
+using MX.Api.Abstractions;
+
+using XtremeIdiots.Portal.Repository.Abstractions.Constants.V1.Analytics;
+using XtremeIdiots.Portal.Repository.Abstractions.Models.V1.Analytics.Global;
+
+namespace XtremeIdiots.Portal.Repository.Abstractions.Interfaces.V1;
+
+public interface IGlobalAnalyticsApi
+{
+    Task<ApiResult<GlobalOverviewDto>> GetOverview(DateTime fromUtc, DateTime toUtc, CancellationToken cancellationToken = default);
+    Task<ApiResult<GlobalTimeseriesDto>> GetTimeseries(DateTime fromUtc, DateTime toUtc, AnalyticsBucket bucket, CancellationToken cancellationToken = default);
+    Task<ApiResult<GlobalGameBreakdownDto>> GetGameBreakdown(DateTime fromUtc, DateTime toUtc, int top = AnalyticsQueryDefaults.DefaultTop, CancellationToken cancellationToken = default);
+    Task<ApiResult<GlobalServerBreakdownDto>> GetServerBreakdown(DateTime fromUtc, DateTime toUtc, int top = AnalyticsQueryDefaults.DefaultTop, CancellationToken cancellationToken = default);
+    Task<ApiResult<GlobalPlayerActivityDto>> GetPlayerActivity(DateTime fromUtc, DateTime toUtc, int top = AnalyticsQueryDefaults.DefaultTop, CancellationToken cancellationToken = default);
+    Task<ApiResult<GlobalGeoDistributionDto>> GetGeoDistribution(DateTime fromUtc, DateTime toUtc, int top = AnalyticsQueryDefaults.DefaultTop, CancellationToken cancellationToken = default);
+    Task<ApiResult<GlobalModerationDto>> GetModeration(DateTime fromUtc, DateTime toUtc, CancellationToken cancellationToken = default);
+}

src/XtremeIdiots.Portal.Repository.Abstractions.V1/Interfaces/V1/IMapAnalyticsApi.cs

@@ -0,0 +1,13 @@
+using MX.Api.Abstractions;
+
+using XtremeIdiots.Portal.Repository.Abstractions.Constants.V1.Analytics;
+using XtremeIdiots.Portal.Repository.Abstractions.Models.V1.Analytics.Maps;
+
+namespace XtremeIdiots.Portal.Repository.Abstractions.Interfaces.V1;
+
+public interface IMapAnalyticsApi
+{
+    Task<ApiResult<MapOverviewDto>> GetOverview(Guid mapId, DateTime fromUtc, DateTime toUtc, CancellationToken cancellationToken = default);
+    Task<ApiResult<MapTrendsDto>> GetTrends(Guid mapId, DateTime fromUtc, DateTime toUtc, AnalyticsBucket bucket, CancellationToken cancellationToken = default);
+    Task<ApiResult<MapRankingsDto>> GetRankings(DateTime fromUtc, DateTime toUtc, int top = AnalyticsQueryDefaults.DefaultTop, CancellationToken cancellationToken = default);
+}

src/XtremeIdiots.Portal.Repository.Abstractions.V1/Interfaces/V1/IPlayerAnalyticsV2Api.cs

@@ -0,0 +1,14 @@
+using MX.Api.Abstractions;
+
+using XtremeIdiots.Portal.Repository.Abstractions.Constants.V1.Analytics;
+using XtremeIdiots.Portal.Repository.Abstractions.Models.V1.Analytics.Players;
+
+namespace XtremeIdiots.Portal.Repository.Abstractions.Interfaces.V1;
+
+public interface IPlayerAnalyticsV2Api
+{
+    Task<ApiResult<PlayerOverviewDto>> GetOverview(Guid playerId, DateTime fromUtc, DateTime toUtc, CancellationToken cancellationToken = default);
+    Task<ApiResult<PlayerTrendsDto>> GetTrends(Guid playerId, DateTime fromUtc, DateTime toUtc, AnalyticsBucket bucket, CancellationToken cancellationToken = default);
+    Task<ApiResult<PlayerRelatedActivityDto>> GetRelatedActivity(Guid playerId, DateTime fromUtc, DateTime toUtc, CancellationToken cancellationToken = default);
+    Task<ApiResult<PlayerModerationSummaryDto>> GetModerationSummary(Guid playerId, DateTime fromUtc, DateTime toUtc, CancellationToken cancellationToken = default);
+}

src/XtremeIdiots.Portal.Repository.Abstractions.V1/Interfaces/V1/IServerAnalyticsApi.cs

@@ -0,0 +1,13 @@
+using MX.Api.Abstractions;
+
+using XtremeIdiots.Portal.Repository.Abstractions.Constants.V1.Analytics;
+using XtremeIdiots.Portal.Repository.Abstractions.Models.V1.Analytics.Servers;
+
+namespace XtremeIdiots.Portal.Repository.Abstractions.Interfaces.V1;
+
+public interface IServerAnalyticsApi
+{
+    Task<ApiResult<ServerOverviewDto>> GetOverview(Guid gameServerId, DateTime fromUtc, DateTime toUtc, CancellationToken cancellationToken = default);
+    Task<ApiResult<ServerTimeseriesDto>> GetTimeseries(Guid gameServerId, DateTime fromUtc, DateTime toUtc, AnalyticsBucket bucket, CancellationToken cancellationToken = default);
+    Task<ApiResult<ServerSummaryDto>> GetSummary(Guid gameServerId, DateTime fromUtc, DateTime toUtc, CancellationToken cancellationToken = default);
+}

src/XtremeIdiots.Portal.Repository.Abstractions.V1/Models/V1/Analytics/AnalyticsBreakdownItemDto.cs

@@ -0,0 +1,21 @@
+using Newtonsoft.Json;
+
+namespace XtremeIdiots.Portal.Repository.Abstractions.Models.V1.Analytics;
+
+public record AnalyticsBreakdownItemDto : IDto
+{
+    [JsonProperty]
+    public string Key { get; internal set; } = string.Empty;
+
+    [JsonProperty]
+    public string Label { get; internal set; } = string.Empty;
+
+    [JsonProperty]
+    public int Count { get; internal set; }
+
+    [JsonProperty]
+    public double? Score { get; internal set; }
+
+    [JsonIgnore]
+    public Dictionary<string, string> TelemetryProperties => [];
+}

src/XtremeIdiots.Portal.Repository.Abstractions.V1/Models/V1/Analytics/AnalyticsSummaryMetricDto.cs

@@ -0,0 +1,18 @@
+using Newtonsoft.Json;
+
+namespace XtremeIdiots.Portal.Repository.Abstractions.Models.V1.Analytics;
+
+public record AnalyticsSummaryMetricDto : IDto
+{
+    [JsonProperty]
+    public string Name { get; internal set; } = string.Empty;
+
+    [JsonProperty]
+    public double Value { get; internal set; }
+
+    [JsonProperty]
+    public string? Unit { get; internal set; }
+
+    [JsonIgnore]
+    public Dictionary<string, string> TelemetryProperties => [];
+}