Métricas

<?php

namespace App\Control\Tutor;

use App\Models\TutorDemo\TutorDemoPedido;
use App\Support\Tutor\TutorDemoSeed;
use App\Support\Tutor\TutorPage;

/**
 * TutorDashboardsMetricas — página "Métricas" do catálogo.
 *
 * mad-stat-grid + mad-db-metric-card não precisam de PHP (auto-query). Os
 * métodos abaixo só existem para os exemplos que precisam de um valor
 * CALCULADO (mad-metric-card, mad-kpi-card) — nunca @php com query Eloquent
 * direto no blade (R038/universal.md).
 */
class TutorDashboardsMetricas extends TutorPage
{
    protected string $catalogKey = 'dashboards_metricas';

    public function mount(array $params = []): void
    {
        TutorDemoSeed::ensure();
    }

    public function ticketMedio(): string
    {
        $media = (float) (TutorDemoPedido::query()->avg('valor_total') ?? 0);

        return 'R$ ' . number_format($media, 2, ',', '.');
    }

    public function receitaTotalFormatada(): string
    {
        $total = (float) (TutorDemoPedido::query()->sum('valor_total') ?? 0);

        return 'R$ ' . number_format($total, 2, ',', '.');
    }

    public function taxaEntregaPercentual(): float
    {
        $total = TutorDemoPedido::query()->count();
        if ($total === 0) {
            return 0.0;
        }

        $entregues = TutorDemoPedido::query()
            ->join('tutor_estados_pedido as te', 'te.id', '=', 'tutor_pedidos.estado_id')
            ->where('te.nome', '=', 'Entregue')
            ->count();

        return round(($entregues / $total) * 100, 1);
    }

    /** Receita agrupada por mês (Y-m) — série curta pro sparkline do mad-kpi-card. */
    public function receitaMensal(): array
    {
        return TutorDemoPedido::query()
            ->orderBy('dt_pedido')
            ->get(['dt_pedido', 'valor_total'])
            ->groupBy(fn ($p) => substr((string) $p->dt_pedido, 0, 7))
            ->map(fn ($grupo) => (float) $grupo->sum('valor_total'))
            ->values()
            ->all();
    }
}

<x-tutor-page page="dashboards_metricas">
    <x-tutor-demo demo="tutor.examples.dashboards-metricas.grid-kpis-db"
        title="Grid de KPIs (auto-query)" desc="mad-stat-grid organizando mad-db-metric-card — cada card faz a própria agregação, zero PHP." />

    <x-tutor-demo demo="tutor.examples.dashboards-metricas.metric-card-manual"
        title="Valor calculado em PHP" desc="mad-metric-card quando o número não é uma agregação simples de 1 tabela — o cálculo mora num método público do controller."
        php="TutorDashboardsMetricas::ticketMedio" />

    <x-tutor-demo demo="tutor.examples.dashboards-metricas.kpi-strip"
        title="Faixa de KPIs estilo BI" desc="mad-kpi-strip + mad-kpi-card: valor grande, pill de variação, sparkline SVG e barra de progresso — tudo sem JS."
        php="TutorDashboardsMetricas::receitaMensal" />

    <x-tutor-demo demo="tutor.examples.dashboards-metricas.progress"
        title="Barra de progresso" desc="mad-progress em variantes e tamanhos — indicador simples de meta/percentual." />
</x-tutor-page>