✨ Add reporting functionality with metrics and history queries

Author: Beelzenef

TaleEngine/TaleEngine.API.Contracts/Dtos/Requests/ReportingFilterRequest.cs

@@ -0,0 +1,13 @@
+using System;
+
+namespace TaleEngine.API.Contracts.Dtos.Requests
+{
+    public class ReportingFilterRequest
+    {
+        public int EditionId { get; set; }
+        public DateTime? DateFrom { get; set; }
+        public DateTime? DateTo { get; set; }
+        public int Page { get; set; } = 0;
+        public int PageSize { get; set; } = 20;
+    }
+}

TaleEngine/TaleEngine.API.Contracts/Dtos/Results/ActivityHistoryResult.cs

@@ -0,0 +1,16 @@
+using System;
+using System.Collections.Generic;
+
+namespace TaleEngine.API.Contracts.Dtos.Results
+{
+    public class ActivityHistoryResult
+    {
+        public int ActivityId { get; set; }
+        public string ActivityTitle { get; set; }
+        public DateTime? ActivityStartDate { get; set; }
+        public DateTime? ActivityEndDate { get; set; }
+        public DateTime? CreatedAt { get; set; }
+        public DateTime? LastModifiedAt { get; set; }
+        public List<ActivityHistoryUserEntryDto> Participants { get; set; }
+    }
+}

TaleEngine/TaleEngine.API.Contracts/Dtos/Results/ActivityHistoryUserEntryDto.cs

@@ -0,0 +1,9 @@
+namespace TaleEngine.API.Contracts.Dtos.Results
+{
+    public class ActivityHistoryUserEntryDto
+    {
+        public int UserId { get; set; }
+        public string Username { get; set; }
+        public string RelationType { get; set; }
+    }
+}

TaleEngine/TaleEngine.API.Contracts/Dtos/Results/ActivityReportMetricDto.cs

@@ -0,0 +1,13 @@
+namespace TaleEngine.API.Contracts.Dtos.Results
+{
+    public class ActivityReportMetricDto
+    {
+        public int ActivityId { get; set; }
+        public string Title { get; set; }
+        public int Places { get; set; }
+        public int EnrolledUsers { get; set; }
+        public int WaitingUsers { get; set; }
+        public int FavouriteUsers { get; set; }
+        public decimal OccupancyRate { get; set; }
+    }
+}

TaleEngine/TaleEngine.API.Contracts/Dtos/Results/DashboardMetricsResult.cs

@@ -0,0 +1,19 @@
+using System;
+using System.Collections.Generic;
+
+namespace TaleEngine.API.Contracts.Dtos.Results
+{
+    public class DashboardMetricsResult
+    {
+        public int EditionId { get; set; }
+        public DateTime? DateFrom { get; set; }
+        public DateTime? DateTo { get; set; }
+        public int TotalActivities { get; set; }
+        public int TotalEnrollments { get; set; }
+        public int TotalWaitingList { get; set; }
+        public int TotalFavourites { get; set; }
+        public decimal AverageOccupancyRate { get; set; }
+        public List<ActivityReportMetricDto> TopActivitiesByParticipation { get; set; }
+        public List<UserParticipationMetricDto> UserParticipation { get; set; }
+    }
+}

TaleEngine/TaleEngine.API.Contracts/Dtos/Results/ReportFileResult.cs

@@ -0,0 +1,9 @@
+namespace TaleEngine.API.Contracts.Dtos.Results
+{
+    public class ReportFileResult
+    {
+        public byte[] Content { get; set; }
+        public string ContentType { get; set; }
+        public string FileName { get; set; }
+    }
+}

TaleEngine/TaleEngine.API.Contracts/Dtos/Results/UserHistoryEntryDto.cs

@@ -0,0 +1,13 @@
+using System;
+
+namespace TaleEngine.API.Contracts.Dtos.Results
+{
+    public class UserHistoryEntryDto
+    {
+        public int ActivityId { get; set; }
+        public string ActivityTitle { get; set; }
+        public string RelationType { get; set; }
+        public DateTime? ActivityStartDate { get; set; }
+        public DateTime? ActivityEndDate { get; set; }
+    }
+}

TaleEngine/TaleEngine.API.Contracts/Dtos/Results/UserHistoryResult.cs

@@ -0,0 +1,15 @@
+using System;
+using System.Collections.Generic;
+
+namespace TaleEngine.API.Contracts.Dtos.Results
+{
+    public class UserHistoryResult
+    {
+        public int UserId { get; set; }
+        public string Username { get; set; }
+        public int EditionId { get; set; }
+        public DateTime? DateFrom { get; set; }
+        public DateTime? DateTo { get; set; }
+        public List<UserHistoryEntryDto> Entries { get; set; }
+    }
+}

TaleEngine/TaleEngine.API.Contracts/Dtos/Results/UserParticipationMetricDto.cs

@@ -0,0 +1,11 @@
+namespace TaleEngine.API.Contracts.Dtos.Results
+{
+    public class UserParticipationMetricDto
+    {
+        public int UserId { get; set; }
+        public string Username { get; set; }
+        public int EnrolledActivities { get; set; }
+        public int WaitingListActivities { get; set; }
+        public int FavouriteActivities { get; set; }
+    }
+}

TaleEngine/TaleEngine.Application.Contracts/IReportingService.cs

@@ -0,0 +1,14 @@
+using System.Collections.Generic;
+using TaleEngine.API.Contracts.Dtos.Requests;
+using TaleEngine.API.Contracts.Dtos.Results;
+
+namespace TaleEngine.Services.Contracts
+{
+    public interface IReportingService
+    {
+        DashboardMetricsResult GetDashboardMetrics(ReportingFilterRequest request);
+        List<ActivityHistoryResult> GetActivityHistory(ReportingFilterRequest request);
+        UserHistoryResult GetUserHistory(int userId, int editionId, System.DateTime? dateFrom = null, System.DateTime? dateTo = null);
+        ReportFileResult ExportDashboardExcel(ReportingFilterRequest request);
+    }
+}