Layout de dashboard

<?php

namespace App\Control\Tutor;

use App\Models\TutorDemo\TutorLayoutNota;
use App\Support\Tutor\TutorPage;
use Illuminate\Support\Facades\Schema;
use Mad\Form\MadDbBlocksTrait;
use Mad\Routing\MadRoutes;

/**
 * TutorDashboardsLayout — página "Layout de dashboard" do catálogo.
 *
 * Cobre mad-dashboard (stack vertical), mad-db-blocks + mad-db-blocks-row
 * (quadro de avisos em modo "flat" — sem registro-mestre) e
 * mad-dashboard-tabs (abas lazy apontando para as telas irmãs deste mesmo
 * catálogo, via MadRoutes::urlFor — sem criar rota nova).
 */
class TutorDashboardsLayout extends TutorPage
{
    use MadDbBlocksTrait;

    protected string $catalogKey = 'dashboards_layout';

    public function mount(array $params = []): void
    {
        $this->ensureNotasFixture();
    }

    /**
     * URLs das telas irmãs do catálogo — usadas como panes lazy do exemplo de
     * <mad-dashboard-tabs>. Não cria rota nova: reaproveita as rotas
     * `tutor_dashboards_*` já expostas em routes/modules/tutor.php.
     */
    public function tabsDoCatalogo(): array
    {
        return [
            [
                'name'  => 'metricas',
                'label' => 'Métricas',
                'icon'  => 'gauge',
                'url'   => MadRoutes::urlFor('TutorDashboardsMetricas'),
            ],
            [
                'name'  => 'charts',
                'label' => 'Gráficos',
                'icon'  => 'bar-chart-3',
                'url'   => MadRoutes::urlFor('TutorDashboardsCharts'),
            ],
            [
                'name'  => 'widgets',
                'label' => 'Widgets',
                'icon'  => 'layout-grid',
                'url'   => MadRoutes::urlFor('TutorDashboardsWidgets'),
            ],
        ];
    }

    /**
     * on-add hook do <mad-db-blocks mode="flat"> — único cuidado é não
     * aceitar um aviso vazio (o form do bloco não tem `required` nativo
     * disponível fora de um <mad-form>).
     */
    public function onNotaAdd(TutorLayoutNota $pivot): bool
    {
        return trim((string) ($pivot->texto ?? '')) !== '';
    }

    /**
     * Fixture própria da página (mesmo molde de
     * App\Control\Sys\DashboardDevView::ensureFixture()) — NÃO é a fixture
     * compartilhada TutorDemoSeed, então não entra nela.
     */
    private function ensureNotasFixture(): void
    {
        $schema = Schema::connection('business');
        if (!$schema->hasTable('tutor_layout_notas')) {
            $schema->create('tutor_layout_notas', function ($t) {
                $t->increments('id');
                $t->string('texto');
                $t->string('tipo', 16)->default('info');
                $t->timestamp('created_at')->useCurrent();
            });
        }
    }
}

<x-tutor-page page="dashboards_layout">
    <x-tutor-demo demo="tutor.examples.dashboards-layout.stack-vertical"
        title="Stack vertical" desc="mad-dashboard empilha seções com gap consistente — dispensa margin-bottom manual em cada bloco." />

    <x-tutor-demo demo="tutor.examples.dashboards-layout.avisos-fixados"
        title="Quadro de avisos" desc="mad-db-blocks em modo flat (sem registro-mestre) + mad-db-blocks-row como template inline da linha — adicionar/remover sem nenhum drawer."
        php="TutorDashboardsLayout::onNotaAdd" />

    <x-tutor-demo demo="tutor.examples.dashboards-layout.abas-lazy"
        title="Abas com carga lazy" desc="mad-dashboard-tabs busca cada aba por AJAX (X-Mad-Partial) só quando o usuário clica — aqui cada aba é uma tela irmã deste catálogo." />
</x-tutor-page>