feat: add tag discovery analytics and reporting

database/migrations/2026_03_16_000001_create_tag_interaction_events_table.php

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('tag_interaction_events', function (Blueprint $table): void {
+            $table->id();
+            $table->date('event_date')->index();
+            $table->string('event_type', 24)->index();
+            $table->string('surface', 32)->index();
+            $table->foreignId('user_id')->nullable()->constrained('users')->nullOnDelete();
+            $table->string('session_key', 64)->nullable()->index();
+            $table->string('tag_slug', 120)->nullable()->index();
+            $table->string('source_tag_slug', 120)->nullable()->index();
+            $table->string('query', 120)->nullable();
+            $table->unsignedSmallInteger('position')->nullable();
+            $table->json('meta')->nullable();
+            $table->timestamp('occurred_at')->nullable()->index();
+            $table->timestamps();
+
+            $table->index(['event_date', 'surface', 'event_type'], 'tag_interaction_events_daily_idx');
+            $table->index(['tag_slug', 'surface', 'event_date'], 'tag_interaction_events_tag_surface_idx');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('tag_interaction_events');
+    }
+};

database/migrations/2026_03_17_000001_create_tag_interaction_daily_metrics_table.php

@@ -0,0 +1,38 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('tag_interaction_daily_metrics', function (Blueprint $table): void {
+            $table->id();
+            $table->date('metric_date');
+            $table->string('surface', 32);
+            $table->string('tag_slug', 120)->default('');
+            $table->string('source_tag_slug', 120)->default('');
+            $table->string('query', 120)->default('');
+            $table->unsignedInteger('clicks')->default(0);
+            $table->unsignedInteger('unique_users')->default(0);
+            $table->unsignedInteger('unique_sessions')->default(0);
+            $table->decimal('avg_position', 8, 2)->default(0);
+            $table->timestamps();
+
+            $table->unique(
+                ['metric_date', 'surface', 'tag_slug', 'source_tag_slug', 'query'],
+                'tag_interaction_daily_metrics_unique_idx'
+            );
+            $table->index(['metric_date', 'surface'], 'tag_interaction_daily_metrics_surface_idx');
+            $table->index(['metric_date', 'tag_slug'], 'tag_interaction_daily_metrics_tag_idx');
+            $table->index(['metric_date', 'query'], 'tag_interaction_daily_metrics_query_idx');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('tag_interaction_daily_metrics');
+    }
+};