analytics and statistics

Webshop.Api/Controllers/Admin/AdminAnalyticsController.cs

@@ -0,0 +1,36 @@
+// src/Webshop.Api/Controllers/Admin/AdminAnalyticsController.cs
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using System.Threading.Tasks;
+using Webshop.Application.DTOs.Admin;
+using Webshop.Application.Services.Admin.Interfaces;
+
+namespace Webshop.Api.Controllers.Admin
+{
+    /// <summary>
+    /// Stellt aggregierte Analysedaten für das Admin-Dashboard bereit.
+    /// </summary>
+    [ApiController]
+    [Route("api/v1/admin/[controller]")]
+    [Authorize(Roles = "Admin")]
+    public class AdminAnalyticsController : ControllerBase
+    {
+        private readonly IAdminAnalyticsService _analyticsService;
+
+        public AdminAnalyticsController(IAdminAnalyticsService analyticsService)
+        {
+            _analyticsService = analyticsService;
+        }
+
+        /// <summary>
+        /// Ruft die aggregierten Analysedaten und KPIs für den Admin-Bereich ab.
+        /// </summary>
+        /// <param name="period">Der Zeitraum für die Statistiken (Last7Days, Last30Days, AllTime). Standard ist Last30Days.</param>
+        [HttpGet]
+        public async Task<ActionResult<AnalyticsDto>> GetAnalytics([FromQuery] AnalyticsPeriod period = AnalyticsPeriod.Last30Days)
+        {
+            var stats = await _analyticsService.GetAnalyticsAsync(period);
+            return Ok(stats);
+        }
+    }
+}