feat: add tag discovery analytics and reporting

app/Http/Controllers/Admin/TagInteractionReportController.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Services\Analytics\TagInteractionReportService;
+use Illuminate\Contracts\View\View;
+use Illuminate\Http\Request;
+
+final class TagInteractionReportController extends Controller
+{
+    public function __construct(private readonly TagInteractionReportService $reportService) {}
+
+    public function index(Request $request): View
+    {
+        $validated = $request->validate([
+            'from' => ['nullable', 'date_format:Y-m-d'],
+            'to' => ['nullable', 'date_format:Y-m-d'],
+            'limit' => ['nullable', 'integer', 'min:1', 'max:100'],
+        ]);
+
+        $from = (string) ($validated['from'] ?? now()->subDays(13)->toDateString());
+        $to = (string) ($validated['to'] ?? now()->toDateString());
+        $limit = (int) ($validated['limit'] ?? 15);
+
+        abort_if($from > $to, 422, 'Invalid date range.');
+
+        $report = $this->reportService->buildReport($from, $to, $limit);
+
+        return view('admin.reports.tags', [
+            'filters' => [
+                'from' => $from,
+                'to' => $to,
+                'limit' => $limit,
+            ],
+            'overview' => $report['overview'],
+            'dailyClicks' => $report['daily_clicks'],
+            'bySurface' => $report['by_surface'],
+            'topTags' => $report['top_tags'],
+            'topQueries' => $report['top_queries'],
+            'topTransitions' => $report['top_transitions'],
+            'latestAggregatedDate' => $report['latest_aggregated_date'],
+        ]);
+    }
+}