Add Transaction Summary by Operator report

EstateManagementUI.BlazorServer/Models/Models.cs

@@ -224,6 +224,18 @@ public class MerchantTransactionSummaryModel
     public int FailedTransactionCount { get; set; }
 }
 
+public class OperatorTransactionSummaryModel
+{
+    public Guid OperatorId { get; set; }
+    public string? OperatorName { get; set; }
+    public int TotalTransactionCount { get; set; }
+    public decimal TotalTransactionValue { get; set; }
+    public decimal AverageTransactionValue { get; set; }
+    public int SuccessfulTransactionCount { get; set; }
+    public int FailedTransactionCount { get; set; }
+    public decimal TotalFeesEarned { get; set; }
+}
+
 public class ProductPerformanceModel
 {
     public string? ProductName { get; set; }

EstateManagementUI.BlazorServer/Requests/Requests.cs

@@ -40,6 +40,7 @@ public record GetLastSettlementQuery(CorrelationId CorrelationId, string AccessT
     public record GetMerchantQuery(CorrelationId CorrelationId, string AccessToken, Guid EstateId, Guid MerchantId) : IRequest<Result<MerchantModel>>;
     public record GetMerchantTransactionSummaryQuery(CorrelationId CorrelationId, string AccessToken, Guid EstateId, DateTime StartDate, DateTime EndDate, Guid? MerchantId = null, Guid? OperatorId = null, Guid? ProductId = null) : IRequest<Result<List<MerchantTransactionSummaryModel>>>;
     public record GetProductPerformanceQuery(CorrelationId CorrelationId, string AccessToken, Guid EstateId, DateTime StartDate, DateTime EndDate) : IRequest<Result<List<ProductPerformanceModel>>>;
+    public record GetOperatorTransactionSummaryQuery(CorrelationId CorrelationId, string AccessToken, Guid EstateId, DateTime StartDate, DateTime EndDate, Guid? MerchantId = null, Guid? OperatorId = null) : IRequest<Result<List<OperatorTransactionSummaryModel>>>;
     public record GetMerchantSettlementHistoryQuery(CorrelationId CorrelationId, string AccessToken, Guid EstateId, Guid? MerchantId, DateTime StartDate, DateTime EndDate) : IRequest<Result<List<MerchantSettlementHistoryModel>>>;
 }
 

EstateManagementUI.BlazorServer/Services/TestMediatorService.cs

@@ -58,6 +58,7 @@
             Queries.GetLastSettlementQuery => Task.FromResult((TResponse)(object)Result<LastSettlementModel>.Success(GetMockLastSettlement())),
             Queries.GetMerchantTransactionSummaryQuery query => Task.FromResult((TResponse)(object)Result<List<MerchantTransactionSummaryModel>>.Success(GetMockMerchantTransactionSummary(query))),
             Queries.GetProductPerformanceQuery query => Task.FromResult((TResponse)(object)Result<List<ProductPerformanceModel>>.Success(GetMockProductPerformance(query))),
+            Queries.GetOperatorTransactionSummaryQuery query => Task.FromResult((TResponse)(object)Result<List<OperatorTransactionSummaryModel>>.Success(GetMockOperatorTransactionSummary(query))),
             Queries.GetMerchantSettlementHistoryQuery query => Task.FromResult((TResponse)(object)Result<List<MerchantSettlementHistoryModel>>.Success(GetMockMerchantSettlementHistory(query))),
 
             // Commands - execute against test data store
@@ -732,4 +733,41 @@
         // For now, we just return success
         return Result.Success();
     }
+
+    private List<OperatorTransactionSummaryModel> GetMockOperatorTransactionSummary(Queries.GetOperatorTransactionSummaryQuery query)
+    {
+        var operators = _testDataStore.GetOperators(query.EstateId);
+        var summary = new List<OperatorTransactionSummaryModel>();
+        var random = new Random(42); // Use seed for consistent test data
+
+        const decimal DefaultSuccessRate = 0.92m; // 92% success rate for mock data
+        const decimal DefaultFeePercentage = 0.015m; // 1.5% fee rate
+
+        foreach (var op in operators)
+        {
+            // Apply operator filter if specified
+            if (query.OperatorId.HasValue && op.OperatorId != query.OperatorId.Value)
+                continue;
+
+            var totalCount = random.Next(500, 5000);
+            var successfulCount = (int)(totalCount * DefaultSuccessRate);
+            var failedCount = totalCount - successfulCount;
+            var totalValue = (decimal)(random.NextDouble() * 500000 + 50000);
+            var totalFees = Math.Round(totalValue * DefaultFeePercentage, 2);
+
+            summary.Add(new OperatorTransactionSummaryModel
+            {
+                OperatorId = op.OperatorId,
+                OperatorName = op.Name,
+                TotalTransactionCount = totalCount,
+                TotalTransactionValue = Math.Round(totalValue, 2),
+                AverageTransactionValue = Math.Round(totalValue / totalCount, 2),
+                SuccessfulTransactionCount = successfulCount,
+                FailedTransactionCount = failedCount,
+                TotalFeesEarned = totalFees
+            });
+        }
+
+        return summary;
+    }
 }

EstateManagementUI.BusinessLogic/Models/OperatorTransactionSummaryModel.cs

@@ -0,0 +1,16 @@
+using System.Diagnostics.CodeAnalysis;
+
+namespace EstateManagementUI.BusinessLogic.Models;
+
+[ExcludeFromCodeCoverage]
+public class OperatorTransactionSummaryModel
+{
+    public Guid OperatorId { get; set; }
+    public string? OperatorName { get; set; }
+    public int TotalTransactionCount { get; set; }
+    public decimal TotalTransactionValue { get; set; }
+    public decimal AverageTransactionValue { get; set; }
+    public int SuccessfulTransactionCount { get; set; }
+    public int FailedTransactionCount { get; set; }
+    public decimal TotalFeesEarned { get; set; }
+}

EstateManagementUI.BusinessLogic/RequestHandlers/ReportingRequestHandler.cs

@@ -24,7 +24,8 @@
 IRequestHandler<GetBottomOperatorDataQuery, Result<List<TopBottomOperatorDataModel>>>,
 IRequestHandler<GetLastSettlementQuery, Result<LastSettlementModel>>,
 IRequestHandler<GetMerchantTransactionSummaryQuery, Result<List<MerchantTransactionSummaryModel>>>,
-IRequestHandler<GetProductPerformanceQuery, Result<List<ProductPerformanceModel>>> {
+IRequestHandler<GetProductPerformanceQuery, Result<List<ProductPerformanceModel>>>,
+IRequestHandler<GetOperatorTransactionSummaryQuery, Result<List<OperatorTransactionSummaryModel>>> {
 
     private readonly IApiClient ApiClient;
     public ReportingRequestHandler(IApiClient apiClient)
@@ -236,4 +237,47 @@
 
         return Result.Success(products);
     }
+
+    public async Task<Result<List<OperatorTransactionSummaryModel>>> Handle(GetOperatorTransactionSummaryQuery request,
+                                                                             CancellationToken cancellationToken) {
+        // TODO: Replace with actual API call when endpoint is available
+        // For now, return mock data for testing
+        var operators = await this.ApiClient.GetOperators(request.AccessToken, Guid.Empty, request.EstateId, cancellationToken);
+
+        if (!operators.IsSuccess) {
+            return Result.Failure<List<OperatorTransactionSummaryModel>>(operators.Message);
+        }
+
+        var summary = new List<OperatorTransactionSummaryModel>();
+        var random = new Random(42); // Use seed for consistent test data
+
+        const decimal DefaultSuccessRate = 0.92m; // 92% success rate for mock data
+        const decimal DefaultFeePercentage = 0.015m; // 1.5% fee rate
+
+        foreach (var op in operators.Data) {
+            var totalCount = random.Next(500, 5000);
+            var successfulCount = (int)(totalCount * DefaultSuccessRate);
+            var failedCount = totalCount - successfulCount;
+            var totalValue = (decimal)(random.NextDouble() * 500000 + 50000);
+            var totalFees = Math.Round(totalValue * DefaultFeePercentage, 2);
+
+            summary.Add(new OperatorTransactionSummaryModel {
+                OperatorId = op.Id,
+                OperatorName = op.Name,
+                TotalTransactionCount = totalCount,
+                TotalTransactionValue = Math.Round(totalValue, 2),
+                AverageTransactionValue = Math.Round(totalValue / totalCount, 2),
+                SuccessfulTransactionCount = successfulCount,
+                FailedTransactionCount = failedCount,
+                TotalFeesEarned = totalFees
+            });
+        }
+
+        // Apply filters if specified
+        if (request.OperatorId.HasValue) {
+            summary = summary.Where(s => s.OperatorId == request.OperatorId.Value).ToList();
+        }
+
+        return Result.Success(summary);
+    }
 }

EstateManagementUI.BusinessLogic/Requests/Queries.cs

@@ -72,5 +72,7 @@ public record GetMerchantQuery(CorrelationId CorrelationId, String AccessToken,
         public record GetMerchantTransactionSummaryQuery(CorrelationId CorrelationId, String AccessToken, Guid EstateId, DateTime StartDate, DateTime EndDate, Guid? MerchantId = null, Guid? OperatorId = null, Guid? ProductId = null) : IRequest<Result<List<MerchantTransactionSummaryModel>>>;
 
         public record GetProductPerformanceQuery(CorrelationId CorrelationId, String AccessToken, Guid EstateId, DateTime StartDate, DateTime EndDate) : IRequest<Result<List<ProductPerformanceModel>>>;
+
+        public record GetOperatorTransactionSummaryQuery(CorrelationId CorrelationId, String AccessToken, Guid EstateId, DateTime StartDate, DateTime EndDate, Guid? MerchantId = null, Guid? OperatorId = null) : IRequest<Result<List<OperatorTransactionSummaryModel>>>;
     }
 }