Ações de linha

<?php

namespace App\Control\Tutor;

use App\Models\TutorDemo\TutorDemoPedido;
use App\Support\Tutor\TutorDemoSeed;
use Mad\Grid\MadDataGrid;
use Mad\Http\MadResponse;

/**
 * TutorGridsAcoes — ações de linha: mad-act, mad-action (alias), mad-nav,
 * mad-del, mad-action-group, mad-seek.
 *
 * NÃO estende TutorPage: <mad-grid self> exige que o HOST seja literalmente
 * uma subclasse de MadDataGrid (colunas/ações leem $model/$with/métodos
 * DESTA classe) — TutorPage estende MadComponent puro, sem esse contrato.
 * view() abaixo aponta pro MESMO caminho que o TutorCatalog usaria
 * (tutor.grids.acoes) — TutorCatalog/TutorPage.php não são tocados.
 */
class TutorGridsAcoes extends MadDataGrid
{
    protected static string $wrapper = self::INTERNAL;

    protected string $model       = TutorDemoPedido::class;
    protected array  $with        = ['cliente', 'estado'];
    protected string $defaultSort = 'id DESC';
    protected string $actionSide  = 'left';

    /** Campo do <mad-seek> do exemplo "Buscar pedido". */
    public string $pedidoBuscaId = '';

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

    // ── Ações de linha ──────────────────────────────────────────────────

    /** Novo(1)/Em separação(2) -> Enviado(3). */
    public function onAprovar(int $id): MadResponse
    {
        $pedido = TutorDemoPedido::findOrFail($id);
        $pedido->estado_id = 3;
        $pedido->save();

        return (new MadResponse())
            ->toast("Pedido #{$id} aprovado — agora está Enviado.", 'success')
            ->manageRow($id, static::class);
    }

    /** Enviado(3) -> Entregue(4). */
    public function onEntregar(int $id): MadResponse
    {
        $pedido = TutorDemoPedido::findOrFail($id);
        $pedido->estado_id = 4;
        $pedido->save();

        return (new MadResponse())
            ->toast("Pedido #{$id} marcado como Entregue.", 'success')
            ->manageRow($id, static::class);
    }

    /** Qualquer estado exceto Entregue(4)/Cancelado(5) -> Cancelado(5). */
    public function onCancelar(int $id): MadResponse
    {
        $pedido = TutorDemoPedido::findOrFail($id);
        $pedido->estado_id = 5;
        $pedido->save();

        return (new MadResponse())
            ->toast("Pedido #{$id} cancelado.", 'warning')
            ->manageRow($id, static::class);
    }

    /** Cancelado(5) -> Novo(1) — reabre o pedido (via a tag <mad-action>, alias de mad-act). */
    public function onReabrir(int $id): MadResponse
    {
        $pedido = TutorDemoPedido::findOrFail($id);
        $pedido->estado_id = 1;
        $pedido->save();

        return (new MadResponse())
            ->toast("Pedido #{$id} reaberto — voltou para Novo.", 'info')
            ->manageRow($id, static::class);
    }

    /**
     * <mad-del> exige onMadGridDelete(int $id) na subclasse (o built-in só
     * existe na MadGrid zero-PHP). Aqui a exclusão é SIMULADA de propósito:
     * os 150 pedidos da fixture são compartilhados por TODOS os visitantes
     * do Tutor (TutorDemoSeed::ensure() só re-semeia quando a tabela fica
     * vazia) — apagar de verdade a cada clique de demonstração esgotaria o
     * dataset com o tempo. removeRow() tira a linha da TELA sem tocar o
     * banco; um novo carregamento da página mostra o pedido de novo.
     */
    public function onMadGridDelete(int $id): MadResponse
    {
        return (new MadResponse())
            ->toast("Exclusão simulada — o pedido #{$id} não foi removido do banco (dado de demonstração compartilhado).", 'info')
            ->removeRow($id, static::class);
    }

    /** Display-condition de AÇÃO: recebe array (não stdClass — isso é regra de coluna). */
    public static function podeReabrir(array $row): bool
    {
        return (int) ($row['estado_id'] ?? 0) === 5;
    }

    // ── mad-seek: localizar um pedido pela descrição ─────────────────────

    public function onBuscarPedido(): MadResponse
    {
        if ($this->pedidoBuscaId === '') {
            return (new MadResponse())->toast('Selecione um pedido na busca.', 'warning');
        }

        $pedido = TutorDemoPedido::with(['cliente', 'estado'])->find($this->pedidoBuscaId);

        if (!$pedido) {
            return (new MadResponse())->toast('Pedido não encontrado.', 'danger');
        }

        $cliente = $pedido->cliente->nome ?? '—';
        $estado  = $pedido->estado->nome ?? '—';

        return (new MadResponse())->toast(
            "Pedido #{$pedido->id} — {$pedido->descricao} — cliente {$cliente} — estado {$estado}.",
            'success'
        );
    }

    protected function view(): string|array
    {
        return 'tutor.grids.acoes';
    }
}

<x-tutor-page page="grids_acoes">
    <mad-callout type="info" title="Navegação de exemplo" icon="info">
        O <code>&lt;mad-nav&gt;</code> abaixo aponta para a página <strong>Texto</strong>
        (Formulários) só pra ilustrar a navegação — o Tutor não tem uma tela de
        "detalhe do pedido" dedicada. Numa tela real o target seria o
        form/detalhe do próprio registro (ex.: <code>PedidoForm::onEdit({id})</code>).
    </mad-callout>

    <x-tutor-demo demo="tutor.examples.grids-acoes.navegar"
        title="Navegar (mad-nav)" desc="mad-nav abre outra tela — nunca mad-act pra isso." />

    <x-tutor-demo demo="tutor.examples.grids-acoes.completas"
        title="Ações completas" desc="mad-act, mad-action (alias), mad-action-group, mad-del, when-field e display-condition no mesmo grid."
        php="TutorGridsAcoes::onAprovar" />

    <x-tutor-demo demo="tutor.examples.grids-acoes.buscar"
        title="Buscar pedido (mad-seek)" desc="Campo de busca modal com múltiplas colunas — seleciona o registro e dispara uma ação."
        php="TutorGridsAcoes::onBuscarPedido" />
</x-tutor-page>