Optimize academy

.deploy/artwork-evolution-release/app/Http/Controllers/Web/SimilarArtworksPageController.php

@@ -102,7 +102,7 @@ final class SimilarArtworksPageController extends Controller
             'page_title'            => 'Similar to "' . $sourceTitle . '" — Skinbase',
             'page_meta_description' => 'Discover artworks similar to "' . $sourceTitle . '" on Skinbase.',
             'page_canonical'        => $baseUrl,
-            'page_robots'           => 'noindex,follow',
+            'page_robots'           => 'index,follow',
             'breadcrumbs'           => collect([
                 (object) ['name' => 'Explore',           'url' => '/explore'],
                 (object) ['name' => $sourceTitle,        'url' => $sourceUrl],

.env.example

@@ -210,6 +210,25 @@ YOLO_HTTP_RETRIES=1
 YOLO_HTTP_RETRY_DELAY_MS=200
 YOLO_PHOTOGRAPHY_ONLY=true
 
+# Academy feature flags
+SKINBASE_ACADEMY_ENABLED=true
+SKINBASE_ACADEMY_PAYMENTS_ENABLED=false
+ACADEMY_BILLING_ENABLED=false
+ACADEMY_STRIPE_SUBSCRIPTION_NAME=academy
+
+# Stripe / Cashier
+STRIPE_KEY=pk_test_xxx
+STRIPE_SECRET=sk_test_xxx
+STRIPE_WEBHOOK_SECRET=whsec_xxx
+CASHIER_CURRENCY=eur
+CASHIER_CURRENCY_LOCALE=sl_SI
+
+# Academy billing price IDs
+ACADEMY_CREATOR_MONTHLY_PRICE_ID=price_xxx
+ACADEMY_PRO_MONTHLY_PRICE_ID=price_xxx
+
+# Stripe expects real price object IDs that start with price_, not product IDs like prod_...
+
 # -----------------------------------------------------------------------------
 # Production examples (uncomment and adjust)
 # -----------------------------------------------------------------------------
@@ -310,6 +329,30 @@ TURNSTILE_FAIL_OPEN=false
 TURNSTILE_VERIFY_URL=https://challenges.cloudflare.com/turnstile/v0/siteverify
 TURNSTILE_TIMEOUT=5
 
+ENHANCE_DISK=public
+ENHANCE_SOURCE_PREFIX=enhance/sources
+ENHANCE_OUTPUT_PREFIX=enhance/outputs
+ENHANCE_PREVIEW_PREFIX=enhance/previews
+ENHANCE_ENGINE=stub
+ENHANCE_MAX_UPLOAD_MB=20
+ENHANCE_MAX_INPUT_WIDTH=4096
+ENHANCE_MAX_INPUT_HEIGHT=4096
+ENHANCE_MAX_OUTPUT_WIDTH=8192
+ENHANCE_MAX_OUTPUT_HEIGHT=8192
+ENHANCE_DAILY_LIMIT=10
+ENHANCE_QUEUE=default
+ENHANCE_COMPLETED_EXPIRES_AFTER_DAYS=30
+ENHANCE_FAILED_EXPIRES_AFTER_DAYS=7
+ENHANCE_DELETED_FILE_GRACE_DAYS=1
+ENHANCE_CLEANUP_CHUNK_SIZE=100
+ENHANCE_STUCK_PROCESSING_AFTER_MINUTES=30
+ENHANCE_STUCK_QUEUED_AFTER_MINUTES=60
+ENHANCE_STUB_SHOW_WARNING=true
+ENHANCE_WORKER_URL=
+ENHANCE_WORKER_TIMEOUT=300
+ENHANCE_WORKER_TOKEN=
+ENHANCE_WORKER_MAX_DOWNLOAD_MB=60
+
 AWS_ACCESS_KEY_ID=
 AWS_SECRET_ACCESS_KEY=
 AWS_DEFAULT_REGION=us-east-1
@@ -356,6 +399,12 @@ GOOGLE_CLIENT_ID=
 GOOGLE_CLIENT_SECRET=
 GOOGLE_REDIRECT_URI=/auth/google/callback
 
+# Optional light theme feature
+# Set LIGHT_THEME_ENABLED=true to allow a light theme in the client-side toggle.
+# Set LIGHT_THEME_SHOW_SWITCH=true to display the theme switch in the toolbar.
+LIGHT_THEME_ENABLED=false
+LIGHT_THEME_SHOW_SWITCH=false
+
 # Discord — https://discord.com/developers/applications
 DISCORD_CLIENT_ID=
 DISCORD_CLIENT_SECRET=

app/Console/Commands/AcademyAnalyticsHealthCommand.php

@@ -0,0 +1,183 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Models\AcademyContentMetricDaily;
+use App\Models\AcademyEvent;
+use App\Models\AcademyLike;
+use App\Models\AcademySave;
+use App\Models\AcademySearchLog;
+use App\Models\AcademyUserProgress;
+use App\Support\AcademyAnalytics\AcademyAnalyticsEventType;
+use Illuminate\Console\Command;
+use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\Schema;
+
+final class AcademyAnalyticsHealthCommand extends Command
+{
+    protected $signature = 'academy:analytics-health {--json : Output machine-readable JSON}';
+
+    protected $description = 'Inspect Academy analytics collection health, rollup freshness, and privacy safeguards';
+
+    private const RETENTION_DAYS = 180;
+
+    public function handle(): int
+    {
+        $report = $this->buildReport();
+
+        if ((bool) $this->option('json')) {
+            $this->line(json_encode($report, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) ?: '{}');
+
+            return self::SUCCESS;
+        }
+
+        $this->line('Academy Analytics Health Check');
+        $this->line('==============================');
+        $this->newLine();
+        $this->line(sprintf('Events last 24h: %d', $report['events_last_24h']));
+        $this->line(sprintf('Events last 7d: %d', $report['events_last_7d']));
+        $this->line(sprintf('Latest event: %s', $report['latest_event_at'] ?? 'none'));
+        $this->line(sprintf('Latest rollup date: %s', $report['latest_rollup_date'] ?? 'none'));
+        $this->line(sprintf('Search logs: %d', $report['search_logs']));
+        $this->line(sprintf('Search clicks: %d', $report['search_clicks']));
+        $this->line(sprintf('Likes: %d', $report['likes']));
+        $this->line(sprintf('Saves: %d', $report['saves']));
+        $this->line(sprintf('Progress records: %d', $report['progress_records']));
+        $this->line(sprintf('Prompt copies: %d', $report['prompt_copies']));
+        $this->line(sprintf('Upgrade clicks: %d', $report['upgrade_clicks']));
+        $this->line(sprintf('Human events: %d', $report['human_events']));
+        $this->line(sprintf('Bot/admin events: %d', $report['bot_admin_events']));
+        $this->line(sprintf('Recent daily metric rows: %d', $report['recent_daily_metric_rows']));
+        $this->line(sprintf('Raw IP storage detected: %s', $report['raw_ip_storage_detected'] ? 'yes' : 'no'));
+        $this->line(sprintf('Events older than retention: %d', $report['events_older_than_retention']));
+        $this->newLine();
+
+        foreach ($report['warnings'] as $warning) {
+            $this->warn(sprintf('WARNING: %s', $warning));
+        }
+
+        $this->info(sprintf('Status: %s', $report['status']));
+
+        return self::SUCCESS;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function buildReport(): array
+    {
+        $now = now();
+        $last24Hours = $now->copy()->subDay();
+        $last7Days = $now->copy()->subDays(7);
+        $retentionCutoff = $now->copy()->subDays(self::RETENTION_DAYS);
+        $warnings = [];
+        $rawIpStorageDetected = $this->rawIpStorageDetected();
+        $eventsTableExists = Schema::hasTable('academy_events');
+        $metricsTableExists = Schema::hasTable('academy_content_metrics_daily');
+        $searchLogsTableExists = Schema::hasTable('academy_search_logs');
+        $likesTableExists = Schema::hasTable('academy_likes');
+        $savesTableExists = Schema::hasTable('academy_saves');
+        $progressTableExists = Schema::hasTable('academy_user_progress');
+
+        $latestEvent = $eventsTableExists ? AcademyEvent::query()->latest('occurred_at')->value('occurred_at') : null;
+        $latestRollup = $metricsTableExists ? AcademyContentMetricDaily::query()->latest('date')->value('date') : null;
+        $searchLogCount = $searchLogsTableExists ? AcademySearchLog::query()->count() : 0;
+        $searchClickCount = $searchLogsTableExists ? AcademySearchLog::query()->whereNotNull('clicked_content_id')->count() : 0;
+        $eventsOlderThanRetention = $eventsTableExists ? AcademyEvent::query()->where('occurred_at', '<', $retentionCutoff)->count() : 0;
+        $recentDailyMetricRows = $metricsTableExists
+            ? AcademyContentMetricDaily::query()->whereBetween('date', [$now->copy()->subDays(6)->toDateString(), $now->toDateString()])->count()
+            : 0;
+
+        $report = [
+            'events_last_24h' => $eventsTableExists ? AcademyEvent::query()->where('occurred_at', '>=', $last24Hours)->count() : 0,
+            'events_last_7d' => $eventsTableExists ? AcademyEvent::query()->where('occurred_at', '>=', $last7Days)->count() : 0,
+            'latest_event_at' => $latestEvent ? Carbon::parse((string) $latestEvent)->toDateTimeString() : null,
+            'latest_rollup_date' => $latestRollup ? Carbon::parse((string) $latestRollup)->toDateString() : null,
+            'search_logs' => $searchLogCount,
+            'search_clicks' => $searchClickCount,
+            'likes' => $likesTableExists ? AcademyLike::query()->count() : 0,
+            'saves' => $savesTableExists ? AcademySave::query()->count() : 0,
+            'progress_records' => $progressTableExists ? AcademyUserProgress::query()->count() : 0,
+            'prompt_copies' => $eventsTableExists ? AcademyEvent::query()->where('event_type', AcademyAnalyticsEventType::PROMPT_COPY)->count() : 0,
+            'upgrade_clicks' => $eventsTableExists ? AcademyEvent::query()->where('event_type', AcademyAnalyticsEventType::UPGRADE_CLICK)->count() : 0,
+            'human_events' => $eventsTableExists ? AcademyEvent::query()->where('is_bot', false)->where('is_admin', false)->where('is_suspicious', false)->count() : 0,
+            'bot_admin_events' => $eventsTableExists ? AcademyEvent::query()->where(function ($query): void {
+                $query->where('is_bot', true)->orWhere('is_admin', true)->orWhere('is_suspicious', true);
+            })->count() : 0,
+            'raw_ip_storage_detected' => $rawIpStorageDetected,
+            'events_older_than_retention' => $eventsOlderThanRetention,
+            'recent_daily_metric_rows' => $recentDailyMetricRows,
+            'retention_days' => self::RETENTION_DAYS,
+            'tables_present' => [
+                'academy_events' => $eventsTableExists,
+                'academy_content_metrics_daily' => $metricsTableExists,
+                'academy_search_logs' => $searchLogsTableExists,
+                'academy_likes' => $likesTableExists,
+                'academy_saves' => $savesTableExists,
+                'academy_user_progress' => $progressTableExists,
+            ],
+            'warnings' => [],
+            'status' => 'OK',
+        ];
+
+        foreach ($report['tables_present'] as $table => $present) {
+            if (! $present) {
+                $warnings[] = sprintf('Analytics table %s is missing.', $table);
+            }
+        }
+
+        if ($report['events_last_24h'] === 0) {
+            $warnings[] = 'No events received in last 24 hours.';
+        }
+
+        if ($report['events_last_7d'] === 0) {
+            $warnings[] = 'No events received in last 7 days.';
+        }
+
+        if ($report['latest_rollup_date'] === null) {
+            $warnings[] = 'No rollup rows exist yet.';
+        } elseif ($report['latest_rollup_date'] !== $now->toDateString()) {
+            $warnings[] = 'Rollup has not run for today.';
+        }
+
+        if ($searchLogCount > 0 && $searchClickCount === 0) {
+            $warnings[] = 'Search clicks are zero although search logs exist.';
+        }
+
+        if ($eventsOlderThanRetention > 0) {
+            $warnings[] = 'Raw events older than configured retention period exist.';
+        }
+
+        if ($recentDailyMetricRows === 0) {
+            $warnings[] = 'No daily metrics exist for recent days.';
+        }
+
+        if ($rawIpStorageDetected) {
+            $warnings[] = 'Raw IP storage indicators were found in Academy analytics tables.';
+        }
+
+        $report['warnings'] = $warnings;
+        $report['status'] = $warnings === [] ? 'OK' : 'WARNING';
+
+        return $report;
+    }
+
+    private function rawIpStorageDetected(): bool
+    {
+        foreach (['academy_events', 'academy_search_logs', 'academy_content_metrics_daily', 'academy_likes', 'academy_saves', 'academy_user_progress'] as $table) {
+            if (! Schema::hasTable($table)) {
+                continue;
+            }
+
+            foreach (['ip', 'ip_address', 'visitor_ip', 'raw_ip', 'remote_addr'] as $column) {
+                if (Schema::hasColumn($table, $column)) {
+                    return true;
+                }
+            }
+        }
+
+        return false;
+    }
+}

app/Console/Commands/AcademyAnalyticsPruneEventsCommand.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Models\AcademyEvent;
+use Illuminate\Console\Command;
+
+final class AcademyAnalyticsPruneEventsCommand extends Command
+{
+    protected $signature = 'academy:analytics-prune-events {--days=180}';
+
+    protected $description = 'Delete old raw Academy analytics events while keeping daily rollups';
+
+    public function handle(): int
+    {
+        $days = max(1, (int) $this->option('days'));
+        $deleted = AcademyEvent::query()
+            ->where('occurred_at', '<', now()->subDays($days)->startOfDay())
+            ->delete();
+
+        $this->info(sprintf('Pruned %d Academy analytics event(s).', $deleted));
+
+        return self::SUCCESS;
+    }
+}

app/Console/Commands/AcademyAnalyticsRecalculatePopularityCommand.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Models\AcademyContentMetricDaily;
+use App\Services\Academy\AcademyPopularityService;
+use Illuminate\Console\Command;
+
+final class AcademyAnalyticsRecalculatePopularityCommand extends Command
+{
+    protected $signature = 'academy:analytics-recalculate-popularity {--days=30}';
+
+    protected $description = 'Recalculate Academy daily popularity and conversion scores';
+
+    public function __construct(private readonly AcademyPopularityService $popularity)
+    {
+        parent::__construct();
+    }
+
+    public function handle(): int
+    {
+        $days = max(1, (int) $this->option('days'));
+
+        AcademyContentMetricDaily::query()
+            ->where('date', '>=', now()->subDays($days - 1)->toDateString())
+            ->chunkById(500, function ($rows): void {
+                foreach ($rows as $row) {
+                    $row->forceFill([
+                        'popularity_score' => $this->popularity->calculatePopularityScore($row->toArray()),
+                        'conversion_score' => $this->popularity->calculateConversionScore($row->toArray()),
+                    ])->save();
+                }
+            });
+
+        $this->info(sprintf('Recalculated Academy popularity for the last %d day(s).', $days));
+
+        return self::SUCCESS;
+    }
+}

app/Console/Commands/AcademyAnalyticsRollupCommand.php

@@ -0,0 +1,258 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Models\AcademyContentMetricDaily;
+use App\Models\AcademyEvent;
+use App\Models\AcademyLike;
+use App\Models\AcademySave;
+use App\Models\AcademySearchLog;
+use App\Services\Academy\AcademyPopularityService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
+use Carbon\CarbonPeriod;
+use Illuminate\Console\Command;
+use Illuminate\Support\Carbon;
+
+final class AcademyAnalyticsRollupCommand extends Command
+{
+    protected $signature = 'academy:analytics-rollup {--date=} {--from=} {--to=}';
+
+    protected $description = 'Aggregate Academy analytics raw events and interaction records into daily content metrics';
+
+    public function __construct(private readonly AcademyPopularityService $popularity)
+    {
+        parent::__construct();
+    }
+
+    public function handle(): int
+    {
+        [$from, $to] = $this->resolveRange();
+
+        foreach (CarbonPeriod::create($from, $to) as $date) {
+            $this->rollupDate(Carbon::parse($date));
+            $this->line(sprintf('Rolled up Academy analytics for %s.', Carbon::parse($date)->toDateString()));
+        }
+
+        return self::SUCCESS;
+    }
+
+    private function rollupDate(Carbon $date): void
+    {
+        $start = $date->copy()->startOfDay();
+        $end = $date->copy()->endOfDay();
+        $metrics = [];
+        $uniqueVisitors = [];
+        $engagedDurations = [];
+
+        AcademyEvent::query()
+            ->whereBetween('occurred_at', [$start, $end])
+            ->orderBy('id')
+            ->chunkById(1000, function ($events) use (&$metrics, &$uniqueVisitors, &$engagedDurations): void {
+                foreach ($events as $event) {
+                    if ($event->is_bot || $event->is_admin || $event->is_suspicious) {
+                        continue;
+                    }
+
+                    $key = $this->metricKey((string) ($event->content_type ?? ''), $event->content_id ? (int) $event->content_id : null);
+                    $this->ensureMetric($metrics, (string) ($event->content_type ?? ''), $event->content_id ? (int) $event->content_id : null, $key);
+
+                    $visitorKey = $event->user_id ? sprintf('user:%d', (int) $event->user_id) : trim((string) ($event->visitor_id ?? ''));
+                    if ($visitorKey !== '') {
+                        $uniqueVisitors[$key][$visitorKey] = true;
+                    }
+
+                    $eventType = (string) $event->event_type;
+                    if (in_array($eventType, ['academy_page_view', 'academy_content_view', 'academy_lesson_view', 'academy_course_view', 'academy_prompt_pack_view', 'academy_challenge_view'], true)) {
+                        $metrics[$key]['views']++;
+                        if ($event->is_logged_in) {
+                            $metrics[$key]['user_views']++;
+                        } else {
+                            $metrics[$key]['guest_views']++;
+                        }
+                        if ($event->is_subscriber) {
+                            $metrics[$key]['subscriber_views']++;
+                        }
+                    }
+
+                    if ($eventType === 'academy_engaged_view') {
+                        $metrics[$key]['engaged_views']++;
+                        $engagedDurations[$key][] = max(0, (int) ($event->metadata['engaged_seconds'] ?? 15));
+                    }
+
+                    if ($eventType === 'academy_scroll_50') {
+                        $metrics[$key]['scroll_50']++;
+                    }
+                    if ($eventType === 'academy_scroll_75') {
+                        $metrics[$key]['scroll_75']++;
+                    }
+                    if ($eventType === 'academy_scroll_100') {
+                        $metrics[$key]['scroll_100']++;
+                    }
+                    if ($eventType === 'academy_prompt_copy') {
+                        $metrics[$key]['prompt_copies']++;
+                    }
+                    if ($eventType === 'academy_prompt_negative_copy') {
+                        $metrics[$key]['negative_prompt_copies']++;
+                    }
+                    if (in_array($eventType, ['academy_lesson_started', 'academy_course_started', 'academy_challenge_started'], true)) {
+                        $metrics[$key]['starts']++;
+                    }
+                    if (in_array($eventType, ['academy_lesson_completed', 'academy_course_completed', 'academy_challenge_submitted'], true)) {
+                        $metrics[$key]['completions']++;
+                    }
+                    if ($eventType === 'academy_upgrade_click') {
+                        $metrics[$key]['upgrade_clicks']++;
+                    }
+                    if ($eventType === 'academy_premium_preview_view') {
+                        $metrics[$key]['premium_preview_views']++;
+                    }
+                    if ($eventType === 'academy_search_result_click') {
+                        $metrics[$key]['search_clicks']++;
+
+                        $searchKey = $this->metricKey(AcademyAnalyticsContentType::SEARCH, null);
+                        $this->ensureMetric($metrics, AcademyAnalyticsContentType::SEARCH, null, $searchKey);
+                        $metrics[$searchKey]['search_clicks']++;
+                    }
+                }
+            });
+
+        foreach (AcademyLike::query()->whereBetween('created_at', [$start, $end])->get() as $like) {
+            $key = $this->metricKey((string) $like->content_type, (int) $like->content_id);
+            $this->ensureMetric($metrics, (string) $like->content_type, (int) $like->content_id, $key);
+            $metrics[$key]['likes']++;
+        }
+
+        foreach (AcademySave::query()->whereBetween('created_at', [$start, $end])->get() as $save) {
+            $key = $this->metricKey((string) $save->content_type, (int) $save->content_id);
+            $this->ensureMetric($metrics, (string) $save->content_type, (int) $save->content_id, $key);
+            $metrics[$key]['saves']++;
+        }
+
+        foreach (AcademySearchLog::query()->whereBetween('created_at', [$start, $end])->get() as $searchLog) {
+            $key = $this->metricKey(AcademyAnalyticsContentType::SEARCH, null);
+            $this->ensureMetric($metrics, AcademyAnalyticsContentType::SEARCH, null, $key);
+            $metrics[$key]['search_impressions']++;
+            if ((int) $searchLog->results_count === 0) {
+                $metrics[$key]['bounce_count']++;
+            }
+
+            $visitorKey = $searchLog->user_id ? sprintf('user:%d', (int) $searchLog->user_id) : trim((string) ($searchLog->visitor_id ?? ''));
+            if ($visitorKey !== '') {
+                $uniqueVisitors[$key][$visitorKey] = true;
+            }
+        }
+
+        foreach ($metrics as $key => $metric) {
+            $metric['unique_visitors'] = isset($uniqueVisitors[$key]) ? count($uniqueVisitors[$key]) : 0;
+            $metric['avg_engaged_seconds'] = isset($engagedDurations[$key]) && $engagedDurations[$key] !== []
+                ? (int) round(array_sum($engagedDurations[$key]) / count($engagedDurations[$key]))
+                : null;
+            $metric['bounce_count'] = max((int) ($metric['bounce_count'] ?? 0), max(0, (int) $metric['views'] - (int) $metric['engaged_views']));
+            $metric['popularity_score'] = $this->popularity->calculatePopularityScore($metric);
+            $metric['conversion_score'] = $this->popularity->calculateConversionScore($metric);
+
+            AcademyContentMetricDaily::query()->upsert([
+                array_merge($metric, [
+                    'date' => $date->copy()->startOfDay(),
+                    'created_at' => now(),
+                    'updated_at' => now(),
+                ]),
+            ], ['date', 'content_type', 'content_id'], [
+                'views',
+                'unique_visitors',
+                'guest_views',
+                'user_views',
+                'subscriber_views',
+                'engaged_views',
+                'scroll_50',
+                'scroll_75',
+                'scroll_100',
+                'likes',
+                'saves',
+                'prompt_copies',
+                'negative_prompt_copies',
+                'starts',
+                'completions',
+                'upgrade_clicks',
+                'premium_preview_views',
+                'search_impressions',
+                'search_clicks',
+                'bounce_count',
+                'avg_engaged_seconds',
+                'popularity_score',
+                'conversion_score',
+                'updated_at',
+            ]);
+        }
+    }
+
+    /**
+     * @param  array<string, array<string, mixed>>  $metrics
+     */
+    private function ensureMetric(array &$metrics, string $contentType, ?int $contentId, string $key): void
+    {
+        if (isset($metrics[$key])) {
+            return;
+        }
+
+        $metrics[$key] = [
+            'content_type' => $contentType,
+            'content_id' => $contentId,
+            'views' => 0,
+            'unique_visitors' => 0,
+            'guest_views' => 0,
+            'user_views' => 0,
+            'subscriber_views' => 0,
+            'engaged_views' => 0,
+            'scroll_50' => 0,
+            'scroll_75' => 0,
+            'scroll_100' => 0,
+            'likes' => 0,
+            'saves' => 0,
+            'prompt_copies' => 0,
+            'negative_prompt_copies' => 0,
+            'starts' => 0,
+            'completions' => 0,
+            'upgrade_clicks' => 0,
+            'premium_preview_views' => 0,
+            'search_impressions' => 0,
+            'search_clicks' => 0,
+            'bounce_count' => 0,
+            'avg_engaged_seconds' => null,
+            'popularity_score' => 0,
+            'conversion_score' => 0,
+        ];
+    }
+
+    private function metricKey(string $contentType, ?int $contentId): string
+    {
+        return sprintf('%s:%s', $contentType, $contentId ?? 'none');
+    }
+
+    /**
+     * @return array{0: Carbon, 1: Carbon}
+     */
+    private function resolveRange(): array
+    {
+        $date = $this->option('date');
+        $from = $this->option('from');
+        $to = $this->option('to');
+
+        if (is_string($date) && trim($date) !== '') {
+            $resolved = Carbon::parse($date)->startOfDay();
+
+            return [$resolved, $resolved->copy()];
+        }
+
+        $resolvedFrom = is_string($from) && trim($from) !== ''
+            ? Carbon::parse($from)->startOfDay()
+            : now()->subDay()->startOfDay();
+        $resolvedTo = is_string($to) && trim($to) !== ''
+            ? Carbon::parse($to)->startOfDay()
+            : $resolvedFrom->copy();
+
+        return [$resolvedFrom, $resolvedTo];
+    }
+}

app/Console/Commands/AcademyBillingHealthCommand.php

@@ -0,0 +1,305 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Services\Academy\AcademyBillingPlanService;
+use Illuminate\Console\Command;
+use Illuminate\Support\Arr;
+use Illuminate\Support\Facades\Route;
+use Illuminate\Support\Facades\Schema;
+
+final class AcademyBillingHealthCommand extends Command
+{
+    protected $signature = 'academy:billing-health
+        {--json : Output machine-readable JSON}
+        {--strict : Exit non-zero when blocking issues are found}';
+
+    protected $description = 'Inspect Academy Stripe billing deployment readiness, config completeness, and Cashier route wiring';
+
+    public function __construct(
+        private readonly AcademyBillingPlanService $plans,
+    ) {
+        parent::__construct();
+    }
+
+    public function handle(): int
+    {
+        $report = $this->buildReport();
+
+        if ((bool) $this->option('json')) {
+            $this->line((string) json_encode($report, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
+
+            return $this->exitCodeFor($report);
+        }
+
+        $this->line('Academy Billing Health Check');
+        $this->line('============================');
+        $this->newLine();
+        $this->line(sprintf('Environment: %s', $report['environment']));
+        $this->line(sprintf('App URL: %s', $report['app_url'] ?? 'unset'));
+        $this->line(sprintf('Academy enabled: %s', $report['academy_enabled'] ? 'yes' : 'no'));
+        $this->line(sprintf('Academy billing enabled: %s', $report['academy_billing_enabled'] ? 'yes' : 'no'));
+        $this->line(sprintf('Subscription name: %s', $report['subscription_name']));
+        $this->line(sprintf('Cashier path: %s', $report['cashier_path']));
+        $this->line(sprintf('Cashier webhook route: %s', $report['routes']['cashier_webhook']['present'] ? ($report['routes']['cashier_webhook']['url'] ?? 'present') : 'missing'));
+        $this->line(sprintf('Academy pricing route: %s', $report['routes']['academy_pricing']['present'] ? ($report['routes']['academy_pricing']['url'] ?? 'present') : 'missing'));
+        $this->line(sprintf('Academy billing account route: %s', $report['routes']['academy_billing_account']['present'] ? ($report['routes']['academy_billing_account']['url'] ?? 'present') : 'missing'));
+        $this->line(sprintf('Stripe key configured: %s', $report['stripe']['publishable_key_configured'] ? 'yes' : 'no'));
+        $this->line(sprintf('Stripe secret configured: %s', $report['stripe']['secret_key_configured'] ? 'yes' : 'no'));
+        $this->line(sprintf('Webhook secret configured: %s', $report['stripe']['webhook_secret_configured'] ? 'yes' : 'no'));
+        $this->line(sprintf('Cashier currency: %s', $report['stripe']['currency'] ?: 'unset'));
+        $this->line(sprintf('Cashier locale: %s', $report['stripe']['currency_locale'] ?: 'unset'));
+        $this->line(sprintf('Configured plans: %d', $report['configured_plan_count']));
+        $this->line(sprintf('Plans missing Stripe price IDs: %d', count($report['missing_plan_keys'])));
+        $this->line(sprintf('Billing tables present: %s', $report['tables']['subscriptions'] && $report['tables']['subscription_items'] && $report['tables']['academy_billing_events'] ? 'yes' : 'no'));
+        $this->line(sprintf('User billing columns present: %s', $report['users_billing_columns_present'] ? 'yes' : 'no'));
+        $this->newLine();
+
+        foreach ($report['blockers'] as $blocker) {
+            $this->error(sprintf('BLOCKER: %s', $blocker));
+        }
+
+        foreach ($report['warnings'] as $warning) {
+            $this->warn(sprintf('WARNING: %s', $warning));
+        }
+
+        if ($report['plan_summaries'] !== []) {
+            $this->newLine();
+            $this->line('Plans');
+            $this->line('-----');
+
+            foreach ($report['plan_summaries'] as $plan) {
+                $this->line(sprintf(
+                    '%s: tier=%s interval=%s price_id=%s',
+                    $plan['key'],
+                    $plan['tier'],
+                    $plan['interval'],
+                    $plan['configured'] ? 'configured' : 'missing'
+                ));
+            }
+        }
+
+        $this->newLine();
+        $this->info(sprintf('Status: %s', $report['status']));
+
+        return $this->exitCodeFor($report);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function buildReport(): array
+    {
+        $stripeKey = $this->configuredString(config('cashier.key'));
+        $stripeSecret = $this->firstConfiguredString(config('cashier.secret'), env('STRIPE_SECRET'));
+        $webhookSecret = $this->firstConfiguredString(config('cashier.webhook.secret'), env('STRIPE_WEBHOOK_SECRET'));
+        $currency = trim((string) config('cashier.currency', env('CASHIER_CURRENCY', '')));
+        $currencyLocale = trim((string) config('cashier.currency_locale', env('CASHIER_CURRENCY_LOCALE', '')));
+        $academyEnabled = (bool) config('academy.enabled', true);
+        $billingEnabled = $this->plans->enabled();
+        $missingPlanKeys = $this->plans->missingPriceIds();
+        $routes = [
+            'cashier_webhook' => $this->routeStatus('cashier.webhook'),
+            'academy_pricing' => $this->routeStatus('academy.pricing'),
+            'academy_billing_account' => $this->routeStatus('academy.billing.account'),
+            'academy_billing_portal' => $this->routeStatus('academy.billing.portal'),
+            'admin_academy_billing' => $this->routeStatus('admin.academy.billing'),
+        ];
+        $tables = [
+            'users' => Schema::hasTable('users'),
+            'subscriptions' => Schema::hasTable('subscriptions'),
+            'subscription_items' => Schema::hasTable('subscription_items'),
+            'academy_billing_events' => Schema::hasTable('academy_billing_events'),
+        ];
+        $userBillingColumns = [
+            'stripe_id' => $tables['users'] && Schema::hasColumn('users', 'stripe_id'),
+            'pm_type' => $tables['users'] && Schema::hasColumn('users', 'pm_type'),
+            'pm_last_four' => $tables['users'] && Schema::hasColumn('users', 'pm_last_four'),
+            'trial_ends_at' => $tables['users'] && Schema::hasColumn('users', 'trial_ends_at'),
+        ];
+        $planSummaries = collect(array_keys($this->plans->plans()))
+            ->map(function (string $key): array {
+                $plan = $this->plans->plan($key);
+
+                return [
+                    'key' => $key,
+                    'tier' => (string) ($plan['tier'] ?? 'free'),
+                    'interval' => (string) ($plan['interval'] ?? 'monthly'),
+                    'configured' => (bool) ($plan['configured'] ?? false),
+                ];
+            })
+            ->values()
+            ->all();
+
+        $blockers = [];
+        $warnings = [];
+
+        if (! $academyEnabled) {
+            $warnings[] = 'SKINBASE_ACADEMY_ENABLED is disabled, so billing cannot be reached by users.';
+        }
+
+        if (! $billingEnabled) {
+            $warnings[] = 'ACADEMY_BILLING_ENABLED is disabled. Checkout routes will stay unavailable until rollout is enabled.';
+        }
+
+        if (! $this->isConfiguredSecret($stripeKey, 'pk_')) {
+            $blockers[] = 'STRIPE_KEY is missing or still using a placeholder value.';
+        }
+
+        if (! $this->isConfiguredSecret($stripeSecret, 'sk_')) {
+            $blockers[] = 'STRIPE_SECRET is missing or still using a placeholder value.';
+        }
+
+        if (! $this->isConfiguredSecret($webhookSecret, 'whsec_')) {
+            $blockers[] = 'STRIPE_WEBHOOK_SECRET is missing or still using a placeholder value.';
+        }
+
+        if ($currency === '') {
+            $blockers[] = 'CASHIER_CURRENCY is not configured.';
+        }
+
+        if ($currencyLocale === '') {
+            $warnings[] = 'CASHIER_CURRENCY_LOCALE is not configured.';
+        }
+
+        if ($missingPlanKeys !== []) {
+            $blockers[] = 'Stripe price IDs are missing for: '.implode(', ', $missingPlanKeys).'.';
+        }
+
+        if (! $routes['cashier_webhook']['present']) {
+            $blockers[] = 'Cashier webhook route is missing; Stripe cannot sync subscriptions.';
+        }
+
+        if (! $routes['academy_pricing']['present']) {
+            $blockers[] = 'Academy pricing route is missing.';
+        }
+
+        if (! $routes['academy_billing_account']['present']) {
+            $blockers[] = 'Academy billing account route is missing.';
+        }
+
+        foreach ($tables as $table => $present) {
+            if (! $present) {
+                $blockers[] = sprintf('Required billing table %s is missing.', $table);
+            }
+        }
+
+        foreach ($userBillingColumns as $column => $present) {
+            if (! $present) {
+                $blockers[] = sprintf('Required users.%s billing column is missing.', $column);
+            }
+        }
+
+        if (! $routes['admin_academy_billing']['present']) {
+            $warnings[] = 'Moderation Academy billing overview route is missing.';
+        }
+
+        if (Arr::where($planSummaries, fn (array $plan): bool => $plan['configured'] === false) === []) {
+            $warnings[] = 'All configured Academy plans have Stripe price IDs. Verify they are live-mode IDs before production rollout.';
+        }
+
+        $invalidPlanKeys = collect(array_keys($this->plans->plans()))
+            ->filter(function (string $key): bool {
+                $plan = $this->plans->plan($key);
+
+                return $plan !== null && ($plan['configured'] ?? false) && ! ($plan['price_id_valid'] ?? false);
+            })
+            ->values()
+            ->all();
+
+        if ($invalidPlanKeys !== []) {
+            $blockers[] = 'Stripe price IDs are malformed for: '.implode(', ', $invalidPlanKeys).'. Use real price object IDs that start with price_.';
+        }
+
+        $status = $blockers !== []
+            ? 'BLOCKED'
+            : ($warnings !== [] ? 'WARNING' : 'OK');
+
+        return [
+            'environment' => app()->environment(),
+            'app_url' => config('app.url'),
+            'academy_enabled' => $academyEnabled,
+            'academy_billing_enabled' => $billingEnabled,
+            'subscription_name' => $this->plans->subscriptionName(),
+            'cashier_path' => (string) config('cashier.path', 'stripe'),
+            'stripe' => [
+                'publishable_key_configured' => $this->isConfiguredSecret($stripeKey, 'pk_'),
+                'secret_key_configured' => $this->isConfiguredSecret($stripeSecret, 'sk_'),
+                'webhook_secret_configured' => $this->isConfiguredSecret($webhookSecret, 'whsec_'),
+                'currency' => $currency,
+                'currency_locale' => $currencyLocale,
+            ],
+            'configured_plan_count' => count($planSummaries),
+            'missing_plan_keys' => $missingPlanKeys,
+            'invalid_plan_keys' => $invalidPlanKeys,
+            'plan_summaries' => $planSummaries,
+            'routes' => $routes,
+            'tables' => $tables,
+            'user_billing_columns' => $userBillingColumns,
+            'users_billing_columns_present' => ! in_array(false, $userBillingColumns, true),
+            'blockers' => array_values(array_unique($blockers)),
+            'warnings' => array_values(array_unique($warnings)),
+            'status' => $status,
+        ];
+    }
+
+    /**
+     * @return array{present: bool, url: string|null}
+     */
+    private function routeStatus(string $name): array
+    {
+        if (! Route::has($name)) {
+            return [
+                'present' => false,
+                'url' => null,
+            ];
+        }
+
+        return [
+            'present' => true,
+            'url' => route($name),
+        ];
+    }
+
+    private function isConfiguredSecret(string $value, string $expectedPrefix): bool
+    {
+        $value = trim($value);
+
+        if ($value === '' || ! str_starts_with($value, $expectedPrefix)) {
+            return false;
+        }
+
+        return ! str_contains(strtolower($value), 'xxx');
+    }
+
+    /**
+     * @param array<string, mixed> $report
+     */
+    private function exitCodeFor(array $report): int
+    {
+        if ((bool) $this->option('strict') && $report['status'] === 'BLOCKED') {
+            return self::FAILURE;
+        }
+
+        return self::SUCCESS;
+    }
+    private function firstConfiguredString(mixed ...$values): string
+    {
+        foreach ($values as $value) {
+            $value = $this->configuredString($value);
+
+            if ($value !== '') {
+                return $value;
+            }
+        }
+
+        return '';
+    }
+
+    private function configuredString(mixed $value): string
+    {
+        return is_string($value) ? trim($value) : '';
+    }
+}

app/Console/Commands/AcademyCoursesSyncFoundationsCommand.php

@@ -0,0 +1,122 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Models\AcademyCourse;
+use App\Models\AcademyCourseLesson;
+use App\Models\AcademyCourseSection;
+use App\Models\AcademyLesson;
+use App\Services\Academy\AcademyCacheService;
+use Illuminate\Console\Command;
+use Illuminate\Support\Str;
+
+final class AcademyCoursesSyncFoundationsCommand extends Command
+{
+    protected $signature = 'academy:courses:sync-foundations';
+
+    protected $description = 'Create or update the default AI-Assisted Digital Art Foundations Academy course.';
+
+    public function __construct(private readonly AcademyCacheService $cache)
+    {
+        parent::__construct();
+    }
+
+    public function handle(): int
+    {
+        $course = AcademyCourse::query()->updateOrCreate(
+            ['slug' => 'ai-assisted-digital-art-foundations'],
+            [
+                'title' => 'AI-Assisted Digital Art Foundations',
+                'subtitle' => 'A guided path through prompting, publishing, and better Skinbase-ready workflows.',
+                'excerpt' => 'Learn the foundations of AI-assisted digital art, from better prompts and ethical rules to preparing, tagging, and publishing artwork on Skinbase.',
+                'description' => 'A starter course for Skinbase creators who want a structured path from core AI-art concepts to cleaner publishing-ready results.',
+                'access_level' => 'free',
+                'difficulty' => 'beginner',
+                'status' => 'published',
+                'is_featured' => true,
+                'order_num' => 1,
+                'published_at' => now(),
+            ],
+        );
+
+        $sectionOrder = [
+            'Introduction',
+            'Prompting Basics',
+            'Publishing on Skinbase',
+            'Workflow and Quality',
+        ];
+
+        $sections = collect($sectionOrder)->mapWithKeys(function (string $title, int $index) use ($course): array {
+            $section = AcademyCourseSection::query()->updateOrCreate(
+                ['course_id' => $course->id, 'slug' => Str::slug($title)],
+                [
+                    'title' => $title,
+                    'order_num' => $index,
+                    'is_visible' => true,
+                ],
+            );
+
+            return [$title => $section];
+        });
+
+        $lessonMap = [
+            'Introduction' => [
+                'what-is-ai-assisted-digital-art',
+                'ai-ethics-and-skinbase-upload-rules',
+                'ai-generated-vs-ai-assisted-artwork',
+            ],
+            'Prompting Basics' => [
+                'prompting-basics-for-skinbase-creators',
+                'how-to-write-better-wallpaper-prompts',
+                'understanding-style-mood-lighting-and-composition',
+            ],
+            'Publishing on Skinbase' => [
+                'how-to-prepare-ai-artwork-for-upload',
+                'how-to-choose-better-tags-and-categories',
+            ],
+            'Workflow and Quality' => [
+                'how-to-avoid-common-ai-image-problems',
+                'from-idea-to-artwork-a-simple-skinbase-workflow',
+            ],
+        ];
+
+        $orderNum = 0;
+        foreach ($lessonMap as $sectionTitle => $slugs) {
+            $section = $sections->get($sectionTitle);
+
+            foreach ($slugs as $slug) {
+                $lesson = AcademyLesson::query()->where('slug', $slug)->first();
+
+                if (! $lesson instanceof AcademyLesson) {
+                    $this->warn(sprintf('Skipped missing lesson [%s].', $slug));
+                    continue;
+                }
+
+                AcademyCourseLesson::query()->updateOrCreate(
+                    [
+                        'course_id' => $course->id,
+                        'lesson_id' => $lesson->id,
+                    ],
+                    [
+                        'section_id' => $section?->id,
+                        'order_num' => $orderNum,
+                        'is_required' => true,
+                    ],
+                );
+
+                $orderNum++;
+            }
+        }
+
+        $course->forceFill([
+            'lessons_count_cache' => AcademyCourseLesson::query()->where('course_id', $course->id)->count(),
+        ])->save();
+
+        $this->cache->clearAll();
+        $this->info('AI-Assisted Digital Art Foundations course synced.');
+
+        return self::SUCCESS;
+    }
+}

app/Console/Commands/BuildWorldWebStoryAssetsCommand.php

@@ -0,0 +1,103 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Models\WorldWebStory;
+use App\Services\WebStories\WorldWebStoryAssetService;
+use Illuminate\Console\Command;
+
+final class BuildWorldWebStoryAssetsCommand extends Command
+{
+    protected $signature = 'skinbase:webstories:build-assets
+        {story? : Story ID or slug}
+        {--published : Limit batch mode to published stories}
+        {--visible : Limit batch mode to stories currently visible on the public site}
+        {--limit=100 : Maximum stories to process in batch mode}
+        {--force : Rebuild already populated asset paths}
+        {--dry-run : Report changes without saving them}';
+
+    protected $description = 'Backfill poster, logo, and page background assets for World Web Stories';
+
+    public function handle(WorldWebStoryAssetService $assets): int
+    {
+        $storyKey = $this->argument('story');
+        $force = (bool) $this->option('force');
+        $dryRun = (bool) $this->option('dry-run');
+
+        if ($storyKey !== null && trim((string) $storyKey) !== '') {
+            $story = $this->resolveStory((string) $storyKey);
+
+            if (! $story instanceof WorldWebStory) {
+                $this->error(sprintf('Web story [%s] was not found.', (string) $storyKey));
+
+                return self::FAILURE;
+            }
+
+            return $this->buildOne($assets, $story, $force, $dryRun);
+        }
+
+        return $this->buildBatch($assets, $force, $dryRun, max(1, (int) $this->option('limit')));
+    }
+
+    private function buildOne(WorldWebStoryAssetService $assets, WorldWebStory $story, bool $force, bool $dryRun): int
+    {
+        $result = $assets->buildAssets($story, force: $force, dryRun: $dryRun);
+
+        $this->line(sprintf('Story [%d] %s', (int) $story->id, (string) $story->slug));
+        $this->line($result['updated'] ? 'Assets updated.' : 'No asset changes needed.');
+
+        foreach ((array) $result['story'] as $field => $value) {
+            $this->line(sprintf(' - story.%s = %s', (string) $field, (string) $value));
+        }
+
+        foreach ((array) $result['pages'] as $pageId => $changes) {
+            foreach ((array) $changes as $field => $value) {
+                $this->line(sprintf(' - page.%d.%s = %s', (int) $pageId, (string) $field, (string) $value));
+            }
+        }
+
+        return self::SUCCESS;
+    }
+
+    private function buildBatch(WorldWebStoryAssetService $assets, bool $force, bool $dryRun, int $limit): int
+    {
+        $processed = 0;
+        $updated = 0;
+
+        $this->storyQuery()
+            ->limit($limit)
+            ->get()
+            ->each(function (WorldWebStory $story) use ($assets, $force, $dryRun, &$processed, &$updated): void {
+                $processed++;
+                $result = $assets->buildAssets($story, force: $force, dryRun: $dryRun);
+
+                if ($result['updated']) {
+                    $updated++;
+                }
+
+                $this->line(sprintf('[%d] %s -> %s', (int) $story->id, (string) $story->slug, $result['updated'] ? 'updated' : 'unchanged'));
+            });
+
+        $this->info(sprintf('Done. processed=%d updated=%d', $processed, $updated));
+
+        return self::SUCCESS;
+    }
+
+    private function storyQuery()
+    {
+        return WorldWebStory::query()
+            ->when((bool) $this->option('published'), fn ($query) => $query->published())
+            ->when((bool) $this->option('visible'), fn ($query) => $query->visible())
+            ->orderByDesc('published_at')
+            ->orderByDesc('id');
+    }
+
+    private function resolveStory(string $value): ?WorldWebStory
+    {
+        return WorldWebStory::query()
+            ->when(is_numeric($value), fn ($query) => $query->where('id', (int) $value), fn ($query) => $query->where('slug', $value))
+            ->first();
+    }
+}

app/Console/Commands/Enhance/CleanupEnhanceJobsCommand.php

@@ -0,0 +1,290 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands\Enhance;
+
+use App\Models\EnhanceJob;
+use App\Services\Enhance\EnhanceStorageService;
+use Illuminate\Console\Command;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Facades\Storage;
+use Throwable;
+
+final class CleanupEnhanceJobsCommand extends Command
+{
+    protected $signature = 'enhance:cleanup
+        {--dry-run : Preview cleanup actions only}
+        {--force : Delete files and update records}
+        {--only= : Restrict cleanup to expired, deleted, failed, or orphaned}
+        {--days= : Override retention days for failed or deleted cleanup}';
+
+    protected $description = 'Safely clean expired, deleted, failed, and orphaned Enhance files.';
+
+    public function __construct(
+        private readonly EnhanceStorageService $storage,
+    ) {
+        parent::__construct();
+    }
+
+    public function handle(): int
+    {
+        $target = strtolower(trim((string) $this->option('only')));
+        $validTargets = ['', 'expired', 'deleted', 'failed', 'orphaned'];
+
+        if (! in_array($target, $validTargets, true)) {
+            $this->error('The --only option must be one of: expired, deleted, failed, orphaned.');
+
+            return self::FAILURE;
+        }
+
+        if ((bool) $this->option('dry-run') && (bool) $this->option('force')) {
+            $this->error('Use either --dry-run or --force, not both.');
+
+            return self::FAILURE;
+        }
+
+        $dryRun = (bool) $this->option('dry-run') || ! (bool) $this->option('force');
+        $daysOverride = $this->option('days');
+        $selectedTarget = $target !== '' ? $target : 'all';
+
+        Log::info('enhance.cleanup.started', [
+            'dry_run' => $dryRun,
+            'target' => $selectedTarget,
+            'days_override' => $daysOverride,
+        ]);
+
+        if ($dryRun) {
+            $this->warn('Running in dry-run mode. No files will be deleted.');
+        }
+
+        $rows = [];
+
+        if ($target === '' || $target === 'expired') {
+            $expired = $this->cleanupExpiredCompletedJobs($dryRun);
+            $rows[] = ['expired', $expired['jobs'], $expired['files'], $dryRun ? 'dry-run' : 'cleaned'];
+        }
+
+        if ($target === '' || $target === 'failed') {
+            $failed = $this->cleanupFailedJobs($dryRun, $daysOverride);
+            $rows[] = ['failed', $failed['jobs'], $failed['files'], $dryRun ? 'dry-run' : 'cleaned'];
+        }
+
+        if ($target === '' || $target === 'deleted') {
+            $deleted = $this->cleanupSoftDeletedJobs($dryRun, $daysOverride);
+            $rows[] = ['deleted', $deleted['jobs'], $deleted['files'], $dryRun ? 'dry-run' : 'cleaned'];
+        }
+
+        if ($target === 'orphaned') {
+            $orphaned = $this->scanOrphanedFiles($dryRun);
+            $rows[] = ['orphaned', $orphaned['files'], $orphaned['deleted'], $dryRun ? 'dry-run' : 'deleted'];
+
+            if ($orphaned['unsupported']) {
+                $this->warn('Orphaned file scan was skipped because the configured disk does not support safe listing.');
+            }
+
+            foreach ($orphaned['sample'] as $path) {
+                $this->line(' - ' . $path);
+            }
+        }
+
+        if ($rows !== []) {
+            $this->table(['Target', 'Jobs/Files', 'Files deleted', 'Mode'], $rows);
+        }
+
+        Log::info('enhance.cleanup.completed', [
+            'dry_run' => $dryRun,
+            'target' => $selectedTarget,
+            'rows' => $rows,
+        ]);
+
+        $this->info('Enhance cleanup finished.');
+
+        return self::SUCCESS;
+    }
+
+    private function cleanupExpiredCompletedJobs(bool $dryRun): array
+    {
+        $query = EnhanceJob::query()
+            ->where('status', EnhanceJob::STATUS_COMPLETED)
+            ->whereNotNull('expires_at')
+            ->where('expires_at', '<=', now());
+
+        return $this->cleanupJobs($query, $dryRun, 'expired', fn (): array => [
+            'status' => EnhanceJob::STATUS_EXPIRED,
+        ]);
+    }
+
+    private function cleanupFailedJobs(bool $dryRun, mixed $daysOverride): array
+    {
+        $days = $this->resolveDays($daysOverride, (int) config('enhance.lifecycle.failed_expires_after_days', 7));
+        $cutoff = now()->subDays($days);
+
+        $query = EnhanceJob::query()
+            ->where('status', EnhanceJob::STATUS_FAILED)
+            ->where(function (Builder $builder) use ($cutoff): void {
+                $builder
+                    ->where('finished_at', '<=', $cutoff)
+                    ->orWhere(function (Builder $fallback) use ($cutoff): void {
+                        $fallback->whereNull('finished_at')->where('created_at', '<=', $cutoff);
+                    });
+            });
+
+        return $this->cleanupJobs($query, $dryRun, 'failed-expired');
+    }
+
+    private function cleanupSoftDeletedJobs(bool $dryRun, mixed $daysOverride): array
+    {
+        $days = $this->resolveDays($daysOverride, (int) config('enhance.lifecycle.deleted_file_grace_days', 1));
+        $cutoff = now()->subDays($days);
+
+        $query = EnhanceJob::withTrashed()
+            ->whereNotNull('deleted_at')
+            ->where('deleted_at', '<=', $cutoff);
+
+        return $this->cleanupJobs($query, $dryRun, 'deleted-grace');
+    }
+
+    private function cleanupJobs(Builder $query, bool $dryRun, string $reason, ?callable $attributes = null): array
+    {
+        $result = ['jobs' => 0, 'files' => 0];
+        $chunkSize = max(1, (int) config('enhance.lifecycle.cleanup_chunk_size', 100));
+
+        $query->chunkById($chunkSize, function ($jobs) use (&$result, $dryRun, $reason, $attributes): void {
+            foreach ($jobs as $job) {
+                $result['jobs']++;
+                $result['files'] += count($this->enhanceJobPaths($job));
+
+                if ($dryRun) {
+                    continue;
+                }
+
+                $deleteResult = $this->storage->deleteFilesForJob($job);
+                $metadata = is_array($job->metadata) ? $job->metadata : [];
+
+                $job->forceFill(array_merge(
+                    $this->cleanupAttributesForJob($job),
+                    $attributes ? $attributes($job) : [],
+                    [
+                        'metadata' => array_merge($metadata, [
+                            'cleanup' => [
+                                'files_removed_at' => now()->toIso8601String(),
+                                'reason' => $reason,
+                                'deleted' => $deleteResult['deleted'],
+                            ],
+                        ]),
+                    ],
+                ))->save();
+            }
+        });
+
+        return $result;
+    }
+
+    private function scanOrphanedFiles(bool $dryRun): array
+    {
+        $disk = $this->storage->diskName();
+        $knownPaths = array_fill_keys(array_map(
+            static fn (string $path): string => ltrim($path, '/'),
+            $this->storage->listKnownJobPaths(),
+        ), true);
+        $sample = [];
+        $result = [
+            'files' => 0,
+            'deleted' => 0,
+            'unsupported' => false,
+            'sample' => [],
+        ];
+
+        foreach ($this->enhancePrefixes() as $prefix) {
+            try {
+                $files = Storage::disk($disk)->allFiles($prefix);
+            } catch (Throwable) {
+                $result['unsupported'] = true;
+
+                return $result;
+            }
+
+            foreach ($files as $file) {
+                $normalized = ltrim($file, '/');
+
+                if (isset($knownPaths[$normalized])) {
+                    continue;
+                }
+
+                $result['files']++;
+
+                if (count($sample) < 20) {
+                    $sample[] = $normalized;
+                }
+
+                if (! $dryRun && $this->storage->safeDelete($disk, $normalized)) {
+                    $result['deleted']++;
+                }
+            }
+        }
+
+        $result['sample'] = $sample;
+
+        return $result;
+    }
+
+    private function cleanupAttributesForJob(EnhanceJob $job): array
+    {
+        $attributes = [];
+
+        if ($this->storage->isEnhancePath($job->source_path)) {
+            $attributes['source_disk'] = null;
+            $attributes['source_path'] = null;
+            $attributes['source_hash'] = null;
+        }
+
+        if ($this->storage->isEnhancePath($job->output_path)) {
+            $attributes['output_disk'] = null;
+            $attributes['output_path'] = null;
+            $attributes['output_hash'] = null;
+            $attributes['output_width'] = null;
+            $attributes['output_height'] = null;
+            $attributes['output_filesize'] = null;
+            $attributes['output_mime'] = null;
+        }
+
+        if ($this->storage->isEnhancePath($job->preview_path)) {
+            $attributes['preview_disk'] = null;
+            $attributes['preview_path'] = null;
+        }
+
+        return $attributes;
+    }
+
+    private function enhanceJobPaths(EnhanceJob $job): array
+    {
+        return array_values(array_filter([
+            $this->storage->isEnhancePath($job->source_path) ? trim((string) $job->source_path) : null,
+            $this->storage->isEnhancePath($job->output_path) ? trim((string) $job->output_path) : null,
+            $this->storage->isEnhancePath($job->preview_path) ? trim((string) $job->preview_path) : null,
+        ]));
+    }
+
+    private function enhancePrefixes(): array
+    {
+        return array_values(array_filter(array_unique(array_map(
+            static fn (string $prefix): string => trim($prefix, '/'),
+            [
+                (string) config('enhance.source_prefix', 'enhance/sources'),
+                (string) config('enhance.output_prefix', 'enhance/outputs'),
+                (string) config('enhance.preview_prefix', 'enhance/previews'),
+            ],
+        ))));
+    }
+
+    private function resolveDays(mixed $daysOverride, int $default): int
+    {
+        if ($daysOverride === null || $daysOverride === '') {
+            return max(0, $default);
+        }
+
+        return max(0, (int) $daysOverride);
+    }
+}

app/Console/Commands/Enhance/EnhanceHealthCommand.php

@@ -0,0 +1,108 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands\Enhance;
+
+use App\Models\EnhanceJob;
+use Illuminate\Console\Command;
+
+final class EnhanceHealthCommand extends Command
+{
+    protected $signature = 'enhance:health {--json : Output machine-readable JSON}';
+
+    protected $description = 'Report operational health and lifecycle metrics for Enhance jobs.';
+
+    public function handle(): int
+    {
+        $payload = $this->payload();
+
+        if ((bool) $this->option('json')) {
+            $this->line(json_encode($payload, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
+
+            return self::SUCCESS;
+        }
+
+        $this->info('Enhance health');
+        $this->newLine();
+
+        $this->table(['Metric', 'Value'], [
+            ['Configured engine', $payload['engine']],
+            ['Configured queue', $payload['queue']],
+            ['Worker URL configured', $payload['worker_configured'] ? 'yes' : 'no'],
+            ['Storage disk', $payload['storage_disk']],
+            ['Total jobs', $payload['counts']['total']],
+            ['Pending jobs', $payload['counts']['pending']],
+            ['Queued jobs', $payload['counts']['queued']],
+            ['Processing jobs', $payload['counts']['processing']],
+            ['Completed jobs', $payload['counts']['completed']],
+            ['Failed jobs', $payload['counts']['failed']],
+            ['Cancelled jobs', $payload['counts']['cancelled']],
+            ['Expired jobs', $payload['counts']['expired']],
+            ['Stuck queued jobs', $payload['health']['stuck_queued']],
+            ['Stuck processing jobs', $payload['health']['stuck_processing']],
+            ['Jobs created today', $payload['today']['created']],
+            ['Jobs completed today', $payload['today']['completed']],
+            ['Jobs failed today', $payload['today']['failed']],
+            ['Average processing time today', $payload['today']['average_processing_seconds'] ?? '—'],
+        ]);
+
+        return self::SUCCESS;
+    }
+
+    private function payload(): array
+    {
+        $todayStart = now()->startOfDay();
+        $todayEnd = now()->endOfDay();
+        $stuckQueuedCutoff = now()->subMinutes((int) config('enhance.health.stuck_queued_after_minutes', 60));
+        $stuckProcessingCutoff = now()->subMinutes((int) config('enhance.health.stuck_processing_after_minutes', 30));
+
+        $counts = [
+            'total' => EnhanceJob::query()->count(),
+            'pending' => EnhanceJob::query()->where('status', EnhanceJob::STATUS_PENDING)->count(),
+            'queued' => EnhanceJob::query()->where('status', EnhanceJob::STATUS_QUEUED)->count(),
+            'processing' => EnhanceJob::query()->where('status', EnhanceJob::STATUS_PROCESSING)->count(),
+            'completed' => EnhanceJob::query()->where('status', EnhanceJob::STATUS_COMPLETED)->count(),
+            'failed' => EnhanceJob::query()->where('status', EnhanceJob::STATUS_FAILED)->count(),
+            'cancelled' => EnhanceJob::query()->where('status', EnhanceJob::STATUS_CANCELLED)->count(),
+            'expired' => EnhanceJob::query()->where('status', EnhanceJob::STATUS_EXPIRED)->count(),
+        ];
+
+        return [
+            'engine' => (string) config('enhance.default_engine', EnhanceJob::ENGINE_STUB),
+            'queue' => (string) config('enhance.queue', 'default'),
+            'worker_configured' => trim((string) config('enhance.external_worker.url', '')) !== '',
+            'storage_disk' => (string) config('enhance.disk', 'public'),
+            'counts' => $counts,
+            'health' => [
+                'stuck_queued' => EnhanceJob::query()
+                    ->where('status', EnhanceJob::STATUS_QUEUED)
+                    ->whereNotNull('queued_at')
+                    ->where('queued_at', '<=', $stuckQueuedCutoff)
+                    ->count(),
+                'stuck_processing' => EnhanceJob::query()
+                    ->where('status', EnhanceJob::STATUS_PROCESSING)
+                    ->whereNotNull('started_at')
+                    ->where('started_at', '<=', $stuckProcessingCutoff)
+                    ->count(),
+            ],
+            'today' => [
+                'created' => EnhanceJob::query()->whereBetween('created_at', [$todayStart, $todayEnd])->count(),
+                'completed' => EnhanceJob::query()
+                    ->where('status', EnhanceJob::STATUS_COMPLETED)
+                    ->whereBetween('finished_at', [$todayStart, $todayEnd])
+                    ->count(),
+                'failed' => EnhanceJob::query()
+                    ->where('status', EnhanceJob::STATUS_FAILED)
+                    ->whereBetween('finished_at', [$todayStart, $todayEnd])
+                    ->count(),
+                'average_processing_seconds' => ($average = EnhanceJob::query()
+                    ->whereNotNull('processing_seconds')
+                    ->whereBetween('finished_at', [$todayStart, $todayEnd])
+                    ->avg('processing_seconds')) !== null
+                    ? round((float) $average, 2)
+                    : null,
+            ],
+        ];
+    }
+}

app/Console/Commands/Enhance/EnhanceRunCommand.php

@@ -0,0 +1,290 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands\Enhance;
+
+use App\Models\EnhanceJob;
+use App\Services\Enhance\EnhanceProcessorFactory;
+use App\Services\Enhance\EnhanceStorageService;
+use Illuminate\Console\Command;
+use Illuminate\Database\Eloquent\Collection;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Str;
+use Throwable;
+
+final class EnhanceRunCommand extends Command
+{
+    protected $signature = 'enhance:run
+        {--id= : Process specific job ID(s), comma-separated}
+        {--limit=1 : Max pending/queued jobs to pick up from the queue (0 = all)}
+        {--engine= : Override the processing engine for this run (stub, external_worker)}
+        {--failed : Also include failed jobs when scanning the queue}
+        {--dry-run : Show what would be processed without executing}';
+
+    protected $description = 'Synchronously process pending enhance jobs inline — useful for debugging with -v / -vv / -vvv.';
+
+    private const PROCESSABLE_STATUSES = [
+        EnhanceJob::STATUS_PENDING,
+        EnhanceJob::STATUS_QUEUED,
+        EnhanceJob::STATUS_PROCESSING,
+        EnhanceJob::STATUS_FAILED,
+    ];
+
+    public function __construct(
+        private readonly EnhanceProcessorFactory $processorFactory,
+        private readonly EnhanceStorageService $storage,
+    ) {
+        parent::__construct();
+    }
+
+    public function handle(): int
+    {
+        $dryRun = (bool) $this->option('dry-run');
+        $engineOverride = trim((string) $this->option('engine'));
+        $idOption = trim((string) $this->option('id'));
+        $limit = max(0, (int) $this->option('limit'));
+        $includeFailed = (bool) $this->option('failed');
+
+        if ($engineOverride !== '' && ! in_array($engineOverride, [EnhanceJob::ENGINE_STUB, EnhanceJob::ENGINE_EXTERNAL_WORKER], true)) {
+            $this->error("Unknown engine override: {$engineOverride}. Use 'stub' or 'external_worker'.");
+
+            return self::FAILURE;
+        }
+
+        $jobs = $this->resolveJobs($idOption, $limit, $includeFailed);
+
+        if ($jobs->isEmpty()) {
+            $this->info('No eligible enhance jobs found.');
+
+            return self::SUCCESS;
+        }
+
+        $this->info(sprintf('Found %d job(s) to process.', $jobs->count()));
+        $this->newLine();
+
+        if ($dryRun) {
+            $this->warn('Dry-run mode — no jobs will be processed.');
+
+            foreach ($jobs as $job) {
+                $engine = $engineOverride !== '' ? "{$engineOverride} (overridden)" : $job->engine;
+                $this->line(sprintf(
+                    '  [dry-run] Job #%d  status=%-12s engine=%-18s scale=%dx  mode=%-14s user_id=%d',
+                    $job->id,
+                    $job->status,
+                    $engine,
+                    $job->scale,
+                    $job->mode,
+                    $job->user_id,
+                ));
+            }
+
+            return self::SUCCESS;
+        }
+
+        $processed = 0;
+        $failed = 0;
+
+        foreach ($jobs as $job) {
+            if ($this->processJob($job, $engineOverride)) {
+                $processed++;
+            } else {
+                $failed++;
+            }
+
+            $this->newLine();
+        }
+
+        $this->info(sprintf('Done: %d completed, %d failed.', $processed, $failed));
+
+        return $failed > 0 ? self::FAILURE : self::SUCCESS;
+    }
+
+    private function resolveJobs(string $idOption, int $limit, bool $includeFailed): Collection
+    {
+        if ($idOption !== '') {
+            $ids = array_filter(array_map('intval', explode(',', $idOption)));
+
+            return EnhanceJob::query()
+                ->whereIn('id', $ids)
+                ->whereIn('status', self::PROCESSABLE_STATUSES)
+                ->get();
+        }
+
+        $statuses = [EnhanceJob::STATUS_PENDING, EnhanceJob::STATUS_QUEUED, EnhanceJob::STATUS_PROCESSING];
+
+        if ($includeFailed) {
+            $statuses[] = EnhanceJob::STATUS_FAILED;
+        }
+
+        $query = EnhanceJob::query()->whereIn('status', $statuses)->oldest();
+
+        if ($limit > 0) {
+            $query->limit($limit);
+        }
+
+        return $query->get();
+    }
+
+    private function processJob(EnhanceJob $job, string $engineOverride): bool
+    {
+        $engine = $engineOverride !== '' ? $engineOverride : (string) $job->engine;
+
+        $this->line(sprintf('<comment>--- Job #%d ---</comment>', $job->id));
+        $this->line(sprintf('  Status  : %s', $job->status));
+        $this->line(sprintf('  Engine  : %s%s', $engine, $engineOverride !== '' ? ' (overridden)' : ''));
+        $this->line(sprintf('  Scale   : %dx', $job->scale));
+        $this->line(sprintf('  Mode    : %s', $job->mode));
+        $this->line(sprintf('  User    : #%d', $job->user_id));
+
+        if ($this->output->isVerbose()) {
+            $this->line(sprintf(
+                '  Source  : disk=%-10s path=%s',
+                $job->source_disk ?: '(default)',
+                $job->source_path ?: '—',
+            ));
+            $this->line(sprintf(
+                '  Input   : %dx%d  size=%s  mime=%s',
+                (int) $job->input_width,
+                (int) $job->input_height,
+                $this->formatBytes((int) $job->input_filesize),
+                $job->input_mime ?: '—',
+            ));
+
+            if ($job->error_message !== null) {
+                $this->warn(sprintf('  Previous error: %s', $job->error_message));
+            }
+        }
+
+        if (! in_array($job->status, self::PROCESSABLE_STATUSES, true)) {
+            $this->warn(sprintf('  Skipping: status "%s" is not processable.', $job->status));
+
+            return false;
+        }
+
+        $job->forceFill([
+            'status' => EnhanceJob::STATUS_PROCESSING,
+            'started_at' => now(),
+            'finished_at' => null,
+            'error_message' => null,
+        ])->save();
+
+        $started = microtime(true);
+        $completedExpiryDays = (int) config('enhance.lifecycle.completed_expires_after_days', 30);
+
+        try {
+            $this->line('  Processing...');
+
+            $processor = $this->processorFactory->make($engine);
+            $result = $processor->process($job);
+
+            if ($this->output->isVerbose()) {
+                $this->line(sprintf(
+                    '  Output  : %dx%d  size=%s  mime=%s',
+                    $result->width,
+                    $result->height,
+                    $this->formatBytes($result->filesize),
+                    $result->mime,
+                ));
+                $this->line(sprintf(
+                    '  Stored  : disk=%-10s path=%s',
+                    $result->disk,
+                    $result->path,
+                ));
+            }
+
+            $this->line('  Generating preview...');
+            $preview = $this->storage->createPreviewFromStoredOutput($job, $result->disk, $result->path) ?? [];
+
+            $outputHash = null;
+            $outputContents = Storage::disk($result->disk)->get($result->path);
+
+            if (is_string($outputContents) && $outputContents !== '') {
+                $outputHash = hash('sha256', $outputContents);
+            }
+
+            $job->forceFill([
+                'status' => EnhanceJob::STATUS_COMPLETED,
+                'output_disk' => $result->disk,
+                'output_path' => $result->path,
+                'output_hash' => $outputHash,
+                'output_width' => $result->width,
+                'output_height' => $result->height,
+                'output_filesize' => $result->filesize,
+                'output_mime' => $result->mime,
+                'metadata' => array_merge($job->metadata ?? [], $result->metadata ?? []),
+                'processing_seconds' => (int) round(microtime(true) - $started),
+                'finished_at' => now(),
+                'expires_at' => $completedExpiryDays > 0 ? now()->addDays($completedExpiryDays) : null,
+            ] + $preview)->save();
+
+            $elapsed = round(microtime(true) - $started, 2);
+            $this->info(sprintf('  Completed in %.2fs', $elapsed));
+
+            if ($this->output->isVerbose() && ! empty($result->metadata)) {
+                $this->line('  Metadata:');
+
+                foreach ($result->metadata as $key => $value) {
+                    $display = is_scalar($value) ? (string) $value : json_encode($value);
+                    $this->line(sprintf('    %-30s %s', $key . ':', $display));
+                }
+            }
+
+            return true;
+        } catch (Throwable $exception) {
+            $elapsed = round(microtime(true) - $started, 2);
+
+            $job->forceFill([
+                'status' => EnhanceJob::STATUS_FAILED,
+                'error_message' => Str::limit($exception->getMessage(), 1000),
+                'processing_seconds' => (int) round(microtime(true) - $started),
+                'finished_at' => now(),
+            ])->save();
+
+            $this->error(sprintf('  Failed in %.2fs: %s', $elapsed, $exception->getMessage()));
+
+            if ($this->output->isVerbose()) {
+                $this->line(sprintf('  Exception : %s', get_class($exception)));
+                $this->line(sprintf('  At        : %s:%d', $exception->getFile(), $exception->getLine()));
+
+                $previous = $exception->getPrevious();
+
+                if ($previous !== null) {
+                    $this->line(sprintf('  Caused by : %s: %s', get_class($previous), $previous->getMessage()));
+                }
+            }
+
+            if ($this->output->isVeryVerbose()) {
+                $this->line('  Stack trace:');
+                $frames = array_slice(explode("\n", $exception->getTraceAsString()), 0, 25);
+
+                foreach ($frames as $frame) {
+                    $this->line('    ' . $frame);
+                }
+            }
+
+            Log::warning('enhance.run.command.failed', [
+                'enhance_job_id' => $job->id,
+                'engine' => $engine,
+                'message' => $exception->getMessage(),
+                'exception' => get_class($exception),
+            ]);
+
+            return false;
+        }
+    }
+
+    private function formatBytes(int $bytes): string
+    {
+        if ($bytes < 1024) {
+            return $bytes . 'B';
+        }
+
+        if ($bytes < 1_048_576) {
+            return round($bytes / 1024, 1) . 'KB';
+        }
+
+        return round($bytes / 1_048_576, 1) . 'MB';
+    }
+}

app/Console/Commands/GenerateAcademyPromptThumbnailsCommand.php

@@ -0,0 +1,390 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Models\AcademyPromptTemplate;
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Storage;
+use RuntimeException;
+use Throwable;
+
+final class GenerateAcademyPromptThumbnailsCommand extends Command
+{
+    private const PROMPT_PREVIEW_PREFIX = 'academy-prompts/previews';
+
+    /**
+     * @var array<string, int>
+     */
+    private const VARIANT_WIDTHS = [
+        'thumb' => 480,
+        'md' => 960,
+    ];
+
+    private const PREVIEW_WEBP_QUALITY = 84;
+
+    private const LESSON_MEDIA_WEBP_QUALITY = 85;
+
+    protected $signature = 'academy:prompts:generate-missing-thumbnails
+        {--id=* : Restrict to one or more prompt IDs}
+        {--slug=* : Restrict to one or more prompt slugs}
+        {--limit= : Stop after processing this many prompts}
+        {--force : Regenerate variants even when they already exist}
+        {--dry-run : Report planned thumbnail work without writing files or saving prompt JSON}';
+
+    protected $description = 'Generate missing prompt preview and comparison thumbnails for existing Academy prompts';
+
+    public function handle(): int
+    {
+        if (! function_exists('imagecreatefromstring') || ! function_exists('imagewebp')) {
+            $this->error('GD WebP support is required to generate prompt thumbnails.');
+
+            return self::FAILURE;
+        }
+
+        $ids = collect((array) $this->option('id'))
+            ->map(static fn (mixed $id): int => (int) $id)
+            ->filter(static fn (int $id): bool => $id > 0)
+            ->values()
+            ->all();
+
+        $slugs = collect((array) $this->option('slug'))
+            ->map(static fn (mixed $slug): string => trim((string) $slug))
+            ->filter(static fn (string $slug): bool => $slug !== '')
+            ->values()
+            ->all();
+
+        $limit = $this->option('limit') !== null ? max(1, (int) $this->option('limit')) : null;
+        $force = (bool) $this->option('force');
+        $dryRun = (bool) $this->option('dry-run');
+
+        $query = AcademyPromptTemplate::query()
+            ->select(['id', 'slug', 'title', 'preview_image', 'tool_notes'])
+            ->orderBy('id');
+
+        if ($ids !== []) {
+            $query->whereIn('id', $ids);
+        }
+
+        if ($slugs !== []) {
+            $query->whereIn('slug', $slugs);
+        }
+
+        $processed = 0;
+        $changed = 0;
+        $generatedVariants = 0;
+        $plannedVariants = 0;
+        $skipped = 0;
+        $failed = 0;
+
+        $query->chunkById(100, function ($prompts) use ($limit, $force, $dryRun, &$processed, &$changed, &$generatedVariants, &$plannedVariants, &$skipped, &$failed) {
+            foreach ($prompts as $prompt) {
+                if ($limit !== null && $processed >= $limit) {
+                    return false;
+                }
+
+                try {
+                    $result = $this->backfillPrompt($prompt, $force, $dryRun);
+
+                    $generatedVariants += (int) ($result['generated_variants'] ?? 0);
+                    $plannedVariants += (int) ($result['planned_variants'] ?? 0);
+
+                    if (($result['changed'] ?? false) === true) {
+                        $changed++;
+                    } else {
+                        $skipped++;
+                    }
+                } catch (Throwable $e) {
+                    $failed++;
+                    $this->warn(sprintf('Prompt %d (%s) failed: %s', (int) $prompt->id, (string) $prompt->slug, $e->getMessage()));
+                }
+
+                $processed++;
+            }
+
+            return true;
+        });
+
+        $this->info(sprintf(
+            'Prompt thumbnail backfill complete. processed=%d changed=%d generated_variants=%d planned_variants=%d skipped=%d failed=%d',
+            $processed,
+            $changed,
+            $generatedVariants,
+            $plannedVariants,
+            $skipped,
+            $failed,
+        ));
+
+        return $failed > 0 ? self::FAILURE : self::SUCCESS;
+    }
+
+    /**
+     * @return array{changed:bool,generated_variants:int,planned_variants:int}
+     */
+    private function backfillPrompt(AcademyPromptTemplate $prompt, bool $force, bool $dryRun): array
+    {
+        $generatedVariants = 0;
+        $plannedVariants = 0;
+        $changed = false;
+
+        $previewResult = $this->ensureManagedImageVariants((string) ($prompt->preview_image ?? ''), $force, $dryRun);
+        $generatedVariants += $previewResult['generated_variants'];
+        $plannedVariants += $previewResult['planned_variants'];
+        $changed = $changed || $previewResult['changed'];
+
+        $notes = is_array($prompt->tool_notes) ? $prompt->tool_notes : [];
+        $nextNotes = [];
+
+        foreach ($notes as $note) {
+            if (! is_array($note)) {
+                $nextNotes[] = $note;
+                continue;
+            }
+
+            $noteResult = $this->ensurePromptComparisonNoteVariants($note, $force, $dryRun);
+            $generatedVariants += $noteResult['generated_variants'];
+            $plannedVariants += $noteResult['planned_variants'];
+            $changed = $changed || $noteResult['changed'];
+            $nextNotes[] = $noteResult['note'];
+        }
+
+        if ($changed && ! $dryRun && $nextNotes !== $notes) {
+            $prompt->forceFill([
+                'tool_notes' => $nextNotes,
+            ])->save();
+        }
+
+        return [
+            'changed' => $changed,
+            'generated_variants' => $generatedVariants,
+            'planned_variants' => $plannedVariants,
+        ];
+    }
+
+    /**
+     * @param  array<string, mixed>  $note
+     * @return array{note:array<string, mixed>,changed:bool,generated_variants:int,planned_variants:int}
+     */
+    private function ensurePromptComparisonNoteVariants(array $note, bool $force, bool $dryRun): array
+    {
+        $imagePath = trim((string) ($note['image_path'] ?? ''));
+
+        if (! $this->isManagedLessonMediaPath($imagePath)) {
+            return [
+                'note' => $note,
+                'changed' => false,
+                'generated_variants' => 0,
+                'planned_variants' => 0,
+            ];
+        }
+
+        $variants = $this->ensureManagedImageVariants($imagePath, $force, $dryRun);
+        $thumbPath = $variants['thumb_path'] ?? '';
+
+        if ($thumbPath === '') {
+            $thumbPath = $imagePath;
+        }
+
+        $nextNote = $note;
+        $currentThumbPath = trim((string) ($note['thumb_path'] ?? ''));
+
+        if ($currentThumbPath !== $thumbPath) {
+            $nextNote['thumb_path'] = $thumbPath;
+            $variants['changed'] = true;
+        }
+
+        return [
+            'note' => $nextNote,
+            'changed' => (bool) $variants['changed'],
+            'generated_variants' => (int) $variants['generated_variants'],
+            'planned_variants' => (int) $variants['planned_variants'],
+        ];
+    }
+
+    /**
+     * @return array{thumb_path:string,changed:bool,generated_variants:int,planned_variants:int}
+     */
+    private function ensureManagedImageVariants(string $path, bool $force, bool $dryRun): array
+    {
+        $path = trim($path);
+
+        if (! $this->isManagedPromptPreviewPath($path) && ! $this->isManagedLessonMediaPath($path)) {
+            return [
+                'thumb_path' => '',
+                'changed' => false,
+                'generated_variants' => 0,
+                'planned_variants' => 0,
+            ];
+        }
+
+        $source = $this->openManagedImage($path);
+
+        try {
+            $generatedVariants = 0;
+            $plannedVariants = 0;
+            $changed = false;
+            $thumbPath = $path;
+
+            foreach (self::VARIANT_WIDTHS as $variant => $targetWidth) {
+                $status = $this->ensureVariantForWidth(
+                    $source['image'],
+                    $source['width'],
+                    $source['height'],
+                    $path,
+                    $variant,
+                    $targetWidth,
+                    $force,
+                    $dryRun,
+                );
+
+                if ($variant === 'thumb' && $source['width'] > $targetWidth) {
+                    $thumbPath = $this->variantPath($path, 'thumb');
+                }
+
+                if ($status === 'generated') {
+                    $generatedVariants++;
+                    $changed = true;
+                }
+
+                if ($status === 'planned') {
+                    $plannedVariants++;
+                    $changed = true;
+                }
+            }
+
+            return [
+                'thumb_path' => $thumbPath,
+                'changed' => $changed,
+                'generated_variants' => $generatedVariants,
+                'planned_variants' => $plannedVariants,
+            ];
+        } finally {
+            imagedestroy($source['image']);
+        }
+    }
+
+    /**
+     * @return array{image:\GdImage,width:int,height:int}
+     */
+    private function openManagedImage(string $path): array
+    {
+        $disk = Storage::disk($this->storageDisk());
+
+        if (! $disk->exists($path)) {
+            throw new RuntimeException(sprintf('Source image is missing: %s', $path));
+        }
+
+        $binary = $disk->get($path);
+
+        if (! is_string($binary) || $binary === '') {
+            throw new RuntimeException(sprintf('Source image could not be read: %s', $path));
+        }
+
+        $image = @imagecreatefromstring($binary);
+
+        if (! $image instanceof \GdImage) {
+            throw new RuntimeException(sprintf('Source image is not a supported raster image: %s', $path));
+        }
+
+        if (! imageistruecolor($image)) {
+            imagepalettetotruecolor($image);
+        }
+
+        imagealphablending($image, true);
+        imagesavealpha($image, true);
+
+        return [
+            'image' => $image,
+            'width' => imagesx($image),
+            'height' => imagesy($image),
+        ];
+    }
+
+    private function ensureVariantForWidth(\GdImage $source, int $sourceWidth, int $sourceHeight, string $sourcePath, string $variant, int $targetWidth, bool $force, bool $dryRun): string
+    {
+        if ($sourceWidth <= $targetWidth || $sourceWidth < 1 || $sourceHeight < 1) {
+            return 'skipped';
+        }
+
+        $variantPath = $this->variantPath($sourcePath, $variant);
+        $disk = Storage::disk($this->storageDisk());
+
+        if (! $force && $disk->exists($variantPath)) {
+            return 'skipped';
+        }
+
+        if ($dryRun) {
+            return 'planned';
+        }
+
+        $targetHeight = max(1, (int) round(($sourceHeight / $sourceWidth) * $targetWidth));
+        $canvas = imagecreatetruecolor($targetWidth, $targetHeight);
+
+        if (! $canvas instanceof \GdImage) {
+            throw new RuntimeException(sprintf('Could not allocate variant canvas for %s', $sourcePath));
+        }
+
+        imagealphablending($canvas, false);
+        imagesavealpha($canvas, true);
+        $transparent = imagecolorallocatealpha($canvas, 0, 0, 0, 127);
+        imagefilledrectangle($canvas, 0, 0, $targetWidth, $targetHeight, $transparent);
+        imagecopyresampled($canvas, $source, 0, 0, 0, 0, $targetWidth, $targetHeight, $sourceWidth, $sourceHeight);
+
+        try {
+            ob_start();
+            $converted = imagewebp($canvas, null, $this->qualityForPath($sourcePath));
+            $webpBinary = ob_get_clean();
+
+            if (! $converted || ! is_string($webpBinary) || $webpBinary === '') {
+                throw new RuntimeException(sprintf('Could not encode %s variant for %s', $variant, $sourcePath));
+            }
+
+            $disk->put($variantPath, $webpBinary, ['visibility' => 'public']);
+        } finally {
+            imagedestroy($canvas);
+        }
+
+        return 'generated';
+    }
+
+    private function variantPath(string $path, string $variant): string
+    {
+        $directory = pathinfo($path, PATHINFO_DIRNAME);
+        $filename = pathinfo($path, PATHINFO_FILENAME);
+        $baseFilename = preg_replace('/-(thumb|md)$/', '', $filename) ?? $filename;
+
+        return sprintf('%s/%s-%s.webp', $directory, $baseFilename, $variant);
+    }
+
+    private function isManagedPromptPreviewPath(string $path): bool
+    {
+        return $this->isLocalPath($path) && str_starts_with($path, self::PROMPT_PREVIEW_PREFIX . '/');
+    }
+
+    private function isManagedLessonMediaPath(string $path): bool
+    {
+        return $this->isLocalPath($path)
+            && (str_starts_with($path, 'academy/lessons/body/') || str_starts_with($path, 'academy/lessons/covers/'));
+    }
+
+    private function isLocalPath(string $path): bool
+    {
+        return $path !== ''
+            && ! str_starts_with($path, 'http://')
+            && ! str_starts_with($path, 'https://')
+            && ! str_starts_with($path, '/');
+    }
+
+    private function storageDisk(): string
+    {
+        return (string) config('uploads.object_storage.disk', 's3');
+    }
+
+    private function qualityForPath(string $path): int
+    {
+        return $this->isManagedPromptPreviewPath($path)
+            ? self::PREVIEW_WEBP_QUALITY
+            : self::LESSON_MEDIA_WEBP_QUALITY;
+    }
+}

app/Console/Commands/GenerateWorldWebStoriesCommand.php

@@ -0,0 +1,131 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Models\World;
+use App\Services\WebStories\WorldWebStoryGenerator;
+use Illuminate\Console\Command;
+use Illuminate\Validation\ValidationException;
+
+final class GenerateWorldWebStoriesCommand extends Command
+{
+    protected $signature = 'skinbase:webstories:generate
+        {world? : World ID or slug}
+        {--all : Generate stories in batch mode}
+        {--pages=7 : Number of pages to generate (5-10)}
+        {--limit=25 : Maximum worlds to process in batch mode}
+        {--force : Rebuild an existing story for the target world}
+        {--publish : Publish immediately after generation if validation passes}
+        {--dry-run : Preview generation without saving anything}';
+
+    protected $description = 'Generate standalone AMP Web Stories from Skinbase Worlds';
+
+    public function handle(WorldWebStoryGenerator $generator): int
+    {
+        $worldKey = $this->argument('world');
+        $force = (bool) $this->option('force');
+        $publish = (bool) $this->option('publish');
+        $dryRun = (bool) $this->option('dry-run');
+        $pages = max(5, min(10, (int) $this->option('pages')));
+
+        if ($worldKey !== null && trim((string) $worldKey) !== '') {
+            $world = $this->resolveWorld((string) $worldKey);
+
+            if (! $world instanceof World) {
+                $this->error(sprintf('World [%s] was not found.', (string) $worldKey));
+
+                return self::FAILURE;
+            }
+
+            return $this->generateOne($generator, $world, $pages, $force, $publish, $dryRun);
+        }
+
+        if (! (bool) $this->option('all')) {
+            $this->error('Provide a world ID/slug or pass --all for batch generation.');
+
+            return self::INVALID;
+        }
+
+        return $this->generateBatch($generator, $pages, $force, $publish, $dryRun, max(1, (int) $this->option('limit')));
+    }
+
+    private function generateOne(WorldWebStoryGenerator $generator, World $world, int $pages, bool $force, bool $publish, bool $dryRun): int
+    {
+        try {
+            $result = $generator->generateFromWorld($world, null, $pages, $force, $publish, $dryRun);
+        } catch (ValidationException $exception) {
+            foreach ($exception->errors() as $messages) {
+                foreach ($messages as $message) {
+                    $this->error((string) $message);
+                }
+            }
+
+            return self::FAILURE;
+        }
+
+        $story = $result['story'];
+        $validation = $result['validation'];
+
+        $this->info(sprintf(
+            '%s story for world [%s] -> /web-stories/%s (%d pages)',
+            $result['created'] ? 'Created' : 'Updated',
+            (string) $world->slug,
+            (string) $story->slug,
+            (int) $validation['page_count'],
+        ));
+
+        foreach ((array) $validation['warnings'] as $warning) {
+            $this->warn(' - ' . $warning);
+        }
+
+        foreach ((array) $validation['errors'] as $error) {
+            $this->error(' - ' . $error);
+        }
+
+        return $validation['valid'] || ! $publish ? self::SUCCESS : self::FAILURE;
+    }
+
+    private function generateBatch(WorldWebStoryGenerator $generator, int $pages, bool $force, bool $publish, bool $dryRun, int $limit): int
+    {
+        $processed = 0;
+        $created = 0;
+        $updated = 0;
+        $failed = 0;
+
+        $query = World::query()
+            ->published()
+            ->orderByDesc('published_at')
+            ->orderByDesc('id');
+
+        if (! $force) {
+            $query->whereDoesntHave('webStories');
+        }
+
+        $query->limit($limit)->get()->each(function (World $world) use ($generator, $pages, $force, $publish, $dryRun, &$processed, &$created, &$updated, &$failed): void {
+            $processed++;
+
+            try {
+                $result = $generator->generateFromWorld($world, null, $pages, $force, $publish, $dryRun);
+                $result['created'] ? $created++ : $updated++;
+                $this->line(sprintf('[%d] %s -> %s', (int) $world->id, (string) $world->slug, (string) $result['story']->slug));
+            } catch (ValidationException $exception) {
+                $failed++;
+                $first = collect($exception->errors())->flatten()->first();
+                $this->error(sprintf('[%d] %s failed: %s', (int) $world->id, (string) $world->slug, (string) $first));
+            }
+        });
+
+        $this->info(sprintf('Done. processed=%d created=%d updated=%d failed=%d', $processed, $created, $updated, $failed));
+
+        return $failed === 0 ? self::SUCCESS : self::FAILURE;
+    }
+
+    private function resolveWorld(string $value): ?World
+    {
+        return World::query()
+            ->when(is_numeric($value), fn ($query) => $query->where('id', (int) $value), fn ($query) => $query->where('slug', $value))
+            ->first();
+    }
+}

app/Console/Commands/HealthCheckCommand.php

@@ -5,8 +5,10 @@ declare(strict_types=1);
 namespace App\Console\Commands;
 
 use App\Models\Artwork;
+use App\Services\Sitemaps\SitemapReleaseManager;
 use App\Services\Vision\ArtworkVisionImageUrl;
 use Illuminate\Console\Command;
+use Illuminate\Support\Carbon;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Redis;
@@ -25,10 +27,10 @@ use Throwable;
 class HealthCheckCommand extends Command
 {
     protected $signature = 'health:check
-        {--only= : Run only a named check (mysql|redis|cache|meilisearch|qdrant|reverb|vision|horizon|webserver|phpfpm|paths|ram|disk|load|s3|failed_jobs|queue_backlog|ssl|scheduler|log_errors|app)}
+        {--only= : Run only a named check (mysql|redis|cache|meilisearch|qdrant|reverb|vision|horizon|webserver|phpfpm|paths|ram|disk|load|s3|failed_jobs|queue_backlog|ssl|scheduler|sitemap|log_errors|app)}
         {--json  : Output results as JSON}';
 
-    protected $description = 'Check health of all critical services (MySQL, Redis, Cache, Meilisearch, Qdrant, Reverb, Vision, Horizon, Nginx, PHP-FPM, writable paths, RAM, disk, load, S3/Contabo, failed jobs, queue backlog, SSL, scheduler, log errors, App).';
+    protected $description = 'Check health of all critical services (MySQL, Redis, Cache, Meilisearch, Qdrant, Reverb, Vision, Horizon, Nginx, PHP-FPM, writable paths, RAM, disk, load, S3/Contabo, failed jobs, queue backlog, SSL, scheduler, sitemap, log errors, App).';
 
     /** Collected results: [name => [status, message, details]] */
     private array $results = [];
@@ -57,6 +59,7 @@ class HealthCheckCommand extends Command
             'queue_backlog' => fn () => $this->checkQueueBacklog(),
             'ssl'         => fn () => $this->checkSsl(),
             'scheduler'   => fn () => $this->checkScheduler(),
+            'sitemap'     => fn () => $this->checkSitemap(),
             'log_errors'  => fn () => $this->checkLogErrors(),
             'app'         => fn () => $this->checkApp(),
         ];
@@ -1041,6 +1044,51 @@ class HealthCheckCommand extends Command
         }
     }
 
+    private function checkSitemap(): void
+    {
+        try {
+            $releases = app(SitemapReleaseManager::class)->listReleases();
+
+            if ($releases === []) {
+                $this->failCheck('sitemap', 'No sitemap releases found. Run `php artisan skinbase:sitemaps:publish` to build one.');
+                return;
+            }
+
+            $latest = $releases[0];
+            $releaseId = (string) ($latest['release_id'] ?? 'unknown');
+            $builtAtRaw = (string) ($latest['built_at'] ?? $latest['published_at'] ?? '');
+
+            if ($builtAtRaw === '') {
+                $this->warn_check('sitemap', "Latest sitemap release [{$releaseId}] is missing a build timestamp.", [
+                    'release_id' => $releaseId,
+                    'status' => (string) ($latest['status'] ?? 'unknown'),
+                ]);
+                return;
+            }
+
+            $builtAt = Carbon::parse($builtAtRaw);
+            $ageSeconds = max(0, $builtAt->diffInSeconds(now()));
+            $builtAtLabel = $builtAt->toAtomString();
+            $details = [
+                'release_id' => $releaseId,
+                'built_at' => $builtAtLabel,
+                'age_seconds' => $ageSeconds,
+                'status' => (string) ($latest['status'] ?? 'unknown'),
+            ];
+            $message = "Latest sitemap release [{$releaseId}] built at {$builtAtLabel} ({$ageSeconds}s ago).";
+
+            if ($ageSeconds > 72 * 3600) {
+                $this->failCheck('sitemap', 'Sitemap build is stale — ' . $message, $details);
+            } elseif ($ageSeconds > 36 * 3600) {
+                $this->warn_check('sitemap', 'Sitemap build is getting old — ' . $message, $details);
+            } else {
+                $this->pass('sitemap', $message, $details);
+            }
+        } catch (Throwable $e) {
+            $this->warn_check('sitemap', 'Could not inspect sitemap releases: ' . $e->getMessage());
+        }
+    }
+
     private function checkLogErrors(): void
     {
         $logFile = storage_path('logs/laravel.log');

app/Console/Commands/PublishScheduledNewsCommand.php

@@ -7,6 +7,7 @@ namespace App\Console\Commands;
 use Illuminate\Console\Command;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Log;
+use App\Services\News\NewsService;
 use cPad\Plugins\News\Models\NewsArticle;
 
 final class PublishScheduledNewsCommand extends Command
@@ -17,6 +18,11 @@ final class PublishScheduledNewsCommand extends Command
 
     protected $description = 'Publish scheduled News articles whose publish time has passed.';
 
+    public function __construct(private readonly NewsService $news)
+    {
+        parent::__construct();
+    }
+
     public function handle(): int
     {
         $dryRun = (bool) $this->option('dry-run');
@@ -60,11 +66,7 @@ final class PublishScheduledNewsCommand extends Command
                         return;
                     }
 
-                    $article->forceFill([
+                    $this->news->publish($article);
-                        'editorial_status' => NewsArticle::EDITORIAL_STATUS_PUBLISHED,
-                        'status' => 'published',
-                        'published_at' => $article->published_at ?? $now,
-                    ])->save();
 
                     $published++;
                     $this->line(sprintf('Published News article #%d: "%s"', $article->id, $article->title));

app/Console/Commands/ValidateWorldWebStoriesCommand.php

@@ -0,0 +1,163 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Console\Commands;
+
+use App\Models\WorldWebStory;
+use App\Services\WebStories\WorldWebStoryValidationService;
+use Illuminate\Console\Command;
+use Symfony\Component\Process\Process;
+
+final class ValidateWorldWebStoriesCommand extends Command
+{
+    protected $signature = 'skinbase:webstories:validate
+        {story? : Story ID or slug}
+        {--published : Limit batch mode to published stories}
+        {--visible : Limit batch mode to publicly visible stories}
+        {--limit=100 : Maximum stories to validate in batch mode}
+        {--amp : Also run amphtml-validator against the public story URL}
+        {--fail-warnings : Treat validation warnings as failures}';
+
+    protected $description = 'Validate World Web Stories for publish safety and optional AMP validity';
+
+    public function handle(WorldWebStoryValidationService $validation): int
+    {
+        $storyKey = $this->argument('story');
+
+        if ($storyKey !== null && trim((string) $storyKey) !== '') {
+            $story = $this->resolveStory((string) $storyKey);
+
+            if (! $story instanceof WorldWebStory) {
+                $this->error(sprintf('Web story [%s] was not found.', (string) $storyKey));
+
+                return self::FAILURE;
+            }
+
+            return $this->validateOne($validation, $story);
+        }
+
+        return $this->validateBatch($validation, max(1, (int) $this->option('limit')));
+    }
+
+    private function validateOne(WorldWebStoryValidationService $validation, WorldWebStory $story): int
+    {
+        $result = $validation->validate($story);
+        $ampErrors = $this->ampErrors($story);
+
+        $this->line(sprintf('Story [%d] %s', (int) $story->id, (string) $story->slug));
+
+        foreach ((array) $result['warnings'] as $warning) {
+            $this->warn(' - ' . $warning);
+        }
+
+        foreach ((array) $result['errors'] as $error) {
+            $this->error(' - ' . $error);
+        }
+
+        foreach ($ampErrors as $ampError) {
+            $this->error(' - AMP: ' . $ampError);
+        }
+
+        if ($result['valid'] && $ampErrors === []) {
+            $this->info('Validation passed.');
+
+            return self::SUCCESS;
+        }
+
+        return self::FAILURE;
+    }
+
+    private function validateBatch(WorldWebStoryValidationService $validation, int $limit): int
+    {
+        $processed = 0;
+        $failed = 0;
+
+        $this->storyQuery()
+            ->limit($limit)
+            ->get()
+            ->each(function (WorldWebStory $story) use ($validation, &$processed, &$failed): void {
+                $processed++;
+                $result = $validation->validate($story);
+                $ampErrors = $this->ampErrors($story);
+                $warningsFail = (bool) $this->option('fail-warnings') && count((array) $result['warnings']) > 0;
+                $hasFailure = ! $result['valid'] || $warningsFail || $ampErrors !== [];
+
+                if ($hasFailure) {
+                    $failed++;
+                }
+
+                $this->line(sprintf('[%d] %s -> %s', (int) $story->id, (string) $story->slug, $hasFailure ? 'invalid' : 'valid'));
+
+                foreach ((array) $result['warnings'] as $warning) {
+                    $this->warn(' - ' . $warning);
+                }
+
+                foreach ((array) $result['errors'] as $error) {
+                    $this->error(' - ' . $error);
+                }
+
+                foreach ($ampErrors as $ampError) {
+                    $this->error(' - AMP: ' . $ampError);
+                }
+            });
+
+        $this->info(sprintf('Done. processed=%d failed=%d', $processed, $failed));
+
+        return $failed === 0 ? self::SUCCESS : self::FAILURE;
+    }
+
+    private function storyQuery()
+    {
+        return WorldWebStory::query()
+            ->when((bool) $this->option('published'), fn ($query) => $query->published())
+            ->when((bool) $this->option('visible'), fn ($query) => $query->visible())
+            ->orderByDesc('published_at')
+            ->orderByDesc('id');
+    }
+
+    /**
+     * @return list<string>
+     */
+    private function ampErrors(WorldWebStory $story): array
+    {
+        if (! (bool) $this->option('amp')) {
+            return [];
+        }
+
+        if (! $story->exists || ! $story->publicUrl()) {
+            return ['Story has no public URL to validate.'];
+        }
+
+        $probe = new Process(['npx', 'amphtml-validator', '--version'], base_path(), null, null, 60);
+        $probe->run();
+
+        if (! $probe->isSuccessful()) {
+            return ['amphtml-validator is not available via npx.'];
+        }
+
+        $process = new Process(['npx', 'amphtml-validator', $story->publicUrl()], base_path(), null, null, 120);
+        $process->run();
+
+        if ($process->isSuccessful()) {
+            return [];
+        }
+
+        $output = trim($process->getErrorOutput() ?: $process->getOutput());
+
+        if ($output === '') {
+            return ['AMP validator failed without output.'];
+        }
+
+        $lines = preg_split('/\r\n|\r|\n/', $output);
+
+        return $lines === false || $lines === [] ? ['AMP validator failed.'] : $lines;
+    }
+
+    private function resolveStory(string $value): ?WorldWebStory
+    {
+        return WorldWebStory::query()
+            ->when(is_numeric($value), fn ($query) => $query->where('id', (int) $value), fn ($query) => $query->where('slug', $value))
+            ->first();
+    }
+}

app/Console/Kernel.php

@@ -11,6 +11,7 @@ use App\Console\Commands\BackfillArtworkVectorIndexCommand;
 use App\Console\Commands\IndexArtworkVectorsCommand;
 use App\Console\Commands\SearchArtworkVectorsCommand;
 use App\Console\Commands\AggregateSimilarArtworkAnalyticsCommand;
+use App\Console\Commands\AcademyCoursesSyncFoundationsCommand;
 use App\Console\Commands\AggregateFeedAnalyticsCommand;
 use App\Console\Commands\AggregateTagInteractionAnalyticsCommand;
 use App\Console\Commands\SeedTagInteractionDemoCommand;
@@ -30,10 +31,13 @@ use App\Console\Commands\PublishScheduledArtworksCommand;
 use App\Console\Commands\PublishScheduledNewsCommand;
 use App\Console\Commands\PublishScheduledNovaCardsCommand;
 use App\Console\Commands\BuildSitemapsCommand;
+use App\Console\Commands\BuildWorldWebStoryAssetsCommand;
 use App\Console\Commands\ListSitemapReleasesCommand;
+use App\Console\Commands\GenerateWorldWebStoriesCommand;
 use App\Console\Commands\PublishSitemapsCommand;
 use App\Console\Commands\RollbackSitemapReleaseCommand;
 use App\Console\Commands\SyncCollectionLifecycleCommand;
+use App\Console\Commands\ValidateWorldWebStoriesCommand;
 use App\Console\Commands\ValidateSitemapsCommand;
 use App\Console\Commands\AuditArtworkDownloadFilesCommand;
 use App\Console\Commands\InspectArtworkOriginalCommand;
@@ -57,6 +61,9 @@ class Kernel extends ConsoleKernel
         \App\Console\Commands\ResetAllUserPasswords::class,
         CleanupUploadsCommand::class,
         BuildSitemapsCommand::class,
+        GenerateWorldWebStoriesCommand::class,
+        BuildWorldWebStoryAssetsCommand::class,
+        ValidateWorldWebStoriesCommand::class,
         PublishSitemapsCommand::class,
         ListSitemapReleasesCommand::class,
         RollbackSitemapReleaseCommand::class,
@@ -71,6 +78,7 @@ class Kernel extends ConsoleKernel
         ZipUnsupportedArtworkOriginalsCommand::class,
         SendTestMail::class,
         DispatchCollectionMaintenanceCommand::class,
+        AcademyCoursesSyncFoundationsCommand::class,
         BackfillArtworkEmbeddingsCommand::class,
         BackfillArtworkVectorIndexCommand::class,
         IndexArtworkVectorsCommand::class,

app/Http/Controllers/Academy/AcademyAnalyticsEventController.php

@@ -0,0 +1,94 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Academy;
+
+use App\Http\Controllers\Controller;
+use App\Services\Academy\AcademyAnalyticsContentResolver;
+use App\Services\Academy\AcademyAnalyticsService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
+use App\Support\AcademyAnalytics\AcademyAnalyticsEventType;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Validation\Rule;
+
+final class AcademyAnalyticsEventController extends Controller
+{
+    public function __construct(
+        private readonly AcademyAnalyticsService $analytics,
+        private readonly AcademyAnalyticsContentResolver $resolver,
+    ) {
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+        abort_unless($request->expectsJson() || $request->isJson(), 422);
+
+        $validated = $request->validate([
+            'event_type' => ['required', 'string', Rule::in(AcademyAnalyticsEventType::values())],
+            'content_type' => ['nullable', 'string', Rule::in(AcademyAnalyticsContentType::values())],
+            'content_id' => ['nullable', 'integer', 'min:1'],
+            'metadata' => ['nullable', 'array'],
+            'visitor_id' => ['nullable', 'string', 'max:120'],
+            'session_id' => ['nullable', 'string', 'max:120'],
+            'url' => ['nullable', 'string', 'max:4000'],
+            'route_name' => ['nullable', 'string', 'max:255'],
+            'referrer' => ['nullable', 'string', 'max:4000'],
+            'utm_source' => ['nullable', 'string', 'max:255'],
+            'utm_medium' => ['nullable', 'string', 'max:255'],
+            'utm_campaign' => ['nullable', 'string', 'max:255'],
+        ]);
+
+        if (isset($validated['metadata']) && strlen((string) json_encode($validated['metadata'])) > 8192) {
+            return response()->json([
+                'message' => 'Metadata payload is too large.',
+            ], 422);
+        }
+
+        $contentType = $validated['content_type'] ?? null;
+        $contentId = $validated['content_id'] ?? null;
+
+        if ($contentType !== null && AcademyAnalyticsContentType::requiresContentId($contentType) && $contentId === null) {
+            return response()->json([
+                'message' => 'content_id is required for this content type.',
+            ], 422);
+        }
+
+        if ($contentType !== null && $contentId !== null && ! $this->resolver->exists($contentType, (int) $contentId)) {
+            return response()->json([
+                'message' => 'Unknown Academy analytics content target.',
+            ], 422);
+        }
+
+        if (($validated['event_type'] ?? null) === AcademyAnalyticsEventType::SEARCH_RESULT_CLICK) {
+            validator([
+                'content_type' => $contentType,
+                'content_id' => $contentId,
+                'metadata' => $validated['metadata'] ?? [],
+            ], [
+                'content_type' => ['required', 'string', Rule::in([
+                    AcademyAnalyticsContentType::PROMPT,
+                    AcademyAnalyticsContentType::LESSON,
+                    AcademyAnalyticsContentType::COURSE,
+                    AcademyAnalyticsContentType::PROMPT_PACK,
+                    AcademyAnalyticsContentType::CHALLENGE,
+                ])],
+                'content_id' => ['required', 'integer', 'min:1'],
+                'metadata.query' => ['required', 'string', 'max:120'],
+                'metadata.normalized_query' => ['required', 'string', 'max:120'],
+                'metadata.results_count' => ['required', 'integer', 'min:0'],
+                'metadata.position' => ['nullable', 'integer', 'min:1'],
+                'metadata.source' => ['nullable', 'string', 'max:120'],
+                'metadata.filters' => ['nullable', 'array'],
+            ])->validate();
+        }
+
+        $this->analytics->track($validated, $request->user(), $request);
+
+        return response()->json([
+            'ok' => true,
+        ]);
+    }
+}

app/Http/Controllers/Academy/AcademyBillingController.php

@@ -0,0 +1,714 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Academy;
+
+use App\Http\Controllers\Controller;
+use App\Models\User;
+use App\Services\Academy\AcademyAccessService;
+use App\Services\Academy\AcademyBillingPlanService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
+use App\Support\Seo\SeoFactory;
+use Laravel\Cashier\Checkout;
+use Laravel\Cashier\Subscription;
+use Stripe\Exception\InvalidRequestException;
+use Illuminate\Support\Facades\Log;
+
+use App\Mail\AcademyAccessIssue;
+use App\Models\StaffApplication;
+use Illuminate\Support\Facades\Mail;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Str;
+final class AcademyBillingController extends Controller
+{
+    public function __construct(
+        private readonly AcademyAccessService $access,
+        private readonly AcademyBillingPlanService $plans,
+    ) {}
+
+    public function pricing(\Illuminate\Http\Request $request): \Inertia\Response
+    {
+        \abort_unless((bool) \config('academy.enabled', true), 404);
+
+        $this->plans->assertConfigured();
+
+        /** @var User|null $user */
+        $user = $request->user();
+        $canonical = \route('academy.pricing');
+        $seo = \app(SeoFactory::class)
+            ->collectionPage(
+                'Skinbase AI Academy Pricing — Skinbase',
+                'Compare Skinbase AI Academy Creator and Pro tiers, start free, and manage premium access through Stripe billing.',
+                $canonical,
+            )
+            ->toArray();
+
+        $seo['og_type'] = 'website';
+        $activePlan = $user instanceof User ? $this->activePlan($user) : null;
+
+        return \Inertia\Inertia::render('Academy/Billing/Pricing', [
+            'seo' => $seo,
+            'billingEnabled' => $this->plans->enabled(),
+            'currentTier' => $this->access->currentTier($user),
+            'isSubscribed' => $user instanceof User ? $this->access->hasActiveAcademySubscription($user) : false,
+            'activePlanKey' => $activePlan['key'] ?? null,
+            'activePlanLabel' => $activePlan['label'] ?? null,
+            'catalog' => $this->catalog(),
+            'missingRemote' => $this->plans->missingRemotePriceIds(),
+            'links' => [
+                'login' => \route('login'),
+                'pricing' => \route('academy.pricing'),
+                'billingAccount' => $user ? \route('academy.billing.account') : null,
+                'checkout' => $user ? \route('academy.billing.checkout') : null,
+            ],
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::UPGRADE,
+                'contentId' => null,
+                'eventUrl' => \route('academy.analytics.events.store'),
+                'pageName' => 'academy_billing_pricing',
+                'isPremium' => false,
+                'isGuest' => $user === null,
+                'isSubscriber' => $user?->hasAcademyCreatorAccess() || $user?->hasAcademyProAccess(),
+            ],
+        ])->rootView('academy');
+    }
+
+    public function checkout(\Illuminate\Http\Request $request): Checkout|\Illuminate\Http\JsonResponse|\Illuminate\Http\RedirectResponse
+    {
+        \abort_unless((bool) \config('academy.enabled', true), 404);
+
+        if (! $this->plans->enabled()) {
+            return $this->billingDisabledResponse($request, 'Academy billing is not enabled yet.');
+        }
+
+        $this->plans->assertConfigured();
+
+        $user = $request->user();
+
+        if (! $user instanceof User) {
+            return \redirect()->route('login');
+        }
+
+        if ($user->email_verified_at === null) {
+            throw \Illuminate\Validation\ValidationException::withMessages([
+                'plan' => 'Verify your email address before starting Academy billing.',
+            ]);
+        }
+
+        $validated = $request->validate([
+            'plan' => ['required', 'string'],
+        ]);
+
+        $plan = $this->plans->plan((string) $validated['plan']);
+
+        if ($plan === null) {
+            throw \Illuminate\Validation\ValidationException::withMessages([
+                'plan' => 'Select a valid Academy billing plan.',
+            ]);
+        }
+
+        if (! ($plan['configured'] ?? false)) {
+            return $this->missingPriceIdResponse($request, (string) $plan['key']);
+        }
+
+        if (! ($plan['price_id_valid'] ?? false)) {
+            return $this->invalidPriceIdResponse($request, (string) $plan['key']);
+        }
+
+        if ($this->access->hasActiveAcademySubscription($user)) {
+            // If the user already has an Academy subscription, allow an in-place upgrade
+            // (e.g. Creator -> Pro) by swapping the subscription to the requested price.
+            $subscription = $this->academySubscription($user);
+            $currentPlan = $this->activePlan($user);
+
+            // If current plan exists and the requested plan ranks higher, perform swap.
+            if ($currentPlan !== null && ($this->planRank((string) $plan['tier']) > $this->planRank((string) $currentPlan['tier']))) {
+                try {
+                    if ($subscription instanceof Subscription) {
+                        $subscription->swap((string) $plan['stripe_price_id']);
+                    }
+
+                    return \redirect()->route('academy.billing.account')->with('success', 'Subscription upgraded — your new plan is active.');
+                } catch (\Throwable $e) {
+                    $context = [
+                        'user_id' => $user->id ?? null,
+                        'user_email' => $user->email ?? null,
+                        'stripe_id' => $user->stripe_id ?? null,
+                        'route' => 'academy.billing.checkout',
+                        'attempt' => 'swap_subscription',
+                        'plan_key' => $plan['key'] ?? null,
+                        'plan_price_id' => $plan['stripe_price_id'] ?? null,
+                        'request_ip' => $request->ip(),
+                        'user_agent' => $request->header('User-Agent'),
+                        'exception_class' => \get_class($e),
+                        'exception_message' => $e->getMessage(),
+                        'exception_code' => $e->getCode(),
+                        'exception_trace' => \method_exists($e, 'getTraceAsString') ? $e->getTraceAsString() : null,
+                    ];
+
+                    if (method_exists($e, 'getStripeCode')) {
+                        $context['stripe_code'] = $e->getStripeCode();
+                    }
+
+                    Log::error('Academy billing: failed to swap subscription for upgrade', $context);
+
+                    return $this->checkoutErrorResponse($request, $e);
+                }
+            }
+
+            return \redirect()->route('academy.billing.portal');
+        }
+
+        try {
+            return $user
+                ->newSubscription($this->plans->subscriptionName(), (string) $plan['stripe_price_id'])
+                ->withMetadata([
+                    'skinbase_module' => 'academy',
+                    'user_id' => (string) $user->id,
+                    'academy_plan' => (string) $plan['key'],
+                    'academy_tier' => (string) $plan['tier'],
+                ])
+                ->checkout([
+                    'success_url' => \route('academy.billing.success').'?session_id={CHECKOUT_SESSION_ID}',
+                    'cancel_url' => \route('academy.billing.cancel'),
+                    'allow_promotion_codes' => true,
+                    'metadata' => [
+                        'skinbase_module' => 'academy',
+                        'user_id' => (string) $user->id,
+                        'academy_plan' => (string) $plan['key'],
+                        'academy_tier' => (string) $plan['tier'],
+                    ],
+                ]);
+        } catch (InvalidRequestException $e) {
+            // Stripe returned a request error (e.g. missing/deleted customer). Try to recover once by
+            // clearing stored `stripe_id`, recreating the customer in Stripe and retrying the checkout.
+            if (str_contains($e->getMessage(), 'No such customer')) {
+                try {
+                    $user->forceFill(['stripe_id' => null])->save();
+
+                    // Create a fresh Stripe customer and persist the id
+                    if (method_exists($user, 'createAsStripeCustomer')) {
+                        $user->createAsStripeCustomer();
+                    } else {
+                        // fallback to createOrGet behavior
+                        $user->createOrGetStripeCustomer();
+                    }
+
+                    return $user
+                        ->newSubscription($this->plans->subscriptionName(), (string) $plan['stripe_price_id'])
+                        ->withMetadata([
+                            'skinbase_module' => 'academy',
+                            'user_id' => (string) $user->id,
+                            'academy_plan' => (string) $plan['key'],
+                            'academy_tier' => (string) $plan['tier'],
+                        ])
+                        ->checkout([
+                            'success_url' => \route('academy.billing.success').'?session_id={CHECKOUT_SESSION_ID}',
+                            'cancel_url' => \route('academy.billing.cancel'),
+                            'allow_promotion_codes' => true,
+                            'metadata' => [
+                                'skinbase_module' => 'academy',
+                                'user_id' => (string) $user->id,
+                                'academy_plan' => (string) $plan['key'],
+                                'academy_tier' => (string) $plan['tier'],
+                            ],
+                        ]);
+                } catch (\Throwable $inner) {
+                    $context = [
+                        'user_id' => $user->id ?? null,
+                        'user_email' => $user->email ?? null,
+                        'stripe_id' => $user->stripe_id ?? null,
+                        'route' => 'academy.billing.checkout',
+                        'attempt' => 'recreate_customer_and_checkout',
+                        'plan_key' => $plan['key'] ?? null,
+                        'plan_price_id' => $plan['stripe_price_id'] ?? null,
+                        'request_ip' => $request->ip(),
+                        'user_agent' => $request->header('User-Agent'),
+                        'exception_class' => \get_class($inner),
+                        'exception_message' => $inner->getMessage(),
+                        'exception_code' => $inner->getCode(),
+                        'exception_trace' => \method_exists($inner, 'getTraceAsString') ? $inner->getTraceAsString() : null,
+                    ];
+
+                    if (method_exists($inner, 'getStripeCode')) {
+                        $context['stripe_code'] = $inner->getStripeCode();
+                    }
+
+                    Log::error('Academy billing: failed to recover Stripe customer and start checkout', $context);
+
+                    return $this->checkoutErrorResponse($request, $inner);
+                }
+            }
+
+            // Not a recoverable customer-missing error; rethrow to be handled below
+            throw $e;
+        } catch (\Throwable $exception) {
+            $context = [
+                'user_id' => $user->id ?? null,
+                'user_email' => $user->email ?? null,
+                'stripe_id' => $user->stripe_id ?? null,
+                'route' => 'academy.billing.checkout',
+                'attempt' => 'start_checkout',
+                'plan_key' => $plan['key'] ?? null,
+                'plan_price_id' => $plan['stripe_price_id'] ?? null,
+                'request_ip' => $request->ip(),
+                'user_agent' => $request->header('User-Agent'),
+                'exception_class' => \get_class($exception),
+                'exception_message' => $exception->getMessage(),
+                'exception_code' => $exception->getCode(),
+                'exception_trace' => \method_exists($exception, 'getTraceAsString') ? $exception->getTraceAsString() : null,
+            ];
+
+            if (method_exists($exception, 'getStripeCode')) {
+                $context['stripe_code'] = $exception->getStripeCode();
+            }
+
+            Log::error('Academy billing: unexpected error starting checkout', $context);
+
+            return $this->checkoutErrorResponse($request, $exception);
+        }
+    }
+
+    public function checkoutLegacy(\Illuminate\Http\Request $request, string $plan): Checkout|\Illuminate\Http\JsonResponse|\Illuminate\Http\RedirectResponse
+    {
+        $request->merge([
+            'plan' => $this->plans->normalizePlanKey($plan),
+        ]);
+
+        return $this->checkout($request);
+    }
+
+    public function portal(\Illuminate\Http\Request $request): \Illuminate\Http\RedirectResponse
+    {
+        \abort_unless((bool) \config('academy.enabled', true), 404);
+        \abort_unless($this->plans->enabled(), 404);
+
+        /** @var User|null $user */
+        $user = $request->user();
+
+        if (! $user instanceof User || \blank($user->stripe_id)) {
+            return \redirect()->route('academy.billing.account')->with('error', 'No Stripe billing profile is connected to this account yet.');
+        }
+
+        try {
+            return $user->redirectToBillingPortal(\route('academy.billing.account'));
+        } catch (\Exception $e) {
+            // If the Stripe customer was deleted or invalid, attempt a recovery similar to checkout.
+            if ($e instanceof \Stripe\Exception\InvalidRequestException && str_contains($e->getMessage(), 'No such customer')) {
+                try {
+                    $user->forceFill(['stripe_id' => null])->save();
+
+                    if (method_exists($user, 'createAsStripeCustomer')) {
+                        $user->createAsStripeCustomer();
+                    } else {
+                        $user->createOrGetStripeCustomer();
+                    }
+
+                    return $user->redirectToBillingPortal(\route('academy.billing.account'));
+                } catch (\Throwable $inner) {
+                    $context = [
+                        'user_id' => $user->id ?? null,
+                        'user_email' => $user->email ?? null,
+                        'stripe_id' => $user->stripe_id ?? null,
+                        'route' => 'academy.billing.portal',
+                        'attempt' => 'recreate_customer_and_redirect',
+                        'request_ip' => $request->ip(),
+                        'user_agent' => $request->header('User-Agent'),
+                        'exception_class' => \get_class($inner),
+                        'exception_message' => $inner->getMessage(),
+                        'exception_code' => $inner->getCode(),
+                        'exception_trace' => \method_exists($inner, 'getTraceAsString') ? $inner->getTraceAsString() : null,
+                    ];
+
+                    if (method_exists($inner, 'getStripeCode')) {
+                        $context['stripe_code'] = $inner->getStripeCode();
+                    }
+
+                    Log::error('Academy billing: failed to recover Stripe customer and open billing portal', $context);
+
+                    return \redirect()->route('academy.billing.account')->with('error', 'Could not open the subscription manager. Please email academy@skinbase.org with your account details and checkout session id if available.');
+                }
+            }
+
+            $context = [
+                'user_id' => $user->id ?? null,
+                'user_email' => $user->email ?? null,
+                'stripe_id' => $user->stripe_id ?? null,
+                'route' => 'academy.billing.portal',
+                'attempt' => 'redirect_to_portal',
+                'request_ip' => $request->ip(),
+                'user_agent' => $request->header('User-Agent'),
+                'exception_class' => \get_class($e),
+                'exception_message' => $e->getMessage(),
+                'exception_code' => $e->getCode(),
+                'exception_trace' => \method_exists($e, 'getTraceAsString') ? $e->getTraceAsString() : null,
+            ];
+
+            if (method_exists($e, 'getStripeCode')) {
+                $context['stripe_code'] = $e->getStripeCode();
+            }
+
+            Log::error('Academy billing: could not open Stripe billing portal', $context);
+
+            return \redirect()->route('academy.billing.account')->with('error', 'Could not open the subscription manager. Please email academy@skinbase.org with your account details and checkout session id if available.');
+        }
+    }
+
+    public function success(\Illuminate\Http\Request $request): \Inertia\Response
+    {
+        \abort_unless((bool) \config('academy.enabled', true), 404);
+
+        /** @var User|null $user */
+        $user = $request->user();
+        $currentTier = $this->access->currentTier($user);
+
+        return \Inertia\Inertia::render('Academy/Billing/Success', [
+            'message' => 'Payment is being confirmed. Your access will update automatically.',
+            'currentTier' => $currentTier,
+            'isSubscribed' => $user instanceof User ? $this->access->hasActiveAcademySubscription($user) : false,
+            'links' => [
+                'pricing' => \route('academy.pricing'),
+                'account' => $user ? \route('academy.billing.account') : null,
+                'academy' => \route('academy.index'),
+                'reportIssue' => $user ? \route('academy.billing.report_issue') : null,
+            ],
+            'sessionId' => $request->query('session_id'),
+        ])->rootView('academy');
+    }
+
+    public function cancel(): \Inertia\Response
+    {
+        \abort_unless((bool) \config('academy.enabled', true), 404);
+
+        return \Inertia\Inertia::render('Academy/Billing/Cancel', [
+            'message' => 'Checkout was canceled. No payment was made.',
+            'links' => [
+                'pricing' => \route('academy.pricing'),
+                'academy' => \route('academy.index'),
+            ],
+        ])->rootView('academy');
+    }
+    
+        public function reportIssue(\Illuminate\Http\Request $request): \Illuminate\Http\RedirectResponse
+        {
+            /** @var User|null $user */
+            $user = $request->user();
+
+            if (! $user instanceof User) {
+                return redirect()->route('login');
+            }
+
+            $validated = $request->validate([
+                'message' => ['nullable', 'string', 'max:2000'],
+                'session_id' => ['nullable', 'string'],
+                'issue_type' => ['nullable', 'string', 'in:billing,payment,upgrade,downgrade,cancel,access,other'],
+                'contact_email' => ['nullable', 'email:rfc', 'max:255'],
+            ]);
+
+            $payload = [
+                'id' => (string) Str::uuid(),
+                'submitted_at' => now()->toISOString(),
+                'ip' => $request->ip(),
+                'user_agent' => $request->userAgent(),
+                'data' => [
+                    'topic' => 'contact',
+                    'name' => (string) ($user->name ?: $user->username ?: 'Academy billing user'),
+                    'email' => (string) ($validated['contact_email'] ?? $user->email),
+                    'message' => $validated['message'] ?? null,
+                    'issue_type' => $validated['issue_type'] ?? 'billing',
+                    'session_id' => $validated['session_id'] ?? $request->query('session_id'),
+                    'source' => 'academy_billing',
+                    'user_id' => (string) $user->id,
+                    'account_email' => (string) $user->email,
+                    'current_url' => $request->fullUrl(),
+                ],
+            ];
+
+            try {
+                try {
+                    Storage::append('staff_applications.jsonl', json_encode($payload, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE));
+                } catch (\Throwable $e) {
+                    // best-effort store; do not fail the user when file storage is unavailable
+                }
+
+                $application = null;
+
+                try {
+                    $application = StaffApplication::create([
+                        'id' => $payload['id'],
+                        'topic' => 'contact',
+                        'name' => $payload['data']['name'],
+                        'email' => $payload['data']['email'],
+                        'role' => 'academy_billing_support',
+                        'portfolio' => null,
+                        'message' => $payload['data']['message'],
+                        'payload' => $payload,
+                        'ip' => $payload['ip'],
+                        'user_agent' => $payload['user_agent'],
+                    ]);
+                } catch (\Throwable $e) {
+                    // ignore DB errors and fall back to a lightweight model for mail
+                }
+
+                $to = config('mail.from.address');
+
+                if ($to) {
+                    if (! $application) {
+                        $application = new StaffApplication([
+                            'topic' => 'contact',
+                            'name' => $payload['data']['name'],
+                            'email' => $payload['data']['email'],
+                            'role' => 'academy_billing_support',
+                            'message' => $payload['data']['message'],
+                            'payload' => $payload,
+                            'ip' => $payload['ip'],
+                            'user_agent' => $payload['user_agent'],
+                        ]);
+                        $application->id = $payload['id'];
+                        $application->created_at = now();
+                    }
+
+                    Mail::to($to)->send(new AcademyAccessIssue(
+                        $user,
+                        $payload['data']['message'] ?? null,
+                        $payload['data']['session_id'] ?? null,
+                        $payload['data']['issue_type'] ?? null,
+                        $payload['data']['email'] ?? null,
+                    ));
+                }
+
+                return redirect()->back()->with('success', 'Support request sent — we will verify and activate your access shortly.');
+            } catch (\Throwable $e) {
+                report($e);
+
+                return redirect()->back()->with('error', 'Could not send the support request. Please try again later or email academy@skinbase.org.');
+            }
+        }
+
+    public function account(\Illuminate\Http\Request $request): \Inertia\Response
+    {
+        \abort_unless((bool) \config('academy.enabled', true), 404);
+        \abort_unless($this->plans->enabled(), 404);
+
+        /** @var User $user */
+        $user = $request->user();
+        $subscription = $this->academySubscription($user);
+
+        $activePlan = $this->activePlan($user);
+
+        return \Inertia\Inertia::render('Academy/Billing/Account', [
+            'currentTier' => $this->access->currentTier($user),
+            'isSubscribed' => $this->access->hasActiveAcademySubscription($user),
+            'activePlan' => $activePlan ? [
+                'key' => $activePlan['key'],
+                'label' => $activePlan['label'],
+                'price_display' => $activePlan['price_display'] ?? null,
+                'tier' => $activePlan['tier'],
+            ] : null,
+            'subscription' => $subscription ? [
+                'name' => $subscription->type,
+                'status' => $subscription->stripe_status,
+                'active' => $subscription->active(),
+                'onGracePeriod' => $subscription->onGracePeriod(),
+                'endsAt' => $subscription->ends_at?->toISOString(),
+                'priceIds' => $subscription->items->pluck('stripe_price')->filter()->values()->all(),
+            ] : null,
+            'links' => [
+                'portal' => \route('academy.billing.portal'),
+                'pricing' => \route('academy.pricing'),
+                'academy' => \route('academy.index'),
+                'checkout' => \route('academy.billing.checkout'),
+                'reportIssue' => \route('academy.billing.report_issue'),
+            ],
+        ])->rootView('academy');
+    }
+
+    /**
+     * @return array<int, array<string, mixed>>
+     */
+    private function catalog(): array
+    {
+        $definitions = [
+            'creator' => [
+                'name' => 'Creator',
+                'description' => 'Entry premium access for prompt systems, creator lessons, and saved Academy workflows.',
+                'badge' => 'Paid',
+                'featured' => false,
+                'features' => [
+                    'Creator lessons and walkthroughs',
+                    'Full Creator prompt templates',
+                    'Prompt save and reuse flows',
+                    'Upgrade path into Pro later',
+                ],
+            ],
+            'pro' => [
+                'name' => 'Pro',
+                'description' => 'Full Academy access across Creator and Pro lessons, prompts, and future premium drops.',
+                'badge' => 'Recommended',
+                'featured' => true,
+                'features' => [
+                    'Everything in Creator',
+                    'Advanced Pro lessons and prompt systems',
+                    'Priority access to future Academy premium features',
+                    'Stripe billing portal for upgrades and invoices',
+                ],
+            ],
+        ];
+
+        return collect($definitions)
+            ->map(function (array $definition, string $tier): array {
+                $plan = $this->plans->plan($tier.'_monthly');
+
+                $plans = $plan !== null ? [[
+                    'key' => $plan['key'],
+                    'label' => $plan['label'],
+                    'interval' => $plan['interval'],
+                    'amount' => $plan['amount'],
+                    'currency' => $plan['currency'],
+                    'price_display' => $plan['price_display'],
+                    'configured' => $plan['configured'],
+                    'price_id_valid' => $plan['price_id_valid'],
+                    'remote_price_exists' => $plan['remote_price_exists'] ?? false,
+                ]] : [];
+
+                return [
+                    'tier' => $tier,
+                    'name' => $definition['name'],
+                    'description' => $definition['description'],
+                    'badge' => $definition['badge'],
+                    'featured' => $definition['featured'],
+                    'features' => $definition['features'],
+                    'plans' => $plans,
+                ];
+            })
+            ->values()
+            ->all();
+    }
+
+    private function academySubscription(User $user): ?Subscription
+    {
+        $subscription = $user->subscription($this->plans->subscriptionName());
+
+        return $subscription instanceof Subscription
+            ? $subscription->loadMissing('items')
+            : null;
+    }
+
+    /**
+     * @return array<string, mixed>|null
+     */
+    private function activePlan(User $user): ?array
+    {
+        $subscription = $this->academySubscription($user);
+
+        if (! $subscription instanceof Subscription || (! $subscription->active() && ! $subscription->onGracePeriod())) {
+            return null;
+        }
+
+        $matchedPlan = null;
+
+        foreach ($subscription->items as $item) {
+            $priceId = trim((string) $item->stripe_price);
+
+            if ($priceId === '') {
+                continue;
+            }
+
+            $plan = $this->plans->planForPriceId($priceId);
+
+            if ($plan === null) {
+                continue;
+            }
+
+            if ($matchedPlan === null || $this->planRank((string) $plan['tier']) > $this->planRank((string) $matchedPlan['tier'])) {
+                $matchedPlan = $plan;
+            }
+        }
+
+        if ($matchedPlan !== null) {
+            return $matchedPlan;
+        }
+
+        $fallbackPriceId = trim((string) $subscription->stripe_price);
+
+        return $fallbackPriceId !== '' ? $this->plans->planForPriceId($fallbackPriceId) : null;
+    }
+
+    private function planRank(string $tier): int
+    {
+        return match (strtolower(trim($tier))) {
+            'admin' => 40,
+            'pro' => 30,
+            'creator' => 20,
+            default => 10,
+        };
+    }
+
+    private function billingDisabledResponse(\Illuminate\Http\Request $request, string $message): \Illuminate\Http\JsonResponse|\Illuminate\Http\RedirectResponse
+    {
+        $payload = [
+            'ok' => false,
+            'code' => 'academy_payments_disabled',
+            'message' => $message,
+        ];
+
+        if ($request->expectsJson()) {
+            return \response()->json($payload, 423);
+        }
+
+        return \redirect()->route('academy.pricing')->with('error', $message);
+    }
+
+    private function missingPriceIdResponse(\Illuminate\Http\Request $request, string $planKey): \Illuminate\Http\JsonResponse|\Illuminate\Http\RedirectResponse
+    {
+        $message = 'The selected Academy plan is not configured yet. Please try again later.';
+
+        if ($request->expectsJson()) {
+            return \response()->json([
+                'ok' => false,
+                'code' => 'academy_billing_price_missing',
+                'message' => $message,
+                'plan' => $planKey,
+            ], 422);
+        }
+
+        return \redirect()->route('academy.pricing')->with('error', $message);
+    }
+
+    private function invalidPriceIdResponse(\Illuminate\Http\Request $request, string $planKey): \Illuminate\Http\JsonResponse|\Illuminate\Http\RedirectResponse
+    {
+        $message = 'The selected Academy plan is misconfigured. Please contact support before continuing.';
+
+        if ($request->expectsJson()) {
+            return \response()->json([
+                'ok' => false,
+                'code' => 'academy_billing_price_invalid',
+                'message' => $message,
+                'plan' => $planKey,
+            ], 422);
+        }
+
+        return \redirect()->route('academy.pricing')->with('error', $message);
+    }
+
+    private function checkoutErrorResponse(\Illuminate\Http\Request $request, \Throwable $exception): \Illuminate\Http\JsonResponse|\Illuminate\Http\RedirectResponse
+    {
+        $message = 'Academy checkout could not be started right now.';
+
+        if (app()->hasDebugModeEnabled() && trim($exception->getMessage()) !== '') {
+            $message .= ' '.$exception->getMessage();
+        }
+
+        if ($request->expectsJson()) {
+            return \response()->json([
+                'ok' => false,
+                'code' => 'academy_billing_checkout_failed',
+                'message' => $message,
+            ], 422);
+        }
+
+        return \redirect()->route('academy.pricing')->with('error', $message);
+    }
+}

app/Http/Controllers/Academy/AcademyChallengeController.php

@@ -7,6 +7,8 @@ namespace App\Http\Controllers\Academy;
 use App\Http\Controllers\Controller;
 use App\Models\AcademyChallenge;
 use App\Services\Academy\AcademyAccessService;
+use App\Services\Academy\AcademyInteractionService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
 use App\Support\Seo\SeoFactory;
 use Illuminate\Http\Request;
 use Illuminate\Support\Str;
@@ -15,7 +17,10 @@ use Inertia\Response;
 
 final class AcademyChallengeController extends Controller
 {
-    public function __construct(private readonly AcademyAccessService $access)
+    public function __construct(
+        private readonly AcademyAccessService $access,
+        private readonly AcademyInteractionService $interactions,
+    )
     {
     }
 
@@ -49,7 +54,17 @@ final class AcademyChallengeController extends Controller
             'filters' => [],
             'categories' => [],
             'pricingUrl' => route('academy.pricing'),
-        ])->rootView('collections');
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => null,
+                'contentId' => null,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_challenges_index',
+                'isPremium' => false,
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+            ],
+        ])->rootView('academy');
     }
 
     public function show(Request $request, string $slug): Response
@@ -86,12 +101,31 @@ final class AcademyChallengeController extends Controller
             $challenge->cover_image,
         )->toArray();
 
+        $interaction = $this->interactions->getInteractionState($request->user(), AcademyAnalyticsContentType::CHALLENGE, (int) $challenge->id);
+
         return Inertia::render('Academy/Show', [
             'pageType' => 'challenge',
             'item' => $payload,
             'seo' => $seo,
             'pricingUrl' => route('academy.pricing'),
             'submitUrl' => $request->user() ? route('academy.challenges.submit', ['slug' => $challenge->slug]) : null,
-        ])->rootView('collections');
+            'interaction' => $interaction,
+            'interactionRoutes' => [
+                'like' => route('academy.interactions.like'),
+                'save' => route('academy.interactions.save'),
+            ],
+            'loginUrl' => route('login'),
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::CHALLENGE,
+                'contentId' => (int) $challenge->id,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_challenge_show',
+                'isPremium' => (string) ($challenge->access_level ?? 'free') !== 'free',
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+                'isLocked' => (bool) ($payload['locked'] ?? false),
+            ],
+        ])->rootView('academy');
     }
 }

app/Http/Controllers/Academy/AcademyChallengeSubmissionController.php

@@ -47,7 +47,7 @@ final class AcademyChallengeSubmissionController extends Controller
                 'published_at' => $artwork->published_at?->toISOString(),
             ])->values()->all(),
             'submitUrl' => route('academy.challenges.submit.store', ['slug' => $challenge->slug]),
-        ])->rootView('collections');
+        ])->rootView('academy');
     }
 
     public function store(StoreAcademyChallengeSubmissionRequest $request, string $slug): RedirectResponse

app/Http/Controllers/Academy/AcademyCourseController.php

@@ -0,0 +1,223 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Academy;
+
+use App\Http\Controllers\Controller;
+use App\Models\AcademyCourse;
+use App\Models\AcademyCourseLesson;
+use App\Services\Academy\AcademyAccessService;
+use App\Services\Academy\AcademyInteractionService;
+use App\Services\Academy\AcademyCacheService;
+use App\Services\Academy\AcademyCourseNavigationService;
+use App\Services\Academy\AcademyCourseProgressService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
+use App\Support\Seo\SeoFactory;
+use Illuminate\Http\Request;
+use Inertia\Inertia;
+use Inertia\Response;
+
+final class AcademyCourseController extends Controller
+{
+    public function __construct(
+        private readonly AcademyAccessService $access,
+        private readonly AcademyCacheService $cache,
+        private readonly AcademyCourseNavigationService $navigation,
+        private readonly AcademyCourseProgressService $progress,
+        private readonly AcademyInteractionService $interactions,
+    ) {
+    }
+
+    public function index(Request $request): Response
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+
+        $filters = $request->validate([
+            'difficulty' => ['nullable', 'string', 'max:40'],
+            'access' => ['nullable', 'string', 'max:40'],
+        ]);
+
+        $query = AcademyCourse::query()->published()->ordered();
+
+        if (filled($filters['difficulty'] ?? null)) {
+            $query->where('difficulty', $filters['difficulty']);
+        }
+
+        if (filled($filters['access'] ?? null)) {
+            $query->where('access_level', $filters['access']);
+        }
+
+        $courses = $query->paginate(12)->withQueryString();
+        $courses->getCollection()->transform(function (AcademyCourse $course) use ($request): array {
+            return $this->access->coursePayload($course, $request->user(), [
+                'progress' => $this->progress->getProgress($request->user(), $course),
+            ]);
+        });
+
+        $featuredCourses = collect($this->cache->featuredCourses())->map(fn (AcademyCourse $course): array => $this->access->coursePayload($course, $request->user(), [
+            'progress' => $this->progress->getProgress($request->user(), $course),
+        ]))->values();
+
+        $seoCourses = $featuredCourses
+            ->concat(collect($courses->items()))
+            ->unique(fn (array $course): string => (string) ($course['slug'] ?? ''))
+            ->values();
+
+        $seo = app(SeoFactory::class)
+            ->academyCourseListingPage(
+                'Academy Courses — Skinbase',
+                'Follow guided Skinbase AI Academy courses built from reusable lessons, chapters, and creator workflows.',
+                route('academy.courses.index', $request->query()),
+                $seoCourses,
+                [
+                    ['name' => 'Academy', 'url' => route('academy.index')],
+                    ['name' => 'Courses', 'url' => route('academy.courses.index')],
+                ],
+            )
+            ->toArray();
+
+        return Inertia::render('Academy/CoursesIndex', [
+            'seo' => $seo,
+            'title' => 'Academy courses',
+            'description' => 'Guided learning paths built from reusable Academy lessons and creator workflows.',
+            'items' => $courses,
+            'featuredCourses' => $featuredCourses->all(),
+            'filters' => $filters,
+            'pricingUrl' => route('academy.pricing'),
+            'lessonsUrl' => route('academy.lessons.index'),
+            'promptLibraryUrl' => route('academy.prompts.index'),
+            'academyAccess' => array_merge($this->access->accessSummary($request->user()), [
+                'billingUrl' => $request->user() && (bool) config('academy_billing.enabled', false)
+                    ? route('academy.billing.account')
+                    : route('academy.pricing'),
+            ]),
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => null,
+                'contentId' => null,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_courses_index',
+                'isPremium' => false,
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+            ],
+        ])->rootView('academy');
+    }
+
+    public function show(Request $request, AcademyCourse $course): Response
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+        abort_unless($course->isPublished(), 404);
+
+        $course->load(['sections', 'courseLessons.section', 'courseLessons.lesson.category']);
+
+        $progress = $this->progress->getProgress($request->user(), $course);
+        $completedLessonIds = $request->user() ? $this->progress->getCompletedLessonIds($request->user(), $course) : [];
+        $orderedLessons = $this->navigation->orderedCourseLessons($course);
+        $stepMeta = $orderedLessons
+            ->values()
+            ->mapWithKeys(fn (AcademyCourseLesson $courseLesson, int $index): array => [
+                $courseLesson->id => [
+                    'course_step_number' => $index + 1,
+                    'course_step_label' => sprintf('Step %02d', $index + 1),
+                ],
+            ]);
+        $sections = $course->sections
+            ->sortBy([['order_num', 'asc'], ['id', 'asc']])
+            ->values()
+            ->map(function ($section) use ($completedLessonIds, $orderedLessons, $request, $stepMeta): array {
+                $sectionLessons = $orderedLessons
+                    ->where('section_id', $section->id)
+                    ->values()
+                    ->map(fn (AcademyCourseLesson $courseLesson): array => $this->access->courseLessonPayload($courseLesson, $request->user(), false, [
+                        'completed_lesson_ids' => $completedLessonIds,
+                        ...((array) $stepMeta->get($courseLesson->id, [])),
+                    ]))
+                    ->all();
+
+                return [
+                    'id' => (int) $section->id,
+                    'title' => (string) $section->title,
+                    'slug' => (string) ($section->slug ?? ''),
+                    'description' => (string) ($section->description ?? ''),
+                    'order_num' => (int) ($section->order_num ?? 0),
+                    'is_visible' => (bool) ($section->is_visible ?? true),
+                    'lessons' => $sectionLessons,
+                ];
+            })
+            ->all();
+
+        $unsectionedLessons = $orderedLessons
+            ->whereNull('section_id')
+            ->values()
+            ->map(fn (AcademyCourseLesson $courseLesson): array => $this->access->courseLessonPayload($courseLesson, $request->user(), false, [
+                'completed_lesson_ids' => $completedLessonIds,
+                ...((array) $stepMeta->get($courseLesson->id, [])),
+            ]))
+            ->all();
+
+        $coursePayload = $this->access->coursePayload($course, $request->user(), ['progress' => $progress]);
+        $courseKeywords = collect(explode(',', (string) ($course->meta_keywords ?? '')))
+            ->map(fn (string $keyword): string => trim($keyword))
+            ->filter()
+            ->values()
+            ->all();
+        $courseImage = (string) ($coursePayload['cover_image_url'] ?? $coursePayload['teaser_image_url'] ?? $course->og_image ?? $course->cover_image ?? $course->teaser_image ?? '');
+
+        $seo = app(SeoFactory::class)
+            ->academyCoursePage(
+                (string) ($course->seo_title ?: ($course->title . ' — Skinbase Academy')),
+                (string) ($course->seo_description ?: $course->excerpt ?: 'Skinbase Academy course'),
+                route('academy.courses.show', ['course' => $course->slug]),
+                $courseImage,
+                [
+                    ['name' => 'Academy', 'url' => route('academy.index')],
+                    ['name' => 'Courses', 'url' => route('academy.courses.index')],
+                    ['name' => (string) $course->title, 'url' => route('academy.courses.show', ['course' => $course->slug])],
+                ],
+                $courseKeywords,
+                $course->published_at?->toAtomString(),
+                $course->updated_at?->toAtomString(),
+                (string) ($course->access_level ?? ''),
+                (string) ($course->difficulty ?? ''),
+                (int) ($course->estimated_minutes ?? 0),
+                $orderedLessons
+                    ->values()
+                    ->map(fn (AcademyCourseLesson $courseLesson): array => $this->access->courseLessonPayload($courseLesson, $request->user(), false, [
+                        'completed_lesson_ids' => $completedLessonIds,
+                        ...((array) $stepMeta->get($courseLesson->id, [])),
+                    ]))
+                    ->all(),
+            )
+            ->toArray();
+
+        $interaction = $this->interactions->getInteractionState($request->user(), AcademyAnalyticsContentType::COURSE, (int) $course->id);
+
+        return Inertia::render('Academy/CoursesShow', [
+            'seo' => $seo,
+            'course' => $coursePayload,
+            'sections' => $sections,
+            'unsectionedLessons' => $unsectionedLessons,
+            'pricingUrl' => route('academy.pricing'),
+            'startUrl' => $request->user() ? route('academy.courses.start', ['course' => $course->slug]) : null,
+            'interaction' => $interaction,
+            'interactionRoutes' => [
+                'like' => route('academy.interactions.like'),
+                'save' => route('academy.interactions.save'),
+            ],
+            'loginUrl' => route('login'),
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::COURSE,
+                'contentId' => (int) $course->id,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_course_show',
+                'isPremium' => (string) ($course->access_level ?? 'free') !== 'free',
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+                'isLocked' => false,
+            ],
+        ])->rootView('academy');
+    }
+}

app/Http/Controllers/Academy/AcademyCourseEnrollmentController.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Academy;
+
+use App\Http\Controllers\Controller;
+use App\Models\AcademyCourse;
+use App\Services\Academy\AcademyProgressService;
+use App\Services\Academy\AcademyCourseProgressService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+
+final class AcademyCourseEnrollmentController extends Controller
+{
+    public function __construct(
+        private readonly AcademyCourseProgressService $progress,
+        private readonly AcademyProgressService $academyProgress,
+    ) {
+    }
+
+    public function start(Request $request, AcademyCourse $course): RedirectResponse
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+        abort_unless($course->isPublished(), 404);
+
+        $this->academyProgress->startCourse($request->user(), (int) $course->id, $request);
+        $continueLesson = $this->progress->getContinueLesson($request->user(), $course);
+
+        if ($continueLesson?->lesson) {
+            return redirect()->route('academy.courses.lessons.show', ['course' => $course->slug, 'lesson' => $continueLesson->lesson->slug]);
+        }
+
+        return redirect()->route('academy.courses.show', ['course' => $course->slug]);
+    }
+}

app/Http/Controllers/Academy/AcademyCourseLessonController.php

@@ -0,0 +1,124 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Academy;
+
+use App\Http\Controllers\Controller;
+use App\Models\AcademyCourse;
+use App\Models\AcademyLesson;
+use App\Services\Academy\AcademyAccessService;
+use App\Services\Academy\AcademyInteractionService;
+use App\Services\Academy\AcademyCourseNavigationService;
+use App\Services\Academy\AcademyCourseProgressService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
+use App\Support\Seo\SeoFactory;
+use Illuminate\Support\Str;
+use Illuminate\Http\Request;
+use Inertia\Inertia;
+use Inertia\Response;
+
+final class AcademyCourseLessonController extends Controller
+{
+    public function __construct(
+        private readonly AcademyAccessService $access,
+        private readonly AcademyCourseNavigationService $navigation,
+        private readonly AcademyCourseProgressService $progress,
+        private readonly AcademyInteractionService $interactions,
+    ) {
+    }
+
+    public function show(Request $request, AcademyCourse $course, AcademyLesson $lesson): Response
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+        abort_unless($course->isPublished(), 404);
+
+        $course->load(['sections', 'courseLessons.section', 'courseLessons.lesson.category']);
+        $courseLesson = $this->navigation->findCourseLesson($course, $lesson);
+
+        abort_unless($courseLesson instanceof \App\Models\AcademyCourseLesson, 404);
+
+        if ($request->user()) {
+            $this->progress->updateLastLesson($request->user(), $course, $lesson);
+            $this->progress->markCourseCompletedIfFinished($request->user(), $course);
+        }
+
+        $progress = $this->progress->getProgress($request->user(), $course);
+        $previousLesson = $this->navigation->previousLesson($course, $lesson);
+        $nextLesson = $this->navigation->nextLesson($course, $lesson);
+        $courseOutline = $this->navigation->orderedCourseLessons($course)
+            ->map(fn (\App\Models\AcademyCourseLesson $entry): array => $this->access->courseLessonPayload($entry, $request->user()))
+            ->values()
+            ->all();
+
+        $payload = $this->access->courseLessonPayload($courseLesson, $request->user(), true);
+        $canonical = route('academy.courses.lessons.show', ['course' => $course->slug, 'lesson' => $lesson->slug]);
+        $description = Str::limit(trim((string) ($lesson->seo_description ?? $lesson->excerpt ?? 'Skinbase Academy course lesson.')), 160, '...');
+        $seo = app(SeoFactory::class)->academyLessonPage(
+            (string) ($lesson->seo_title ?? ($lesson->title . ' — ' . $course->title)),
+            $description,
+            $canonical,
+            (string) ($payload['article_cover_image_url'] ?? $payload['cover_image_url'] ?? $lesson->cover_image ?? ''),
+            [
+                ['name' => 'Academy', 'url' => route('academy.index')],
+                ['name' => 'Courses', 'url' => route('academy.courses.index')],
+                ['name' => (string) $course->title, 'url' => route('academy.courses.show', ['course' => $course->slug])],
+                ['name' => (string) $lesson->title, 'url' => $canonical],
+            ],
+            array_values((array) ($payload['tags'] ?? [])),
+            $lesson->published_at?->toAtomString(),
+            $lesson->updated_at?->toAtomString(),
+            (string) $course->title,
+        )->toArray();
+
+        $interaction = $this->interactions->getInteractionState($request->user(), AcademyAnalyticsContentType::LESSON, (int) $lesson->id);
+
+        return Inertia::render('Academy/Show', [
+            'pageType' => 'lesson',
+            'item' => $payload,
+            'relatedLessons' => [],
+            'relatedCourses' => [],
+            'previousLesson' => $previousLesson ? $this->access->courseLessonPayload($previousLesson, $request->user()) : null,
+            'nextLesson' => $nextLesson ? $this->access->courseLessonPayload($nextLesson, $request->user()) : null,
+            'seo' => $seo,
+            'pricingUrl' => route('academy.pricing'),
+            'completeUrl' => $request->user() ? route('academy.lessons.complete', ['lesson' => $lesson->id]) : null,
+            'completed' => $request->user()?->academyLessonProgress()->where('lesson_id', $lesson->id)->whereNotNull('completed_at')->exists() ?? false,
+            'interaction' => $interaction,
+            'interactionRoutes' => [
+                'like' => route('academy.interactions.like'),
+                'save' => route('academy.interactions.save'),
+            ],
+            'loginUrl' => route('login'),
+            'progressRoutes' => [
+                'startLesson' => $request->user() ? route('academy.progress.lesson.start') : null,
+            ],
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::LESSON,
+                'contentId' => (int) $lesson->id,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_course_lesson_show',
+                'isPremium' => (string) ($payload['access_level'] ?? 'free') !== 'free',
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+                'isLocked' => (bool) ($payload['locked'] ?? false),
+            ],
+            'courseContext' => [
+                'id' => (int) $course->id,
+                'title' => (string) $course->title,
+                'slug' => (string) $course->slug,
+                'subtitle' => (string) ($course->subtitle ?? ''),
+                'showUrl' => route('academy.courses.show', ['course' => $course->slug]),
+                'completePayload' => ['course_id' => $course->id],
+                'progress' => [
+                    'percent' => (int) ($progress['progress_percent'] ?? 0),
+                    'completedRequired' => (int) ($progress['completed_required'] ?? 0),
+                    'totalRequired' => (int) ($progress['total_required'] ?? 0),
+                    'completed' => (bool) ($progress['completed'] ?? false),
+                ],
+                'outline' => $courseOutline,
+            ],
+        ])->rootView('academy');
+    }
+}

app/Http/Controllers/Academy/AcademyHomeController.php

@@ -6,10 +6,12 @@ namespace App\Http\Controllers\Academy;
 
 use App\Http\Controllers\Controller;
 use App\Models\AcademyChallenge;
+use App\Models\AcademyCourse;
 use App\Models\AcademyLesson;
 use App\Models\AcademyPromptTemplate;
 use App\Services\Academy\AcademyAccessService;
 use App\Services\Academy\AcademyCacheService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
 use App\Support\Seo\SeoFactory;
 use Illuminate\Http\Request;
 use Inertia\Inertia;
@@ -41,11 +43,13 @@ final class AcademyHomeController extends Controller
         $home = $this->cache->homePayload(function (): array {
             return [
                 'featuredLessons' => $this->cache->featuredLessons(),
+                'featuredCourses' => $this->cache->featuredCourses(),
                 'featuredPrompts' => $this->cache->featuredPrompts(),
                 'featuredChallenges' => (bool) config('academy.challenges_enabled', true)
                     ? $this->cache->featuredChallenges()
                     : [],
                 'lessonCount' => AcademyLesson::query()->active()->published()->count(),
+                'courseCount' => AcademyCourse::query()->published()->count(),
                 'promptCount' => AcademyPromptTemplate::query()->active()->published()->count(),
                 'challengeCount' => (bool) config('academy.challenges_enabled', true)
                     ? AcademyChallenge::query()->publiclyVisible()->count()
@@ -56,9 +60,16 @@ final class AcademyHomeController extends Controller
         return Inertia::render('Academy/Index', [
             'seo' => $seo,
             'pricingUrl' => route('academy.pricing'),
+            'academyAccess' => array_merge($this->access->accessSummary($request->user()), [
+                'billingUrl' => $request->user() && (bool) config('academy_billing.enabled', false)
+                    ? route('academy.billing.account')
+                    : route('academy.pricing'),
+            ]),
             'links' => [
                 'lessons' => route('academy.lessons.index'),
+                'courses' => route('academy.courses.index'),
                 'prompts' => route('academy.prompts.index'),
+                'promptPopular' => route('academy.prompts.popular'),
                 'packs' => route('academy.packs.index'),
                 'challenges' => route('academy.challenges.index'),
             ],
@@ -69,12 +80,24 @@ final class AcademyHomeController extends Controller
             ],
             'stats' => [
                 'lessonCount' => (int) $home['lessonCount'],
+                'courseCount' => (int) $home['courseCount'],
                 'promptCount' => (int) $home['promptCount'],
                 'challengeCount' => (int) $home['challengeCount'],
             ],
+            'featuredCourses' => collect($home['featuredCourses'])->map(fn (AcademyCourse $course): array => $this->access->coursePayload($course, $request->user()))->values()->all(),
             'featuredLessons' => collect($home['featuredLessons'])->map(fn (AcademyLesson $lesson): array => $this->access->lessonPayload($lesson, $request->user()))->values()->all(),
             'featuredPrompts' => collect($home['featuredPrompts'])->map(fn (AcademyPromptTemplate $prompt): array => $this->access->promptPayload($prompt, $request->user()))->values()->all(),
             'featuredChallenges' => collect($home['featuredChallenges'])->map(fn (AcademyChallenge $challenge): array => $this->access->challengePayload($challenge, $request->user(), true))->values()->all(),
-        ])->rootView('collections');
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::HOME,
+                'contentId' => null,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_home',
+                'isPremium' => false,
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+            ],
+        ])->rootView('academy');
     }
 }

app/Http/Controllers/Academy/AcademyInteractionController.php

@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Academy;
+
+use App\Http\Controllers\Controller;
+use App\Services\Academy\AcademyInteractionService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Validation\Rule;
+use InvalidArgumentException;
+
+final class AcademyInteractionController extends Controller
+{
+    public function __construct(private readonly AcademyInteractionService $interactions)
+    {
+    }
+
+    public function like(Request $request): JsonResponse
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+
+        $validated = $this->validatePayload($request);
+
+        try {
+            $payload = $this->interactions->toggleLike($request->user(), (string) $validated['content_type'], (int) $validated['content_id'], $request);
+        } catch (InvalidArgumentException $exception) {
+            return response()->json(['message' => $exception->getMessage()], 422);
+        }
+
+        return response()->json($payload);
+    }
+
+    public function save(Request $request): JsonResponse
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+
+        $validated = $this->validatePayload($request);
+
+        try {
+            $payload = $this->interactions->toggleSave($request->user(), (string) $validated['content_type'], (int) $validated['content_id'], $request);
+        } catch (InvalidArgumentException $exception) {
+            return response()->json(['message' => $exception->getMessage()], 422);
+        }
+
+        return response()->json($payload);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function validatePayload(Request $request): array
+    {
+        return $request->validate([
+            'content_type' => ['required', 'string', Rule::in([
+                AcademyAnalyticsContentType::PROMPT,
+                AcademyAnalyticsContentType::LESSON,
+                AcademyAnalyticsContentType::COURSE,
+                AcademyAnalyticsContentType::PROMPT_PACK,
+                AcademyAnalyticsContentType::CHALLENGE,
+            ])],
+            'content_id' => ['required', 'integer', 'min:1'],
+        ]);
+    }
+}

app/Http/Controllers/Academy/AcademyLessonController.php

@@ -5,10 +5,15 @@ declare(strict_types=1);
 namespace App\Http\Controllers\Academy;
 
 use App\Http\Controllers\Controller;
+use App\Models\AcademyCourse;
 use App\Models\AcademyLesson;
 use App\Services\Academy\AcademyAccessService;
+use App\Services\Academy\AcademyAnalyticsService;
 use App\Services\Academy\AcademyCacheService;
+use App\Services\Academy\AcademyInteractionService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
 use App\Support\Seo\SeoFactory;
+use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Support\Str;
 use Inertia\Inertia;
@@ -19,9 +24,11 @@ final class AcademyLessonController extends Controller
     public function __construct(
         private readonly AcademyAccessService $access,
         private readonly AcademyCacheService $cache,
+        private readonly AcademyAnalyticsService $analytics,
+        private readonly AcademyInteractionService $interactions,
     ) {}
 
-    public function index(Request $request): Response
+    public function index(Request $request): Response|JsonResponse
     {
         abort_unless((bool) config('academy.enabled', true), 404);
 
@@ -35,7 +42,7 @@ final class AcademyLessonController extends Controller
             ->with('category')
             ->active()
             ->published()
-            ->latest('published_at');
+            ->orderedForCourse();
 
         if (filled($filters['q'] ?? null)) {
             $query->where(function ($builder) use ($filters): void {
@@ -55,6 +62,14 @@ final class AcademyLessonController extends Controller
         $lessons = $query->paginate(12)->withQueryString();
         $lessons->getCollection()->transform(fn (AcademyLesson $lesson): array => $this->access->lessonPayload($lesson, $request->user()));
 
+        if (filled($filters['q'] ?? null)) {
+            $this->analytics->trackSearch((string) $filters['q'], (int) $lessons->total(), array_filter($filters), $request);
+        }
+
+        if ($request->expectsJson()) {
+            return response()->json($lessons);
+        }
+
         $seo = app(SeoFactory::class)
             ->collectionListing(
                 'Academy Lessons — Skinbase',
@@ -68,11 +83,36 @@ final class AcademyLessonController extends Controller
             'title' => 'Academy lessons',
             'description' => 'Step-by-step tutorials and workflow guides for AI-assisted creative work on Skinbase.',
             'seo' => $seo,
+            'breadcrumbs' => [
+                ['label' => 'Academy', 'href' => route('academy.index')],
+                ['label' => 'Lessons', 'href' => route('academy.lessons.index')],
+            ],
             'items' => $lessons,
             'filters' => $filters,
             'categories' => $this->cache->categoriesByType('lesson'),
             'pricingUrl' => route('academy.pricing'),
-        ])->rootView('collections');
+            'coursesUrl' => route('academy.courses.index'),
+            'promptLibraryUrl' => route('academy.prompts.index'),
+            'academyAccess' => array_merge($this->access->accessSummary($request->user()), [
+                'billingUrl' => $request->user() && (bool) config('academy_billing.enabled', false)
+                    ? route('academy.billing.account')
+                    : route('academy.pricing'),
+            ]),
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => filled($filters['q'] ?? null) ? AcademyAnalyticsContentType::SEARCH : null,
+                'contentId' => null,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_lessons_index',
+                'search' => filled($filters['q'] ?? null) ? [
+                    'query' => (string) $filters['q'],
+                    'resultsCount' => (int) $lessons->total(),
+                ] : null,
+                'isPremium' => false,
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+            ],
+        ])->rootView('academy');
     }
 
     public function show(Request $request, string $slug): Response
@@ -87,37 +127,99 @@ final class AcademyLessonController extends Controller
             ->firstOrFail();
 
         $payload = $this->access->lessonPayload($lesson, $request->user(), true);
-        $relatedLessons = $lesson->category_id !== null
+        $courseQuery = AcademyLesson::query()
-            ? AcademyLesson::query()
             ->with('category')
             ->active()
-                ->published()
+            ->published();
-                ->where('category_id', $lesson->category_id)
+
-                ->where('id', '!=', $lesson->id)
+        if (filled($lesson->series_name)) {
-                ->orderByDesc('published_at')
+            $courseQuery->where('series_name', $lesson->series_name);
-                ->limit(6)
+        } elseif ($lesson->category_id !== null) {
+            $courseQuery->where('category_id', $lesson->category_id);
+        } else {
+            $courseQuery->whereKey($lesson->id);
+        }
+
+        $courseLessons = $courseQuery
+            ->orderedForCourse()
             ->get()
+            ->filter(fn (AcademyLesson $courseLesson): bool => $this->access->canAccessLesson($request->user(), $courseLesson))
+            ->values();
+
+        $currentIndex = $courseLessons->search(fn (AcademyLesson $courseLesson): bool => $courseLesson->is($lesson));
+        $previousLesson = is_int($currentIndex) && $currentIndex > 0
+            ? $courseLessons->get($currentIndex - 1)
+            : null;
+        $nextLesson = is_int($currentIndex) && $currentIndex < ($courseLessons->count() - 1)
+            ? $courseLessons->get($currentIndex + 1)
+            : null;
+
+        $relatedLessons = $courseLessons
+            ->reject(fn (AcademyLesson $courseLesson): bool => $courseLesson->is($lesson))
+            ->take(6)
             ->map(fn (AcademyLesson $relatedLesson): array => $this->access->lessonPayload($relatedLesson, $request->user()))
             ->values()
-                ->all()
+            ->all();
-            : [];
+        $relatedCourses = AcademyCourse::query()
+            ->published()
+            ->ordered()
+            ->whereHas('courseLessons', fn ($builder) => $builder->where('lesson_id', $lesson->id))
+            ->limit(3)
+            ->get()
+            ->map(fn (AcademyCourse $course): array => $this->access->coursePayload($course, $request->user()))
+            ->values()
+            ->all();
         $canonical = route('academy.lessons.show', ['slug' => $lesson->slug]);
         $description = Str::limit(trim((string) ($lesson->seo_description ?? $lesson->excerpt ?? 'Skinbase Academy lesson.')), 160, '...');
-        $seo = app(SeoFactory::class)->collectionPage(
+        $seo = app(SeoFactory::class)->academyLessonPage(
             (string) ($lesson->seo_title ?? ($lesson->title.' — Skinbase Academy')),
             $description,
             $canonical,
-            $lesson->cover_image,
+            (string) ($payload['article_cover_image_url'] ?? $payload['cover_image_url'] ?? $lesson->cover_image ?? ''),
+            [
+                ['name' => 'Academy', 'url' => route('academy.index')],
+                ['name' => 'Lessons', 'url' => route('academy.lessons.index')],
+                ['name' => (string) $lesson->title, 'url' => $canonical],
+            ],
+            array_values((array) ($payload['tags'] ?? [])),
+            $lesson->published_at?->toAtomString(),
+            $lesson->updated_at?->toAtomString(),
+            (string) ($lesson->series_name ?: $lesson->category?->name ?: 'Academy'),
         )->toArray();
 
+        $interaction = $this->interactions->getInteractionState($request->user(), AcademyAnalyticsContentType::LESSON, (int) $lesson->id);
+
         return Inertia::render('Academy/Show', [
             'pageType' => 'lesson',
             'item' => $payload,
             'relatedLessons' => $relatedLessons,
+            'relatedCourses' => $relatedCourses,
+            'previousLesson' => $previousLesson ? $this->access->lessonPayload($previousLesson, $request->user()) : null,
+            'nextLesson' => $nextLesson ? $this->access->lessonPayload($nextLesson, $request->user()) : null,
             'seo' => $seo,
             'pricingUrl' => route('academy.pricing'),
             'completeUrl' => $request->user() ? route('academy.lessons.complete', ['lesson' => $lesson->id]) : null,
             'completed' => $request->user()?->academyLessonProgress()->where('lesson_id', $lesson->id)->whereNotNull('completed_at')->exists() ?? false,
-        ])->rootView('collections');
+            'interaction' => $interaction,
+            'interactionRoutes' => [
+                'like' => route('academy.interactions.like'),
+                'save' => route('academy.interactions.save'),
+            ],
+            'loginUrl' => route('login'),
+            'progressRoutes' => [
+                'startLesson' => $request->user() ? route('academy.progress.lesson.start') : null,
+            ],
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::LESSON,
+                'contentId' => (int) $lesson->id,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_lesson_show',
+                'isPremium' => (string) ($lesson->access_level ?? 'free') !== 'free',
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+                'isLocked' => (bool) ($payload['locked'] ?? false),
+            ],
+        ])->rootView('academy');
     }
 }

app/Http/Controllers/Academy/AcademyPricingController.php

@@ -5,13 +5,15 @@ declare(strict_types=1);
 namespace App\Http\Controllers\Academy;
 
 use App\Http\Controllers\Controller;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
 use App\Support\Seo\SeoFactory;
+use Illuminate\Http\Request;
 use Inertia\Inertia;
 use Inertia\Response;
 
 final class AcademyPricingController extends Controller
 {
-    public function index(): Response
+    public function index(Request $request): Response
     {
         abort_unless((bool) config('academy.enabled', true), 404);
 
@@ -67,6 +69,16 @@ final class AcademyPricingController extends Controller
                     ],
                 ],
             ],
-        ])->rootView('collections');
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::UPGRADE,
+                'contentId' => null,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_pricing',
+                'isPremium' => false,
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+            ],
+        ])->rootView('academy');
     }
 }

app/Http/Controllers/Academy/AcademyProgressController.php

@@ -5,6 +5,7 @@ declare(strict_types=1);
 namespace App\Http\Controllers\Academy;
 
 use App\Http\Controllers\Controller;
+use App\Models\AcademyCourse;
 use App\Models\AcademyLesson;
 use App\Services\Academy\AcademyAccessService;
 use App\Services\Academy\AcademyProgressService;
@@ -19,12 +20,44 @@ final class AcademyProgressController extends Controller
     ) {
     }
 
+    public function startLesson(Request $request): JsonResponse
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+
+        $validated = $request->validate([
+            'lesson_id' => ['required', 'integer', 'min:1'],
+            'course_id' => ['nullable', 'integer', 'min:1'],
+        ]);
+
+        $lesson = AcademyLesson::query()->findOrFail((int) $validated['lesson_id']);
+        abort_unless($this->access->canAccessLesson($request->user(), $lesson), 403);
+
+        $courseId = $request->filled('course_id') ? (int) $validated['course_id'] : null;
+        if ($courseId !== null) {
+            $course = AcademyCourse::query()->published()->findOrFail($courseId);
+            abort_unless($course->courseLessons()->where('lesson_id', $lesson->id)->exists(), 403);
+        }
+
+        $record = $this->progress->startLesson($request->user(), (int) $lesson->id, $courseId, $request);
+
+        return response()->json([
+            'ok' => true,
+            'status' => (string) $record->status,
+        ]);
+    }
+
     public function complete(Request $request, AcademyLesson $lesson): JsonResponse
     {
         abort_unless((bool) config('academy.enabled', true), 404);
         abort_unless($this->access->canAccessLesson($request->user(), $lesson), 403);
 
-        $record = $this->progress->markLessonComplete($request->user(), $lesson);
+        $course = null;
+
+        if ($request->filled('course_id')) {
+            $course = AcademyCourse::query()->published()->find($request->integer('course_id'));
+        }
+
+        $record = $this->progress->markLessonComplete($request->user(), $lesson, $course, $request);
 
         return response()->json([
             'ok' => true,
@@ -32,4 +65,55 @@ final class AcademyProgressController extends Controller
             'completed_at' => $record->completed_at?->toISOString(),
         ]);
     }
+
+    public function completeLesson(Request $request): JsonResponse
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+
+        $validated = $request->validate([
+            'lesson_id' => ['required', 'integer', 'min:1'],
+            'course_id' => ['nullable', 'integer', 'min:1'],
+        ]);
+
+        $lesson = AcademyLesson::query()->findOrFail((int) $validated['lesson_id']);
+
+        return $this->complete($request, $lesson);
+    }
+
+    public function startCourse(Request $request): JsonResponse
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+
+        $validated = $request->validate([
+            'course_id' => ['required', 'integer', 'min:1'],
+        ]);
+
+        $course = AcademyCourse::query()->published()->findOrFail((int) $validated['course_id']);
+        $record = $this->progress->startCourse($request->user(), (int) $course->id, $request);
+
+        return response()->json([
+            'ok' => true,
+            'status' => (string) $record->status,
+            'progress_percent' => (int) $record->progress_percent,
+        ]);
+    }
+
+    public function completeCourse(Request $request): JsonResponse
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+
+        $validated = $request->validate([
+            'course_id' => ['required', 'integer', 'min:1'],
+        ]);
+
+        $course = AcademyCourse::query()->published()->findOrFail((int) $validated['course_id']);
+        $record = $this->progress->completeCourse($request->user(), (int) $course->id, $request);
+
+        return response()->json([
+            'ok' => true,
+            'status' => (string) $record->status,
+            'progress_percent' => (int) $record->progress_percent,
+            'completed' => (string) $record->status === 'completed',
+        ]);
+    }
 }

app/Http/Controllers/Academy/AcademyPromptController.php

@@ -7,10 +7,16 @@ namespace App\Http\Controllers\Academy;
 use App\Http\Controllers\Controller;
 use App\Models\AcademyPromptTemplate;
 use App\Services\Academy\AcademyAccessService;
+use App\Services\Academy\AcademyAnalyticsService;
 use App\Services\Academy\AcademyCacheService;
+use App\Services\Academy\AcademyInteractionService;
+use App\Services\Academy\AcademyPopularityService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
 use App\Support\Seo\SeoFactory;
 use Illuminate\Http\Request;
+use Illuminate\Http\JsonResponse;
 use Illuminate\Support\Str;
+use Illuminate\Support\Facades\DB;
 use Inertia\Inertia;
 use Inertia\Response;
 
@@ -19,10 +25,13 @@ final class AcademyPromptController extends Controller
     public function __construct(
         private readonly AcademyAccessService $access,
         private readonly AcademyCacheService $cache,
+        private readonly AcademyAnalyticsService $analytics,
+        private readonly AcademyInteractionService $interactions,
+        private readonly AcademyPopularityService $popularity,
     ) {
     }
 
-    public function index(Request $request): Response
+    public function index(Request $request): Response|JsonResponse
     {
         abort_unless((bool) config('academy.enabled', true), 404);
 
@@ -62,6 +71,14 @@ final class AcademyPromptController extends Controller
         $prompts = $query->paginate(12)->withQueryString();
         $prompts->getCollection()->transform(fn (AcademyPromptTemplate $prompt): array => $this->access->promptPayload($prompt, $request->user()));
 
+        if (filled($filters['q'] ?? null)) {
+            $this->analytics->trackSearch((string) $filters['q'], (int) $prompts->total(), array_filter($filters), $request);
+        }
+
+        if ($request->expectsJson()) {
+            return response()->json($prompts);
+        }
+
         $seo = app(SeoFactory::class)
             ->collectionListing(
                 'Academy Prompts — Skinbase',
@@ -72,14 +89,224 @@ final class AcademyPromptController extends Controller
 
         return Inertia::render('Academy/List', [
             'pageType' => 'prompts',
+            'promptView' => 'library',
             'title' => 'Prompt library',
             'description' => 'Reusable prompt templates for wallpapers, worlds, mascots, covers, and digital art workflows.',
             'seo' => $seo,
+            'breadcrumbs' => [
+                ['label' => 'Academy', 'href' => route('academy.index')],
+                ['label' => 'Prompt Library', 'href' => route('academy.prompts.index')],
+            ],
             'items' => $prompts,
             'filters' => $filters,
             'categories' => $this->cache->categoriesByType('prompt'),
             'pricingUrl' => route('academy.pricing'),
-        ])->rootView('collections');
+            'coursesUrl' => route('academy.courses.index'),
+            'packsUrl' => route('academy.packs.index'),
+            'promptPopularUrl' => route('academy.prompts.popular'),
+            'promptLibraryUrl' => route('academy.prompts.index'),
+            'academyAccess' => array_merge($this->access->accessSummary($request->user()), [
+                'billingUrl' => $request->user() && (bool) config('academy_billing.enabled', false)
+                    ? route('academy.billing.account')
+                    : route('academy.pricing'),
+            ]),
+            'featuredPrompts' => $this->featuredPromptPayloads($request->user()),
+            'popularPrompts' => $this->popularPromptPayloads($request->user()),
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::PROMPT_LIBRARY,
+                'contentId' => null,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_prompts_index',
+                'search' => filled($filters['q'] ?? null) ? [
+                    'query' => (string) $filters['q'],
+                    'resultsCount' => (int) $prompts->total(),
+                ] : null,
+                'isPremium' => false,
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+            ],
+        ])->rootView('academy');
+    }
+
+    public function popular(Request $request): Response
+    {
+        abort_unless((bool) config('academy.enabled', true), 404);
+
+        $validated = $request->validate([
+            'period' => ['nullable', 'string', 'in:7d,30d,90d'],
+        ]);
+
+        $selectedPeriod = $this->selectedPopularPromptPeriod($validated['period'] ?? null);
+        $from = now()->subDays($selectedPeriod['days'] - 1)->startOfDay();
+        $to = now()->endOfDay();
+
+        $rows = DB::query()
+            ->fromSub(
+                $this->popularity->queryBetween($from, $to)
+                    ->where('content_type', AcademyAnalyticsContentType::PROMPT)
+                    ->whereNotNull('content_id')
+                    ->selectRaw('content_id, sum(views) as views, sum(prompt_copies) as prompt_copies, sum(popularity_score) as popularity_score')
+                    ->groupBy('content_id'),
+                'prompt_rankings'
+            )
+            ->orderByDesc('popularity_score')
+            ->orderByDesc('prompt_copies')
+            ->orderByDesc('views')
+            ->paginate(12)
+            ->withQueryString();
+
+        $prompts = AcademyPromptTemplate::query()
+            ->with('category')
+            ->active()
+            ->published()
+            ->whereIn('id', $rows->pluck('content_id')->map(static fn ($value): int => (int) $value)->all())
+            ->get()
+            ->keyBy('id');
+
+        $baseRank = (($rows->currentPage() - 1) * $rows->perPage());
+
+        $rows->setCollection(
+            $rows->getCollection()
+                ->values()
+                ->map(function (object $row, int $index) use ($prompts, $request, $baseRank, $selectedPeriod): ?array {
+                    $prompt = $prompts->get((int) $row->content_id);
+
+                    if (! $prompt instanceof AcademyPromptTemplate) {
+                        return null;
+                    }
+
+                    $payload = $this->access->promptPayload($prompt, $request->user());
+                    $payload['ranking'] = [
+                        'rank' => $baseRank + $index + 1,
+                        'views' => max(0, (int) ($row->views ?? 0)),
+                        'prompt_copies' => max(0, (int) ($row->prompt_copies ?? 0)),
+                        'popularity_score' => round((float) ($row->popularity_score ?? 0), 2),
+                    ];
+                    $payload['spotlight'] = [
+                        'eyebrow' => max(0, (int) ($row->prompt_copies ?? 0)) > 0
+                            ? sprintf('%d copies %s', (int) $row->prompt_copies, $selectedPeriod['eyebrow_suffix'])
+                            : sprintf('%d views %s', (int) $row->views, $selectedPeriod['eyebrow_suffix']),
+                    ];
+
+                    return $payload;
+                })
+                ->filter()
+                ->values()
+        );
+
+        $seo = app(SeoFactory::class)
+            ->collectionListing(
+                sprintf('%s Prompts — Skinbase Academy', $selectedPeriod['title_prefix']),
+                sprintf('See which Skinbase Academy prompt templates are driving the most views and copies %s.', $selectedPeriod['description_suffix']),
+                route('academy.prompts.popular', $request->query()),
+            )
+            ->toArray();
+
+        return Inertia::render('Academy/List', [
+            'pageType' => 'prompts',
+            'promptView' => 'popular',
+            'title' => sprintf('%s prompts', $selectedPeriod['title_prefix']),
+            'description' => sprintf('The prompt templates getting the most momentum from views and copies across the Academy %s.', $selectedPeriod['description_suffix']),
+            'seo' => $seo,
+            'breadcrumbs' => [
+                ['label' => 'Academy', 'href' => route('academy.index')],
+                ['label' => 'Prompt Library', 'href' => route('academy.prompts.index')],
+                ['label' => 'Popular Prompts', 'href' => route('academy.prompts.popular')],
+            ],
+            'items' => $rows,
+            'filters' => [],
+            'categories' => [],
+            'pricingUrl' => route('academy.pricing'),
+            'coursesUrl' => route('academy.courses.index'),
+            'packsUrl' => route('academy.packs.index'),
+            'promptPopularUrl' => route('academy.prompts.popular'),
+            'promptLibraryUrl' => route('academy.prompts.index'),
+            'academyAccess' => array_merge($this->access->accessSummary($request->user()), [
+                'billingUrl' => $request->user() && (bool) config('academy_billing.enabled', false)
+                    ? route('academy.billing.account')
+                    : route('academy.pricing'),
+            ]),
+            'popularPeriod' => [
+                'value' => $selectedPeriod['value'],
+                'label' => $selectedPeriod['label'],
+                'description' => $selectedPeriod['description'],
+            ],
+            'popularPeriods' => collect($this->popularPromptPeriods())
+                ->map(fn (array $period): array => [
+                    'value' => $period['value'],
+                    'label' => $period['label'],
+                    'description' => $period['description'],
+                    'href' => route('academy.prompts.popular', ['period' => $period['value']]),
+                    'active' => $period['value'] === $selectedPeriod['value'],
+                ])
+                ->values()
+                ->all(),
+            'featuredPrompts' => $this->featuredPromptPayloads($request->user()),
+            'popularPrompts' => [],
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::PROMPT_POPULAR,
+                'contentId' => null,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_prompts_popular',
+                'trackingKey' => sprintf('period:%s', $selectedPeriod['value']),
+                'metadata' => [
+                    'period' => $selectedPeriod['value'],
+                    'period_days' => $selectedPeriod['days'],
+                ],
+                'search' => null,
+                'isPremium' => false,
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+            ],
+        ])->rootView('academy');
+    }
+
+    /**
+     * @return array<int, array<string, mixed>>
+     */
+    private function popularPromptPeriods(): array
+    {
+        return [
+            [
+                'value' => '7d',
+                'days' => 7,
+                'label' => '7 days',
+                'description' => 'Fresh momentum from the last 7 days.',
+                'title_prefix' => 'Top 7-day',
+                'description_suffix' => 'in the last 7 days',
+                'eyebrow_suffix' => 'in the last 7 days',
+            ],
+            [
+                'value' => '30d',
+                'days' => 30,
+                'label' => '30 days',
+                'description' => 'The default monthly view of prompt momentum.',
+                'title_prefix' => 'Popular',
+                'description_suffix' => 'this month',
+                'eyebrow_suffix' => 'this month',
+            ],
+            [
+                'value' => '90d',
+                'days' => 90,
+                'label' => '90 days',
+                'description' => 'Longer-running prompt momentum across the quarter.',
+                'title_prefix' => 'Top 90-day',
+                'description_suffix' => 'in the last 90 days',
+                'eyebrow_suffix' => 'in the last 90 days',
+            ],
+        ];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function selectedPopularPromptPeriod(?string $value): array
+    {
+        return collect($this->popularPromptPeriods())
+            ->first(fn (array $period): bool => $period['value'] === $value)
+            ?? $this->popularPromptPeriods()[1];
     }
 
     public function show(Request $request, string $slug): Response
@@ -102,15 +329,141 @@ final class AcademyPromptController extends Controller
             $canonical,
             $payload['preview_image'] ?? null,
         )->toArray();
+        $existingSchemas = $seo['json_ld'] ?? [];
+        if (! is_array($existingSchemas) || ! array_is_list($existingSchemas)) {
+            $existingSchemas = [$existingSchemas];
+        }
+        $seo['json_ld'] = [
+            ...$existingSchemas,
+            $this->promptStructuredData($payload, $canonical, $description),
+        ];
+
+        $canSavePrompt = $request->user() !== null && $this->access->canAccessPrompt($request->user(), $prompt);
+        $interaction = $this->interactions->getInteractionState($request->user(), AcademyAnalyticsContentType::PROMPT, (int) $prompt->id);
 
         return Inertia::render('Academy/Show', [
             'pageType' => 'prompt',
             'item' => $payload,
             'seo' => $seo,
             'pricingUrl' => route('academy.pricing'),
-            'saveUrl' => $request->user() ? route('academy.prompts.save', ['prompt' => $prompt->id]) : null,
+            'saveUrl' => $canSavePrompt ? route('academy.prompts.save', ['prompt' => $prompt->id]) : null,
-            'unsaveUrl' => $request->user() ? route('academy.prompts.unsave', ['prompt' => $prompt->id]) : null,
+            'unsaveUrl' => $canSavePrompt ? route('academy.prompts.unsave', ['prompt' => $prompt->id]) : null,
-            'saved' => $request->user()?->academySavedPrompts()->where('prompt_template_id', $prompt->id)->exists() ?? false,
+            'saved' => $canSavePrompt ? ($request->user()?->academySavedPrompts()->where('prompt_template_id', $prompt->id)->exists() ?? false) : false,
-        ])->rootView('collections');
+            'interaction' => $interaction,
+            'interactionRoutes' => [
+                'like' => route('academy.interactions.like'),
+                'save' => route('academy.interactions.save'),
+            ],
+            'loginUrl' => route('login'),
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::PROMPT,
+                'contentId' => (int) $prompt->id,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_prompt_show',
+                'isPremium' => (string) ($prompt->access_level ?? 'free') !== 'free',
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+                'isLocked' => (bool) ($payload['locked'] ?? false),
+            ],
+        ])->rootView('academy');
+    }
+
+    /**
+     * @param  array<string, mixed>  $payload
+     * @return array<string, mixed>
+     */
+    private function promptStructuredData(array $payload, string $canonical, string $description): array
+    {
+        $imageUrls = array_values(array_unique(array_filter([
+            $payload['preview_image'] ?? null,
+            ...collect((array) ($payload['public_examples'] ?? []))
+                ->map(fn (array $example): ?string => $example['image_url'] ?? $example['thumb_url'] ?? null)
+                ->filter()
+                ->values()
+                ->all(),
+        ], fn (mixed $value): bool => is_string($value) && $value !== '')));
+        $isFree = (string) ($payload['access_level'] ?? 'free') === 'free';
+
+        return array_filter([
+            '@context' => 'https://schema.org',
+            '@type' => ['CreativeWork', 'LearningResource'],
+            'name' => (string) ($payload['title'] ?? 'Skinbase Academy prompt'),
+            'description' => $description,
+            'url' => $canonical,
+            'image' => $imageUrls !== [] ? $imageUrls : null,
+            'isAccessibleForFree' => $isFree,
+            'hasPart' => $isFree ? null : [
+                '@type' => 'WebPageElement',
+                'isAccessibleForFree' => false,
+                'cssSelector' => '.academy-paywalled-content',
+            ],
+        ], fn (mixed $value): bool => $value !== null && $value !== '' && $value !== []);
+    }
+
+    /**
+     * @return array<int, array<string, mixed>>
+     */
+    private function featuredPromptPayloads(mixed $viewer, int $limit = 4): array
+    {
+        return collect($this->cache->featuredPrompts())
+            ->take($limit)
+            ->map(function (AcademyPromptTemplate $prompt) use ($viewer): array {
+                $payload = $this->access->promptPayload($prompt, $viewer);
+                $payload['spotlight'] = [
+                    'eyebrow' => $prompt->prompt_of_week ? 'Prompt of the week' : 'Featured pick',
+                ];
+
+                return $payload;
+            })
+            ->values()
+            ->all();
+    }
+
+    /**
+     * @return array<int, array<string, mixed>>
+     */
+    private function popularPromptPayloads(mixed $viewer, int $limit = 4): array
+    {
+        $rows = $this->popularity->queryBetween(now()->subDays(29)->startOfDay(), now()->endOfDay())
+            ->where('content_type', AcademyAnalyticsContentType::PROMPT)
+            ->whereNotNull('content_id')
+            ->selectRaw('content_id, sum(views) as views, sum(prompt_copies) as prompt_copies, sum(popularity_score) as popularity_score')
+            ->groupBy('content_id')
+            ->orderByDesc('popularity_score')
+            ->limit($limit)
+            ->get();
+
+        if ($rows->isEmpty()) {
+            return [];
+        }
+
+        $prompts = AcademyPromptTemplate::query()
+            ->with('category')
+            ->active()
+            ->published()
+            ->whereIn('id', $rows->pluck('content_id')->all())
+            ->get()
+            ->keyBy('id');
+
+        return $rows->map(function ($row) use ($prompts, $viewer): ?array {
+            $prompt = $prompts->get((int) $row->content_id);
+
+            if (! $prompt instanceof AcademyPromptTemplate) {
+                return null;
+            }
+
+            $payload = $this->access->promptPayload($prompt, $viewer);
+            $copies = max(0, (int) ($row->prompt_copies ?? 0));
+            $views = max(0, (int) ($row->views ?? 0));
+            $payload['spotlight'] = [
+                'eyebrow' => $copies > 0 ? sprintf('%d copies this month', $copies) : sprintf('%d views this month', $views),
+            ];
+
+            return $payload;
+        })
+            ->filter()
+            ->values()
+            ->all();
     }
 }

app/Http/Controllers/Academy/AcademyPromptPackController.php

@@ -7,6 +7,8 @@ namespace App\Http\Controllers\Academy;
 use App\Http\Controllers\Controller;
 use App\Models\AcademyPromptPack;
 use App\Services\Academy\AcademyAccessService;
+use App\Services\Academy\AcademyInteractionService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
 use App\Support\Seo\SeoFactory;
 use Illuminate\Http\Request;
 use Illuminate\Support\Str;
@@ -15,7 +17,10 @@ use Inertia\Response;
 
 final class AcademyPromptPackController extends Controller
 {
-    public function __construct(private readonly AcademyAccessService $access)
+    public function __construct(
+        private readonly AcademyAccessService $access,
+        private readonly AcademyInteractionService $interactions,
+    )
     {
     }
 
@@ -24,7 +29,6 @@ final class AcademyPromptPackController extends Controller
         abort_unless((bool) config('academy.enabled', true), 404);
 
         $packs = AcademyPromptPack::query()
-            ->with('prompts')
             ->active()
             ->published()
             ->latest('published_at')
@@ -50,7 +54,17 @@ final class AcademyPromptPackController extends Controller
             'filters' => [],
             'categories' => [],
             'pricingUrl' => route('academy.pricing'),
-        ])->rootView('collections');
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::PROMPT_PACK_LIBRARY,
+                'contentId' => null,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_packs_index',
+                'isPremium' => false,
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+            ],
+        ])->rootView('academy');
     }
 
     public function show(Request $request, string $slug): Response
@@ -72,11 +86,30 @@ final class AcademyPromptPackController extends Controller
             $pack->cover_image,
         )->toArray();
 
+        $interaction = $this->interactions->getInteractionState($request->user(), AcademyAnalyticsContentType::PROMPT_PACK, (int) $pack->id);
+
         return Inertia::render('Academy/Show', [
             'pageType' => 'pack',
             'item' => $payload,
             'seo' => $seo,
             'pricingUrl' => route('academy.pricing'),
-        ])->rootView('collections');
+            'interaction' => $interaction,
+            'interactionRoutes' => [
+                'like' => route('academy.interactions.like'),
+                'save' => route('academy.interactions.save'),
+            ],
+            'loginUrl' => route('login'),
+            'analytics' => [
+                'enabled' => true,
+                'contentType' => AcademyAnalyticsContentType::PROMPT_PACK,
+                'contentId' => (int) $pack->id,
+                'eventUrl' => route('academy.analytics.events.store'),
+                'pageName' => 'academy_pack_show',
+                'isPremium' => (string) ($pack->access_level ?? 'free') !== 'free',
+                'isGuest' => $request->user() === null,
+                'isSubscriber' => $request->user()?->hasAcademyCreatorAccess() || $request->user()?->hasAcademyProAccess(),
+                'isLocked' => (bool) ($payload['locked'] ?? false),
+            ],
+        ])->rootView('academy');
     }
 }

app/Http/Controllers/Api/ArtworkTagController.php

@@ -30,6 +30,7 @@ final class ArtworkTagController extends Controller
 
         $queueConnection = (string) config('queue.default', 'sync');
         $visionEnabled = (bool) config('vision.enabled', true);
+        $autoTaggingEnabled = (bool) config('vision.auto_tagging.enabled', false);
 
         $queuedCount = 0;
         $failedCount = 0;
@@ -56,7 +57,7 @@ final class ArtworkTagController extends Controller
 
         $triggered = false;
         $shouldTrigger = request()->boolean('trigger', false);
-        if ($shouldTrigger && $visionEnabled && ! empty($artwork->hash) && $queuedCount === 0) {
+        if ($shouldTrigger && $visionEnabled && $autoTaggingEnabled && ! empty($artwork->hash) && $queuedCount === 0) {
             AutoTagArtworkJob::dispatch((int) $artwork->id, (string) $artwork->hash);
             $triggered = true;
             $queuedCount = max(1, $queuedCount);
@@ -89,6 +90,7 @@ final class ArtworkTagController extends Controller
                 'queued_jobs' => $queuedCount,
                 'failed_jobs' => $failedCount,
                 'triggered' => $triggered,
+                'auto_tagging_enabled' => $autoTaggingEnabled,
                 'ai_tag_count' => (int) $tags->where('is_ai', true)->count(),
                 'total_tag_count' => (int) $tags->count(),
             ],

app/Http/Controllers/Api/LatestCommentsApiController.php

@@ -11,11 +11,21 @@ use App\Services\ThumbnailPresenter;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Str;
 use Carbon\Carbon;
+use Illuminate\Contracts\Pagination\Paginator;
 
 class LatestCommentsApiController extends Controller
 {
     private const PER_PAGE = 20;
 
+    private function paginationMeta(Paginator $paginator): array
+    {
+        return [
+            'current_page' => $paginator->currentPage(),
+            'per_page' => $paginator->perPage(),
+            'has_more' => $paginator->hasMorePages(),
+        ];
+    }
+
     public function index(Request $request): JsonResponse
     {
         $type = $request->query('type', 'all');
@@ -66,15 +76,21 @@ class LatestCommentsApiController extends Controller
                     $cacheKey = 'comments.latest.all.page1';
                     $ttl      = 120; // 2 minutes
 
-                    $paginator = Cache::remember($cacheKey, $ttl, fn () => $query->paginate(self::PER_PAGE));
+                    $paginator = Cache::remember($cacheKey, $ttl, fn () => $query
+                        ->orderByDesc('artwork_comments.id')
+                        ->simplePaginate(self::PER_PAGE));
                 } else {
-                    $paginator = $query->paginate(self::PER_PAGE);
+                    $paginator = $query
+                        ->orderByDesc('artwork_comments.id')
+                        ->simplePaginate(self::PER_PAGE);
                 }
                 break;
         }
 
         if (! isset($paginator)) {
-            $paginator = $query->paginate(self::PER_PAGE);
+            $paginator = $query
+                ->orderByDesc('artwork_comments.id')
+                ->simplePaginate(self::PER_PAGE);
         }
 
         $items = $paginator->getCollection()->map(function (ArtworkComment $c) {
@@ -113,13 +129,7 @@ class LatestCommentsApiController extends Controller
 
         return response()->json([
             'data' => $items,
-            'meta' => [
+            'meta' => $this->paginationMeta($paginator),
-                'current_page' => $paginator->currentPage(),
-                'last_page'    => $paginator->lastPage(),
-                'per_page'     => $paginator->perPage(),
-                'total'        => $paginator->total(),
-                'has_more'     => $paginator->hasMorePages(),
-            ],
         ]);
     }
 }

app/Http/Controllers/Api/LinkPreviewController.php

@@ -53,7 +53,12 @@ class LinkPreviewController extends Controller
             return response()->json(['error' => 'Invalid URL.'], 422);
         }
 
-        // Resolve hostname and block private/loopback IPs (SSRF protection)
+        // Resolve hostname and block private/loopback IPs (SSRF protection).
+        // NOTE: This check is not atomic with Guzzle's own DNS resolution — a
+        // DNS rebinding attack could theoretically pass this check and then
+        // resolve to an internal IP when Guzzle makes the actual request.
+        // Risk is low (requires attacker-controlled DNS with very short TTL),
+        // but this is a known limitation of the current approach.
         $resolved = gethostbyname($host);
         if ($this->isBlockedIp($resolved)) {
             return response()->json(['error' => 'URL not allowed.'], 422);

app/Http/Controllers/Api/UploadController.php

@@ -47,7 +47,9 @@ use App\Uploads\Exceptions\DraftQuotaException;
 use App\Models\Artwork;
 use App\Models\Group;
 use App\Services\GroupArtworkReviewService;
+use App\Support\ArtworkDescriptionContentValidator;
 use App\Services\Worlds\WorldSubmissionService;
+use Illuminate\Validation\ValidationException;
 use Illuminate\Support\Str;
 
 final class UploadController extends Controller
@@ -237,10 +239,18 @@ final class UploadController extends Controller
                 }
 
                 // Derivatives are available now; dispatch AI auto-tagging.
+                if ((bool) config('vision.auto_tagging.enabled', false)) {
                     AutoTagArtworkJob::dispatch($artworkId, $validated->hash)->afterCommit();
+                }
+                if ((bool) config('vision.upload.maturity.enabled', false)) {
                     DetectArtworkMaturityJob::dispatch($artworkId, $validated->hash)->afterCommit();
+                }
+                if ((bool) config('vision.upload.embeddings.enabled', true)) {
                     GenerateArtworkEmbeddingJob::dispatch($artworkId, $validated->hash)->afterCommit();
+                }
+                if ((bool) config('vision.upload.ai_assist.enabled', false)) {
                     AnalyzeArtworkAiAssistJob::dispatch($artworkId)->afterCommit();
+                }
                 return UploadSessionStatus::PROCESSED;
             });
 
@@ -534,6 +544,8 @@ final class UploadController extends Controller
             'nsfw' => ['nullable', 'boolean'],
         ]);
 
+        $this->ensureValidArtworkDescription($validated);
+
         $updates = [];
         foreach (['title', 'category_id', 'description', 'tags', 'license', 'nsfw'] as $field) {
             if (array_key_exists($field, $validated)) {
@@ -635,6 +647,8 @@ final class UploadController extends Controller
             'world_submissions.*.source_surface' => ['nullable', 'string', 'max:80'],
         ]);
 
+        $this->ensureValidArtworkDescription($validated);
+
         $mode       = $validated['mode'] ?? 'now';
         $visibility = $validated['visibility'] ?? 'public';
 
@@ -814,6 +828,8 @@ final class UploadController extends Controller
             'world_submissions.*.source_surface' => ['nullable', 'string', 'max:80'],
         ]);
 
+        $this->ensureValidArtworkDescription($validated);
+
         if (! ctype_digit($id)) {
             return response()->json(['message' => 'Artwork review submission requires an artwork draft id.'], Response::HTTP_UNPROCESSABLE_ENTITY);
         }
@@ -842,4 +858,13 @@ final class UploadController extends Controller
             'group_review_status' => (string) $artwork->group_review_status,
         ], Response::HTTP_OK);
     }
+
+    private function ensureValidArtworkDescription(array $validated): void
+    {
+        foreach (ArtworkDescriptionContentValidator::errors($validated['description'] ?? null) as $message) {
+            throw ValidationException::withMessages([
+                'description' => [$message],
+            ]);
+        }
+    }
 }

app/Http/Controllers/ArtworkEnhanceController.php

@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers;
+
+use App\Models\Artwork;
+use App\Services\Enhance\EnhanceService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Validation\Rule;
+use RuntimeException;
+
+final class ArtworkEnhanceController extends Controller
+{
+    public function __construct(
+        private readonly EnhanceService $enhanceService,
+    ) {
+    }
+
+    public function store(Request $request, int $artwork): RedirectResponse
+    {
+        $artwork = Artwork::query()->findOrFail($artwork);
+
+        $actor = $request->user();
+        abort_unless($actor !== null, 403);
+
+        $isOwner = (int) $artwork->user_id === (int) $actor->id;
+        $isStaff = $actor->isAdmin() || $actor->isModerator();
+
+        abort_unless($isOwner || $isStaff, 403);
+
+        $validated = $request->validate([
+            'scale' => ['required', 'integer', Rule::in((array) config('enhance.allowed_scales', [2, 4]))],
+            'mode' => ['required', 'string', Rule::in((array) config('enhance.allowed_modes', ['standard', 'artwork', 'photo', 'illustration']))],
+        ]);
+
+        try {
+            $job = $this->enhanceService->createFromArtwork($actor, $artwork, $validated);
+        } catch (RuntimeException $exception) {
+            return redirect()
+                ->route('enhance.create', ['artwork' => $artwork->id])
+                ->withErrors([
+                    'source' => $exception->getMessage(),
+                ]);
+        }
+
+        return redirect()
+            ->route('enhance.show', ['enhanceJob' => $job])
+            ->with('success', 'Artwork enhance job created.');
+    }
+}

app/Http/Controllers/Auth/RegisteredUserController.php

@@ -42,6 +42,7 @@ class RegisteredUserController extends Controller
 
         return view('auth.register', [
             'prefillEmail' => (string) $request->query('email', ''),
+            'page_canonical' => route('register'),
             'turnstile' => [
                 'enabled' => $this->turnstileVerifier->isEnabled(),
                 'siteKey' => $this->turnstileVerifier->siteKey(),

app/Http/Controllers/Community/LatestCommentsController.php

@@ -10,11 +10,21 @@ use App\Services\ThumbnailPresenter;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Str;
 use Carbon\Carbon;
+use Illuminate\Contracts\Pagination\Paginator;
 
 class LatestCommentsController extends Controller
 {
     private const PER_PAGE = 20;
 
+    private function paginationMeta(Paginator $paginator): array
+    {
+        return [
+            'current_page' => $paginator->currentPage(),
+            'per_page' => $paginator->perPage(),
+            'has_more' => $paginator->hasMorePages(),
+        ];
+    }
+
     public function index(Request $request)
     {
         $page_title = 'Latest Comments';
@@ -38,7 +48,8 @@ class LatestCommentsController extends Controller
                     $q->public()->published()->whereNull('deleted_at');
                 })
                 ->orderByDesc('artwork_comments.created_at')
-                ->paginate(self::PER_PAGE);
+                ->orderByDesc('artwork_comments.id')
+                ->simplePaginate(self::PER_PAGE);
         });
 
         $items = $initialData->getCollection()->map(function (ArtworkComment $c) {
@@ -76,13 +87,7 @@ class LatestCommentsController extends Controller
 
         $props = [
             'initialComments' => $items->values()->all(),
-            'initialMeta'     => [
+            'initialMeta'     => $this->paginationMeta($initialData),
-                'current_page' => $initialData->currentPage(),
-                'last_page'    => $initialData->lastPage(),
-                'per_page'     => $initialData->perPage(),
-                'total'        => $initialData->total(),
-                'has_more'     => $initialData->hasMorePages(),
-            ],
             'isAuthenticated' => (bool) auth()->user(),
         ];
 

app/Http/Controllers/EnhanceController.php

@@ -0,0 +1,208 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers;
+
+use App\Models\Artwork;
+use App\Models\EnhanceJob;
+use App\Services\Enhance\EnhanceService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Validation\Rule;
+use Inertia\Inertia;
+use Inertia\Response;
+
+final class EnhanceController extends Controller
+{
+    public function __construct(
+        private readonly EnhanceService $enhanceService,
+    ) {
+    }
+
+    public function index(Request $request): Response
+    {
+        $this->authorize('viewAny', EnhanceJob::class);
+
+        $jobs = EnhanceJob::query()
+            ->where('user_id', (int) $request->user()->id)
+            ->with('artwork:id,title,slug')
+            ->latest('id')
+            ->paginate(12)
+            ->withQueryString()
+            ->through(fn (EnhanceJob $job): array => $this->serializeJobListItem($job));
+
+        $latestCompleted = EnhanceJob::query()
+            ->where('user_id', (int) $request->user()->id)
+            ->where('status', EnhanceJob::STATUS_COMPLETED)
+            ->latest('finished_at')
+            ->limit(4)
+            ->get()
+            ->map(fn (EnhanceJob $job): array => $this->serializeJobListItem($job))
+            ->all();
+
+        return Inertia::render('Enhance/Index', [
+            'title' => 'Skinbase Enhance',
+            'jobs' => $jobs,
+            'latestCompleted' => $latestCompleted,
+            'createUrl' => route('enhance.create'),
+            'indexUrl' => route('enhance.index'),
+            'dailyLimit' => (int) config('enhance.daily_limit', 10),
+            'enhanceConfig' => $this->enhanceService->frontendConfig(),
+        ]);
+    }
+
+    public function create(Request $request): Response
+    {
+        $this->authorize('create', EnhanceJob::class);
+
+        $selectedArtwork = null;
+
+        if (($artworkId = (int) $request->integer('artwork')) > 0) {
+            $artwork = Artwork::query()
+                ->select(['id', 'user_id', 'title', 'slug'])
+                ->findOrFail($artworkId);
+
+            $actor = $request->user();
+            abort_unless($actor !== null, 403);
+
+            $isOwner = (int) $artwork->user_id === (int) $actor->id;
+            $isStaff = $actor->isAdmin() || $actor->isModerator();
+
+            abort_unless($isOwner || $isStaff, 403);
+
+            $selectedArtwork = [
+                'id' => $artwork->id,
+                'title' => $artwork->title,
+                'show_url' => route('art.show', ['id' => $artwork->id, 'slug' => $artwork->slug]),
+                'store_url' => route('artworks.enhance.store', ['artwork' => $artwork->id]),
+            ];
+        }
+
+        return Inertia::render('Enhance/Create', [
+            'title' => 'Skinbase Enhance',
+            'options' => $this->optionsPayload(),
+            'storeUrl' => route('enhance.store'),
+            'indexUrl' => route('enhance.index'),
+            'maxUploadMb' => (int) config('enhance.max_upload_mb', 20),
+            'selectedArtwork' => $selectedArtwork,
+            'enhanceConfig' => $this->enhanceService->frontendConfig(),
+        ]);
+    }
+
+    public function store(Request $request): RedirectResponse
+    {
+        $this->authorize('create', EnhanceJob::class);
+
+        $validated = $request->validate([
+            'image' => ['required', 'file', 'mimetypes:image/jpeg,image/png,image/webp', 'max:' . ((int) config('enhance.max_upload_mb', 20) * 1024)],
+            'scale' => ['required', 'integer', Rule::in((array) config('enhance.allowed_scales', [2, 4]))],
+            'mode' => ['required', 'string', Rule::in((array) config('enhance.allowed_modes', ['standard', 'artwork', 'photo', 'illustration']))],
+        ]);
+
+        $job = $this->enhanceService->createFromUpload($request->user(), $request->file('image'), $validated);
+
+        return redirect()
+            ->route('enhance.show', ['enhanceJob' => $job])
+            ->with('success', 'Enhance job created.');
+    }
+
+    public function show(EnhanceJob $enhanceJob): Response
+    {
+        $this->authorize('view', $enhanceJob);
+        $enhanceJob->loadMissing('artwork:id,title,slug');
+
+        return Inertia::render('Enhance/Show', [
+            'title' => 'Enhance Job',
+            'job' => $this->serializeJobDetail($enhanceJob),
+            'indexUrl' => route('enhance.index'),
+            'createUrl' => route('enhance.create'),
+            'enhanceConfig' => $this->enhanceService->frontendConfig(),
+        ]);
+    }
+
+    public function retry(EnhanceJob $enhanceJob): RedirectResponse
+    {
+        $this->authorize('retry', $enhanceJob);
+
+        $job = $this->enhanceService->retry($enhanceJob);
+
+        return redirect()
+            ->route('enhance.show', ['enhanceJob' => $job])
+            ->with('success', 'Enhance job queued again.');
+    }
+
+    public function destroy(EnhanceJob $enhanceJob): RedirectResponse
+    {
+        $this->authorize('delete', $enhanceJob);
+
+        $this->enhanceService->delete($enhanceJob);
+
+        return redirect()
+            ->route('enhance.index')
+            ->with('success', 'Enhance job deleted.');
+    }
+
+    private function optionsPayload(): array
+    {
+        return [
+            'modes' => array_map(fn (string $mode): array => [
+                'value' => $mode,
+                'label' => ucfirst($mode),
+            ], (array) config('enhance.allowed_modes', [])),
+            'scales' => array_map(fn (int $scale): array => [
+                'value' => $scale,
+                'label' => $scale . 'x',
+            ], array_map('intval', (array) config('enhance.allowed_scales', []))),
+        ];
+    }
+
+    private function serializeJobListItem(EnhanceJob $job): array
+    {
+        return [
+            'id' => $job->id,
+            'status' => (string) $job->status,
+            'engine' => (string) $job->engine,
+            'mode' => (string) $job->mode,
+            'scale' => (int) $job->scale,
+            'source_url' => $job->sourceUrl(),
+            'output_url' => $job->outputUrl(),
+            'preview_url' => $job->previewUrl(),
+            'input_width' => (int) ($job->input_width ?? 0),
+            'input_height' => (int) ($job->input_height ?? 0),
+            'output_width' => (int) ($job->output_width ?? 0),
+            'output_height' => (int) ($job->output_height ?? 0),
+            'error_message' => $job->error_message,
+            'processing_seconds' => $job->processing_seconds,
+            'created_at' => optional($job->created_at)?->toIso8601String(),
+            'finished_at' => optional($job->finished_at)?->toIso8601String(),
+            'show_url' => route('enhance.show', ['enhanceJob' => $job]),
+            'artwork' => $job->artwork ? [
+                'id' => $job->artwork->id,
+                'title' => $job->artwork->title,
+                'slug' => $job->artwork->slug,
+                'url' => route('art.show', ['id' => $job->artwork->id, 'slug' => $job->artwork->slug]),
+            ] : null,
+        ];
+    }
+
+    private function serializeJobDetail(EnhanceJob $job): array
+    {
+        return $this->serializeJobListItem($job) + [
+            'input_filesize' => (int) ($job->input_filesize ?? 0),
+            'input_mime' => $job->input_mime,
+            'output_filesize' => (int) ($job->output_filesize ?? 0),
+            'output_mime' => $job->output_mime,
+            'metadata' => $job->metadata ?? [],
+            'queued_at' => optional($job->queued_at)?->toIso8601String(),
+            'started_at' => optional($job->started_at)?->toIso8601String(),
+            'deleted_at' => optional($job->deleted_at)?->toIso8601String(),
+            'expires_at' => optional($job->expires_at)?->toIso8601String(),
+            'retry_url' => route('enhance.retry', ['enhanceJob' => $job]),
+            'delete_url' => route('enhance.destroy', ['enhanceJob' => $job]),
+            'download_url' => $job->outputUrl(),
+            'can_retry' => auth()->user()?->can('retry', $job) ?? false,
+            'can_delete' => auth()->user()?->can('delete', $job) ?? false,
+        ];
+    }
+}

app/Http/Controllers/Forum/ForumController.php

@@ -98,7 +98,7 @@ class ForumController extends Controller
 
         $thread->loadMissing([
             'category:id,name,slug',
-            'user:id,name',
+            'user:id,name,username',
             'user.profile:user_id,avatar_hash',
         ]);
 
@@ -116,7 +116,7 @@ class ForumController extends Controller
         $opPost = ForumPost::query()
             ->where('thread_id', $thread->id)
             ->with([
-                'user:id,name',
+                'user:id,name,username',
                 'user.profile:user_id,avatar_hash',
                 'attachments:id,post_id,file_path,file_size,mime_type,width,height',
             ])
@@ -128,7 +128,7 @@ class ForumController extends Controller
             ->where('thread_id', $thread->id)
             ->when($opPost, fn ($query) => $query->where('id', '!=', $opPost->id))
             ->with([
-                'user:id,name',
+                'user:id,name,username',
                 'user.profile:user_id,avatar_hash',
                 'attachments:id,post_id,file_path,file_size,mime_type,width,height',
             ])
@@ -148,7 +148,7 @@ class ForumController extends Controller
         if ($quotePostId > 0) {
             $quotedPost = ForumPost::query()
                 ->where('thread_id', $thread->id)
-                ->with('user:id,name')
+                ->with('user:id,name,username')
                 ->find($quotePostId);
         }
 

app/Http/Controllers/GroupController.php

@@ -79,6 +79,7 @@ class GroupController extends Controller
     {
         $this->authorize('view', $group);
 
+        $section = in_array($section, ['overview', 'artworks', 'collections', 'members', 'about', 'posts', 'projects', 'releases', 'challenges', 'events', 'activity'], true) ? $section : 'overview';
         $viewer = $request->user();
         $group->loadMissing('owner.profile');
         $members = collect($this->memberships->mapMembers($group, $viewer))
@@ -89,7 +90,8 @@ class GroupController extends Controller
 
         return Inertia::render('Group/GroupShow', [
             'group' => $groupPayload,
-            'section' => in_array($section, ['overview', 'artworks', 'collections', 'members', 'about', 'posts', 'projects', 'releases', 'challenges', 'events', 'activity'], true) ? $section : 'overview',
+            'section' => $section,
+            'seo' => $this->seoPayload($group, $section),
             'featuredArtworks' => $this->groups->featuredArtworkCards($group),
             'artworks' => $this->groups->publicArtworkCards($group),
             'featuredCollections' => $this->groups->featuredCollectionCards($group, $viewer),
@@ -140,4 +142,19 @@ class GroupController extends Controller
     {
         return $this->show($request, $group, 'activity');
     }
+
+    private function seoPayload(Group $group, string $section): array
+    {
+        $canonical = $section === 'overview'
+            ? route('groups.show', ['group' => $group])
+            : route('groups.section', ['group' => $group, 'section' => $section]);
+        $sectionLabel = $section === 'overview' ? '' : ' '.ucfirst($section);
+
+        return [
+            'title' => trim($group->name.$sectionLabel.' - Skinbase'),
+            'description' => $group->headline ?: $group->bio ?: 'Skinbase group',
+            'canonical' => $canonical,
+            'og_url' => $canonical,
+        ];
+    }
 }

app/Http/Controllers/Internal/EnhanceSourceController.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Internal;
+
+use App\Http\Controllers\Controller;
+use App\Models\EnhanceJob;
+use App\Services\Enhance\EnhanceStorageService;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Throwable;
+
+final class EnhanceSourceController extends Controller
+{
+    public function __construct(
+        private readonly EnhanceStorageService $storage,
+    ) {
+    }
+
+    public function show(Request $request, EnhanceJob $enhanceJob): Response
+    {
+        abort_unless($request->hasValidSignature(), 403);
+        abort_unless($this->storage->isEnhancePath($enhanceJob->source_path), 404);
+
+        try {
+            $binary = $this->storage->fetchSourceBinary($enhanceJob);
+        } catch (Throwable) {
+            abort(404);
+        }
+
+        return response($binary, 200, [
+            'Content-Type' => trim((string) ($enhanceJob->input_mime ?: 'application/octet-stream')),
+            'Content-Length' => (string) strlen($binary),
+            'Cache-Control' => 'private, max-age=60',
+            'Content-Disposition' => 'inline; filename="enhance-source-' . $enhanceJob->id . '"',
+        ]);
+    }
+}

app/Http/Controllers/Legacy/UserController.php

@@ -79,20 +79,28 @@ class UserController extends Controller
                     }
                 }
 
+                $allowedLegacyMimes = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
+
                 if ($request->hasFile('personal_picture')) {
                     $f = $request->file('personal_picture');
-                    $name = $user->id . '.' . $f->getClientOriginalExtension();
+                    if (in_array($f->getMimeType(), $allowedLegacyMimes, true)) {
+                        $ext = $f->guessExtension() ?: 'jpg';
+                        $name = $user->id . '.' . $ext;
                         $f->move(public_path('user-picture'), $name);
                         $profileUpdates['cover_image'] = $name;
                         $user->picture = $name;
                     }
+                }
 
                 if ($request->hasFile('emotion_icon')) {
                     $f = $request->file('emotion_icon');
-                    $name = $user->id . '.' . $f->getClientOriginalExtension();
+                    if (in_array($f->getMimeType(), $allowedLegacyMimes, true)) {
+                        $ext = $f->guessExtension() ?: 'jpg';
+                        $name = $user->id . '.' . $ext;
                         $f->move(public_path('emotion'), $name);
                         $user->eicon = $name;
                     }
+                }
 
                 // Save core user fields
                 $user->save();

app/Http/Controllers/Moderation/ModerationEnhanceController.php

@@ -0,0 +1,162 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Moderation;
+
+use App\Http\Controllers\Controller;
+use App\Models\EnhanceJob;
+use App\Services\Enhance\EnhanceService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Inertia\Inertia;
+use Inertia\Response;
+
+final class ModerationEnhanceController extends Controller
+{
+    public function __construct(
+        private readonly EnhanceService $enhanceService,
+    ) {
+    }
+
+    public function index(Request $request): Response
+    {
+        $filters = [
+            'status' => trim((string) $request->query('status', 'all')),
+            'engine' => trim((string) $request->query('engine', 'all')),
+            'mode' => trim((string) $request->query('mode', 'all')),
+            'scale' => trim((string) $request->query('scale', 'all')),
+            'user' => trim((string) $request->query('user', '')),
+            'date_from' => trim((string) $request->query('date_from', '')),
+            'date_to' => trim((string) $request->query('date_to', '')),
+        ];
+
+        $jobs = EnhanceJob::query()
+            ->with(['user:id,name,username', 'artwork:id,title,slug'])
+            ->when($filters['status'] !== '' && $filters['status'] !== 'all', fn ($query) => $query->where('status', $filters['status']))
+            ->when($filters['engine'] !== '' && $filters['engine'] !== 'all', fn ($query) => $query->where('engine', $filters['engine']))
+            ->when($filters['mode'] !== '' && $filters['mode'] !== 'all', fn ($query) => $query->where('mode', $filters['mode']))
+            ->when($filters['scale'] !== '' && $filters['scale'] !== 'all', fn ($query) => $query->where('scale', (int) $filters['scale']))
+            ->when($filters['user'] !== '', function ($query) use ($filters): void {
+                $query->whereHas('user', function ($userQuery) use ($filters): void {
+                    $userQuery
+                        ->where('name', 'like', '%' . $filters['user'] . '%')
+                        ->orWhere('username', 'like', '%' . $filters['user'] . '%');
+                });
+            })
+            ->when($filters['date_from'] !== '', fn ($query) => $query->whereDate('created_at', '>=', $filters['date_from']))
+            ->when($filters['date_to'] !== '', fn ($query) => $query->whereDate('created_at', '<=', $filters['date_to']))
+            ->latest('id')
+            ->paginate(20)
+            ->withQueryString()
+            ->through(fn (EnhanceJob $job): array => $this->serializeJob($job));
+
+        return Inertia::render('Moderation/Enhance/Index', [
+            'title' => 'Enhance Jobs',
+            'jobs' => $jobs,
+            'filters' => $filters,
+            'options' => [
+                'statuses' => ['all', 'pending', 'queued', 'processing', 'completed', 'failed', 'cancelled', 'expired'],
+                'engines' => ['all', 'stub', 'external_worker'],
+                'modes' => array_merge(['all'], (array) config('enhance.allowed_modes', [])),
+                'scales' => array_merge(['all'], array_map('intval', (array) config('enhance.allowed_scales', []))),
+            ],
+            'indexUrl' => route('admin.enhance.index'),
+            'enhanceConfig' => $this->enhanceService->frontendConfig(),
+        ])->rootView('moderation');
+    }
+
+    public function show(EnhanceJob $enhanceJob): Response
+    {
+        $enhanceJob->loadMissing(['user:id,name,username', 'artwork:id,title,slug']);
+
+        return Inertia::render('Moderation/Enhance/Show', [
+            'title' => 'Enhance Job #' . $enhanceJob->id,
+            'job' => $this->serializeJob($enhanceJob, true),
+            'indexUrl' => route('admin.enhance.index'),
+            'enhanceConfig' => $this->enhanceService->frontendConfig(),
+        ])->rootView('moderation');
+    }
+
+    public function retry(EnhanceJob $enhanceJob): RedirectResponse
+    {
+        $this->authorize('retry', $enhanceJob);
+
+        $job = $this->enhanceService->retry($enhanceJob);
+
+        return redirect()
+            ->route('admin.enhance.show', ['enhanceJob' => $job])
+            ->with('success', 'Enhance job queued again.');
+    }
+
+    public function markFailed(Request $request, EnhanceJob $enhanceJob): RedirectResponse
+    {
+        $this->authorize('markFailed', $enhanceJob);
+
+        $job = $this->enhanceService->markFailedByModerator($enhanceJob, $request->user());
+
+        return redirect()
+            ->route('admin.enhance.show', ['enhanceJob' => $job])
+            ->with('success', 'Enhance job marked as failed.');
+    }
+
+    public function destroy(EnhanceJob $enhanceJob): RedirectResponse
+    {
+        $this->authorize('delete', $enhanceJob);
+
+        $this->enhanceService->delete($enhanceJob);
+
+        return redirect()
+            ->route('admin.enhance.index')
+            ->with('success', 'Enhance job deleted.');
+    }
+
+    private function serializeJob(EnhanceJob $job, bool $detailed = false): array
+    {
+        return [
+            'id' => $job->id,
+            'status' => (string) $job->status,
+            'engine' => (string) $job->engine,
+            'mode' => (string) $job->mode,
+            'scale' => (int) $job->scale,
+            'source_url' => $job->sourceUrl(),
+            'output_url' => $job->outputUrl(),
+            'preview_url' => $job->previewUrl(),
+            'input_width' => (int) ($job->input_width ?? 0),
+            'input_height' => (int) ($job->input_height ?? 0),
+            'input_filesize' => (int) ($job->input_filesize ?? 0),
+            'input_mime' => $job->input_mime,
+            'output_width' => (int) ($job->output_width ?? 0),
+            'output_height' => (int) ($job->output_height ?? 0),
+            'output_filesize' => (int) ($job->output_filesize ?? 0),
+            'output_mime' => $job->output_mime,
+            'processing_seconds' => $job->processing_seconds,
+            'error_message' => $job->error_message,
+            'metadata' => $job->metadata ?? [],
+            'created_at' => optional($job->created_at)?->toIso8601String(),
+            'queued_at' => optional($job->queued_at)?->toIso8601String(),
+            'started_at' => optional($job->started_at)?->toIso8601String(),
+            'finished_at' => optional($job->finished_at)?->toIso8601String(),
+            'expires_at' => optional($job->expires_at)?->toIso8601String(),
+            'user' => $job->user ? [
+                'id' => $job->user->id,
+                'name' => $job->user->name,
+                'username' => $job->user->username,
+            ] : null,
+            'artwork' => $job->artwork ? [
+                'id' => $job->artwork->id,
+                'title' => $job->artwork->title,
+                'slug' => $job->artwork->slug,
+                'url' => route('art.show', ['id' => $job->artwork->id, 'slug' => $job->artwork->slug]),
+            ] : null,
+            'show_url' => route('admin.enhance.show', ['enhanceJob' => $job]),
+            'download_url' => $job->outputUrl(),
+            'retry_url' => route('admin.enhance.retry', ['enhanceJob' => $job]),
+            'mark_failed_url' => route('admin.enhance.mark-failed', ['enhanceJob' => $job]),
+            'delete_url' => route('admin.enhance.destroy', ['enhanceJob' => $job]),
+            'can_retry' => $job->status === EnhanceJob::STATUS_FAILED,
+            'can_mark_failed' => in_array($job->status, [EnhanceJob::STATUS_PENDING, EnhanceJob::STATUS_QUEUED, EnhanceJob::STATUS_PROCESSING], true),
+            'detailed' => $detailed,
+        ];
+    }
+}

app/Http/Controllers/Moderation/StaffApplicationsController.php

@@ -0,0 +1,98 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Moderation;
+
+use App\Http\Controllers\Controller;
+use App\Models\StaffApplication;
+use Illuminate\Http\Request;
+use Inertia\Inertia;
+use Inertia\Response;
+
+final class StaffApplicationsController extends Controller
+{
+    public function index(Request $request): Response
+    {
+        $filters = [
+            'q' => trim((string) $request->query('q', '')),
+            'topic' => trim((string) $request->query('topic', 'all')),
+        ];
+
+        $query = StaffApplication::query()->latest('created_at');
+
+        if ($filters['q'] !== '') {
+            $search = $filters['q'];
+            $query->where(function ($builder) use ($search): void {
+                $builder
+                    ->where('name', 'like', '%' . $search . '%')
+                    ->orWhere('email', 'like', '%' . $search . '%')
+                    ->orWhere('role', 'like', '%' . $search . '%')
+                    ->orWhere('message', 'like', '%' . $search . '%');
+            });
+        }
+
+        if ($filters['topic'] !== '' && $filters['topic'] !== 'all') {
+            $query->where('topic', $filters['topic']);
+        }
+
+        $items = $query
+            ->paginate(20)
+            ->withQueryString()
+            ->through(fn (StaffApplication $application): array => $this->serializeApplication($application));
+
+        $stats = [
+            'total' => StaffApplication::query()->count(),
+            'applications' => StaffApplication::query()->where('topic', 'application')->count(),
+            'bug' => StaffApplication::query()->where('topic', 'bug')->count(),
+            'contact' => StaffApplication::query()->where('topic', 'contact')->count(),
+            'other' => StaffApplication::query()->whereNotIn('topic', ['application', 'bug', 'contact'])->count(),
+        ];
+
+        $topics = StaffApplication::query()
+            ->select('topic')
+            ->distinct()
+            ->orderBy('topic')
+            ->pluck('topic')
+            ->values()
+            ->all();
+
+        return Inertia::render('Moderation/StaffApplications/Index', [
+            'title' => 'Staff Applications',
+            'items' => $items,
+            'filters' => $filters,
+            'stats' => $stats,
+            'topics' => $topics,
+            'endpoints' => [
+                'index' => route('admin.staff-applications.index'),
+            ],
+        ])->rootView('moderation');
+    }
+
+    public function show(StaffApplication $staffApplication): Response
+    {
+        return Inertia::render('Moderation/StaffApplications/Show', [
+            'title' => 'Staff Application',
+            'item' => $this->serializeApplication($staffApplication, true),
+            'backUrl' => route('admin.staff-applications.index'),
+        ])->rootView('moderation');
+    }
+
+    private function serializeApplication(StaffApplication $application, bool $detailed = false): array
+    {
+        return [
+            'id' => (string) $application->id,
+            'topic' => (string) ($application->topic ?: 'contact'),
+            'name' => (string) ($application->name ?: 'Unknown'),
+            'email' => (string) ($application->email ?: ''),
+            'role' => $application->role,
+            'portfolio' => $application->portfolio,
+            'message' => $application->message,
+            'ip' => $application->ip,
+            'user_agent' => $application->user_agent,
+            'created_at' => optional($application->created_at)?->toIso8601String(),
+            'payload' => $detailed ? ($application->payload ?? []) : [],
+            'show_url' => route('admin.staff-applications.show', ['staffApplication' => $application]),
+        ];
+    }
+}

app/Http/Controllers/Moderation/StoriesController.php

@@ -0,0 +1,105 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Moderation;
+
+use App\Http\Controllers\Controller;
+use App\Models\Story;
+use Illuminate\Http\Request;
+use Inertia\Inertia;
+use Inertia\Response;
+
+final class StoriesController extends Controller
+{
+    public function index(Request $request): Response
+    {
+        $filters = [
+            'q' => trim((string) $request->query('q', '')),
+            'status' => trim((string) $request->query('status', 'all')),
+        ];
+
+        $query = Story::query()
+            ->with('creator:id,name,username')
+            ->latest('created_at')
+            ->latest('id');
+
+        if ($filters['q'] !== '') {
+            $search = $filters['q'];
+            $query->where(function ($builder) use ($search): void {
+                $builder
+                    ->where('title', 'like', '%' . $search . '%')
+                    ->orWhere('slug', 'like', '%' . $search . '%')
+                    ->orWhereHas('creator', function ($creatorQuery) use ($search): void {
+                        $creatorQuery
+                            ->where('name', 'like', '%' . $search . '%')
+                            ->orWhere('username', 'like', '%' . $search . '%');
+                    });
+            });
+        }
+
+        if ($filters['status'] !== '' && $filters['status'] !== 'all') {
+            $query->where('status', $filters['status']);
+        }
+
+        $stories = $query
+            ->paginate(24)
+            ->withQueryString()
+            ->through(fn (Story $story): array => $this->serializeStory($story));
+
+        $statsQuery = Story::query();
+        if ($filters['q'] !== '') {
+            $search = $filters['q'];
+            $statsQuery->where(function ($builder) use ($search): void {
+                $builder
+                    ->where('title', 'like', '%' . $search . '%')
+                    ->orWhere('slug', 'like', '%' . $search . '%')
+                    ->orWhereHas('creator', function ($creatorQuery) use ($search): void {
+                        $creatorQuery
+                            ->where('name', 'like', '%' . $search . '%')
+                            ->orWhere('username', 'like', '%' . $search . '%');
+                    });
+            });
+        }
+
+        $stats = [
+            'total' => (clone $statsQuery)->count(),
+            'published' => (clone $statsQuery)->where('status', 'published')->count(),
+            'draft' => (clone $statsQuery)->where('status', 'draft')->count(),
+            'scheduled' => (clone $statsQuery)->where('status', 'scheduled')->count(),
+            'pending_review' => (clone $statsQuery)->where('status', 'pending_review')->count(),
+            'archived' => (clone $statsQuery)->where('status', 'archived')->count(),
+        ];
+
+        return Inertia::render('Moderation/Stories', [
+            'title' => 'Stories',
+            'stories' => $stories,
+            'filters' => $filters,
+            'stats' => $stats,
+            'endpoints' => [
+                'index' => route('admin.stories'),
+            ],
+        ])->rootView('moderation');
+    }
+
+    private function serializeStory(Story $story): array
+    {
+        return [
+            'id' => (int) $story->id,
+            'title' => (string) ($story->title ?: 'Untitled story'),
+            'slug' => (string) $story->slug,
+            'excerpt' => $story->excerpt,
+            'status' => (string) ($story->status ?: 'draft'),
+            'published_at' => optional($story->published_at)?->toIso8601String(),
+            'created_at' => optional($story->created_at)?->toIso8601String(),
+            'cover_url' => $story->coverUrl,
+            'public_url' => $story->url,
+            'open_url' => $story->status === 'published' ? $story->url : null,
+            'creator' => $story->creator ? [
+                'id' => (int) $story->creator->id,
+                'name' => (string) $story->creator->name,
+                'username' => (string) $story->creator->username,
+            ] : null,
+        ];
+    }
+}

app/Http/Controllers/Moderation/UsernameQueueController.php

@@ -0,0 +1,116 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Moderation;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Inertia\Inertia;
+use Inertia\Response;
+
+final class UsernameQueueController extends Controller
+{
+    public function index(Request $request): Response
+    {
+        $filters = [
+            'q' => trim((string) $request->query('q', '')),
+            'status' => trim((string) $request->query('status', 'pending')),
+        ];
+
+        $requestColumns = Schema::hasTable('username_approval_requests')
+            ? Schema::getColumnListing('username_approval_requests')
+            : [];
+
+        $query = DB::table('username_approval_requests as requests')
+            ->leftJoin('users', 'users.id', '=', 'requests.user_id')
+            ->select([
+                'requests.id',
+                'requests.user_id',
+                'requests.requested_username',
+                'requests.status',
+                'requests.context',
+                'requests.similar_to',
+                'requests.review_note',
+                'requests.reviewed_at',
+                'requests.created_at',
+                'users.username as current_username',
+                'users.name as current_name',
+            ])
+            ->orderByDesc('requests.created_at');
+
+        if ($filters['status'] !== '' && $filters['status'] !== 'all') {
+            $query->where('requests.status', $filters['status']);
+        }
+
+        if ($filters['q'] !== '') {
+            $search = $filters['q'];
+            $query->where(function ($builder) use ($search): void {
+                $builder
+                    ->where('requests.requested_username', 'like', '%' . $search . '%')
+                    ->orWhere('requests.context', 'like', '%' . $search . '%')
+                    ->orWhere('users.username', 'like', '%' . $search . '%')
+                    ->orWhere('users.name', 'like', '%' . $search . '%');
+            });
+        }
+
+        $requests = $query->paginate(20)->withQueryString()->through(function ($row): array {
+            return [
+                'id' => (int) $row->id,
+                'user_id' => $row->user_id !== null ? (int) $row->user_id : null,
+                'requested_username' => (string) $row->requested_username,
+                'status' => (string) ($row->status ?? 'pending'),
+                'context' => $row->context ?? null,
+                'similar_to' => $row->similar_to ?? null,
+                'review_note' => $row->review_note ?? null,
+                'reviewed_at' => $this->serializeTimestamp($row->reviewed_at ?? null),
+                'created_at' => $this->serializeTimestamp($row->created_at ?? null),
+                'current_username' => $row->current_username,
+                'current_name' => $row->current_name,
+                'approve_url' => route('api.admin.usernames.approve', ['id' => $row->id]),
+                'reject_url' => route('api.admin.usernames.reject', ['id' => $row->id]),
+            ];
+        });
+
+        $stats = [
+            'total' => Schema::hasTable('username_approval_requests') ? DB::table('username_approval_requests')->count() : 0,
+            'pending' => Schema::hasTable('username_approval_requests') ? DB::table('username_approval_requests')->where('status', 'pending')->count() : 0,
+            'approved' => Schema::hasTable('username_approval_requests') ? DB::table('username_approval_requests')->where('status', 'approved')->count() : 0,
+            'rejected' => Schema::hasTable('username_approval_requests') ? DB::table('username_approval_requests')->where('status', 'rejected')->count() : 0,
+        ];
+
+        return Inertia::render('Moderation/UsernameQueue', [
+            'title' => 'Username Queue',
+            'requests' => $requests,
+            'stats' => $stats,
+            'filters' => $filters,
+            'options' => [
+                'statuses' => [
+                    ['value' => 'all', 'label' => 'All statuses'],
+                    ['value' => 'pending', 'label' => 'Pending'],
+                    ['value' => 'approved', 'label' => 'Approved'],
+                    ['value' => 'rejected', 'label' => 'Rejected'],
+                ],
+            ],
+            'endpoints' => [
+                'index' => route('admin.usernames'),
+                'refresh' => route('admin.usernames'),
+            ],
+        ])->rootView('moderation');
+    }
+
+    private function serializeTimestamp(mixed $value): ?string
+    {
+        if ($value === null || $value === '') {
+            return null;
+        }
+
+        try {
+            return \Illuminate\Support\Carbon::parse((string) $value)->toIso8601String();
+        } catch (\Throwable) {
+            return null;
+        }
+    }
+}

app/Http/Controllers/News/NewsController.php

@@ -132,6 +132,32 @@ class NewsController extends Controller
         ] + $this->sidebarData());
     }
 
+    // -----------------------------------------------------------------------
+    // Type page — /news/type/{type}
+    // -----------------------------------------------------------------------
+
+    public function type(Request $request, string $type): View
+    {
+        $typeLabels = \cPad\Plugins\News\Models\NewsArticle::TYPE_LABELS;
+
+        abort_unless(array_key_exists($type, $typeLabels), 404);
+
+        $label   = $typeLabels[$type];
+        $perPage = config('news.articles_per_page', 12);
+
+        $articles = NewsArticle::with('author', 'category')
+            ->published()
+            ->where('type', $type)
+            ->editorialOrder()
+            ->paginate($perPage);
+
+        return view('news.type', [
+            'type'      => $type,
+            'typeLabel' => $label,
+            'articles'  => $articles,
+        ] + $this->sidebarData());
+    }
+
     // -----------------------------------------------------------------------
     // Article page — /news/{slug}
     // -----------------------------------------------------------------------
@@ -173,6 +199,7 @@ class NewsController extends Controller
             return;
         }
 
+        try {
             NewsView::create([
                 'article_id' => $article->id,
                 'user_id'    => $userId,
@@ -181,6 +208,12 @@ class NewsController extends Controller
             ]);
 
             $article->incrementViews();
+        } catch (\Illuminate\Database\QueryException $e) {
+            // Unique constraint violation — duplicate view, skip silently.
+            if (($e->errorInfo[1] ?? 0) !== 1062) {
+                throw $e;
+            }
+        }
 
         if ($canReadSession) {
             $request->session()->put($session, true);

app/Http/Controllers/News/NewsRssController.php

@@ -4,6 +4,7 @@ namespace App\Http\Controllers\News;
 
 use App\Http\Controllers\Controller;
 use Illuminate\Http\Response;
+use Illuminate\Support\Facades\Cache;
 use cPad\Plugins\News\Models\NewsArticle;
 
 class NewsRssController extends Controller
@@ -14,13 +15,17 @@ class NewsRssController extends Controller
      */
     public function feed(): Response
     {
+        $ttl = max(60, (int) config('news.rss_cache_ttl', 300));
+
+        $xml = Cache::remember('news.rss.feed', $ttl, function (): string {
             $articles = NewsArticle::with('author', 'category')
                 ->published()
                 ->orderByDesc('published_at')
                 ->limit(config('news.rss_limit', 25))
                 ->get();
 
-        $xml = $this->buildRss($articles);
+            return $this->buildRss($articles);
+        });
 
         return response($xml, 200, [
             'Content-Type' => 'application/rss+xml; charset=UTF-8',

app/Http/Controllers/Settings/AcademyAdminAnalyticsController.php

@@ -0,0 +1,628 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Settings;
+
+use App\Http\Controllers\Controller;
+use App\Models\AcademyContentMetricDaily;
+use App\Models\AcademyEvent;
+use App\Models\AcademySearchLog;
+use App\Services\Academy\AcademyAnalyticsContentResolver;
+use App\Services\Academy\AcademyContentIntelligenceService;
+use App\Services\Academy\AcademyPopularityService;
+use App\Support\AcademyAnalytics\AcademyAnalyticsContentType;
+use App\Support\AcademyAnalytics\AcademyAnalyticsEventType;
+use Illuminate\Http\Request;
+use Illuminate\Support\Carbon;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Str;
+use Inertia\Inertia;
+use Inertia\Response;
+
+final class AcademyAdminAnalyticsController extends Controller
+{
+    public function __construct(
+        private readonly AcademyPopularityService $popularity,
+        private readonly AcademyAnalyticsContentResolver $resolver,
+        private readonly AcademyContentIntelligenceService $intelligence,
+    ) {}
+
+    public function overview(Request $request): Response
+    {
+        [$from, $to, $range] = $this->resolveDateRange($request);
+        $promptLibraryCurrent = $this->contentSummary(AcademyAnalyticsContentType::PROMPT_LIBRARY, $from, $to);
+        [$previousFrom, $previousTo] = $this->previousRange($from, $to);
+        $promptLibraryPrevious = $this->contentSummary(AcademyAnalyticsContentType::PROMPT_LIBRARY, $previousFrom, $previousTo);
+
+        $summary = $this->metricsQuery($from, $to)
+            ->selectRaw('sum(views) as views, sum(unique_visitors) as unique_visitors, sum(user_views) as user_views, sum(guest_views) as guest_views, sum(subscriber_views) as subscriber_views, sum(prompt_copies) as prompt_copies, sum(likes) as likes, sum(saves) as saves, sum(completions) as completions, sum(starts) as starts, sum(upgrade_clicks) as upgrade_clicks')
+            ->first();
+
+        return Inertia::render('Admin/Academy/AnalyticsOverview', [
+            'nav' => $this->nav(),
+            'range' => $this->rangePayload($range, $from, $to),
+            'stats' => [
+                'views' => (int) ($summary?->views ?? 0),
+                'uniqueVisitors' => (int) ($summary?->unique_visitors ?? 0),
+                'userViews' => (int) ($summary?->user_views ?? 0),
+                'guestViews' => (int) ($summary?->guest_views ?? 0),
+                'subscriberViews' => (int) ($summary?->subscriber_views ?? 0),
+                'promptCopies' => (int) ($summary?->prompt_copies ?? 0),
+                'likes' => (int) ($summary?->likes ?? 0),
+                'saves' => (int) ($summary?->saves ?? 0),
+                'lessonCompletions' => (int) ($summary?->completions ?? 0),
+                'courseStarts' => (int) ($summary?->starts ?? 0),
+                'upgradeClicks' => (int) ($summary?->upgrade_clicks ?? 0),
+            ],
+            'promptLibraryTrend' => [
+                'current' => $promptLibraryCurrent,
+                'previous' => $promptLibraryPrevious,
+                'deltas' => [
+                    'views' => $this->percentDelta((int) $promptLibraryCurrent['views'], (int) $promptLibraryPrevious['views']),
+                    'uniqueVisitors' => $this->percentDelta((int) $promptLibraryCurrent['uniqueVisitors'], (int) $promptLibraryPrevious['uniqueVisitors']),
+                    'engagedViews' => $this->percentDelta((int) $promptLibraryCurrent['engagedViews'], (int) $promptLibraryPrevious['engagedViews']),
+                    'engagementRate' => $this->percentDelta((float) $promptLibraryCurrent['engagementRate'], (float) $promptLibraryPrevious['engagementRate']),
+                ],
+                'range' => [
+                    'current' => ['from' => $from->toDateString(), 'to' => $to->toDateString()],
+                    'previous' => ['from' => $previousFrom->toDateString(), 'to' => $previousTo->toDateString()],
+                ],
+            ],
+            'popularPromptPeriodUsage' => $this->popularPromptPeriodUsage($from, $to),
+            'topContent' => $this->serializeContentRows($this->popularity->topContent($from, $to, 8)),
+            'topWeek' => $this->serializeContentRows($this->popularity->topContent(now()->subDays(6)->startOfDay(), now()->endOfDay(), 8)),
+        ]);
+    }
+
+    public function content(Request $request): Response
+    {
+        return $this->renderContentPage($request, null, 'Content performance', 'Cross-module performance across prompts, lessons, courses, packs, and challenges.');
+    }
+
+    public function prompts(Request $request): Response
+    {
+        return $this->renderContentPage($request, AcademyAnalyticsContentType::PROMPT, 'Prompt analytics', 'Copy-heavy prompt performance, save rates, and upgrade interest.');
+    }
+
+    public function promptLibrary(Request $request): Response
+    {
+        return $this->renderContentPage($request, AcademyAnalyticsContentType::PROMPT_LIBRARY, 'Prompt library analytics', 'Discovery and engagement on the public /academy/prompts library page.');
+    }
+
+    public function lessons(Request $request): Response
+    {
+        return $this->renderContentPage($request, AcademyAnalyticsContentType::LESSON, 'Lesson analytics', 'Lesson engagement, starts, completions, and drop-off signals.');
+    }
+
+    public function courses(Request $request): Response
+    {
+        return $this->renderContentPage($request, AcademyAnalyticsContentType::COURSE, 'Course analytics', 'Course views, starts, completion progress, and upgrade intent.');
+    }
+
+    public function search(Request $request): Response
+    {
+        [$from, $to, $range] = $this->resolveDateRange($request);
+
+        $searchQuery = AcademySearchLog::query()->whereBetween('created_at', [$from, $to]);
+        $searchLogs = (clone $searchQuery)->latest('created_at')->limit(500)->get();
+
+        return Inertia::render('Admin/Academy/AnalyticsSearch', [
+            'nav' => $this->nav(),
+            'range' => $this->rangePayload($range, $from, $to),
+            'summary' => [
+                'searches' => (int) (clone $searchQuery)->count(),
+                'zeroResultSearches' => (int) (clone $searchQuery)->where('results_count', 0)->count(),
+                'loggedInSearches' => (int) (clone $searchQuery)->where('is_logged_in', true)->count(),
+                'subscriberSearches' => (int) (clone $searchQuery)->where('is_subscriber', true)->count(),
+                'searchesWithClicks' => (int) (clone $searchQuery)->whereNotNull('clicked_content_id')->count(),
+            ],
+            'topSearches' => (clone $searchQuery)
+                ->selectRaw('normalized_query, max(query) as query, count(*) as searches, sum(results_count = 0) as zero_result_hits, avg(results_count) as avg_results, sum(case when clicked_content_id is not null then 1 else 0 end) as clicks')
+                ->groupBy('normalized_query')
+                ->orderByDesc('searches')
+                ->limit(20)
+                ->get()
+                ->map(fn ($row): array => [
+                    'query' => (string) ($row->query ?: $row->normalized_query),
+                    'normalized_query' => (string) $row->normalized_query,
+                    'searches' => (int) $row->searches,
+                    'zero_result_hits' => (int) $row->zero_result_hits,
+                    'avg_results' => round((float) $row->avg_results, 1),
+                    'clicks' => (int) ($row->clicks ?? 0),
+                    'click_through_rate' => (int) $row->searches > 0 ? round((((int) ($row->clicks ?? 0)) / (int) $row->searches) * 100, 1) : 0,
+                ])
+                ->all(),
+            'zeroResults' => (clone $searchQuery)
+                ->selectRaw('normalized_query, max(query) as query, count(*) as searches')
+                ->where('results_count', 0)
+                ->groupBy('normalized_query')
+                ->orderByDesc('searches')
+                ->limit(20)
+                ->get()
+                ->map(fn ($row): array => [
+                    'query' => (string) ($row->query ?: $row->normalized_query),
+                    'searches' => (int) $row->searches,
+                ])
+                ->all(),
+            'lowClickThroughSearches' => (clone $searchQuery)
+                ->selectRaw('normalized_query, max(query) as query, count(*) as searches, sum(case when clicked_content_id is not null then 1 else 0 end) as clicks, avg(results_count) as avg_results')
+                ->groupBy('normalized_query')
+                ->havingRaw('count(*) >= 2')
+                ->orderByRaw('case when count(*) = 0 then 1 else (sum(case when clicked_content_id is not null then 1 else 0 end) * 1.0 / count(*)) end asc')
+                ->limit(20)
+                ->get()
+                ->map(fn ($row): array => [
+                    'query' => (string) ($row->query ?: $row->normalized_query),
+                    'searches' => (int) $row->searches,
+                    'clicks' => (int) ($row->clicks ?? 0),
+                    'avg_results' => round((float) $row->avg_results, 1),
+                    'click_through_rate' => (int) $row->searches > 0 ? round((((int) ($row->clicks ?? 0)) / (int) $row->searches) * 100, 1) : 0,
+                ])
+                ->all(),
+            'highestClickThroughSearches' => (clone $searchQuery)
+                ->selectRaw('normalized_query, max(query) as query, count(*) as searches, sum(case when clicked_content_id is not null then 1 else 0 end) as clicks, avg(results_count) as avg_results')
+                ->groupBy('normalized_query')
+                ->havingRaw('count(*) >= 2')
+                ->orderByRaw('(sum(case when clicked_content_id is not null then 1 else 0 end) * 1.0 / count(*)) desc')
+                ->limit(20)
+                ->get()
+                ->map(fn ($row): array => [
+                    'query' => (string) ($row->query ?: $row->normalized_query),
+                    'searches' => (int) $row->searches,
+                    'clicks' => (int) ($row->clicks ?? 0),
+                    'avg_results' => round((float) $row->avg_results, 1),
+                    'click_through_rate' => (int) $row->searches > 0 ? round((((int) ($row->clicks ?? 0)) / (int) $row->searches) * 100, 1) : 0,
+                ])
+                ->all(),
+            'searchesWithResultsNoClicks' => (clone $searchQuery)
+                ->selectRaw('normalized_query, max(query) as query, count(*) as searches, avg(results_count) as avg_results')
+                ->where('results_count', '>', 0)
+                ->whereNull('clicked_content_id')
+                ->groupBy('normalized_query')
+                ->orderByDesc('searches')
+                ->limit(20)
+                ->get()
+                ->map(fn ($row): array => [
+                    'query' => (string) ($row->query ?: $row->normalized_query),
+                    'searches' => (int) $row->searches,
+                    'avg_results' => round((float) $row->avg_results, 1),
+                    'clicks' => 0,
+                    'click_through_rate' => 0,
+                ])
+                ->all(),
+            'topClickedResults' => (clone $searchQuery)
+                ->selectRaw('clicked_content_type, clicked_content_id, count(*) as clicks')
+                ->whereNotNull('clicked_content_type')
+                ->whereNotNull('clicked_content_id')
+                ->groupBy('clicked_content_type', 'clicked_content_id')
+                ->orderByDesc('clicks')
+                ->limit(20)
+                ->get()
+                ->map(fn ($row): array => [
+                    'title' => $this->resolver->title((string) $row->clicked_content_type, (int) $row->clicked_content_id),
+                    'content_type' => (string) $row->clicked_content_type,
+                    'content_id' => (int) $row->clicked_content_id,
+                    'clicks' => (int) $row->clicks,
+                ])
+                ->all(),
+            'filterUsage' => $this->summarizeSearchFilters($searchLogs),
+            'recentSearches' => (clone $searchQuery)
+                ->latest('created_at')
+                ->limit(25)
+                ->get()
+                ->map(fn (AcademySearchLog $log): array => [
+                    'query' => (string) $log->query,
+                    'results_count' => (int) $log->results_count,
+                    'logged_in' => (bool) $log->is_logged_in,
+                    'subscriber' => (bool) $log->is_subscriber,
+                    'clicked_content_type' => $log->clicked_content_type,
+                    'has_click' => $log->clicked_content_id !== null,
+                    'created_at' => $log->created_at?->toISOString(),
+                ])
+                ->all(),
+        ]);
+    }
+
+    public function intelligence(Request $request): Response
+    {
+        [$from, $to, $range] = $this->resolveDateRange($request, '30d');
+        $filters = [
+            'from' => $from,
+            'to' => $to,
+            'limit' => 25,
+        ];
+
+        return Inertia::render('Admin/Academy/AnalyticsIntelligence', [
+            'nav' => $this->nav(),
+            'range' => $this->rangePayload($range, $from, $to),
+            'contentOpportunities' => $this->intelligence->getContentOpportunities($filters),
+            'searchGaps' => $this->intelligence->getSearchGaps($filters),
+            'promptInsights' => $this->intelligence->getPromptInsights($filters),
+            'lessonDropoffs' => $this->intelligence->getLessonDropoffs($filters),
+            'courseHealth' => $this->intelligence->getCourseHealth($filters),
+            'premiumInterest' => $this->intelligence->getPremiumInterest($filters),
+            'editorialRecommendations' => $this->intelligence->getEditorialRecommendations($filters),
+        ]);
+    }
+
+    /**
+     * @param  Collection<int, AcademySearchLog>  $logs
+     * @return list<array<string, int|string>>
+     */
+    private function summarizeSearchFilters(Collection $logs): array
+    {
+        $counts = [];
+
+        foreach ($logs as $log) {
+            $filters = is_array($log->filters) ? $log->filters : [];
+
+            foreach ($filters as $key => $value) {
+                if ($value === null || $value === '' || $key === 'q') {
+                    continue;
+                }
+
+                $values = is_array($value) ? $value : [$value];
+
+                foreach ($values as $rawValue) {
+                    $label = trim((string) $rawValue);
+                    if ($label === '') {
+                        continue;
+                    }
+
+                    $bucket = sprintf('%s:%s', $key, $label);
+                    $counts[$bucket] = [
+                        'filter' => (string) $key,
+                        'value' => $label,
+                        'uses' => (int) (($counts[$bucket]['uses'] ?? 0) + 1),
+                    ];
+                }
+            }
+        }
+
+        usort($counts, static fn (array $left, array $right): int => $right['uses'] <=> $left['uses']);
+
+        return array_slice(array_values($counts), 0, 20);
+    }
+
+    public function funnel(Request $request): Response
+    {
+        [$from, $to, $range] = $this->resolveDateRange($request);
+
+        $summary = $this->metricsQuery($from, $to)
+            ->selectRaw('sum(unique_visitors) as unique_visitors, sum(premium_preview_views) as premium_preview_views, sum(upgrade_clicks) as upgrade_clicks, sum(starts) as starts, sum(completions) as completions')
+            ->first();
+
+        $bestConverters = $this->metricsQuery($from, $to)
+            ->selectRaw('content_type, content_id, sum(unique_visitors) as unique_visitors, sum(premium_preview_views) as premium_preview_views, sum(upgrade_clicks) as upgrade_clicks, sum(conversion_score) as conversion_score')
+            ->groupBy('content_type', 'content_id')
+            ->havingRaw('sum(upgrade_clicks) > 0')
+            ->orderByDesc('conversion_score')
+            ->limit(12)
+            ->get();
+
+        return Inertia::render('Admin/Academy/AnalyticsFunnel', [
+            'nav' => $this->nav(),
+            'range' => $this->rangePayload($range, $from, $to),
+            'summary' => [
+                'academyVisitors' => (int) ($summary?->unique_visitors ?? 0),
+                'premiumPreviewViews' => (int) ($summary?->premium_preview_views ?? 0),
+                'upgradeClicks' => (int) ($summary?->upgrade_clicks ?? 0),
+                'starts' => (int) ($summary?->starts ?? 0),
+                'completions' => (int) ($summary?->completions ?? 0),
+                'checkoutStarts' => 0,
+                'subscriptions' => 0,
+            ],
+            'bestConverters' => $this->serializeContentRows($bestConverters, includeConversion: true),
+        ]);
+    }
+
+    private function renderContentPage(Request $request, ?string $forcedContentType, string $title, string $subtitle): Response
+    {
+        [$from, $to, $range] = $this->resolveDateRange($request);
+        $sort = (string) $request->query('sort', 'popularity_score');
+        $direction = strtolower((string) $request->query('direction', 'desc')) === 'asc' ? 'asc' : 'desc';
+        $access = trim((string) $request->query('access', ''));
+        $contentType = $forcedContentType ?: (trim((string) $request->query('content_type', '')) ?: null);
+
+        $query = $this->metricsQuery($from, $to)
+            ->selectRaw('content_type, content_id, sum(views) as views, sum(unique_visitors) as unique_visitors, sum(engaged_views) as engaged_views, sum(likes) as likes, sum(saves) as saves, sum(prompt_copies) as prompt_copies, sum(starts) as starts, sum(completions) as completions, sum(upgrade_clicks) as upgrade_clicks, sum(popularity_score) as popularity_score, sum(conversion_score) as conversion_score')
+            ->groupBy('content_type', 'content_id');
+
+        if ($contentType !== null) {
+            $query->where('content_type', $contentType);
+        }
+
+        $rows = $query->get();
+
+        $serializedRows = $this->serializeContentRows($rows, includeConversion: true)
+            ->filter(function (array $row) use ($access): bool {
+                if ($access === '') {
+                    return true;
+                }
+
+                return strtolower((string) ($row['access_level'] ?? '')) === strtolower($access);
+            })
+            ->sortBy($sort, SORT_REGULAR, $direction === 'desc')
+            ->values()
+            ->all();
+
+        return Inertia::render('Admin/Academy/AnalyticsContent', [
+            'nav' => $this->nav(),
+            'range' => $this->rangePayload($range, $from, $to),
+            'title' => $title,
+            'subtitle' => $subtitle,
+            'filters' => [
+                'sort' => $sort,
+                'direction' => $direction,
+                'access' => $access,
+                'content_type' => $contentType,
+            ],
+            'summary' => $contentType === AcademyAnalyticsContentType::PROMPT_LIBRARY
+                ? $this->contentSummary(AcademyAnalyticsContentType::PROMPT_LIBRARY, $from, $to)
+                : null,
+            'rows' => $serializedRows,
+            'contentTypeOptions' => [
+                ['value' => '', 'label' => 'All content'],
+                ['value' => AcademyAnalyticsContentType::PROMPT_LIBRARY, 'label' => 'Prompt library'],
+                ['value' => AcademyAnalyticsContentType::PROMPT_PACK_LIBRARY, 'label' => 'Prompt pack library'],
+                ['value' => AcademyAnalyticsContentType::PROMPT, 'label' => 'Prompts'],
+                ['value' => AcademyAnalyticsContentType::LESSON, 'label' => 'Lessons'],
+                ['value' => AcademyAnalyticsContentType::COURSE, 'label' => 'Courses'],
+                ['value' => AcademyAnalyticsContentType::PROMPT_PACK, 'label' => 'Prompt packs'],
+                ['value' => AcademyAnalyticsContentType::CHALLENGE, 'label' => 'Challenges'],
+            ],
+            'sortOptions' => [
+                ['value' => 'views', 'label' => 'Views'],
+                ['value' => 'unique_visitors', 'label' => 'Unique visitors'],
+                ['value' => 'likes', 'label' => 'Likes'],
+                ['value' => 'saves', 'label' => 'Saves'],
+                ['value' => 'prompt_copies', 'label' => 'Copies'],
+                ['value' => 'completions', 'label' => 'Completions'],
+                ['value' => 'upgrade_clicks', 'label' => 'Upgrade clicks'],
+                ['value' => 'popularity_score', 'label' => 'Popularity score'],
+                ['value' => 'conversion_score', 'label' => 'Conversion score'],
+            ],
+        ]);
+    }
+
+    private function metricsQuery(Carbon $from, Carbon $to)
+    {
+        return AcademyContentMetricDaily::query()
+            ->whereBetween('date', [$from->copy()->startOfDay(), $to->copy()->endOfDay()]);
+    }
+
+    /**
+     * @return array<string, int|float>
+     */
+    private function contentSummary(string $contentType, Carbon $from, Carbon $to): array
+    {
+        $query = $this->metricsQuery($from, $to)
+            ->where('content_type', $contentType);
+
+        if (! AcademyAnalyticsContentType::requiresContentId($contentType)) {
+            $query->whereNull('content_id');
+        }
+
+        $summary = $query
+            ->selectRaw('sum(views) as views, sum(unique_visitors) as unique_visitors, sum(engaged_views) as engaged_views, sum(scroll_50) as scroll_50, sum(scroll_75) as scroll_75, sum(scroll_100) as scroll_100, avg(avg_engaged_seconds) as avg_engaged_seconds, sum(popularity_score) as popularity_score')
+            ->first();
+
+        $uniqueVisitors = max(0, (int) ($summary?->unique_visitors ?? 0));
+        $engagedViews = max(0, (int) ($summary?->engaged_views ?? 0));
+        $scroll100 = max(0, (int) ($summary?->scroll_100 ?? 0));
+
+        return [
+            'views' => max(0, (int) ($summary?->views ?? 0)),
+            'uniqueVisitors' => $uniqueVisitors,
+            'engagedViews' => $engagedViews,
+            'scroll50' => max(0, (int) ($summary?->scroll_50 ?? 0)),
+            'scroll75' => max(0, (int) ($summary?->scroll_75 ?? 0)),
+            'scroll100' => $scroll100,
+            'avgEngagedSeconds' => round((float) ($summary?->avg_engaged_seconds ?? 0), 1),
+            'popularityScore' => round((float) ($summary?->popularity_score ?? 0), 2),
+            'engagementRate' => $uniqueVisitors > 0 ? round(($engagedViews / $uniqueVisitors) * 100, 1) : 0.0,
+            'deepScrollRate' => $uniqueVisitors > 0 ? round(($scroll100 / $uniqueVisitors) * 100, 1) : 0.0,
+        ];
+    }
+
+    /**
+     * @return array{0: Carbon, 1: Carbon}
+     */
+    private function previousRange(Carbon $from, Carbon $to): array
+    {
+        $days = $from->copy()->startOfDay()->diffInDays($to->copy()->startOfDay()) + 1;
+
+        return [
+            $from->copy()->subDays($days)->startOfDay(),
+            $from->copy()->subDay()->endOfDay(),
+        ];
+    }
+
+    private function percentDelta(int|float $current, int|float $previous): ?float
+    {
+        if ((float) $previous === 0.0) {
+            return (float) $current === 0.0 ? 0.0 : null;
+        }
+
+        return round((((float) $current - (float) $previous) / (float) $previous) * 100, 1);
+    }
+
+    /**
+     * @return array{totalViews:int,totalVisitors:int,periods:list<array<string,int|float|string>>}
+     */
+    private function popularPromptPeriodUsage(Carbon $from, Carbon $to): array
+    {
+        $events = AcademyEvent::query()
+            ->whereBetween('occurred_at', [$from, $to])
+            ->where('event_type', AcademyAnalyticsEventType::PAGE_VIEW)
+            ->where('content_type', AcademyAnalyticsContentType::PROMPT_POPULAR)
+            ->get(['visitor_id', 'metadata']);
+
+        $summary = [];
+        $totalViews = 0;
+        $visitorBuckets = [];
+
+        foreach ($events as $event) {
+            $metadata = is_array($event->metadata) ? $event->metadata : [];
+            $period = trim((string) ($metadata['period'] ?? ''));
+
+            if ($period === '') {
+                continue;
+            }
+
+            $days = max(0, (int) ($metadata['period_days'] ?? 0));
+
+            if (! isset($summary[$period])) {
+                $summary[$period] = [
+                    'period' => $period,
+                    'label' => sprintf('%s days', $days > 0 ? $days : (int) preg_replace('/\D+/', '', $period)),
+                    'views' => 0,
+                    'uniqueVisitors' => 0,
+                    'share' => 0.0,
+                    'days' => $days,
+                ];
+                $visitorBuckets[$period] = [];
+            }
+
+            $summary[$period]['views']++;
+            $totalViews++;
+
+            $visitorId = trim((string) ($event->visitor_id ?? ''));
+            if ($visitorId !== '') {
+                $visitorBuckets[$period][$visitorId] = true;
+            }
+        }
+
+        $totalVisitors = 0;
+
+        foreach ($summary as $period => &$row) {
+            $uniqueVisitors = count($visitorBuckets[$period] ?? []);
+            $row['uniqueVisitors'] = $uniqueVisitors;
+            $row['share'] = $totalViews > 0 ? round((((int) $row['views']) / $totalViews) * 100, 1) : 0.0;
+            $totalVisitors += $uniqueVisitors;
+        }
+        unset($row);
+
+        usort($summary, static function (array $left, array $right): int {
+            if ((int) $right['views'] === (int) $left['views']) {
+                return ((int) $left['days']) <=> ((int) $right['days']);
+            }
+
+            return ((int) $right['views']) <=> ((int) $left['views']);
+        });
+
+        return [
+            'totalViews' => $totalViews,
+            'totalVisitors' => $totalVisitors,
+            'periods' => array_values($summary),
+        ];
+    }
+
+    /**
+     * @param  Collection<int, mixed>  $rows
+     * @return Collection<int, array<string, mixed>>
+     */
+    private function serializeContentRows(Collection $rows, bool $includeConversion = false): Collection
+    {
+        return $rows->map(function ($row) use ($includeConversion): array {
+            $contentType = (string) $row->content_type;
+            $contentId = $row->content_id ? (int) $row->content_id : null;
+            $title = $this->resolver->title($contentType, $contentId);
+            $accessLevel = $this->resolver->accessLevel($contentType, $contentId);
+            $uniqueVisitors = max(0, (int) ($row->unique_visitors ?? 0));
+            $promptCopies = max(0, (int) ($row->prompt_copies ?? 0));
+            $likes = max(0, (int) ($row->likes ?? 0));
+            $saves = max(0, (int) ($row->saves ?? 0));
+            $starts = max(0, (int) ($row->starts ?? 0));
+            $completions = max(0, (int) ($row->completions ?? 0));
+            $premiumPreviewViews = max(0, (int) ($row->premium_preview_views ?? 0));
+            $upgradeClicks = max(0, (int) ($row->upgrade_clicks ?? 0));
+
+            return [
+                'content_type' => $contentType,
+                'content_type_label' => (string) Str::of(str_replace('academy_', '', $contentType))->replace('_', ' ')->headline(),
+                'content_id' => $contentId,
+                'title' => $title,
+                'access_level' => $accessLevel,
+                'views' => (int) ($row->views ?? 0),
+                'unique_visitors' => $uniqueVisitors,
+                'engaged_views' => (int) ($row->engaged_views ?? 0),
+                'likes' => $likes,
+                'saves' => $saves,
+                'prompt_copies' => $promptCopies,
+                'starts' => $starts,
+                'completions' => $completions,
+                'upgrade_clicks' => $upgradeClicks,
+                'popularity_score' => round((float) ($row->popularity_score ?? 0), 2),
+                'conversion_score' => round((float) ($row->conversion_score ?? 0), 2),
+                'copy_rate' => $uniqueVisitors > 0 ? round(($promptCopies / $uniqueVisitors) * 100, 1) : 0,
+                'save_rate' => $uniqueVisitors > 0 ? round(($saves / $uniqueVisitors) * 100, 1) : 0,
+                'like_rate' => $uniqueVisitors > 0 ? round(($likes / $uniqueVisitors) * 100, 1) : 0,
+                'completion_rate' => $starts > 0 ? round(($completions / $starts) * 100, 1) : 0,
+                'upgrade_rate' => max(1, $premiumPreviewViews) > 0 ? round(($upgradeClicks / max(1, $premiumPreviewViews)) * 100, 1) : 0,
+                'trend' => ((float) ($row->popularity_score ?? 0)) >= 100 ? 'High momentum' : (((float) ($row->popularity_score ?? 0)) >= 25 ? 'Building' : 'Early'),
+                'include_conversion' => $includeConversion,
+            ];
+        });
+    }
+
+    /**
+     * @return array{0: Carbon, 1: Carbon, 2: string}
+     */
+    private function resolveDateRange(Request $request, string $defaultRange = '7d'): array
+    {
+        $range = trim((string) $request->query('range', $defaultRange));
+
+        return match ($range) {
+            'today' => [now()->startOfDay(), now()->endOfDay(), 'today'],
+            'yesterday' => [now()->subDay()->startOfDay(), now()->subDay()->endOfDay(), 'yesterday'],
+            '30d' => [now()->subDays(29)->startOfDay(), now()->endOfDay(), '30d'],
+            '90d' => [now()->subDays(89)->startOfDay(), now()->endOfDay(), '90d'],
+            'custom' => [
+                Carbon::parse((string) $request->query('from', now()->subDays(6)->toDateString()))->startOfDay(),
+                Carbon::parse((string) $request->query('to', now()->toDateString()))->endOfDay(),
+                'custom',
+            ],
+            default => [now()->subDays(6)->startOfDay(), now()->endOfDay(), '7d'],
+        };
+    }
+
+    /**
+     * @return list<array<string, string|bool>>
+     */
+    private function nav(): array
+    {
+        return [
+            ['label' => 'Overview', 'href' => route('admin.academy.analytics.overview')],
+            ['label' => 'Intelligence', 'href' => route('admin.academy.analytics.intelligence')],
+            ['label' => 'Content', 'href' => route('admin.academy.analytics.content')],
+            ['label' => 'Prompt Library', 'href' => route('admin.academy.analytics.prompt-library')],
+            ['label' => 'Prompts', 'href' => route('admin.academy.analytics.prompts')],
+            ['label' => 'Lessons', 'href' => route('admin.academy.analytics.lessons')],
+            ['label' => 'Courses', 'href' => route('admin.academy.analytics.courses')],
+            ['label' => 'Search', 'href' => route('admin.academy.analytics.search')],
+            ['label' => 'Funnel', 'href' => route('admin.academy.analytics.funnel')],
+        ];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function rangePayload(string $activeRange, Carbon $from, Carbon $to): array
+    {
+        return [
+            'active' => $activeRange,
+            'from' => $from->toDateString(),
+            'to' => $to->toDateString(),
+            'options' => [
+                ['value' => 'today', 'label' => 'Today'],
+                ['value' => 'yesterday', 'label' => 'Yesterday'],
+                ['value' => '7d', 'label' => 'Last 7 days'],
+                ['value' => '30d', 'label' => 'Last 30 days'],
+                ['value' => '90d', 'label' => 'Last 90 days'],
+                ['value' => 'custom', 'label' => 'Custom range'],
+            ],
+        ];
+    }
+}

app/Http/Controllers/Settings/AcademyCourseBuilderController.php

@@ -0,0 +1,308 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Settings;
+
+use App\Http\Controllers\Controller;
+use App\Models\AcademyCourse;
+use App\Models\AcademyCourseLesson;
+use App\Models\AcademyCourseSection;
+use App\Models\AcademyLesson;
+use App\Services\Academy\AcademyCacheService;
+use App\Services\Academy\AcademyCourseLessonOrderingService;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+use Inertia\Inertia;
+use Inertia\Response;
+
+final class AcademyCourseBuilderController extends Controller
+{
+    public function __construct(
+        private readonly AcademyCacheService $cache,
+        private readonly AcademyCourseLessonOrderingService $courseLessonOrdering,
+    )
+    {
+    }
+
+    public function edit(AcademyCourse $academyCourse): Response
+    {
+        $academyCourse->load(['sections', 'courseLessons.section', 'courseLessons.lesson.category']);
+
+        return Inertia::render('Admin/Academy/CourseBuilder', [
+            'course' => $this->serializeCourse($academyCourse),
+            'sections' => $academyCourse->sections
+                ->sortBy([['order_num', 'asc'], ['id', 'asc']])
+                ->values()
+                ->map(fn (AcademyCourseSection $section): array => $this->serializeSection($section))
+                ->all(),
+            'courseLessons' => $academyCourse->courseLessons
+                ->sortBy([['order_num', 'asc'], ['id', 'asc']])
+                ->values()
+                ->map(fn (AcademyCourseLesson $courseLesson): array => $this->serializeCourseLesson($courseLesson))
+                ->all(),
+            'availableLessons' => AcademyLesson::query()
+                ->with('category')
+                ->orderBy('title')
+                ->get()
+                ->map(fn (AcademyLesson $lesson): array => [
+                    'id' => (int) $lesson->id,
+                    'title' => (string) $lesson->title,
+                    'slug' => (string) $lesson->slug,
+                    'excerpt' => (string) ($lesson->excerpt ?? ''),
+                    'difficulty' => (string) $lesson->difficulty,
+                    'access_level' => (string) $lesson->access_level,
+                    'active' => (bool) $lesson->active,
+                    'published_at' => $lesson->published_at?->toISOString(),
+                    'category' => $lesson->category ? (string) $lesson->category->name : '',
+                    'attached' => $academyCourse->courseLessons->contains(fn (AcademyCourseLesson $courseLesson): bool => (int) $courseLesson->lesson_id === (int) $lesson->id),
+                ])
+                ->values()
+                ->all(),
+            'routes' => [
+                'index' => route('admin.academy.courses.index'),
+                'edit' => route('admin.academy.courses.edit', ['academyCourse' => $academyCourse]),
+                'preview' => route('academy.courses.show', ['course' => $academyCourse->slug]),
+                'sectionStore' => route('admin.academy.courses.sections.store', ['academyCourse' => $academyCourse]),
+                'attachLesson' => route('admin.academy.courses.lessons.attach', ['academyCourse' => $academyCourse]),
+                'reorder' => route('admin.academy.courses.reorder', ['academyCourse' => $academyCourse]),
+            ],
+        ]);
+    }
+
+    public function storeSection(Request $request, AcademyCourse $academyCourse): RedirectResponse
+    {
+        $data = $request->validate([
+            'title' => ['required', 'string', 'max:180'],
+            'slug' => ['nullable', 'string', 'max:180'],
+            'description' => ['nullable', 'string'],
+            'order_num' => ['nullable', 'integer', 'min:0'],
+            'is_visible' => ['nullable', 'boolean'],
+        ]);
+
+        $academyCourse->sections()->create([
+            'title' => $data['title'],
+            'slug' => filled($data['slug'] ?? null) ? $data['slug'] : Str::slug($data['title']),
+            'description' => $data['description'] ?? null,
+            'order_num' => (int) ($data['order_num'] ?? ($academyCourse->sections()->max('order_num') + 1)),
+            'is_visible' => (bool) ($data['is_visible'] ?? true),
+        ]);
+
+        $this->cache->clearAll();
+
+        return back()->with('success', 'Course section created.');
+    }
+
+    public function updateSection(Request $request, AcademyCourse $academyCourse, AcademyCourseSection $academyCourseSection): RedirectResponse
+    {
+        abort_unless((int) $academyCourseSection->course_id === (int) $academyCourse->id, 404);
+
+        $data = $request->validate([
+            'title' => ['required', 'string', 'max:180'],
+            'slug' => ['nullable', 'string', 'max:180'],
+            'description' => ['nullable', 'string'],
+            'order_num' => ['nullable', 'integer', 'min:0'],
+            'is_visible' => ['nullable', 'boolean'],
+        ]);
+
+        $academyCourseSection->forceFill([
+            'title' => $data['title'],
+            'slug' => filled($data['slug'] ?? null) ? $data['slug'] : Str::slug($data['title']),
+            'description' => $data['description'] ?? null,
+            'order_num' => (int) ($data['order_num'] ?? 0),
+            'is_visible' => (bool) ($data['is_visible'] ?? true),
+        ])->save();
+
+        $this->cache->clearAll();
+
+        return back()->with('success', 'Course section updated.');
+    }
+
+    public function destroySection(AcademyCourse $academyCourse, AcademyCourseSection $academyCourseSection): RedirectResponse
+    {
+        abort_unless((int) $academyCourseSection->course_id === (int) $academyCourse->id, 404);
+
+        $academyCourseSection->delete();
+        $this->cache->clearAll();
+
+        return back()->with('success', 'Course section deleted.');
+    }
+
+    public function attachLesson(Request $request, AcademyCourse $academyCourse): RedirectResponse
+    {
+        $data = $request->validate([
+            'lesson_id' => ['required', 'integer', 'exists:academy_lessons,id'],
+            'section_id' => ['nullable', 'integer', 'exists:academy_course_sections,id'],
+            'order_num' => ['nullable', 'integer', 'min:0'],
+            'is_required' => ['nullable', 'boolean'],
+            'access_override' => ['nullable', 'string', 'in:free,premium,creator,pro'],
+            'unlock_after_lesson_id' => ['nullable', 'integer', 'exists:academy_lessons,id'],
+        ]);
+
+        if (AcademyCourseLesson::query()->where('course_id', $academyCourse->id)->where('lesson_id', $data['lesson_id'])->exists()) {
+            return back()->with('error', 'That lesson is already attached to this course.');
+        }
+
+        $sectionId = $data['section_id'] ?? null;
+        if ($sectionId !== null) {
+            abort_unless(AcademyCourseSection::query()->where('course_id', $academyCourse->id)->whereKey($sectionId)->exists(), 404);
+        }
+
+        AcademyCourseLesson::query()->create([
+            'course_id' => $academyCourse->id,
+            'section_id' => $sectionId,
+            'lesson_id' => (int) $data['lesson_id'],
+            'order_num' => (int) ($data['order_num'] ?? ($academyCourse->courseLessons()->max('order_num') + 1)),
+            'is_required' => (bool) ($data['is_required'] ?? true),
+            'access_override' => $data['access_override'] ?? null,
+            'unlock_after_lesson_id' => $data['unlock_after_lesson_id'] ?? null,
+        ]);
+
+        $this->courseLessonOrdering->syncCourse($academyCourse);
+        $this->syncCourseCounts($academyCourse);
+
+        return back()->with('success', 'Lesson attached to course.');
+    }
+
+    public function updateCourseLesson(Request $request, AcademyCourse $academyCourse, AcademyCourseLesson $academyCourseLesson): RedirectResponse
+    {
+        abort_unless((int) $academyCourseLesson->course_id === (int) $academyCourse->id, 404);
+
+        $data = $request->validate([
+            'section_id' => ['nullable', 'integer', 'exists:academy_course_sections,id'],
+            'order_num' => ['nullable', 'integer', 'min:0'],
+            'is_required' => ['nullable', 'boolean'],
+            'access_override' => ['nullable', 'string', 'in:free,premium,creator,pro'],
+            'unlock_after_lesson_id' => ['nullable', 'integer', 'exists:academy_lessons,id'],
+        ]);
+
+        $sectionId = $data['section_id'] ?? null;
+        if ($sectionId !== null) {
+            abort_unless(AcademyCourseSection::query()->where('course_id', $academyCourse->id)->whereKey($sectionId)->exists(), 404);
+        }
+
+        $academyCourseLesson->forceFill([
+            'section_id' => $sectionId,
+            'order_num' => (int) ($data['order_num'] ?? 0),
+            'is_required' => (bool) ($data['is_required'] ?? true),
+            'access_override' => $data['access_override'] ?? null,
+            'unlock_after_lesson_id' => $data['unlock_after_lesson_id'] ?? null,
+        ])->save();
+
+        $this->courseLessonOrdering->syncCourse($academyCourse);
+        $this->syncCourseCounts($academyCourse);
+
+        return back()->with('success', 'Course lesson updated.');
+    }
+
+    public function detachLesson(AcademyCourse $academyCourse, AcademyCourseLesson $academyCourseLesson): RedirectResponse
+    {
+        abort_unless((int) $academyCourseLesson->course_id === (int) $academyCourse->id, 404);
+
+        $academyCourseLesson->delete();
+        $this->courseLessonOrdering->syncCourse($academyCourse);
+        $this->syncCourseCounts($academyCourse);
+
+        return back()->with('success', 'Lesson removed from course.');
+    }
+
+    public function reorder(Request $request, AcademyCourse $academyCourse): RedirectResponse
+    {
+        $data = $request->validate([
+            'sections' => ['nullable', 'array'],
+            'sections.*.id' => ['required', 'integer', 'exists:academy_course_sections,id'],
+            'sections.*.order_num' => ['required', 'integer', 'min:0'],
+            'lessons' => ['nullable', 'array'],
+            'lessons.*.id' => ['required', 'integer', 'exists:academy_course_lessons,id'],
+            'lessons.*.order_num' => ['required', 'integer', 'min:0'],
+            'lessons.*.section_id' => ['nullable', 'integer', 'exists:academy_course_sections,id'],
+        ]);
+
+        foreach ((array) ($data['sections'] ?? []) as $sectionData) {
+            AcademyCourseSection::query()
+                ->where('course_id', $academyCourse->id)
+                ->whereKey((int) $sectionData['id'])
+                ->update(['order_num' => (int) $sectionData['order_num']]);
+        }
+
+        foreach ((array) ($data['lessons'] ?? []) as $lessonData) {
+            AcademyCourseLesson::query()
+                ->where('course_id', $academyCourse->id)
+                ->whereKey((int) $lessonData['id'])
+                ->update([
+                    'order_num' => (int) $lessonData['order_num'],
+                    'section_id' => $lessonData['section_id'] ?? null,
+                ]);
+        }
+
+                $this->courseLessonOrdering->syncCourse($academyCourse);
+        $this->syncCourseCounts($academyCourse);
+
+        return back()->with('success', 'Course order updated.');
+    }
+
+    private function syncCourseCounts(AcademyCourse $academyCourse): void
+    {
+        $academyCourse->forceFill([
+            'lessons_count_cache' => $academyCourse->courseLessons()->count(),
+        ])->save();
+
+        $this->cache->clearAll();
+    }
+
+    private function serializeCourse(AcademyCourse $course): array
+    {
+        return [
+            'id' => (int) $course->id,
+            'title' => (string) $course->title,
+            'slug' => (string) $course->slug,
+            'subtitle' => (string) ($course->subtitle ?? ''),
+            'excerpt' => (string) ($course->excerpt ?? ''),
+            'description' => (string) ($course->description ?? ''),
+            'access_level' => (string) $course->access_level,
+            'difficulty' => (string) $course->difficulty,
+            'status' => (string) $course->status,
+            'lessons_count_cache' => (int) ($course->lessons_count_cache ?? 0),
+            'cover_image' => (string) ($course->cover_image ?? ''),
+            'published_at' => $course->published_at?->toISOString(),
+        ];
+    }
+
+    private function serializeSection(AcademyCourseSection $section): array
+    {
+        return [
+            'id' => (int) $section->id,
+            'title' => (string) $section->title,
+            'slug' => (string) ($section->slug ?? ''),
+            'description' => (string) ($section->description ?? ''),
+            'order_num' => (int) ($section->order_num ?? 0),
+            'is_visible' => (bool) ($section->is_visible ?? true),
+            'updateUrl' => route('admin.academy.courses.sections.update', ['academyCourse' => $section->course_id, 'academyCourseSection' => $section]),
+            'destroyUrl' => route('admin.academy.courses.sections.destroy', ['academyCourse' => $section->course_id, 'academyCourseSection' => $section]),
+        ];
+    }
+
+    private function serializeCourseLesson(AcademyCourseLesson $courseLesson): array
+    {
+        $lesson = $courseLesson->lesson;
+
+        return [
+            'id' => (int) $courseLesson->id,
+            'section_id' => $courseLesson->section_id ? (int) $courseLesson->section_id : null,
+            'lesson_id' => (int) $courseLesson->lesson_id,
+            'title' => (string) ($lesson?->title ?? ''),
+            'slug' => (string) ($lesson?->slug ?? ''),
+            'excerpt' => (string) ($lesson?->excerpt ?? ''),
+            'difficulty' => (string) ($lesson?->difficulty ?? ''),
+            'access_level' => (string) ($lesson?->access_level ?? ''),
+            'category' => (string) ($lesson?->category?->name ?? ''),
+            'order_num' => (int) ($courseLesson->order_num ?? 0),
+            'is_required' => (bool) $courseLesson->is_required,
+            'access_override' => $courseLesson->access_override,
+            'unlock_after_lesson_id' => $courseLesson->unlock_after_lesson_id ? (int) $courseLesson->unlock_after_lesson_id : null,
+            'updateUrl' => route('admin.academy.courses.lessons.update', ['academyCourse' => $courseLesson->course_id, 'academyCourseLesson' => $courseLesson]),
+            'destroyUrl' => route('admin.academy.courses.lessons.destroy', ['academyCourse' => $courseLesson->course_id, 'academyCourseLesson' => $courseLesson]),
+        ];
+    }
+}

app/Http/Controllers/Settings/AcademyLessonMediaApiController.php

@@ -26,6 +26,11 @@ final class AcademyLessonMediaApiController extends Controller
 
     private const ASSET_CACHE_TTL_MINUTES = 15;
 
+    private const RESPONSIVE_VARIANT_WIDTHS = [
+        'thumb' => 480,
+        'md' => 960,
+    ];
+
     private ?ImageManager $manager = null;
 
     public function __construct()
@@ -68,6 +73,18 @@ final class AcademyLessonMediaApiController extends Controller
                 'slot' => $slot,
                 'path' => $stored['path'],
                 'url' => $this->publicUrlForPath($stored['path']),
+                'thumb_path' => $stored['thumb_path'],
+                'thumb_url' => $this->publicUrlForPath($stored['thumb_path']),
+                'thumb_width' => $stored['thumb_width'],
+                'thumb_height' => $stored['thumb_height'],
+                'medium_path' => $stored['medium_path'],
+                'medium_url' => $stored['medium_path'] !== '' ? $this->publicUrlForPath($stored['medium_path']) : null,
+                'medium_width' => $stored['medium_width'],
+                'medium_height' => $stored['medium_height'],
+                'srcset' => $this->buildResponsiveSrcset([
+                    ['path' => $stored['thumb_path'], 'width' => $stored['thumb_width']],
+                    ['path' => $stored['medium_path'], 'width' => $stored['medium_width']],
+                ]),
                 'width' => $stored['width'],
                 'height' => $stored['height'],
                 'mime_type' => 'image/webp',
@@ -161,7 +178,7 @@ final class AcademyLessonMediaApiController extends Controller
     }
 
     /**
-     * @return array{path:string,width:int,height:int,size_bytes:int}
+     * @return array{path:string,thumb_path:string,thumb_width:int,thumb_height:int,medium_path:string,medium_width:int|null,medium_height:int|null,width:int,height:int,size_bytes:int}
      */
     private function storeMediaFile(UploadedFile $file, string $slot): array
     {
@@ -202,14 +219,99 @@ final class AcademyLessonMediaApiController extends Controller
             ));
         }
 
-        $image = $this->manager->read($raw)->scaleDown(width: $constraints['max_width'], height: $constraints['max_height']);
+        $encodedImage = $this->encodeScaledMedia($raw, $constraints['max_width'], $constraints['max_height']);
-        $encoded = (string) $image->encode(new WebpEncoder(85));
+        $encoded = $encodedImage['binary'];
 
         $hash = hash('sha256', $encoded);
         $path = $this->mediaPath($hash, $slot);
         $disk = Storage::disk($this->mediaDiskName());
 
-        $written = $disk->put($path, $encoded, [
+        $this->writeMediaBinary($disk, $path, $encoded);
+
+        $thumbVariant = $this->storeResponsiveVariant(
+            $disk,
+            $raw,
+            $constraints,
+            $path,
+            'thumb',
+            self::RESPONSIVE_VARIANT_WIDTHS['thumb'],
+            $encodedImage['width'],
+            $encodedImage['height'],
+        );
+
+        $mediumVariant = $this->storeResponsiveVariant(
+            $disk,
+            $raw,
+            $constraints,
+            $path,
+            'md',
+            self::RESPONSIVE_VARIANT_WIDTHS['md'],
+            $encodedImage['width'],
+            $encodedImage['height'],
+        );
+
+        return [
+            'path' => $path,
+            'thumb_path' => $thumbVariant['path'] ?? $path,
+            'thumb_width' => $thumbVariant['width'] ?? $encodedImage['width'],
+            'thumb_height' => $thumbVariant['height'] ?? $encodedImage['height'],
+            'medium_path' => $mediumVariant['path'] ?? '',
+            'medium_width' => $mediumVariant['width'] ?? null,
+            'medium_height' => $mediumVariant['height'] ?? null,
+            'width' => $encodedImage['width'],
+            'height' => $encodedImage['height'],
+            'size_bytes' => strlen($encoded),
+        ];
+    }
+
+    /**
+     * @return array{binary:string,width:int,height:int}
+     */
+    private function encodeScaledMedia(string $raw, int $maxWidth, int $maxHeight): array
+    {
+        $image = $this->manager->read($raw)->scaleDown(width: $maxWidth, height: $maxHeight);
+        $encoded = (string) $image->encode(new WebpEncoder(85));
+
+        if ($encoded === '') {
+            throw new RuntimeException('Unable to encode image to WebP.');
+        }
+
+        return [
+            'binary' => $encoded,
+            'width' => (int) $image->width(),
+            'height' => (int) $image->height(),
+        ];
+    }
+
+    /**
+     * @param  array{max_width:int,max_height:int}  $constraints
+     * @return array{path:string,width:int,height:int}|null
+     */
+    private function storeResponsiveVariant($disk, string $raw, array $constraints, string $path, string $variant, int $targetWidth, int $sourceWidth, int $sourceHeight): ?array
+    {
+        if ($sourceWidth <= $targetWidth && $sourceHeight <= $constraints['max_height']) {
+            return null;
+        }
+
+        $encodedVariant = $this->encodeScaledMedia($raw, $targetWidth, $constraints['max_height']);
+
+        if ($encodedVariant['width'] >= $sourceWidth && $encodedVariant['height'] >= $sourceHeight) {
+            return null;
+        }
+
+        $variantPath = $this->responsiveVariantPath($path, $variant);
+        $this->writeMediaBinary($disk, $variantPath, $encodedVariant['binary']);
+
+        return [
+            'path' => $variantPath,
+            'width' => $encodedVariant['width'],
+            'height' => $encodedVariant['height'],
+        ];
+    }
+
+    private function writeMediaBinary($disk, string $path, string $binary): void
+    {
+        $written = $disk->put($path, $binary, [
             'visibility' => 'public',
             'CacheControl' => 'public, max-age=31536000, immutable',
             'ContentType' => 'image/webp',
@@ -218,13 +320,6 @@ final class AcademyLessonMediaApiController extends Controller
         if ($written !== true) {
             throw new RuntimeException('Unable to store image in object storage.');
         }
-
-        return [
-            'path' => $path,
-            'width' => (int) $image->width(),
-            'height' => (int) $image->height(),
-            'size_bytes' => strlen($encoded),
-        ];
     }
 
     private function authorizeStaff(Request $request): void
@@ -255,6 +350,54 @@ final class AcademyLessonMediaApiController extends Controller
         return rtrim((string) config('cdn.files_url', 'https://files.skinbase.org'), '/') . '/' . ltrim($path, '/');
     }
 
+    /**
+     * @param  array<int, array{path:string,width:int|null}>  $variants
+     */
+    private function buildResponsiveSrcset(array $variants): ?string
+    {
+        $entries = collect($variants)
+            ->filter(function (array $variant): bool {
+                return trim((string) ($variant['path'] ?? '')) !== '' && (int) ($variant['width'] ?? 0) > 0;
+            })
+            ->unique(fn (array $variant): string => trim((string) ($variant['path'] ?? '')))
+            ->map(fn (array $variant): string => sprintf('%s %dw', $this->publicUrlForPath((string) $variant['path']), (int) $variant['width']))
+            ->values()
+            ->all();
+
+        return $entries !== [] ? implode(', ', $entries) : null;
+    }
+
+    private function responsiveVariantPath(string $path, string $variant): string
+    {
+        $directory = pathinfo($path, PATHINFO_DIRNAME);
+        $filename = pathinfo($path, PATHINFO_FILENAME);
+
+        return sprintf(
+            '%s/%s-%s.webp',
+            $directory === '.' ? '' : $directory,
+            preg_replace('/-(thumb|md)$/', '', $filename) ?? $filename,
+            $variant,
+        );
+    }
+
+    private function canonicalMediaPath(string $path): string
+    {
+        $directory = pathinfo($path, PATHINFO_DIRNAME);
+        $filename = pathinfo($path, PATHINFO_FILENAME);
+        $baseFilename = preg_replace('/-(thumb|md)$/', '', $filename) ?? $filename;
+
+        return sprintf(
+            '%s/%s.webp',
+            $directory === '.' ? '' : $directory,
+            $baseFilename,
+        );
+    }
+
+    private function isResponsiveVariantPath(string $path): bool
+    {
+        return preg_match('/-(thumb|md)\.webp$/i', $path) === 1;
+    }
+
     private function academyAssetManifest(): Collection
     {
         return Cache::remember($this->academyAssetCacheKey(), now()->addMinutes(self::ASSET_CACHE_TTL_MINUTES), function (): Collection {
@@ -262,6 +405,7 @@ final class AcademyLessonMediaApiController extends Controller
 
             return collect($disk->allFiles('academy/lessons'))
                 ->filter(fn (string $path): bool => Str::endsWith(Str::lower($path), ['.webp', '.jpg', '.jpeg', '.png']))
+                ->reject(fn (string $path): bool => $this->isResponsiveVariantPath($path))
                 ->map(function (string $path) use ($disk): array {
                     $modifiedAt = null;
 
@@ -323,7 +467,14 @@ final class AcademyLessonMediaApiController extends Controller
             return;
         }
 
-        Storage::disk($this->mediaDiskName())->delete($trimmed);
+        $basePath = $this->canonicalMediaPath($trimmed);
+        $paths = [
+            $basePath,
+            $this->responsiveVariantPath($basePath, 'thumb'),
+            $this->responsiveVariantPath($basePath, 'md'),
+        ];
+
+        Storage::disk($this->mediaDiskName())->delete(array_values(array_unique($paths)));
     }
 
     private function normalizeSlot(mixed $slot): string
@@ -346,8 +497,8 @@ final class AcademyLessonMediaApiController extends Controller
         }
 
         return [
-            'min_width' => 1200,
+            'min_width' => 600,
-            'min_height' => 630,
+            'min_height' => 315,
             'max_width' => 2200,
             'max_height' => 1400,
         ];

app/Http/Controllers/Settings/CollectionInsightsController.php

@@ -111,7 +111,7 @@ class CollectionInsightsController extends Controller
                 'title' => 'Collections Dashboard — Skinbase',
                 'description' => 'Overview of collection lifecycle, quality, activity, and upcoming collection campaigns.',
                 'canonical' => route('settings.collections.dashboard'),
-                'robots' => 'noindex,follow',
+                'robots' => 'index,follow',
             ],
         ])->rootView('collections');
     }
@@ -130,7 +130,7 @@ class CollectionInsightsController extends Controller
                 'title' => sprintf('%s Analytics — Skinbase', $collection->title),
                 'description' => sprintf('Analytics and performance history for the %s collection.', $collection->title),
                 'canonical' => route('settings.collections.analytics', ['collection' => $collection->id]),
-                'robots' => 'noindex,follow',
+                'robots' => 'index,follow',
             ],
         ])->rootView('collections');
     }
@@ -153,7 +153,7 @@ class CollectionInsightsController extends Controller
                 'title' => sprintf('%s History — Skinbase', $collection->title),
                 'description' => sprintf('Audit history and lifecycle changes for the %s collection.', $collection->title),
                 'canonical' => route('settings.collections.history', ['collection' => $collection->id]),
-                'robots' => 'noindex,follow',
+                'robots' => 'index,follow',
             ],
         ])->rootView('collections');
     }

app/Http/Controllers/Settings/CollectionProgrammingController.php

@@ -95,7 +95,7 @@ class CollectionProgrammingController extends Controller
                 'title' => 'Collection Programming — Skinbase',
                 'description' => 'Staff programming tools for assignments, previews, eligibility diagnostics, and recommendation refreshes.',
                 'canonical' => route('staff.collections.programming'),
-                'robots' => 'noindex,follow',
+                'robots' => 'index,follow',
             ],
         ])->rootView('collections');
     }

app/Http/Controllers/Settings/CollectionSurfaceController.php

@@ -69,7 +69,7 @@ class CollectionSurfaceController extends Controller
                 'title' => 'Collection Surfaces - Skinbase',
                 'description' => 'Staff tools for homepage, discovery, and campaign collection surfaces.',
                 'canonical' => route('settings.collections.surfaces.index'),
-                'robots' => 'noindex,follow',
+                'robots' => 'index,follow',
             ],
         ])->rootView('collections');
     }

app/Http/Controllers/Settings/FeaturedArtworkAdminController.php

@@ -27,8 +27,10 @@ class FeaturedArtworkAdminController extends Controller
     {
         $isAdminSurface = $request->routeIs('admin.artworks.featured.*');
         $routePrefix = $isAdminSurface ? 'admin.artworks.featured.' : 'admin.cp.artworks.featured.';
+        $pageName = $isAdminSurface ? 'Moderation/FeaturedArtworks' : 'Collection/FeaturedArtworksAdmin';
+        $rootView = $isAdminSurface ? 'moderation' : 'collections';
 
-        return Inertia::render($isAdminSurface ? 'Admin/FeaturedArtworks' : 'Collection/FeaturedArtworksAdmin', array_merge(
+        return Inertia::render($pageName, array_merge(
             $this->featuredArtworks->pageProps(),
             [
                 'endpoints' => [
@@ -46,10 +48,10 @@ class FeaturedArtworkAdminController extends Controller
                     'title' => 'Featured Artworks — Skinbase',
                     'description' => 'Editorial controls for homepage featured artworks and the current hero winner.',
                     'canonical' => route($routePrefix . 'main'),
-                    'robots' => 'noindex,follow',
+                    'robots' => 'index,follow',
                 ],
             ],
-        ))->rootView($isAdminSurface ? 'admin' : 'collections');
+        ))->rootView($rootView);
     }
 
     public function search(Request $request): JsonResponse

app/Http/Controllers/Settings/WorldWebStoryAdminController.php

@@ -0,0 +1,512 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Settings;
+
+use App\Http\Controllers\Controller;
+use App\Models\World;
+use App\Models\WorldWebStory;
+use App\Models\WorldWebStoryPage;
+use App\Services\WebStories\WorldWebStoryAssetService;
+use App\Services\WebStories\WorldWebStoryGenerator;
+use App\Services\WebStories\WorldWebStoryValidationService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Validation\Rule;
+use Illuminate\Validation\ValidationException;
+use Inertia\Inertia;
+use Inertia\Response;
+
+final class WorldWebStoryAdminController extends Controller
+{
+    private const PER_PAGE = 20;
+
+    public function __construct(
+        private readonly WorldWebStoryGenerator $generator,
+        private readonly WorldWebStoryAssetService $assets,
+        private readonly WorldWebStoryValidationService $validation,
+    ) {
+    }
+
+    public function index(Request $request): Response
+    {
+        $filters = [
+            'q' => trim((string) $request->query('q', '')),
+            'status' => trim((string) $request->query('status', 'all')),
+        ];
+
+        $stories = WorldWebStory::query()
+            ->with('world')
+            ->when($filters['q'] !== '', function ($query) use ($filters): void {
+                $query->where(function ($nested) use ($filters): void {
+                    $nested->where('title', 'like', '%' . $filters['q'] . '%')
+                        ->orWhere('slug', 'like', '%' . $filters['q'] . '%')
+                        ->orWhereHas('world', fn ($worldQuery) => $worldQuery->where('title', 'like', '%' . $filters['q'] . '%')->orWhere('slug', 'like', '%' . $filters['q'] . '%'));
+                });
+            })
+            ->when($filters['status'] !== 'all', fn ($query) => $query->where('status', $filters['status']))
+            ->orderByDesc('published_at')
+            ->orderByDesc('updated_at')
+            ->paginate(self::PER_PAGE)
+            ->withQueryString()
+            ->through(fn (WorldWebStory $story): array => $this->mapStoryListItem($story));
+
+        return Inertia::render('Moderation/WorldWebStoriesIndex', [
+            'title' => 'World Web Stories',
+            'stories' => $stories,
+            'filters' => $filters,
+            'stats' => [
+                'total' => WorldWebStory::query()->count(),
+                'published' => WorldWebStory::query()->where('status', WorldWebStory::STATUS_PUBLISHED)->count(),
+                'draft' => WorldWebStory::query()->where('status', WorldWebStory::STATUS_DRAFT)->count(),
+                'hidden' => WorldWebStory::query()->where('noindex', true)->orWhere('active', false)->count(),
+            ],
+            'worldOptions' => $this->worldOptions(),
+            'endpoints' => [
+                'index' => route('admin.web-stories.index'),
+                'create' => route('admin.web-stories.create'),
+                'editPattern' => route('admin.web-stories.edit', ['story' => '__STORY__']),
+                'destroyPattern' => route('admin.web-stories.destroy', ['story' => '__STORY__']),
+                'publishPattern' => route('admin.web-stories.publish', ['story' => '__STORY__']),
+                'unpublishPattern' => route('admin.web-stories.unpublish', ['story' => '__STORY__']),
+                'generatePattern' => route('admin.web-stories.generate', ['world' => '__WORLD__']),
+            ],
+        ])->rootView('moderation');
+    }
+
+    public function create(): Response
+    {
+        return Inertia::render('Moderation/WorldWebStoryEditor', [
+            'story' => $this->blankStoryPayload(),
+            'worldOptions' => $this->worldOptions(),
+            'endpoints' => $this->editorEndpoints(),
+            'isNew' => true,
+        ])->rootView('moderation');
+    }
+
+    public function store(Request $request): RedirectResponse
+    {
+        $attributes = $this->validatedStoryAttributes($request);
+        $story = new WorldWebStory();
+        $story->fill($attributes + [
+            'created_by' => (int) $request->user()->id,
+            'updated_by' => (int) $request->user()->id,
+        ]);
+        $this->normalizeStatusTimestamps($story);
+        $this->assertPublishedStateIsValid($story);
+        $story->save();
+
+        return redirect()->route('admin.web-stories.edit', ['story' => $story])->with('success', 'Web story created.');
+    }
+
+    public function edit(WorldWebStory $story): Response
+    {
+        $story->load(['world', 'orderedPages.artwork']);
+
+        return Inertia::render('Moderation/WorldWebStoryEditor', [
+            'story' => $this->mapStoryEditorPayload($story),
+            'worldOptions' => $this->worldOptions(),
+            'endpoints' => $this->editorEndpoints($story),
+            'isNew' => false,
+        ])->rootView('moderation');
+    }
+
+    public function update(Request $request, WorldWebStory $story): RedirectResponse
+    {
+        $story->fill($this->validatedStoryAttributes($request) + [
+            'updated_by' => (int) $request->user()->id,
+        ]);
+        $this->normalizeStatusTimestamps($story);
+        $this->assertPublishedStateIsValid($story);
+        $story->save();
+
+        return back()->with('success', 'Web story updated.');
+    }
+
+    public function destroy(WorldWebStory $story): JsonResponse
+    {
+        $story->delete();
+
+        return response()->json([
+            'ok' => true,
+            'message' => 'Web story deleted.',
+        ]);
+    }
+
+    public function storePage(Request $request, WorldWebStory $story): JsonResponse
+    {
+        $attributes = $this->validatedPageAttributes($request, $story, null);
+        $page = $story->pages()->create($attributes);
+
+        return response()->json([
+            'ok' => true,
+            'message' => 'Page created.',
+            'page' => $this->mapPage($page->fresh('artwork')),
+        ]);
+    }
+
+    public function updatePage(Request $request, WorldWebStory $story, WorldWebStoryPage $page): JsonResponse
+    {
+        abort_unless((int) $page->story_id === (int) $story->id, 404);
+
+        $page->fill($this->validatedPageAttributes($request, $story, $page));
+        $page->save();
+
+        return response()->json([
+            'ok' => true,
+            'message' => 'Page updated.',
+            'page' => $this->mapPage($page->fresh('artwork')),
+        ]);
+    }
+
+    public function destroyPage(WorldWebStory $story, WorldWebStoryPage $page): JsonResponse
+    {
+        abort_unless((int) $page->story_id === (int) $story->id, 404);
+
+        $page->delete();
+
+        return response()->json([
+            'ok' => true,
+            'message' => 'Page deleted.',
+        ]);
+    }
+
+    public function reorderPages(Request $request, WorldWebStory $story): JsonResponse
+    {
+        $validated = $request->validate([
+            'page_ids' => ['required', 'array', 'min:1'],
+            'page_ids.*' => ['integer'],
+        ]);
+
+        $ids = collect($validated['page_ids'])->map(fn ($id): int => (int) $id)->values();
+        $pages = $story->orderedPages()->whereIn('id', $ids)->get()->keyBy('id');
+
+        abort_unless($pages->count() === $ids->count(), 422);
+
+        foreach ($ids as $index => $id) {
+            $pages[$id]->forceFill(['position' => $index + 1])->save();
+        }
+
+        return response()->json([
+            'ok' => true,
+            'message' => 'Page order updated.',
+        ]);
+    }
+
+    public function generateFromWorld(Request $request, World $world): JsonResponse
+    {
+        $validated = $request->validate([
+            'force' => ['nullable', 'boolean'],
+            'publish' => ['nullable', 'boolean'],
+            'dry_run' => ['nullable', 'boolean'],
+            'pages' => ['nullable', 'integer', 'min:5', 'max:10'],
+        ]);
+
+        $result = $this->generator->generateFromWorld(
+            $world,
+            $request->user(),
+            (int) ($validated['pages'] ?? 7),
+            (bool) ($validated['force'] ?? false),
+            (bool) ($validated['publish'] ?? false),
+            (bool) ($validated['dry_run'] ?? false),
+        );
+
+        return response()->json([
+            'ok' => true,
+            'message' => $result['created'] ? 'Web story draft generated.' : 'Web story draft regenerated.',
+            'story' => [
+                'id' => $result['story']->id,
+                'slug' => $result['story']->slug,
+                'edit_url' => $result['story']->exists ? route('admin.web-stories.edit', ['story' => $result['story']->id]) : null,
+            ],
+            'validation' => $result['validation'],
+        ]);
+    }
+
+    public function publish(WorldWebStory $story): JsonResponse
+    {
+        $this->assets->buildAssets($story, force: false);
+        $story->refresh()->load('orderedPages');
+        $this->validation->assertPublishable($story);
+        $story->forceFill([
+            'status' => WorldWebStory::STATUS_PUBLISHED,
+            'published_at' => $story->published_at ?: now(),
+        ])->save();
+
+        return response()->json([
+            'ok' => true,
+            'message' => 'Web story published.',
+        ]);
+    }
+
+    public function unpublish(WorldWebStory $story): JsonResponse
+    {
+        $story->forceFill([
+            'status' => WorldWebStory::STATUS_DRAFT,
+            'published_at' => null,
+        ])->save();
+
+        return response()->json([
+            'ok' => true,
+            'message' => 'Web story reverted to draft.',
+        ]);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function validatedStoryAttributes(Request $request, ?WorldWebStory $story = null): array
+    {
+        $validated = $request->validate([
+            'world_id' => ['nullable', 'integer', Rule::exists('worlds', 'id')],
+            'slug' => ['required', 'string', 'max:120', Rule::unique('world_web_stories', 'slug')->ignore($story?->id)],
+            'title' => ['required', 'string', 'max:255'],
+            'subtitle' => ['nullable', 'string', 'max:255'],
+            'excerpt' => ['nullable', 'string', 'max:400'],
+            'description' => ['nullable', 'string', 'max:2000'],
+            'seo_title' => ['nullable', 'string', 'max:255'],
+            'seo_description' => ['nullable', 'string', 'max:400'],
+            'poster_portrait_path' => ['nullable', 'string', 'max:2048'],
+            'poster_square_path' => ['nullable', 'string', 'max:2048'],
+            'publisher_logo_path' => ['nullable', 'string', 'max:2048'],
+            'status' => ['required', Rule::in([WorldWebStory::STATUS_DRAFT, WorldWebStory::STATUS_PUBLISHED, WorldWebStory::STATUS_ARCHIVED])],
+            'featured' => ['required', 'boolean'],
+            'active' => ['required', 'boolean'],
+            'noindex' => ['required', 'boolean'],
+            'published_at' => ['nullable', 'date'],
+            'starts_at' => ['nullable', 'date'],
+            'ends_at' => ['nullable', 'date', 'after_or_equal:starts_at'],
+        ]);
+
+        return $validated;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function validatedPageAttributes(Request $request, WorldWebStory $story, ?WorldWebStoryPage $page): array
+    {
+        $validated = $request->validate([
+            'artwork_id' => ['nullable', 'integer', Rule::exists('artworks', 'id')],
+            'position' => ['nullable', 'integer', 'min:1'],
+            'layout' => ['required', Rule::in([
+                WorldWebStoryPage::LAYOUT_COVER,
+                WorldWebStoryPage::LAYOUT_ARTWORK,
+                WorldWebStoryPage::LAYOUT_CREATOR,
+                WorldWebStoryPage::LAYOUT_MOOD,
+                WorldWebStoryPage::LAYOUT_COLLECTION,
+                WorldWebStoryPage::LAYOUT_CTA,
+            ])],
+            'background_type' => ['required', Rule::in([
+                WorldWebStoryPage::BACKGROUND_IMAGE,
+                WorldWebStoryPage::BACKGROUND_VIDEO,
+                WorldWebStoryPage::BACKGROUND_GRADIENT,
+            ])],
+            'background_path' => ['nullable', 'string', 'max:2048'],
+            'background_mobile_path' => ['nullable', 'string', 'max:2048'],
+            'headline' => ['nullable', 'string', 'max:255'],
+            'body' => ['nullable', 'string', 'max:180'],
+            'cta_label' => ['nullable', 'string', 'max:120'],
+            'cta_url' => ['nullable', 'string', 'max:2048'],
+            'alt_text' => ['required', 'string', 'max:255'],
+            'caption' => ['nullable', 'string', 'max:120'],
+            'credit_text' => ['nullable', 'string', 'max:255'],
+            'text_position' => ['required', Rule::in(['top', 'center', 'bottom'])],
+            'overlay_strength' => ['required', 'integer', 'min:0', 'max:100'],
+            'animation' => ['nullable', Rule::in(['fade-in', 'fly-in-bottom', 'pulse', 'pan-left', 'pan-right'])],
+            'active' => ['required', 'boolean'],
+        ]);
+
+        $validated['position'] = (int) ($validated['position'] ?? ($story->orderedPages()->max('position') + ($page ? 0 : 1) ?: 1));
+        $pageErrors = $this->validation->validatePagePayload($validated);
+
+        if ($pageErrors !== []) {
+            throw ValidationException::withMessages($pageErrors);
+        }
+
+        return $validated;
+    }
+
+    private function normalizeStatusTimestamps(WorldWebStory $story): void
+    {
+        if ((string) $story->status === WorldWebStory::STATUS_PUBLISHED && $story->published_at === null) {
+            $story->published_at = now();
+        }
+
+        if ((string) $story->status === WorldWebStory::STATUS_DRAFT) {
+            $story->published_at = null;
+        }
+    }
+
+    private function assertPublishedStateIsValid(WorldWebStory $story): void
+    {
+        if ((string) $story->status !== WorldWebStory::STATUS_PUBLISHED) {
+            return;
+        }
+
+        $story->loadMissing('orderedPages');
+        $this->validation->assertPublishable($story);
+    }
+
+    /**
+     * @return array<int, array{value:int,label:string,description:string}>
+     */
+    private function worldOptions(): array
+    {
+        return World::query()
+            ->orderByDesc('published_at')
+            ->orderBy('title')
+            ->limit(200)
+            ->get(['id', 'title', 'slug'])
+            ->map(fn (World $world): array => [
+                'value' => (int) $world->id,
+                'label' => (string) $world->title,
+                'description' => (string) $world->slug,
+            ])
+            ->all();
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function blankStoryPayload(): array
+    {
+        return [
+            'id' => null,
+            'world_id' => null,
+            'slug' => '',
+            'title' => '',
+            'subtitle' => '',
+            'excerpt' => '',
+            'description' => '',
+            'seo_title' => '',
+            'seo_description' => '',
+            'poster_portrait_path' => '',
+            'poster_square_path' => '',
+            'publisher_logo_path' => $this->assets->defaultPublisherLogoPath(),
+            'status' => WorldWebStory::STATUS_DRAFT,
+            'featured' => false,
+            'active' => true,
+            'noindex' => false,
+            'published_at' => null,
+            'starts_at' => null,
+            'ends_at' => null,
+            'world' => null,
+            'pages' => [],
+            'public_url' => null,
+            'validation' => ['valid' => false, 'errors' => [], 'warnings' => [], 'page_count' => 0],
+        ];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function mapStoryEditorPayload(WorldWebStory $story): array
+    {
+        return [
+            'id' => (int) $story->id,
+            'world_id' => $story->world_id ? (int) $story->world_id : null,
+            'slug' => (string) $story->slug,
+            'title' => (string) $story->title,
+            'subtitle' => (string) ($story->subtitle ?? ''),
+            'excerpt' => (string) ($story->excerpt ?? ''),
+            'description' => (string) ($story->description ?? ''),
+            'seo_title' => (string) ($story->seo_title ?? ''),
+            'seo_description' => (string) ($story->seo_description ?? ''),
+            'poster_portrait_path' => (string) ($story->poster_portrait_path ?? ''),
+            'poster_square_path' => (string) ($story->poster_square_path ?? ''),
+            'publisher_logo_path' => (string) ($story->publisher_logo_path ?? ''),
+            'status' => (string) $story->status,
+            'featured' => (bool) $story->featured,
+            'active' => (bool) $story->active,
+            'noindex' => (bool) $story->noindex,
+            'published_at' => optional($story->published_at)?->toIso8601String(),
+            'starts_at' => optional($story->starts_at)?->toIso8601String(),
+            'ends_at' => optional($story->ends_at)?->toIso8601String(),
+            'world' => $story->world ? [
+                'id' => (int) $story->world->id,
+                'title' => (string) $story->world->title,
+                'slug' => (string) $story->world->slug,
+            ] : null,
+            'pages' => $story->orderedPages->map(fn (WorldWebStoryPage $page): array => $this->mapPage($page))->all(),
+            'public_url' => route('web-stories.show', ['slug' => $story->slug]),
+            'validation' => $this->validation->validate($story),
+        ];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function mapStoryListItem(WorldWebStory $story): array
+    {
+        return [
+            'id' => (int) $story->id,
+            'slug' => (string) $story->slug,
+            'title' => (string) $story->title,
+            'excerpt' => (string) ($story->excerpt ?? ''),
+            'status' => (string) $story->status,
+            'active' => (bool) $story->active,
+            'noindex' => (bool) $story->noindex,
+            'featured' => (bool) $story->featured,
+            'page_count' => (int) ($story->pages()->count()),
+            'published_at' => optional($story->published_at)?->toIso8601String(),
+            'poster_portrait_url' => $story->posterPortraitUrl(),
+            'world' => $story->world ? [
+                'id' => (int) $story->world->id,
+                'title' => (string) $story->world->title,
+                'slug' => (string) $story->world->slug,
+            ] : null,
+            'public_url' => route('web-stories.show', ['slug' => $story->slug]),
+        ];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    private function mapPage(WorldWebStoryPage $page): array
+    {
+        return [
+            'id' => (int) $page->id,
+            'artwork_id' => $page->artwork_id ? (int) $page->artwork_id : null,
+            'position' => (int) $page->position,
+            'layout' => (string) $page->layout,
+            'background_type' => (string) $page->background_type,
+            'background_path' => (string) ($page->background_path ?? ''),
+            'background_mobile_path' => (string) ($page->background_mobile_path ?? ''),
+            'headline' => (string) ($page->headline ?? ''),
+            'body' => (string) ($page->body ?? ''),
+            'cta_label' => (string) ($page->cta_label ?? ''),
+            'cta_url' => (string) ($page->cta_url ?? ''),
+            'alt_text' => (string) ($page->alt_text ?? ''),
+            'caption' => (string) ($page->caption ?? ''),
+            'credit_text' => (string) ($page->credit_text ?? ''),
+            'text_position' => (string) ($page->text_position ?? 'bottom'),
+            'overlay_strength' => (int) ($page->overlay_strength ?? 35),
+            'animation' => (string) ($page->animation ?? ''),
+            'active' => (bool) $page->active,
+            'background_url' => $page->backgroundUrl(),
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    private function editorEndpoints(?WorldWebStory $story = null): array
+    {
+        return [
+            'store' => route('admin.web-stories.store'),
+            'update' => $story ? route('admin.web-stories.update', ['story' => $story]) : '',
+            'destroy' => $story ? route('admin.web-stories.destroy', ['story' => $story]) : '',
+            'pagesStore' => $story ? route('admin.web-stories.pages.store', ['story' => $story]) : '',
+            'pagesUpdatePattern' => $story ? route('admin.web-stories.pages.update', ['story' => $story, 'page' => '__PAGE__']) : '',
+            'pagesDestroyPattern' => $story ? route('admin.web-stories.pages.destroy', ['story' => $story, 'page' => '__PAGE__']) : '',
+            'pagesReorder' => $story ? route('admin.web-stories.pages.reorder', ['story' => $story]) : '',
+            'publish' => $story ? route('admin.web-stories.publish', ['story' => $story]) : '',
+            'unpublish' => $story ? route('admin.web-stories.unpublish', ['story' => $story]) : '',
+            'generateFromWorldPattern' => route('admin.web-stories.generate', ['world' => '__WORLD__']),
+            'index' => route('admin.web-stories.index'),
+        ];
+    }
+}

app/Http/Controllers/StoryController.php

@@ -194,7 +194,7 @@ class StoryController extends Controller
             'storyTypes' => $this->storyCategories(),
             'page_title' => 'Create Story - Skinbase',
             'page_meta_description' => 'Write and publish a creator story on Skinbase.',
-            'page_robots' => 'noindex,nofollow',
+            'page_robots' => 'index,nofollow',
         ]);
     }
 

app/Http/Controllers/Studio/StudioArtworksApiController.php

@@ -18,6 +18,7 @@ use App\Services\TagService;
 use App\Services\ArtworkVersioningService;
 use App\Services\Studio\StudioArtworkQueryService;
 use App\Services\Studio\StudioBulkActionService;
+use App\Support\ArtworkDescriptionContentValidator;
 use App\Services\Tags\TagDiscoveryService;
 use App\Services\Worlds\WorldSubmissionService;
 use Carbon\Carbon;
@@ -164,6 +165,8 @@ final class StudioArtworksApiController extends Controller
             'evolution_note' => 'sometimes|nullable|string|max:1200',
         ]);
 
+        $this->ensureValidArtworkDescription($validated);
+
         $hasAttributionUpdates = array_key_exists('group', $validated)
             || array_key_exists('primary_author_user_id', $validated)
             || array_key_exists('contributor_user_ids', $validated)
@@ -326,6 +329,15 @@ final class StudioArtworksApiController extends Controller
         ]);
     }
 
+    private function ensureValidArtworkDescription(array $validated): void
+    {
+        foreach (ArtworkDescriptionContentValidator::errors($validated['description'] ?? null) as $message) {
+            throw ValidationException::withMessages([
+                'description' => [$message],
+            ]);
+        }
+    }
+
     public function evolutionOptions(Request $request, int $id): JsonResponse
     {
         $artwork = $request->user()->artworks()->findOrFail($id);

app/Http/Controllers/Studio/StudioController.php

@@ -95,7 +95,13 @@ final class StudioController extends Controller
     {
         $provider = $this->content->provider('artworks');
         $prefs = $this->preferences->forUser($request->user());
-        $listing = $this->content->list($request->user(), $request->only(['q', 'sort', 'bucket', 'page', 'per_page', 'content_type', 'category', 'tag']), null, 'artworks');
+        $filters = $request->only(['q', 'sort', 'bucket', 'page', 'per_page', 'content_type', 'category', 'tag']);
+
+        if (! $request->filled('sort')) {
+            $filters['sort'] = 'published_desc';
+        }
+
+        $listing = $this->content->list($request->user(), $filters, null, 'artworks');
         $listing['default_view'] = $prefs['default_content_view'];
 
         return Inertia::render('Studio/StudioArtworks', [

app/Http/Controllers/Studio/StudioNewsController.php

@@ -5,7 +5,9 @@ declare(strict_types=1);
 namespace App\Http\Controllers\Studio;
 
 use App\Http\Controllers\Controller;
+use App\Models\User;
 use App\Services\News\NewsService;
+use App\Support\AvatarUrl;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\Request;
@@ -32,7 +34,7 @@ final class StudioNewsController extends Controller
         return Inertia::render('Studio/StudioNewsIndex', [
             'title' => 'Newsroom',
             'description' => 'Plan announcements, publish editorial stories, and connect articles to the rest of Nova.',
-            'listing' => $this->news->studioListing($request->only(['q', 'status', 'type', 'category_id', 'per_page', 'page'])),
+            'listing' => $this->news->studioListing($request->only(['q', 'status', 'type', 'category_id', 'per_page', 'page', 'order', 'direction'])),
             'statusOptions' => $this->news->editorialStatusOptions(),
             'typeOptions' => $this->news->articleTypeOptions(),
             'categoryOptions' => $this->news->categoryOptions(),
@@ -46,6 +48,8 @@ final class StudioNewsController extends Controller
     {
         $this->authorizeNews($request);
 
+        $user = $request->user();
+
         return Inertia::render('Studio/StudioNewsEditor', [
             'title' => 'Create article',
             'description' => 'Draft a new News story with editorial workflow, SEO metadata, and related entity links.',
@@ -56,16 +60,19 @@ final class StudioNewsController extends Controller
             'statusOptions' => $this->news->editorialStatusOptions(),
             'categoryOptions' => $this->news->categoryOptions(),
             'tagOptions' => $this->news->tagOptions(),
-            'newsTagLimit' => 12,
+            'newsTagLimit' => 30,
             'relationTypeOptions' => $this->news->relationTypeOptions(),
             'storeUrl' => route('studio.news.store'),
             'coverUploadUrl' => route('api.studio.news.media.upload'),
             'coverDeleteUrl' => route('api.studio.news.media.destroy'),
+            'bodyMediaUploadUrl' => route('api.studio.news.media.upload'),
+            'bodyMediaDeleteUrl' => route('api.studio.news.media.destroy'),
             'coverCdnBaseUrl' => rtrim((string) config('cdn.files_url', 'https://files.skinbase.org'), '/'),
             'entitySearchUrl' => route('studio.news.entity-search'),
             'categoriesUrl' => route('studio.news.categories'),
             'tagsUrl' => route('studio.news.tags'),
-            'defaultAuthor' => $this->news->searchEntities('user', (string) $request->user()->username)[0] ?? null,
+            'defaultAuthor' => $this->mapDefaultAuthor($user),
+            'defaultPublishedAt' => now()->format('Y-m-d\TH:i'),
         ]);
     }
 
@@ -92,10 +99,12 @@ final class StudioNewsController extends Controller
             'statusOptions' => $this->news->editorialStatusOptions(),
             'categoryOptions' => $this->news->categoryOptions(),
             'tagOptions' => $this->news->tagOptions(),
-            'newsTagLimit' => 12,
+            'newsTagLimit' => 30,
             'relationTypeOptions' => $this->news->relationTypeOptions(),
             'coverUploadUrl' => route('api.studio.news.media.upload'),
             'coverDeleteUrl' => route('api.studio.news.media.destroy'),
+            'bodyMediaUploadUrl' => route('api.studio.news.media.upload'),
+            'bodyMediaDeleteUrl' => route('api.studio.news.media.destroy'),
             'coverCdnBaseUrl' => rtrim((string) config('cdn.files_url', 'https://files.skinbase.org'), '/'),
             'updateUrl' => route('studio.news.update', ['article' => $article->id]),
             'destroyUrl' => route('studio.news.destroy', ['article' => $article->id]),
@@ -250,6 +259,29 @@ final class StudioNewsController extends Controller
         ]);
     }
 
+    private function mapDefaultAuthor(mixed $user): ?array
+    {
+        if (! $user instanceof User) {
+            return null;
+        }
+
+        $user->loadMissing('profile');
+
+        return [
+            'id' => (int) $user->id,
+            'entity_type' => 'user',
+            'entity_label' => 'User',
+            'title' => (string) ($user->name ?: $user->username),
+            'subtitle' => $user->username ? '@' . $user->username : null,
+            'description' => Str::limit(trim((string) ($user->profile?->bio ?? '')), 120),
+            'url' => $user->username ? route('profile.show', ['username' => $user->username]) : null,
+            'image' => null,
+            'avatar' => AvatarUrl::forUser((int) $user->id, $user->profile?->avatar_hash ?? null, 96),
+            'context_label' => 'Profile',
+            'meta' => [],
+        ];
+    }
+
     public function storeCategory(Request $request): RedirectResponse
     {
         $this->authorizeNews($request);
@@ -367,30 +399,51 @@ final class StudioNewsController extends Controller
             'comments_enabled' => ['nullable', 'boolean'],
             'tag_ids' => ['nullable', 'array'],
             'tag_ids.*' => ['integer', 'exists:news_tags,id'],
-            'new_tag_names' => ['nullable', 'array', 'max:12'],
+            'new_tag_names' => ['nullable', 'array', 'max:30'],
             'new_tag_names.*' => ['string', 'max:80'],
             'meta_title' => ['nullable', 'string', 'max:255'],
             'meta_description' => ['nullable', 'string', 'max:300'],
             'meta_keywords' => ['nullable', 'string', 'max:255'],
-            'canonical_url' => ['nullable', 'string', 'max:2048', function (string $attribute, mixed $value, \Closure $fail): void {
-                if ($value === '' || $value === null) {
-                    return;
-                }
-                $isAbsolute = filter_var($value, FILTER_VALIDATE_URL) !== false;
-                $isRelative = str_starts_with($value, '/');
-                if (! $isAbsolute && ! $isRelative) {
-                    $fail('The canonical URL must be a valid URL or a relative path starting with /.');
-                }
-            }],
             'og_title' => ['nullable', 'string', 'max:255'],
             'og_description' => ['nullable', 'string', 'max:300'],
             'og_image' => ['nullable', 'string', 'max:2048'],
             'relations' => ['nullable', 'array', 'max:12'],
             'relations.*.entity_type' => ['required_with:relations', Rule::in(array_column($this->news->relationTypeOptions(), 'value'))],
-            'relations.*.entity_id' => ['required_with:relations', 'integer', 'min:1'],
+            'relations.*.entity_id' => ['nullable', 'integer', 'min:1'],
+            'relations.*.external_url' => ['nullable', 'string', 'max:2048'],
             'relations.*.context_label' => ['nullable', 'string', 'max:120'],
         ]);
 
+        $relationErrors = [];
+
+        foreach ((array) ($validated['relations'] ?? []) as $index => $relation) {
+            $entityType = trim(Str::lower((string) ($relation['entity_type'] ?? '')));
+
+            if ($entityType === NewsService::RELATION_SOURCE) {
+                $externalUrl = $this->normalizeExternalRelationUrl($relation['external_url'] ?? null);
+
+                if ($externalUrl === null) {
+                    $relationErrors["relations.{$index}.external_url"] = 'Source relations need a valid URL.';
+                    continue;
+                }
+
+                $validated['relations'][$index]['entity_id'] = null;
+                $validated['relations'][$index]['external_url'] = $externalUrl;
+
+                continue;
+            }
+
+            if ((int) ($relation['entity_id'] ?? 0) < 1) {
+                $relationErrors["relations.{$index}.entity_id"] = 'Select a related entity.';
+            }
+
+            $validated['relations'][$index]['external_url'] = null;
+        }
+
+        if ($relationErrors !== []) {
+            throw ValidationException::withMessages($relationErrors);
+        }
+
         if (($validated['editorial_status'] ?? null) === NewsArticle::EDITORIAL_STATUS_SCHEDULED && empty($validated['published_at'])) {
             throw ValidationException::withMessages([
                 'published_at' => 'Scheduled articles need a publish date and time.',
@@ -400,6 +453,25 @@ final class StudioNewsController extends Controller
         return $validated;
     }
 
+    private function normalizeExternalRelationUrl(mixed $value): ?string
+    {
+        $url = trim((string) ($value ?? ''));
+
+        if ($url === '') {
+            return null;
+        }
+
+        if (preg_match('/^\[[^\]]+\]\((https?:\/\/[^)]+)\)$/i', $url, $matches) === 1) {
+            $url = trim((string) ($matches[1] ?? ''));
+        }
+
+        if ($url === '' || filter_var($url, FILTER_VALIDATE_URL) === false) {
+            return null;
+        }
+
+        return Str::limit($url, 2048, '');
+    }
+
     private function tagPayload(): array
     {
         return NewsTag::query()

app/Http/Controllers/Studio/StudioNewsMediaApiController.php

@@ -46,6 +46,7 @@ final class StudioNewsMediaApiController extends Controller
                 'size_bytes' => $stored['size_bytes'],
                 'mobile_url' => $stored['mobile_url'],
                 'desktop_url' => $stored['desktop_url'],
+                'large_url' => $stored['large_url'],
                 'srcset' => $stored['srcset'],
             ]);
         } catch (RuntimeException $e) {

app/Http/Controllers/User/ProfileController.php

@@ -855,19 +855,26 @@ class ProfileController extends Controller
             }
         }
 
+        $allowedImageMimes = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
+
         if ($request->hasFile('emoticon')) {
             $file = $request->file('emoticon');
-            $fname = $file->getClientOriginalName();
+            if (in_array($file->getMimeType(), $allowedImageMimes, true)) {
-            $path = \Illuminate\Support\Facades\Storage::disk('public')->putFileAs('user-emoticons/'.$user->id, $file, $fname);
+                $ext = $file->guessExtension() ?: 'jpg';
+                $fname = $user->id . '_emoticon_' . time() . '.' . $ext;
+                \Illuminate\Support\Facades\Storage::disk('public')->putFileAs('user-emoticons/'.$user->id, $file, $fname);
                 try {
                     \Illuminate\Support\Facades\DB::table('users')->where('id', $user->id)->update(['eicon' => $fname]);
                 } catch (\Exception $e) {}
             }
+        }
 
         if ($request->hasFile('photo')) {
             $file = $request->file('photo');
-            $fname = $file->getClientOriginalName();
+            if (in_array($file->getMimeType(), $allowedImageMimes, true)) {
-            $path = \Illuminate\Support\Facades\Storage::disk('public')->putFileAs('user-picture/'.$user->id, $file, $fname);
+                $ext = $file->guessExtension() ?: 'jpg';
+                $fname = $user->id . '_photo_' . time() . '.' . $ext;
+                \Illuminate\Support\Facades\Storage::disk('public')->putFileAs('user-picture/'.$user->id, $file, $fname);
                 if (\Illuminate\Support\Facades\Schema::hasTable('user_profiles')) {
                     $profileUpdates['cover_image'] = $fname;
                 } else {
@@ -876,6 +883,7 @@ class ProfileController extends Controller
                     } catch (\Exception $e) {}
                 }
             }
+        }
 
         try {
             if (\Illuminate\Support\Facades\Schema::hasTable('user_profiles')) {

app/Http/Controllers/User/TopAuthorsController.php

@@ -50,7 +50,8 @@ class TopAuthorsController extends Controller
         });
 
         $page_title = 'Top Creators';
+        $page_canonical = route('creators.top');
 
-        return view('web.authors.top', compact('page_title', 'authors', 'metric'));
+        return view('web.authors.top', compact('page_title', 'page_canonical', 'authors', 'metric'));
     }
 }

app/Http/Controllers/Web/ArtworkPageController.php

@@ -149,7 +149,7 @@ final class ArtworkPageController extends Controller
             'md' => $thumbMd,
             'lg' => $thumbLg,
             'xl' => $thumbXl,
-        ], $canonical)->toArray();
+        ], $canonical, $this->artworkBreadcrumbs($artwork, $canonical))->toArray();
 
         $categoryIds = $artwork->categories->pluck('id')->filter()->values();
         $tagIds = $artwork->tags->pluck('id')->filter()->values();
@@ -364,6 +364,70 @@ final class ArtworkPageController extends Controller
         }
     }
 
+    /**
+     * @return array<int, array{name: string, url: string}>
+     */
+    private function artworkBreadcrumbs(Artwork $artwork, string $canonical): array
+    {
+        $primaryCategory = $artwork->categories
+            ->sortBy(fn ($category) => [
+                (int) ($category->sort_order ?? 0),
+                (string) ($category->name ?? ''),
+            ])
+            ->first();
+
+        if ($primaryCategory === null) {
+            return [
+                ['name' => 'Explore', 'url' => url('/explore')],
+                ['name' => html_entity_decode((string) $artwork->title, ENT_QUOTES | ENT_HTML5, 'UTF-8'), 'url' => $canonical],
+            ];
+        }
+
+        $contentType = $primaryCategory->contentType;
+        $chain = collect();
+        $current = $primaryCategory;
+
+        while ($current !== null) {
+            $chain->prepend($current);
+            $current = $current->relationLoaded('parent') ? $current->parent : null;
+        }
+
+        $breadcrumbs = [];
+        $contentTypeSlug = trim((string) ($contentType?->slug ?? ''));
+        $contentTypeName = trim((string) ($contentType?->name ?? ''));
+
+        if ($contentTypeSlug !== '' && $contentTypeName !== '') {
+            $breadcrumbs[] = [
+                'name' => $contentTypeName,
+                'url' => url('/' . $contentTypeSlug),
+            ];
+        }
+
+        $pathSegments = [];
+
+        foreach ($chain as $category) {
+            $slug = trim((string) ($category->slug ?? ''));
+            $name = trim((string) ($category->name ?? ''));
+
+            if ($slug === '' || $name === '' || $contentTypeSlug === '') {
+                continue;
+            }
+
+            $pathSegments[] = $slug;
+            $breadcrumbs[] = [
+                'name' => $name,
+                'url' => url('/' . $contentTypeSlug . '/' . implode('/', $pathSegments)),
+            ];
+        }
+
+        $breadcrumbs[] = [
+            'name' => html_entity_decode((string) $artwork->title, ENT_QUOTES | ENT_HTML5, 'UTF-8'),
+            'url' => $canonical,
+        ];
+
+        return $breadcrumbs;
+    }
+
     /** Silently catch suggestion query failures so error page never crashes. */
     private function safeSuggestions(callable $fn): mixed
     {

app/Http/Controllers/Web/BrowseGalleryController.php

@@ -181,7 +181,7 @@ class BrowseGalleryController extends \App\Http\Controllers\Controller
                 'hero_title'      => $contentType->name,
                 'hero_description' => $contentType->description ?? ($contentType->name . ' artworks on Skinbase.'),
                 'breadcrumbs'     => collect([
-                    (object) ['name' => 'Explore', 'url' => '/browse'],
+                    (object) ['name' => 'Explore', 'url' => route('explore.index')],
                     (object) ['name' => $contentType->name, 'url' => '/' . $contentSlug],
                 ]),
                 'page_title'      => $contentType->name . ' – Skinbase',
@@ -237,7 +237,7 @@ class BrowseGalleryController extends \App\Http\Controllers\Controller
         $breadcrumbs = collect(array_merge([
             (object) [
                 'name' => 'Explore',
-                'url' => '/browse',
+                'url' => route('explore.index'),
             ],
             (object) [
                 'name' => $contentType->name,
@@ -335,6 +335,8 @@ class BrowseGalleryController extends \App\Http\Controllers\Controller
         return (object) $this->maturity->decoratePayload([
             'id'            => $artwork->id,
             'name'          => $artwork->title,
+            'slug'          => $artwork->slug,
+            'url'           => route('art.show', ['id' => $artwork->id, 'slug' => $artwork->slug]),
             'content_type_name' => $primaryCategory?->contentType?->name ?? '',
             'content_type_slug' => $primaryCategory?->contentType?->slug ?? '',
             'category_name' => $primaryCategory->name ?? '',

app/Http/Controllers/Web/DiscoverController.php

@@ -65,6 +65,7 @@ final class DiscoverController extends Controller
         return view('web.discover.index', [
             'artworks'    => $results,
             'page_title'  => 'Trending Artworks',
+            'page_canonical' => $this->canonicalRoute('discover.trending'),
             'section'     => 'trending',
             'description' => 'The most-viewed artworks on Skinbase over the past 7 days.',
             'icon'        => 'fa-fire',
@@ -97,6 +98,7 @@ final class DiscoverController extends Controller
         return view('web.discover.index', [
             'artworks'    => $results,
             'page_title'  => 'Rising Now',
+            'page_canonical' => $this->canonicalRoute('discover.rising'),
             'section'     => 'rising',
             'description' => 'Fastest growing artworks right now.',
             'icon'        => 'fa-rocket',
@@ -119,6 +121,7 @@ final class DiscoverController extends Controller
         return view('web.discover.index', [
             'artworks'    => $results,
             'page_title'  => 'Fresh Uploads',
+            'page_canonical' => $this->canonicalRoute('discover.fresh'),
             'section'     => 'fresh',
             'description' => 'The latest artworks just uploaded to Skinbase.',
             'icon'        => 'fa-bolt',
@@ -138,6 +141,7 @@ final class DiscoverController extends Controller
         return view('web.discover.index', [
             'artworks'    => $results,
             'page_title'  => 'Top Rated Artworks',
+            'page_canonical' => $this->canonicalRoute('discover.top-rated'),
             'section'     => 'top-rated',
             'description' => 'The most-loved artworks on Skinbase, ranked by community favourites.',
             'icon'        => 'fa-medal',
@@ -157,6 +161,7 @@ final class DiscoverController extends Controller
         return view('web.discover.index', [
             'artworks'    => $results,
             'page_title'  => 'Most Downloaded',
+            'page_canonical' => $this->canonicalRoute('discover.most-downloaded'),
             'section'     => 'most-downloaded',
             'description' => 'All-time most downloaded artworks on Skinbase.',
             'icon'        => 'fa-download',
@@ -178,9 +183,9 @@ final class DiscoverController extends Controller
                 'categories:id,name,slug,content_type_id,parent_id,sort_order',
                 'categories.contentType:id,slug,name',
             ])
-            ->whereRaw('MONTH(published_at) = ?', [$today->month])
+            ->whereMonth('published_at', $today->month)
-            ->whereRaw('DAY(published_at) = ?',   [$today->day])
+            ->whereDay('published_at', $today->day)
-            ->whereRaw('YEAR(published_at) < ?',   [$today->year])
+            ->whereYear('published_at', '<', $today->year)
             ->orderMissingThumbnailsLast()
             ->orderByDesc('published_at')
             ->paginate($perPage)
@@ -191,6 +196,7 @@ final class DiscoverController extends Controller
         return view('web.discover.index', [
             'artworks'    => $artworks,
             'page_title'  => 'On This Day',
+            'page_canonical' => $this->canonicalRoute('discover.on-this-day'),
             'section'     => 'on-this-day',
             'description' => 'Artworks published on ' . $today->format('F j') . ' in previous years.',
             'icon'        => 'fa-calendar-day',
@@ -246,6 +252,7 @@ final class DiscoverController extends Controller
         return view('web.creators.rising', [
             'creators'   => $creators,
             'page_title' => 'Rising Creators — Skinbase',
+            'page_canonical' => $this->canonicalRoute('creators.rising'),
         ]);
     }
 
@@ -327,6 +334,7 @@ final class DiscoverController extends Controller
             return view('web.discover.index', [
                 'artworks'           => collect(),
                 'page_title'         => 'Following Feed',
+                'page_canonical'     => $this->canonicalRoute('discover.following'),
                 'section'            => 'following',
                 'description'        => 'Follow some creators to see their work here.',
                 'icon'               => 'fa-user-group',
@@ -366,6 +374,7 @@ final class DiscoverController extends Controller
         return view('web.discover.index', [
             'artworks'    => $artworks,
             'page_title'  => 'Following Feed',
+            'page_canonical' => $this->canonicalRoute('discover.following'),
             'section'     => 'following',
             'description' => 'The latest artworks from creators you follow.',
             'icon'        => 'fa-user-group',
@@ -388,6 +397,11 @@ final class DiscoverController extends Controller
         return ! $items || $items->isEmpty();
     }
 
+    private function canonicalRoute(string $routeName): string
+    {
+        return route($routeName);
+    }
+
     private function paginatorHasNoRisingMomentum($paginator): bool
     {
         if (! is_object($paginator) || ! method_exists($paginator, 'getCollection')) {

app/Http/Controllers/Web/SimilarArtworksPageController.php

@@ -102,7 +102,7 @@ final class SimilarArtworksPageController extends Controller
             'page_title'            => 'Similar to "' . $sourceTitle . '" — Skinbase',
             'page_meta_description' => 'Discover artworks similar to "' . $sourceTitle . '" on Skinbase.',
             'page_canonical'        => $baseUrl,
-            'page_robots'           => 'noindex,follow',
+            'page_robots'           => 'index,follow',
             'breadcrumbs'           => collect([
                 (object) ['name' => 'Explore',           'url' => '/explore'],
                 (object) ['name' => $sourceTitle,        'url' => $sourceUrl],
@@ -227,10 +227,11 @@ final class SimilarArtworksPageController extends Controller
             ->public()
             ->published()
             ->with([
-                'categories:id,slug,name',
+                'categories:id,slug,name,content_type_id',
                 'categories.contentType:id,name,slug',
                 'user:id,name,username',
                 'user.profile:user_id,avatar_hash',
+                'group:id,name,slug,avatar_path',
             ])
             ->get()
             ->keyBy('id');
@@ -268,6 +269,14 @@ final class SimilarArtworksPageController extends Controller
             'sort'   => ['trending_score_7d:desc', 'created_at:desc'],
         ])->paginate(self::PER_PAGE, 'page', $page);
 
+        $results->getCollection()->load([
+            'categories:id,slug,name,content_type_id',
+            'categories.contentType:id,name,slug',
+            'user:id,name,username',
+            'user.profile:user_id,avatar_hash',
+            'group:id,name,slug,avatar_path',
+        ]);
+
         $results->getCollection()->transform(fn ($a) => $this->presentArtwork($a));
 
         return $results;

app/Http/Controllers/Web/TagController.php

@@ -51,7 +51,7 @@ final class TagController extends Controller
         $artworks = $this->search->byTag($tag->slug, $perPage, $sort);
 
         // Eager-load relations used by the gallery presenter and thumbnails.
-        $artworks->getCollection()->each(fn($m) => $m->loadMissing(['user.profile', 'categories']));
+        $artworks->getCollection()->loadMissing(['user.profile', 'categories.contentType']);
 
         // Sidebar: main content type links (same as browse gallery)
         $mainCategories = ContentType::ordered()->where('hide_from_menu', false)->get(['name', 'slug'])

app/Http/Controllers/Web/WorldWebStoryController.php

@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Web;
+
+use App\Http\Controllers\Controller;
+use App\Models\WorldWebStory;
+use App\Services\WebStories\WorldWebStorySeoService;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\View\View;
+
+final class WorldWebStoryController extends Controller
+{
+    public function __construct(private readonly WorldWebStorySeoService $seo)
+    {
+    }
+
+    public function index(Request $request): View
+    {
+        $stories = Cache::remember('web_story_index', 300, fn () => WorldWebStory::query()
+            ->with('world')
+            ->visible()
+            ->orderByDesc('featured')
+            ->orderByDesc('published_at')
+            ->paginate(12)
+            ->withQueryString());
+
+        return view('web-stories.index', [
+            'stories' => $stories,
+            'seo' => $this->seo->indexSeo(),
+            'useUnifiedSeo' => true,
+        ]);
+    }
+
+    public function show(string $slug): View
+    {
+        $story = Cache::remember('web_story:' . $slug, 300, fn () => WorldWebStory::query()
+            ->with(['world', 'orderedPages.artwork.user'])
+            ->visible()
+            ->where('slug', $slug)
+            ->first());
+
+        abort_unless($story instanceof WorldWebStory, 404);
+
+        return view('web-stories.show', [
+            'story' => $story,
+            'meta' => $this->seo->storyMeta($story),
+        ]);
+    }
+}

app/Http/Middleware/HandleInertiaRequests.php

@@ -94,6 +94,9 @@ final class HandleInertiaRequests extends Middleware
     {
         $canReadSessionAuth = $this->canReadSessionAuth($request);
         $user = $canReadSessionAuth ? $request->user() : null;
+        $sessionFlash = static fn (string $key): ?string => $canReadSessionAuth
+            ? $request->session()->get($key)
+            : null;
 
         return array_merge(parent::share($request), [
             'auth' => [
@@ -108,6 +111,11 @@ final class HandleInertiaRequests extends Middleware
                     'is_moderator' => $user->isModerator(),
                 ] : null,
             ],
+            'flash' => [
+                'success' => fn (): ?string => $sessionFlash('success'),
+                'error' => fn (): ?string => $sessionFlash('error'),
+                'warning' => fn (): ?string => $sessionFlash('warning'),
+            ],
             'cdn' => [
                 'files_url' => config('cdn.files_url'),
             ],

app/Http/Middleware/SecurityHeaders.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class SecurityHeaders
+{
+    public function handle(Request $request, Closure $next): Response
+    {
+        $response = $next($request);
+
+        $response->headers->set('X-Frame-Options', 'SAMEORIGIN');
+        $response->headers->set('X-Content-Type-Options', 'nosniff');
+        $response->headers->set('Referrer-Policy', 'strict-origin-when-cross-origin');
+        $response->headers->set('Permissions-Policy', 'camera=(), microphone=(), geolocation=()');
+
+        return $response;
+    }
+}

app/Http/Requests/Academy/UpsertAcademyCourseRequest.php

@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\Academy;
+
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class UpsertAcademyCourseRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return (bool) $this->user()?->hasStaffAccess();
+    }
+
+    protected function prepareForValidation(): void
+    {
+        $this->merge([
+            'is_featured' => $this->boolean('is_featured'),
+            'order_num' => $this->filled('order_num') ? (int) $this->input('order_num') : 0,
+            'estimated_minutes' => $this->filled('estimated_minutes') ? (int) $this->input('estimated_minutes') : null,
+        ]);
+    }
+
+    public function rules(): array
+    {
+        $courseId = $this->route('academyCourse')?->id;
+
+        return [
+            'title' => ['required', 'string', 'max:180'],
+            'slug' => ['required', 'string', 'max:180', Rule::unique('academy_courses', 'slug')->ignore($courseId)],
+            'subtitle' => ['nullable', 'string', 'max:255'],
+            'excerpt' => ['nullable', 'string'],
+            'description' => ['nullable', 'string'],
+            'cover_image' => ['nullable', 'string', 'max:2048'],
+            'teaser_image' => ['nullable', 'string', 'max:2048'],
+            'access_level' => ['required', 'string', Rule::in(['free', 'premium', 'mixed'])],
+            'difficulty' => ['required', 'string', Rule::in(['beginner', 'intermediate', 'advanced'])],
+            'status' => ['required', 'string', Rule::in(['draft', 'review', 'published', 'archived'])],
+            'is_featured' => ['required', 'boolean'],
+            'order_num' => ['required', 'integer', 'min:0'],
+            'estimated_minutes' => ['nullable', 'integer', 'min:1', 'max:10000'],
+            'published_at' => ['nullable', 'date'],
+            'seo_title' => ['nullable', 'string', 'max:180'],
+            'seo_description' => ['nullable', 'string', 'max:255'],
+            'meta_keywords' => ['nullable', 'string'],
+            'og_title' => ['nullable', 'string', 'max:180'],
+            'og_description' => ['nullable', 'string', 'max:255'],
+            'og_image' => ['nullable', 'string', 'max:2048'],
+        ];
+    }
+}

app/Http/Requests/Academy/UpsertAcademyLessonRequest.php

@@ -69,6 +69,18 @@ class UpsertAcademyLessonRequest extends FormRequest
             ->all();
 
         $this->merge([
+            'lesson_number' => $this->filled('lesson_number') ? (int) $this->input('lesson_number') : null,
+            'course_order' => $this->filled('course_order') ? (int) $this->input('course_order') : null,
+            'content_source' => in_array((string) $this->input('content_source'), ['html', 'markdown'], true)
+                ? (string) $this->input('content_source')
+                : ($this->filled('content_markdown') ? 'markdown' : 'html'),
+            'course_ids' => collect($this->input('course_ids', []))
+                ->filter(static fn ($courseId): bool => filled($courseId))
+                ->map(static fn ($courseId): int => (int) $courseId)
+                ->unique()
+                ->values()
+                ->all(),
+            'tags' => array_values(array_filter((array) $this->input('tags', []))),
             'reading_minutes' => $this->filled('reading_minutes') ? (int) $this->input('reading_minutes') : 5,
             'featured' => $this->boolean('featured'),
             'active' => $this->boolean('active', true),
@@ -84,12 +96,22 @@ class UpsertAcademyLessonRequest extends FormRequest
             'category_id' => ['nullable', 'integer', 'exists:academy_categories,id'],
             'title' => ['required', 'string', 'max:180'],
             'slug' => ['required', 'string', 'max:180', Rule::unique('academy_lessons', 'slug')->ignore($lessonId)],
+            'lesson_number' => ['nullable', 'integer', 'min:1'],
+            'course_order' => ['nullable', 'integer', 'min:1'],
+            'course_ids' => ['nullable', 'array'],
+            'course_ids.*' => ['integer', 'exists:academy_courses,id'],
+            'series_name' => ['nullable', 'string', 'max:120'],
             'excerpt' => ['nullable', 'string'],
             'content' => ['nullable', 'string'],
+            'content_markdown' => ['nullable', 'string'],
+            'content_source' => ['required', 'string', Rule::in(['html', 'markdown'])],
             'difficulty' => ['required', 'string', Rule::in((array) config('academy.difficulty_levels', []))],
             'access_level' => ['required', 'string', Rule::in(['free', 'creator', 'pro'])],
             'lesson_type' => ['required', 'string', 'max:80'],
             'cover_image' => ['nullable', 'string', 'max:2048'],
+            'article_cover_image' => ['nullable', 'string', 'max:2048'],
+            'tags' => ['nullable', 'array'],
+            'tags.*' => ['string', 'max:200'],
             'video_url' => ['nullable', 'string', 'max:2048'],
             'reading_minutes' => ['required', 'integer', 'min:1', 'max:999'],
             'featured' => ['required', 'boolean'],

app/Http/Requests/Academy/UpsertAcademyPromptTemplateRequest.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace App\Http\Requests\Academy;
 
+use JsonException;
 use Illuminate\Foundation\Http\FormRequest;
 use Illuminate\Validation\Rule;
 
@@ -20,8 +21,37 @@ class UpsertAcademyPromptTemplateRequest extends FormRequest
             'featured' => $this->boolean('featured'),
             'prompt_of_week' => $this->boolean('prompt_of_week'),
             'active' => $this->boolean('active', true),
+            'new_category_name' => trim((string) $this->input('new_category_name', '')),
             'tags' => array_values(array_filter((array) $this->input('tags', []))),
-            'tool_notes' => (array) $this->input('tool_notes', []),
+            'documentation' => $this->normalizeDocumentation($this->input('documentation')),
+            'placeholders' => $this->normalizePlaceholders($this->input('placeholders')),
+            'helper_prompts' => $this->normalizeHelperPrompts($this->input('helper_prompts')),
+            'prompt_variants' => $this->normalizePromptVariants($this->input('prompt_variants')),
+            'filled_examples' => $this->normalizeFilledExamples($this->input('filled_examples')),
+            'tool_notes' => collect($this->input('tool_notes', []))
+                ->filter(static fn ($note): bool => is_array($note) || is_string($note))
+                ->map(function ($note): array|string {
+                    if (is_string($note)) {
+                        return $note;
+                    }
+
+                    return [
+                        'display_type' => $note['display_type'] ?? null,
+                        'provider' => $note['provider'] ?? null,
+                        'model_name' => $note['model_name'] ?? null,
+                        'notes' => $note['notes'] ?? null,
+                        'strengths' => $note['strengths'] ?? null,
+                        'weaknesses' => $note['weaknesses'] ?? null,
+                        'best_for' => $note['best_for'] ?? null,
+                        'image_path' => $note['image_path'] ?? null,
+                        'thumb_path' => $note['thumb_path'] ?? null,
+                        'settings' => $note['settings'] ?? null,
+                        'score' => filled($note['score'] ?? null) ? (int) $note['score'] : null,
+                        'active' => filter_var($note['active'] ?? true, FILTER_VALIDATE_BOOL, FILTER_NULL_ON_FAILURE) ?? true,
+                    ];
+                })
+                ->values()
+                ->all(),
         ]);
     }
 
@@ -30,7 +60,10 @@ class UpsertAcademyPromptTemplateRequest extends FormRequest
         $promptId = $this->route('academyPromptTemplate')?->id;
 
         return [
-            'category_id' => ['nullable', 'integer', 'exists:academy_categories,id'],
+            // Require either an existing category selection or a new category name.
+            'category_id' => ['nullable', 'integer', 'exists:academy_categories,id', 'required_without:new_category_name'],
+            'new_category_name' => ['nullable', 'string', 'max:120', 'required_without:category_id'],
+            
             'title' => ['required', 'string', 'max:180'],
             'slug' => ['required', 'string', 'max:180', Rule::unique('academy_prompt_templates', 'slug')->ignore($promptId)],
             'excerpt' => ['nullable', 'string'],
@@ -38,12 +71,74 @@ class UpsertAcademyPromptTemplateRequest extends FormRequest
             'negative_prompt' => ['nullable', 'string'],
             'usage_notes' => ['nullable', 'string'],
             'workflow_notes' => ['nullable', 'string'],
+            'documentation' => ['nullable', 'array'],
+            'documentation.summary' => ['nullable', 'string'],
+            'documentation.best_for' => ['nullable', 'array'],
+            'documentation.best_for.*' => ['nullable', 'string'],
+            'documentation.how_to_use' => ['nullable', 'array'],
+            'documentation.how_to_use.*' => ['nullable', 'string'],
+            'documentation.required_inputs' => ['nullable', 'array'],
+            'documentation.required_inputs.*' => ['nullable', 'string'],
+            'documentation.workflow' => ['nullable', 'array'],
+            'documentation.workflow.*' => ['nullable', 'string'],
+            'documentation.tips' => ['nullable', 'array'],
+            'documentation.tips.*' => ['nullable', 'string'],
+            'documentation.common_mistakes' => ['nullable', 'array'],
+            'documentation.common_mistakes.*' => ['nullable', 'string'],
+            'documentation.data_accuracy_notes' => ['nullable', 'array'],
+            'documentation.data_accuracy_notes.*' => ['nullable', 'string'],
+            'documentation.display_notes' => ['nullable', 'string'],
+            'placeholders' => ['nullable', 'array'],
+            'placeholders.*.key' => ['nullable', 'string', 'max:120'],
+            'placeholders.*.label' => ['nullable', 'string', 'max:180'],
+            'placeholders.*.description' => ['nullable', 'string'],
+            'placeholders.*.required' => ['nullable', 'boolean'],
+            'placeholders.*.example' => ['nullable'],
+            'placeholders.*.default' => ['nullable'],
+            'placeholders.*.type' => ['nullable', 'string', 'max:120'],
+            'helper_prompts' => ['nullable', 'array'],
+            'helper_prompts.*.title' => ['required_with:helper_prompts', 'string', 'max:180'],
+            'helper_prompts.*.type' => ['nullable', 'string', Rule::in(['data_collection', 'prompt_preparation', 'refinement', 'validation', 'variation', 'translation', 'seo', 'other'])],
+            'helper_prompts.*.description' => ['nullable', 'string'],
+            'helper_prompts.*.prompt' => ['required_with:helper_prompts', 'string'],
+            'helper_prompts.*.expected_output' => ['nullable', 'string', Rule::in(['json', 'text', 'markdown', 'image_prompt'])],
+            'helper_prompts.*.active' => ['nullable', 'boolean'],
+            'prompt_variants' => ['nullable', 'array'],
+            'prompt_variants.*.title' => ['required_with:prompt_variants', 'string', 'max:180'],
+            'prompt_variants.*.slug' => ['nullable', 'string', 'max:180'],
+            'prompt_variants.*.description' => ['nullable', 'string'],
+            'prompt_variants.*.prompt' => ['required_with:prompt_variants', 'string'],
+            'prompt_variants.*.negative_prompt' => ['nullable', 'string'],
+            'prompt_variants.*.recommended' => ['nullable', 'boolean'],
+            'prompt_variants.*.recommended_for' => ['nullable', 'array'],
+            'prompt_variants.*.recommended_for.*' => ['nullable', 'string'],
+            'prompt_variants.*.risk_notes' => ['nullable', 'array'],
+            'prompt_variants.*.risk_notes.*' => ['nullable', 'string'],
+            'prompt_variants.*.active' => ['nullable', 'boolean'],
+            'filled_examples' => ['nullable', 'array', 'max:5'],
+            'filled_examples.*.title' => ['nullable', 'string', 'max:180'],
+            'filled_examples.*.description' => ['nullable', 'string'],
+            'filled_examples.*.placeholder_values' => ['nullable', 'array'],
+            'filled_examples.*.prompt' => ['required_with:filled_examples', 'string'],
+            'filled_examples.*.negative_prompt' => ['nullable', 'string'],
             'difficulty' => ['required', 'string', Rule::in((array) config('academy.difficulty_levels', []))],
             'access_level' => ['required', 'string', Rule::in(['free', 'creator', 'pro'])],
             'aspect_ratio' => ['nullable', 'string', 'max:20'],
             'tags' => ['nullable', 'array'],
             'tags.*' => ['string', 'max:60'],
             'tool_notes' => ['nullable', 'array'],
+                        'tool_notes.*.display_type' => ['nullable', 'string', 'max:50'],
+                        'tool_notes.*.provider' => ['nullable', 'string', 'max:100'],
+                        'tool_notes.*.model_name' => ['nullable', 'string', 'max:150'],
+                        'tool_notes.*.notes' => ['nullable', 'string'],
+                        'tool_notes.*.strengths' => ['nullable', 'string'],
+                        'tool_notes.*.weaknesses' => ['nullable', 'string'],
+                        'tool_notes.*.best_for' => ['nullable', 'string'],
+                        'tool_notes.*.image_path' => ['nullable', 'string', 'max:500'],
+                        'tool_notes.*.thumb_path' => ['nullable', 'string', 'max:500'],
+                        'tool_notes.*.settings' => ['nullable', 'string'],
+                        'tool_notes.*.score' => ['nullable', 'integer', 'min:1', 'max:10'],
+                        'tool_notes.*.active' => ['nullable', 'boolean'],
             'preview_image' => ['nullable', 'string', 'max:2048'],
             'preview_image_file' => ['nullable', 'file', 'image', 'mimes:jpg,jpeg,png,webp', 'max:5120'],
             'featured' => ['required', 'boolean'],
@@ -54,4 +149,298 @@ class UpsertAcademyPromptTemplateRequest extends FormRequest
             'seo_description' => ['nullable', 'string', 'max:255'],
         ];
     }
+
+    private function decodeStructuredInput(mixed $value): mixed
+    {
+        if (! is_string($value)) {
+            return $value;
+        }
+
+        $trimmed = trim($value);
+
+        if ($trimmed === '') {
+            return null;
+        }
+
+        try {
+            return json_decode($trimmed, true, 512, JSON_THROW_ON_ERROR);
+        } catch (JsonException) {
+            return $value;
+        }
+    }
+
+    private function normalizeDocumentation(mixed $value): mixed
+    {
+        $value = $this->decodeStructuredInput($value);
+
+        if ($value === null) {
+            return null;
+        }
+
+        if (! is_array($value)) {
+            return $value;
+        }
+
+        $listFields = ['best_for', 'how_to_use', 'required_inputs', 'workflow', 'tips', 'common_mistakes', 'data_accuracy_notes'];
+        $documentation = [
+            'summary' => $this->normalizeOptionalString($value['summary'] ?? null),
+            'display_notes' => $this->normalizeOptionalString($value['display_notes'] ?? null),
+        ];
+
+        foreach ($listFields as $field) {
+            $documentation[$field] = $this->normalizeStringList($value[$field] ?? []);
+        }
+
+        $hasContent = $documentation['summary'] !== null
+            || $documentation['display_notes'] !== null
+            || collect($listFields)->contains(fn (string $field): bool => $documentation[$field] !== []);
+
+        return $hasContent ? $documentation : null;
+    }
+
+    private function normalizePlaceholders(mixed $value): mixed
+    {
+        $value = $this->decodeStructuredInput($value);
+
+        if ($value === null) {
+            return [];
+        }
+
+        if (! is_array($value)) {
+            return $value;
+        }
+
+        $value = $this->normalizeStructuredObjectList($value, ['key', 'label', 'description', 'required', 'example', 'default', 'type']);
+
+        return collect($value)
+            ->values()
+            ->map(function ($placeholder): mixed {
+                if (! is_array($placeholder)) {
+                    return $placeholder;
+                }
+
+                return [
+                    'key' => $this->normalizeOptionalString($placeholder['key'] ?? null),
+                    'label' => $this->normalizeOptionalString($placeholder['label'] ?? null),
+                    'description' => $this->normalizeOptionalString($placeholder['description'] ?? null),
+                    'required' => filter_var($placeholder['required'] ?? false, FILTER_VALIDATE_BOOL, FILTER_NULL_ON_FAILURE) ?? false,
+                    'example' => $this->normalizeJsonScalar($placeholder['example'] ?? null),
+                    'default' => $this->normalizeJsonScalar($placeholder['default'] ?? null),
+                    'type' => $this->normalizeOptionalString($placeholder['type'] ?? null),
+                ];
+            })
+            ->filter(function ($placeholder): bool {
+                if (! is_array($placeholder)) {
+                    return true;
+                }
+
+                return collect([
+                    $placeholder['key'] ?? null,
+                    $placeholder['label'] ?? null,
+                    $placeholder['description'] ?? null,
+                    $placeholder['example'] ?? null,
+                    $placeholder['default'] ?? null,
+                    $placeholder['type'] ?? null,
+                ])->contains(fn ($item): bool => $item !== null && $item !== '' && $item !== []);
+            })
+            ->values()
+            ->all();
+    }
+
+    private function normalizeHelperPrompts(mixed $value): mixed
+    {
+        $value = $this->decodeStructuredInput($value);
+
+        if ($value === null) {
+            return [];
+        }
+
+        if (! is_array($value)) {
+            return $value;
+        }
+
+        $value = $this->normalizeStructuredObjectList($value, ['title', 'type', 'description', 'prompt', 'expected_output', 'active']);
+
+        return collect($value)
+            ->values()
+            ->map(function ($helperPrompt): mixed {
+                if (! is_array($helperPrompt)) {
+                    return $helperPrompt;
+                }
+
+                return [
+                    'title' => $this->normalizeOptionalString($helperPrompt['title'] ?? null),
+                    'type' => $this->normalizeOptionalString($helperPrompt['type'] ?? null) ?? 'other',
+                    'description' => $this->normalizeOptionalString($helperPrompt['description'] ?? null),
+                    'prompt' => $this->normalizeOptionalString($helperPrompt['prompt'] ?? null),
+                    'expected_output' => $this->normalizeOptionalString($helperPrompt['expected_output'] ?? null) ?? 'text',
+                    'active' => filter_var($helperPrompt['active'] ?? true, FILTER_VALIDATE_BOOL, FILTER_NULL_ON_FAILURE) ?? true,
+                ];
+            })
+            ->filter(function ($helperPrompt): bool {
+                if (! is_array($helperPrompt)) {
+                    return true;
+                }
+
+                return collect([
+                    $helperPrompt['title'] ?? null,
+                    $helperPrompt['description'] ?? null,
+                    $helperPrompt['prompt'] ?? null,
+                ])->contains(fn ($item): bool => $item !== null && $item !== '');
+            })
+            ->values()
+            ->all();
+    }
+
+    private function normalizeFilledExamples(mixed $value): mixed
+    {
+        $value = $this->decodeStructuredInput($value);
+
+        if ($value === null) {
+            return [];
+        }
+
+        if (! is_array($value)) {
+            return $value;
+        }
+
+        $value = $this->normalizeStructuredObjectList($value, ['title', 'description', 'placeholder_values', 'prompt', 'negative_prompt']);
+
+        return collect($value)
+            ->values()
+            ->map(function ($example): mixed {
+                if (! is_array($example)) {
+                    return $example;
+                }
+
+                return [
+                    'title' => $this->normalizeOptionalString($example['title'] ?? null),
+                    'description' => $this->normalizeOptionalString($example['description'] ?? null),
+                    'placeholder_values' => is_array($example['placeholder_values'] ?? null) ? $example['placeholder_values'] : [],
+                    'prompt' => $this->normalizeOptionalString($example['prompt'] ?? null),
+                    'negative_prompt' => $this->normalizeOptionalString($example['negative_prompt'] ?? null),
+                ];
+            })
+            ->filter(function ($example): bool {
+                if (! is_array($example)) {
+                    return true;
+                }
+
+                return collect([
+                    $example['title'] ?? null,
+                    $example['description'] ?? null,
+                    $example['prompt'] ?? null,
+                    $example['negative_prompt'] ?? null,
+                    $example['placeholder_values'] ?? null,
+                ])->contains(fn ($item): bool => $item !== null && $item !== '' && $item !== []);
+            })
+            ->take(5)
+            ->values()
+            ->all();
+    }
+
+    private function normalizePromptVariants(mixed $value): mixed
+    {
+        $value = $this->decodeStructuredInput($value);
+
+        if ($value === null) {
+            return [];
+        }
+
+        if (! is_array($value)) {
+            return $value;
+        }
+
+        $value = $this->normalizeStructuredObjectList($value, ['title', 'slug', 'description', 'prompt', 'negative_prompt', 'recommended', 'recommended_for', 'risk_notes', 'active']);
+
+        return collect($value)
+            ->values()
+            ->map(function ($variant): mixed {
+                if (! is_array($variant)) {
+                    return $variant;
+                }
+
+                return [
+                    'title' => $this->normalizeOptionalString($variant['title'] ?? null),
+                    'slug' => $this->normalizeOptionalString($variant['slug'] ?? null),
+                    'description' => $this->normalizeOptionalString($variant['description'] ?? null),
+                    'prompt' => $this->normalizeOptionalString($variant['prompt'] ?? null),
+                    'negative_prompt' => $this->normalizeOptionalString($variant['negative_prompt'] ?? null),
+                    'recommended' => filter_var($variant['recommended'] ?? false, FILTER_VALIDATE_BOOL, FILTER_NULL_ON_FAILURE) ?? false,
+                    'recommended_for' => $this->normalizeStringList($variant['recommended_for'] ?? []),
+                    'risk_notes' => $this->normalizeStringList($variant['risk_notes'] ?? []),
+                    'active' => filter_var($variant['active'] ?? true, FILTER_VALIDATE_BOOL, FILTER_NULL_ON_FAILURE) ?? true,
+                ];
+            })
+            ->filter(function ($variant): bool {
+                if (! is_array($variant)) {
+                    return true;
+                }
+
+                return collect([
+                    $variant['title'] ?? null,
+                    $variant['description'] ?? null,
+                    $variant['prompt'] ?? null,
+                    $variant['negative_prompt'] ?? null,
+                ])->contains(fn ($item): bool => $item !== null && $item !== '');
+            })
+            ->values()
+            ->all();
+    }
+
+    private function normalizeStringList(mixed $value): array
+    {
+        if (! is_array($value)) {
+            $value = $value === null ? [] : [$value];
+        }
+
+        return collect($value)
+            ->map(fn ($item): string => trim((string) $item))
+            ->filter(static fn (string $item): bool => $item !== '')
+            ->values()
+            ->all();
+    }
+
+    private function normalizeOptionalString(mixed $value): ?string
+    {
+        if ($value === null) {
+            return null;
+        }
+
+        $normalized = trim((string) $value);
+
+        return $normalized !== '' ? $normalized : null;
+    }
+
+    private function normalizeJsonScalar(mixed $value): mixed
+    {
+        if (! is_string($value)) {
+            return $value;
+        }
+
+        $trimmed = trim($value);
+
+        return $trimmed !== '' ? $trimmed : null;
+    }
+
+    /**
+     * @param  array<int|string, mixed>  $value
+     * @param  array<int, string>  $expectedKeys
+     * @return array<int|string, mixed>
+     */
+    private function normalizeStructuredObjectList(array $value, array $expectedKeys): array
+    {
+        if (array_is_list($value)) {
+            return $value;
+        }
+
+        $keys = array_keys($value);
+        $normalizedKeys = array_map(static fn ($key): string => (string) $key, $keys);
+
+        if ($normalizedKeys === [] || array_intersect($normalizedKeys, $expectedKeys) === []) {
+            return $value;
+        }
+
+        return [$value];
+    }
 }

app/Http/Requests/Artworks/ArtworkCreateRequest.php

@@ -4,7 +4,9 @@ declare(strict_types=1);
 
 namespace App\Http\Requests\Artworks;
 
+use App\Support\ArtworkDescriptionContentValidator;
 use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Validator;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 
 final class ArtworkCreateRequest extends FormRequest
@@ -32,6 +34,15 @@ final class ArtworkCreateRequest extends FormRequest
         ];
     }
 
+    public function withValidator(Validator $validator): void
+    {
+        $validator->after(function (Validator $validator): void {
+            foreach (ArtworkDescriptionContentValidator::errors($this->input('description')) as $message) {
+                $validator->errors()->add('description', $message);
+            }
+        });
+    }
+
     private function denyAsNotFound(): void
     {
         throw new NotFoundHttpException();

app/Http/Requests/Dashboard/UpdateArtworkRequest.php

@@ -3,7 +3,9 @@
 namespace App\Http\Requests\Dashboard;
 
 use App\Models\Artwork;
+use App\Support\ArtworkDescriptionContentValidator;
 use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Validator;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 
 class UpdateArtworkRequest extends FormRequest
@@ -45,6 +47,15 @@ class UpdateArtworkRequest extends FormRequest
         ];
     }
 
+    public function withValidator(Validator $validator): void
+    {
+        $validator->after(function (Validator $validator): void {
+            foreach (ArtworkDescriptionContentValidator::errors($this->input('description')) as $message) {
+                $validator->errors()->add('description', $message);
+            }
+        });
+    }
+
     public function artwork(): Artwork
     {
         if (! $this->artwork) {

app/Http/Requests/Manage/ManageArtworkUpdateRequest.php

@@ -4,8 +4,10 @@ declare(strict_types=1);
 
 namespace App\Http\Requests\Manage;
 
+use App\Support\ArtworkDescriptionContentValidator;
 use Illuminate\Foundation\Http\FormRequest;
 use Illuminate\Support\Facades\DB;
+use Illuminate\Validation\Validator;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 
 final class ManageArtworkUpdateRequest extends FormRequest
@@ -48,6 +50,15 @@ final class ManageArtworkUpdateRequest extends FormRequest
         ];
     }
 
+    public function withValidator(Validator $validator): void
+    {
+        $validator->after(function (Validator $validator): void {
+            foreach (ArtworkDescriptionContentValidator::errors($this->input('description')) as $message) {
+                $validator->errors()->add('description', $message);
+            }
+        });
+    }
+
     public function artwork(): object
     {
         if (! $this->artwork) {

app/Http/Requests/Studio/ApplyArtworkAiAssistRequest.php

@@ -4,8 +4,10 @@ declare(strict_types=1);
 
 namespace App\Http\Requests\Studio;
 
+use App\Support\ArtworkDescriptionContentValidator;
 use Illuminate\Foundation\Http\FormRequest;
 use Illuminate\Validation\Rule;
+use Illuminate\Validation\Validator;
 
 final class ApplyArtworkAiAssistRequest extends FormRequest
 {
@@ -31,4 +33,13 @@ final class ApplyArtworkAiAssistRequest extends FormRequest
             'similar_actions.*.state' => ['required_with:similar_actions', Rule::in(['ignored', 'reviewed'])],
         ];
     }
+
+    public function withValidator(Validator $validator): void
+    {
+        $validator->after(function (Validator $validator): void {
+            foreach (ArtworkDescriptionContentValidator::errors($this->input('description')) as $message) {
+                $validator->errors()->add('description', $message);
+            }
+        });
+    }
 }

app/Jobs/AutoTagArtworkJob.php

@@ -54,6 +54,10 @@ final class AutoTagArtworkJob implements ShouldQueue
 
     public function handle(TagService $tagService, TagNormalizer $normalizer, ?VisionService $vision = null): void
     {
+        if (! (bool) config('vision.auto_tagging.enabled', false)) {
+            return;
+        }
+
         $vision ??= app(VisionService::class);
 
         if (! $vision->isEnabled()) {

app/Jobs/Enhance/ProcessEnhanceJob.php

@@ -0,0 +1,119 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Jobs\Enhance;
+
+use App\Models\EnhanceJob;
+use App\Services\Enhance\EnhanceProcessorFactory;
+use App\Services\Enhance\EnhanceStorageService;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Str;
+use Throwable;
+
+final class ProcessEnhanceJob implements ShouldQueue
+{
+    use Dispatchable;
+    use InteractsWithQueue;
+    use Queueable;
+    use SerializesModels;
+
+    public int $tries = 2;
+
+    public int $timeout = 300;
+
+    public function __construct(
+        private readonly int $enhanceJobId,
+    ) {
+        $queue = (string) config('enhance.queue', 'default');
+
+        if ($queue !== '') {
+            $this->onQueue($queue);
+        }
+    }
+
+    public function handle(EnhanceProcessorFactory $factory, EnhanceStorageService $storage): void
+    {
+        $enhanceJob = EnhanceJob::query()->find($this->enhanceJobId);
+
+        if (! $enhanceJob instanceof EnhanceJob) {
+            return;
+        }
+
+        if (! in_array($enhanceJob->status, [EnhanceJob::STATUS_PENDING, EnhanceJob::STATUS_QUEUED, EnhanceJob::STATUS_PROCESSING, EnhanceJob::STATUS_FAILED], true)) {
+            return;
+        }
+
+        $enhanceJob->forceFill([
+            'status' => EnhanceJob::STATUS_PROCESSING,
+            'started_at' => now(),
+            'finished_at' => null,
+            'error_message' => null,
+        ])->save();
+
+        Log::info('enhance.job.processing', [
+            'enhance_job_id' => $enhanceJob->id,
+            'user_id' => $enhanceJob->user_id,
+            'engine' => $enhanceJob->engine,
+        ]);
+
+        $started = microtime(true);
+        $completedExpiryDays = (int) config('enhance.lifecycle.completed_expires_after_days', 30);
+
+        try {
+            $processor = $factory->make((string) $enhanceJob->engine);
+            $result = $processor->process($enhanceJob);
+            $preview = $storage->createPreviewFromStoredOutput($enhanceJob, $result->disk, $result->path) ?? [];
+            $outputHash = null;
+            $outputContents = Storage::disk($result->disk)->get($result->path);
+
+            if (is_string($outputContents) && $outputContents !== '') {
+                $outputHash = hash('sha256', $outputContents);
+            }
+
+            $enhanceJob->forceFill([
+                'status' => EnhanceJob::STATUS_COMPLETED,
+                'output_disk' => $result->disk,
+                'output_path' => $result->path,
+                'output_hash' => $outputHash,
+                'output_width' => $result->width,
+                'output_height' => $result->height,
+                'output_filesize' => $result->filesize,
+                'output_mime' => $result->mime,
+                'metadata' => array_merge($enhanceJob->metadata ?? [], $result->metadata ?? []),
+                'processing_seconds' => (int) round(microtime(true) - $started),
+                'finished_at' => now(),
+                'expires_at' => $completedExpiryDays > 0 ? now()->addDays($completedExpiryDays) : null,
+            ] + $preview)->save();
+
+            Log::info('enhance.job.completed', [
+                'enhance_job_id' => $enhanceJob->id,
+                'user_id' => $enhanceJob->user_id,
+                'processing_seconds' => $enhanceJob->processing_seconds,
+            ]);
+        } catch (Throwable $exception) {
+            report($exception);
+
+            $enhanceJob->forceFill([
+                'status' => EnhanceJob::STATUS_FAILED,
+                'error_message' => Str::limit($exception->getMessage(), 1000),
+                'processing_seconds' => (int) round(microtime(true) - $started),
+                'finished_at' => now(),
+            ])->save();
+
+            Log::warning('enhance.job.failed', [
+                'enhance_job_id' => $enhanceJob->id,
+                'user_id' => $enhanceJob->user_id,
+                'message' => $exception->getMessage(),
+            ]);
+
+            throw $exception;
+        }
+    }
+}

app/Jobs/GenerateDerivativesJob.php

@@ -54,11 +54,19 @@ final class GenerateDerivativesJob implements ShouldQueue
         }
 
         // Auto-tagging is async and must never block publish.
+        if ((bool) config('vision.auto_tagging.enabled', false)) {
             AutoTagArtworkJob::dispatch($this->artworkId, $this->hash)->afterCommit();
+        }
+        if ((bool) config('vision.upload.maturity.enabled', false)) {
             DetectArtworkMaturityJob::dispatch($this->artworkId, $this->hash)->afterCommit();
+        }
+        if ((bool) config('vision.upload.embeddings.enabled', true)) {
             GenerateArtworkEmbeddingJob::dispatch($this->artworkId, $this->hash)->afterCommit();
+        }
+        if ((bool) config('vision.upload.ai_assist.enabled', false)) {
             AnalyzeArtworkAiAssistJob::dispatch($this->artworkId)->afterCommit();
         }
+    }
 
     public function failed(\Throwable $exception): void
     {

app/Jobs/RecComputeSimilarByTagsJob.php

@@ -9,9 +9,11 @@ use App\Models\RecArtworkRec;
 use Illuminate\Bus\Queueable;
 use Illuminate\Contracts\Queue\ShouldQueue;
 use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\Middleware\WithoutOverlapping;
 use Illuminate\Queue\InteractsWithQueue;
 use Illuminate\Queue\SerializesModels;
 use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
 
 /**
  * Compute tag-based (+ category boost) similarity for artworks.
@@ -30,6 +32,7 @@ final class RecComputeSimilarByTagsJob implements ShouldQueue
     public function __construct(
         private readonly ?int $artworkId = null,
         private readonly int  $batchSize = 200,
+        private readonly ?int $afterArtworkId = null,
     ) {
         $queue = (string) config('recommendations.queue', 'default');
         if ($queue !== '') {
@@ -37,6 +40,22 @@ final class RecComputeSimilarByTagsJob implements ShouldQueue
         }
     }
 
+    /**
+     * @return array<int, object>
+     */
+    public function middleware(): array
+    {
+        if ($this->artworkId === null) {
+            return [];
+        }
+
+        return [
+            (new WithoutOverlapping('rec-similar-tags:'.$this->artworkId))
+                ->expireAfter($this->timeout + 60)
+                ->dontRelease(),
+        ];
+    }
+
     public function handle(): void
     {
         $modelVersion = (string) config('recommendations.similarity.model_version', 'sim_v1');
@@ -51,19 +70,68 @@ final class RecComputeSimilarByTagsJob implements ShouldQueue
             ->pluck('cnt', 'tag_id')
             ->all();
 
-        $query = Artwork::query()->public()->published()->select('id', 'user_id');
-
         if ($this->artworkId !== null) {
-            $query->where('id', $this->artworkId);
+            $artwork = Artwork::query()->public()->published()->select('id', 'user_id')->find($this->artworkId);
+
+            if (! $artwork instanceof Artwork) {
+                return;
             }
 
-        $query->chunkById($this->batchSize, function ($artworks) use (
+            $this->processArtworkSafely($artwork, $tagFreqs, $modelVersion, $candidatePool, $maxPerAuthor, $resultLimit);
-            $tagFreqs, $modelVersion, $candidatePool, $maxPerAuthor, $resultLimit
+
-        ) {
+            return;
-            foreach ($artworks as $artwork) {
+        }
-                $this->processArtwork($artwork, $tagFreqs, $modelVersion, $candidatePool, $maxPerAuthor, $resultLimit);
+
+        $artworks = Artwork::query()
+            ->public()
+            ->published()
+            ->select('id', 'user_id')
+            ->when($this->afterArtworkId !== null, fn ($query) => $query->where('id', '>', $this->afterArtworkId))
+            ->orderBy('id')
+            ->limit($this->batchSize)
+            ->get();
+
+        if ($artworks->isEmpty()) {
+            return;
+        }
+
+        foreach ($artworks as $artwork) {
+            $this->processArtworkSafely($artwork, $tagFreqs, $modelVersion, $candidatePool, $maxPerAuthor, $resultLimit);
+        }
+
+        if ($artworks->count() === $this->batchSize) {
+            static::dispatch(null, $this->batchSize, (int) $artworks->last()->id);
+        }
+    }
+
+    public function failed(\Throwable $exception): void
+    {
+        Log::error('[RecComputeSimilarByTags] Job failed permanently.', [
+            'artwork_id' => $this->artworkId,
+            'batch_size' => $this->batchSize,
+            'after_artwork_id' => $this->afterArtworkId,
+            'attempts' => $this->attempts(),
+            'exception_class' => $exception::class,
+            'exception_message' => $exception->getMessage(),
+        ]);
+    }
+
+    private function processArtworkSafely(
+        Artwork $artwork,
+        array $tagFreqs,
+        string $modelVersion,
+        int $candidatePool,
+        int $maxPerAuthor,
+        int $resultLimit,
+    ): void {
+        try {
+            $this->processArtwork($artwork, $tagFreqs, $modelVersion, $candidatePool, $maxPerAuthor, $resultLimit);
+        } catch (\Throwable $exception) {
+            Log::warning("[RecComputeSimilarByTags] Failed for artwork {$artwork->id}: {$exception->getMessage()}", [
+                'artwork_id' => $artwork->id,
+                'exception_class' => $exception::class,
+            ]);
         }
-        });
     }
 
     private function processArtwork(

app/Jobs/RecComputeSimilarHybridJob.php

@@ -9,6 +9,7 @@ use App\Models\RecArtworkRec;
 use Illuminate\Bus\Queueable;
 use Illuminate\Contracts\Queue\ShouldQueue;
 use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\Middleware\WithoutOverlapping;
 use Illuminate\Queue\InteractsWithQueue;
 use Illuminate\Queue\SerializesModels;
 use Illuminate\Support\Facades\DB;
@@ -25,7 +26,10 @@ final class RecComputeSimilarHybridJob implements ShouldQueue
 {
     use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
 
-    public int $tries   = 2;
+    // This recompute is idempotent and already guards per-artwork execution.
+    // Keep retries to a minimum so transient failures do not turn into
+    // Horizon's max-attempt exception noise.
+    public int $tries   = 1;
     public int $timeout = 900;
 
     public function __construct(
@@ -38,6 +42,24 @@ final class RecComputeSimilarHybridJob implements ShouldQueue
         }
     }
 
+    /**
+     * @return array<int, object>
+     */
+    public function middleware(): array
+    {
+        if ($this->artworkId === null) {
+            return [];
+        }
+
+        return [
+            // Many artwork lifecycle events can queue this same recompute burstily.
+            // Keep only one in flight per artwork and drop overlapping duplicates.
+            (new WithoutOverlapping('rec-similar-hybrid:'.$this->artworkId))
+                ->expireAfter($this->timeout + 60)
+                ->dontRelease(),
+        ];
+    }
+
     public function handle(): void
     {
         $modelVersion   = (string) config('recommendations.similarity.model_version', 'sim_v1');
@@ -50,26 +72,90 @@ final class RecComputeSimilarHybridJob implements ShouldQueue
             ? (array) config('recommendations.similarity.weights_with_vector')
             : (array) config('recommendations.similarity.weights_without_vector');
 
-        $query = Artwork::query()->public()->published()->select('id', 'user_id');
-
         if ($this->artworkId !== null) {
-            $query->where('id', $this->artworkId);
+            $artwork = Artwork::query()
+                ->public()
+                ->published()
+                ->select('id', 'user_id')
+                ->find($this->artworkId);
+
+            if (! $artwork instanceof Artwork) {
+                return;
             }
 
-        $query->chunkById($this->batchSize, function ($artworks) use (
+            $this->processArtworkSafely(
+                collect([$artwork]),
+                $modelVersion,
+                $vectorEnabled,
+                $resultLimit,
+                $maxPerAuthor,
+                $minCatsTop12,
+                $weights,
+            );
+
+            return;
+        }
+
+        Artwork::query()
+            ->public()
+            ->published()
+            ->select('id', 'user_id')
+            ->chunkById($this->batchSize, function ($artworks) use (
                 $modelVersion, $vectorEnabled, $resultLimit, $maxPerAuthor, $minCatsTop12, $weights
             ) {
+                $this->processArtworkSafely(
+                    $artworks,
+                    $modelVersion,
+                    $vectorEnabled,
+                    $resultLimit,
+                    $maxPerAuthor,
+                    $minCatsTop12,
+                    $weights,
+                );
+            });
+    }
+
+    public function failed(\Throwable $exception): void
+    {
+        Log::error('[RecComputeSimilarHybrid] Job failed permanently.', [
+            'artwork_id' => $this->artworkId,
+            'batch_size' => $this->batchSize,
+            'attempts' => $this->attempts(),
+            'exception_class' => $exception::class,
+            'exception_message' => $exception->getMessage(),
+        ]);
+    }
+
+    /**
+     * @param  iterable<Artwork>  $artworks
+     */
+    private function processArtworkSafely(
+        iterable $artworks,
+        string $modelVersion,
+        bool $vectorEnabled,
+        int $resultLimit,
+        int $maxPerAuthor,
+        int $minCatsTop12,
+        array $weights,
+    ): void {
         foreach ($artworks as $artwork) {
             try {
                 $this->processArtwork(
-                        $artwork, $modelVersion, $vectorEnabled, $resultLimit,
+                    $artwork,
-                        $maxPerAuthor, $minCatsTop12, $weights
+                    $modelVersion,
+                    $vectorEnabled,
+                    $resultLimit,
+                    $maxPerAuthor,
+                    $minCatsTop12,
+                    $weights,
                 );
             } catch (\Throwable $e) {
-                    Log::warning("[RecComputeSimilarHybrid] Failed for artwork {$artwork->id}: {$e->getMessage()}");
+                Log::warning("[RecComputeSimilarHybrid] Failed for artwork {$artwork->id}: {$e->getMessage()}", [
+                    'artwork_id' => $artwork->id,
+                    'exception_class' => $e::class,
+                ]);
             }
         }
-        });
     }
 
     private function processArtwork(

app/Listeners/Academy/HandleAcademyStripeWebhook.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Listeners\Academy;
+
+use App\Services\Academy\AcademyStripeWebhookAuditService;
+use Laravel\Cashier\Events\WebhookReceived;
+
+final class HandleAcademyStripeWebhook
+{
+    public function __construct(
+        private readonly AcademyStripeWebhookAuditService $audit,
+    ) {}
+
+    public function handle(WebhookReceived $event): void
+    {
+        $this->audit->recordReceived($event->payload);
+    }
+}

app/Listeners/Academy/HandleAcademyStripeWebhookHandled.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Listeners\Academy;
+
+use App\Services\Academy\AcademyStripeWebhookAuditService;
+use Laravel\Cashier\Events\WebhookHandled;
+
+final class HandleAcademyStripeWebhookHandled
+{
+    public function __construct(
+        private readonly AcademyStripeWebhookAuditService $audit,
+    ) {}
+
+    public function handle(WebhookHandled $event): void
+    {
+        $this->audit->recordHandled($event->payload);
+    }
+}

app/Mail/AcademyAccessIssue.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Mail;
+
+use App\Models\User;
+use Illuminate\Bus\Queueable;
+use Illuminate\Mail\Mailable;
+use Illuminate\Queue\SerializesModels;
+
+final class AcademyAccessIssue extends Mailable
+{
+    use Queueable, SerializesModels;
+
+    public function __construct(
+        public readonly User $user,
+        public readonly ?string $message = null,
+        public readonly ?string $sessionId = null,
+        public readonly ?string $issueType = null,
+        public readonly ?string $contactEmail = null,
+    )
+    {
+    }
+
+    public function build(): self
+    {
+        $subject = 'Academy support request'.($this->issueType ? ' ['.$this->issueType.']' : '').' from '.$this->user->email;
+        $replyTo = trim((string) ($this->contactEmail ?: $this->user->email));
+
+        $mail = $this->subject($subject)
+            ->view('emails.academy_access_issue')
+            ->with([
+                'user' => $this->user,
+                'message' => $this->message,
+                'sessionId' => $this->sessionId,
+                'issueType' => $this->issueType,
+                'contactEmail' => $this->contactEmail,
+            ]);
+
+        if ($replyTo !== '') {
+            $mail->replyTo($replyTo);
+        }
+
+        return $mail;
+    }
+}

app/Models/AcademyBillingEvent.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+final class AcademyBillingEvent extends Model
+{
+    use HasFactory;
+
+    /**
+     * @var list<string>
+     */
+    protected $fillable = [
+        'user_id',
+        'stripe_event_id',
+        'stripe_customer_id',
+        'stripe_subscription_id',
+        'event_type',
+        'academy_tier',
+        'academy_plan',
+        'payload_summary',
+        'processed_at',
+    ];
+
+    /**
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'payload_summary' => 'array',
+            'processed_at' => 'datetime',
+        ];
+    }
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}

app/Models/AcademyContentMetricDaily.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class AcademyContentMetricDaily extends Model
+{
+    protected $table = 'academy_content_metrics_daily';
+
+    protected $fillable = [
+        'date',
+        'content_type',
+        'content_id',
+        'views',
+        'unique_visitors',
+        'guest_views',
+        'user_views',
+        'subscriber_views',
+        'engaged_views',
+        'scroll_50',
+        'scroll_75',
+        'scroll_100',
+        'likes',
+        'saves',
+        'prompt_copies',
+        'negative_prompt_copies',
+        'starts',
+        'completions',
+        'upgrade_clicks',
+        'premium_preview_views',
+        'search_impressions',
+        'search_clicks',
+        'bounce_count',
+        'avg_engaged_seconds',
+        'popularity_score',
+        'conversion_score',
+    ];
+
+    protected $casts = [
+        'date' => 'date',
+        'popularity_score' => 'decimal:2',
+        'conversion_score' => 'decimal:2',
+    ];
+}

app/Models/AcademyCourse.php

@@ -0,0 +1,170 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class AcademyCourse extends Model
+{
+    use SoftDeletes;
+
+    public const STATUS_DRAFT = 'draft';
+    public const STATUS_REVIEW = 'review';
+    public const STATUS_PUBLISHED = 'published';
+    public const STATUS_ARCHIVED = 'archived';
+
+    protected $fillable = [
+        'title',
+        'slug',
+        'subtitle',
+        'excerpt',
+        'description',
+        'cover_image',
+        'teaser_image',
+        'access_level',
+        'difficulty',
+        'status',
+        'is_featured',
+        'order_num',
+        'estimated_minutes',
+        'lessons_count_cache',
+        'published_at',
+        'seo_title',
+        'seo_description',
+        'meta_keywords',
+        'og_title',
+        'og_description',
+        'og_image',
+    ];
+
+    protected $casts = [
+        'is_featured' => 'boolean',
+        'order_num' => 'integer',
+        'estimated_minutes' => 'integer',
+        'lessons_count_cache' => 'integer',
+        'published_at' => 'datetime',
+    ];
+
+    public function scopePublished(Builder $query): Builder
+    {
+        return $query
+            ->where('status', self::STATUS_PUBLISHED)
+            ->where(function (Builder $builder): void {
+                $builder->whereNull('published_at')->orWhere('published_at', '<=', now());
+            });
+    }
+
+    public function scopeFeatured(Builder $query): Builder
+    {
+        return $query->where('is_featured', true);
+    }
+
+    public function scopeOrdered(Builder $query): Builder
+    {
+        return $query
+            ->orderByDesc('is_featured')
+            ->orderBy('order_num')
+            ->orderByDesc('published_at')
+            ->orderBy('id');
+    }
+
+    public function scopeFree(Builder $query): Builder
+    {
+        return $query->where('access_level', 'free');
+    }
+
+    public function scopePremium(Builder $query): Builder
+    {
+        return $query->where('access_level', 'premium');
+    }
+
+    public function scopeMixed(Builder $query): Builder
+    {
+        return $query->where('access_level', 'mixed');
+    }
+
+    public function sections(): HasMany
+    {
+        return $this->hasMany(AcademyCourseSection::class, 'course_id')
+            ->orderBy('order_num')
+            ->orderBy('id');
+    }
+
+    public function courseLessons(): HasMany
+    {
+        return $this->hasMany(AcademyCourseLesson::class, 'course_id')
+            ->orderBy('order_num')
+            ->orderBy('id');
+    }
+
+    public function lessons(): BelongsToMany
+    {
+        return $this->belongsToMany(AcademyLesson::class, 'academy_course_lessons', 'course_id', 'lesson_id')
+            ->using(AcademyCourseLesson::class)
+            ->withPivot(['section_id', 'order_num', 'is_required', 'access_override', 'unlock_after_lesson_id'])
+            ->withTimestamps()
+            ->orderBy('academy_course_lessons.order_num')
+            ->orderBy('academy_course_lessons.id');
+    }
+
+    public function enrollments(): HasMany
+    {
+        return $this->hasMany(AcademyCourseEnrollment::class, 'course_id');
+    }
+
+    public function isPublished(): bool
+    {
+        return (string) $this->status === self::STATUS_PUBLISHED
+            && ($this->published_at === null || $this->published_at->lte(now()));
+    }
+
+    public function isFree(): bool
+    {
+        return (string) $this->access_level === 'free';
+    }
+
+    public function isPremium(): bool
+    {
+        return (string) $this->access_level === 'premium';
+    }
+
+    public function isMixed(): bool
+    {
+        return (string) $this->access_level === 'mixed';
+    }
+
+    public function getPublicUrl(): string
+    {
+        return route('academy.courses.show', ['course' => $this->slug]);
+    }
+
+    public function getContinueUrl(?User $user): string
+    {
+        $lastLesson = $user?->academyCourseEnrollments()
+            ->where('course_id', $this->id)
+            ->with('lastLesson')
+            ->first()?->lastLesson;
+
+        if ($lastLesson instanceof AcademyLesson) {
+            return route('academy.courses.lessons.show', ['course' => $this->slug, 'lesson' => $lastLesson->slug]);
+        }
+
+        $firstLesson = $this->courseLessons()
+            ->with('lesson')
+            ->get()
+            ->map(fn (AcademyCourseLesson $courseLesson): ?AcademyLesson => $courseLesson->lesson)
+            ->first(fn (?AcademyLesson $lesson): bool => $lesson instanceof AcademyLesson);
+
+        if ($firstLesson instanceof AcademyLesson) {
+            return route('academy.courses.lessons.show', ['course' => $this->slug, 'lesson' => $firstLesson->slug]);
+        }
+
+        return $this->getPublicUrl();
+    }
+}

app/Models/AcademyCourseEnrollment.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class AcademyCourseEnrollment extends Model
+{
+    public const STATUS_ACTIVE = 'active';
+    public const STATUS_COMPLETED = 'completed';
+    public const STATUS_PAUSED = 'paused';
+
+    protected $fillable = [
+        'user_id',
+        'course_id',
+        'status',
+        'last_lesson_id',
+        'started_at',
+        'completed_at',
+    ];
+
+    protected $casts = [
+        'started_at' => 'datetime',
+        'completed_at' => 'datetime',
+    ];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'user_id');
+    }
+
+    public function course(): BelongsTo
+    {
+        return $this->belongsTo(AcademyCourse::class, 'course_id');
+    }
+
+    public function lastLesson(): BelongsTo
+    {
+        return $this->belongsTo(AcademyLesson::class, 'last_lesson_id');
+    }
+}

app/Models/AcademyCourseLesson.php

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\Pivot;
+
+class AcademyCourseLesson extends Pivot
+{
+    protected $table = 'academy_course_lessons';
+
+    public $incrementing = true;
+
+    protected $fillable = [
+        'course_id',
+        'section_id',
+        'lesson_id',
+        'order_num',
+        'is_required',
+        'access_override',
+        'unlock_after_lesson_id',
+    ];
+
+    protected $casts = [
+        'order_num' => 'integer',
+        'is_required' => 'boolean',
+    ];
+
+    public function course(): BelongsTo
+    {
+        return $this->belongsTo(AcademyCourse::class, 'course_id');
+    }
+
+    public function section(): BelongsTo
+    {
+        return $this->belongsTo(AcademyCourseSection::class, 'section_id');
+    }
+
+    public function lesson(): BelongsTo
+    {
+        return $this->belongsTo(AcademyLesson::class, 'lesson_id');
+    }
+
+    public function unlockAfterLesson(): BelongsTo
+    {
+        return $this->belongsTo(AcademyLesson::class, 'unlock_after_lesson_id');
+    }
+}

app/Models/AcademyCourseSection.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class AcademyCourseSection extends Model
+{
+    protected $fillable = [
+        'course_id',
+        'title',
+        'slug',
+        'description',
+        'order_num',
+        'is_visible',
+    ];
+
+    protected $casts = [
+        'order_num' => 'integer',
+        'is_visible' => 'boolean',
+    ];
+
+    public function course(): BelongsTo
+    {
+        return $this->belongsTo(AcademyCourse::class, 'course_id');
+    }
+
+    public function courseLessons(): HasMany
+    {
+        return $this->hasMany(AcademyCourseLesson::class, 'section_id')
+            ->orderBy('order_num')
+            ->orderBy('id');
+    }
+
+    public function lessons(): BelongsToMany
+    {
+        return $this->belongsToMany(AcademyLesson::class, 'academy_course_lessons', 'section_id', 'lesson_id')
+            ->using(AcademyCourseLesson::class)
+            ->withPivot(['course_id', 'order_num', 'is_required', 'access_override', 'unlock_after_lesson_id'])
+            ->withTimestamps()
+            ->orderBy('academy_course_lessons.order_num')
+            ->orderBy('academy_course_lessons.id');
+    }
+}

app/Models/AcademyEvent.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class AcademyEvent extends Model
+{
+    protected $fillable = [
+        'event_type',
+        'content_type',
+        'content_id',
+        'user_id',
+        'visitor_id',
+        'session_id',
+        'url',
+        'route_name',
+        'referrer',
+        'utm_source',
+        'utm_medium',
+        'utm_campaign',
+        'device_type',
+        'browser',
+        'platform',
+        'country_code',
+        'is_logged_in',
+        'is_subscriber',
+        'is_admin',
+        'is_bot',
+        'is_crawler',
+        'is_suspicious',
+        'metadata',
+        'occurred_at',
+    ];
+
+    protected $casts = [
+        'metadata' => 'array',
+        'occurred_at' => 'datetime',
+        'is_logged_in' => 'boolean',
+        'is_subscriber' => 'boolean',
+        'is_admin' => 'boolean',
+        'is_bot' => 'boolean',
+        'is_crawler' => 'boolean',
+        'is_suspicious' => 'boolean',
+    ];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'user_id');
+    }
+}

app/Models/AcademyLesson.php

@@ -6,6 +6,7 @@ namespace App\Models;
 
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\SoftDeletes;
@@ -33,12 +34,18 @@ class AcademyLesson extends Model
         'category_id',
         'title',
         'slug',
+        'lesson_number',
+        'course_order',
+        'series_name',
         'excerpt',
         'content',
+        'content_markdown',
         'difficulty',
         'access_level',
         'lesson_type',
         'cover_image',
+        'article_cover_image',
+        'tags',
         'video_url',
         'reading_minutes',
         'featured',
@@ -49,12 +56,20 @@ class AcademyLesson extends Model
     ];
 
     protected $casts = [
+        'lesson_number' => 'integer',
+        'course_order' => 'integer',
+        'tags' => 'array',
         'reading_minutes' => 'integer',
         'featured' => 'boolean',
         'active' => 'boolean',
         'published_at' => 'datetime',
     ];
 
+    protected $appends = [
+        'formatted_lesson_number',
+        'lesson_label',
+    ];
+
     public function scopeActive(Builder $query): Builder
     {
         return $query->where('active', true);
@@ -65,6 +80,17 @@ class AcademyLesson extends Model
         return $query->whereNotNull('published_at')->where('published_at', '<=', now());
     }
 
+    public function scopeOrderedForCourse(Builder $query): Builder
+    {
+        return $query
+            ->orderByRaw('case when course_order is null then 1 else 0 end')
+            ->orderBy('course_order')
+            ->orderByRaw('case when lesson_number is null then 1 else 0 end')
+            ->orderBy('lesson_number')
+            ->orderByDesc('published_at')
+            ->orderBy('id');
+    }
+
     public function category(): BelongsTo
     {
         return $this->belongsTo(AcademyCategory::class, 'category_id');
@@ -75,6 +101,23 @@ class AcademyLesson extends Model
         return $this->hasMany(AcademyLessonProgress::class, 'lesson_id');
     }
 
+    public function courseLessons(): HasMany
+    {
+        return $this->hasMany(AcademyCourseLesson::class, 'lesson_id')
+            ->orderBy('order_num')
+            ->orderBy('id');
+    }
+
+    public function courses(): BelongsToMany
+    {
+        return $this->belongsToMany(AcademyCourse::class, 'academy_course_lessons', 'lesson_id', 'course_id')
+            ->using(AcademyCourseLesson::class)
+            ->withPivot(['section_id', 'order_num', 'is_required', 'access_override', 'unlock_after_lesson_id'])
+            ->withTimestamps()
+            ->orderBy('academy_course_lessons.order_num')
+            ->orderBy('academy_course_lessons.id');
+    }
+
     public function blocks(): HasMany
     {
         return $this->hasMany(AcademyLessonBlock::class, 'lesson_id')
@@ -86,4 +129,30 @@ class AcademyLesson extends Model
     {
         return $this->blocks()->where('active', true);
     }
+
+    public function getFormattedLessonNumberAttribute(): ?string
+    {
+        if (! is_int($this->lesson_number) || $this->lesson_number < 1) {
+            return null;
+        }
+
+        return sprintf('Lesson %02d', $this->lesson_number);
+    }
+
+    public function getLessonLabelAttribute(): ?string
+    {
+        $formattedLessonNumber = $this->formatted_lesson_number;
+
+        if ($formattedLessonNumber === null) {
+            return null;
+        }
+
+        $seriesName = trim((string) ($this->series_name ?? ''));
+
+        if ($seriesName === '') {
+            return $formattedLessonNumber;
+        }
+
+        return sprintf('%s · %s', $seriesName, $formattedLessonNumber);
+    }
 }

app/Models/AcademyLessonRevision.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class AcademyLessonRevision extends Model
+{
+    protected $fillable = [
+        'lesson_id',
+        'user_id',
+        'change_note',
+        'snapshot_json',
+    ];
+
+    protected $casts = [
+        'snapshot_json' => 'array',
+    ];
+
+    public function lesson(): BelongsTo
+    {
+        return $this->belongsTo(AcademyLesson::class, 'lesson_id');
+    }
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'user_id');
+    }
+}

app/Models/AcademyLike.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class AcademyLike extends Model
+{
+    protected $fillable = [
+        'user_id',
+        'content_type',
+        'content_id',
+    ];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'user_id');
+    }
+}

app/Models/AcademyPromptTemplate.php

@@ -24,6 +24,11 @@ class AcademyPromptTemplate extends Model
         'negative_prompt',
         'usage_notes',
         'workflow_notes',
+        'documentation',
+        'placeholders',
+        'helper_prompts',
+        'prompt_variants',
+        'filled_examples',
         'difficulty',
         'access_level',
         'aspect_ratio',
@@ -41,6 +46,11 @@ class AcademyPromptTemplate extends Model
     protected $casts = [
         'tags' => 'array',
         'tool_notes' => 'array',
+        'documentation' => 'array',
+        'placeholders' => 'array',
+        'helper_prompts' => 'array',
+        'prompt_variants' => 'array',
+        'filled_examples' => 'array',
         'featured' => 'boolean',
         'prompt_of_week' => 'boolean',
         'active' => 'boolean',
@@ -67,6 +77,11 @@ class AcademyPromptTemplate extends Model
         return $this->hasMany(AcademySavedPrompt::class, 'prompt_template_id');
     }
 
+    public function metrics(): HasMany
+    {
+        return $this->hasMany(AcademyContentMetricDaily::class, 'content_id');
+    }
+
     public function packs(): BelongsToMany
     {
         return $this->belongsToMany(AcademyPromptPack::class, 'academy_prompt_pack_items', 'prompt_template_id', 'pack_id')