Filtros de dashboard

<?php

namespace App\Control\Tutor;

use App\Models\TutorDemo\TutorDemoPedido;
use App\Support\Tutor\TutorCatalog;
use App\Support\Tutor\TutorDemoSeed;
use Illuminate\Database\Eloquent\Builder;
use Mad\Dashboard\MadDashboard;

/**
 * TutorDashboardsFiltros — página "Filtros de dashboard" do catálogo.
 *
 * Estende Mad\Dashboard\MadDashboard (em vez de TutorPage): os 3 tags desta
 * página (mad-dash-filters, mad-dashboard-auto-refresh,
 * mad-dashboard-metric-compare) só funcionam de verdade sobre um host que
 * implementa MadFilterable (baseQuery/comparePeriodQuery/getAutoRefreshSec).
 * Herança simples não deixa somar com TutorPage — $catalogKey/view()
 * replicam manualmente o pequeno contrato de TutorPage (ver docblock lá).
 */
class TutorDashboardsFiltros extends MadDashboard
{
    protected string $catalogKey = 'dashboards_filtros';

    protected string $periodType = 'date-range';
    protected string $dateField  = 'dt_pedido';

    /**
     * Filtro extra AUTO-DESCOBERTO pelo Mad\Filters\MadFiltersTrait — toda
     * public string/array vira filtro automático (discoverFilterProps()),
     * aplicado em baseQuery()/comparePeriodQuery() quando a coluna existe no
     * model consultado.
     */
    public string $categoria_id = '';

    protected function onMount(array $params): void
    {
        TutorDemoSeed::ensure();
    }

    public function queryPedidos(): Builder
    {
        return $this->baseQuery(TutorDemoPedido::class);
    }

    public function comparePedidos(): Builder
    {
        return $this->comparePeriodQuery(TutorDemoPedido::class);
    }

    /** Réplica de TutorPage::catalogPage() — ver docblock daquela classe. */
    protected function catalogPage(): array
    {
        $page = TutorCatalog::page($this->catalogKey);

        if ($page === null) {
            throw new \RuntimeException(
                static::class . ': catalogKey [' . $this->catalogKey . '] não existe em TutorCatalog.'
            );
        }

        return $page;
    }

    protected function view(): string|array
    {
        return $this->catalogPage()['view'];
    }
}

<x-tutor-page page="dashboards_filtros">
    <x-tutor-demo demo="tutor.examples.dashboards-filtros.toolbar-com-kpis"
        title="Toolbar de filtros" desc="mad-dash-filters style=toolbar com período (date-range) + categoria — os KPIs abaixo reagem porque usam $that->baseQuery()." />

    <x-tutor-demo demo="tutor.examples.dashboards-filtros.chips"
        title="Estilo chips" desc="Mesmo host, mesmos filtros — só troca style=toolbar por style=chips. Os dois blocos desta página compartilham o mesmo estado." />

    <x-tutor-demo demo="tutor.examples.dashboards-filtros.comparativo-periodo"
        title="Comparativo com período anterior" desc="mad-dashboard-metric-compare calcula o delta automaticamente contra comparePeriodQuery()." />

    <x-tutor-demo demo="tutor.examples.dashboards-filtros.auto-refresh"
        title="Auto-refresh" desc="mad-dashboard-auto-refresh reexecuta as queries via MadWire a cada N segundos (mínimo 5) — o botão dispara o mesmo handler (onAtualizar) manualmente." />
</x-tutor-page>