Planilha (sheet)

<?php

namespace App\Control\Tutor;

use App\Models\TutorDemo\TutorDemoSheetCategoria;
use App\Models\TutorDemo\TutorDemoSheetProduto;
use Illuminate\Support\Facades\Schema;
use Mad\Sheet\MadSheet;

/**
 * TutorModulosSheet — página "Planilha (sheet)" do MAD Lab (catálogo
 * modulos_sheet). Cobre: mad-sheet, mad-sheet-col.
 *
 * O demo pequeno (cascade.blade.php) NÃO reabre `$that` — cai num
 * MadSheetStandalone novo por request (zero PHP, igual ao example_basic do
 * mad_props). O demo grande (lote-completo.blade.php) reabre `$that` via
 * MadRenderContext::getComponent() pra usar o HOST de verdade (esta classe),
 * já que o hook `beforeSaveRow` só existe em subclasse. Diferente do
 * mad-org-chart, o MadSheet NÃO cacheia dados carregados por instância (é
 * entry-first — nasce vazio), então múltiplos <mad-sheet> no mesmo host não
 * têm o bug de "roots desatualizados"; mesmo assim só o ÚLTIMO tag
 * renderizado fica com o `shCfgKey` válido pro round-trip do wire (Salvar/
 * Validar) — por isso o demo grande é sempre o último da página.
 */
class TutorModulosSheet extends MadSheet
{
    protected static string $wrapper = self::INTERNAL;

    protected string $model    = 'TutorDemoSheetLancamento';
    protected string $database = 'business';

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

    /**
     * `compute` é display-only (nunca persiste) — recalcula o total no
     * servidor antes de gravar. Contrato: SheetDevView::enrichComputedTotal.
     */
    protected function beforeSaveRow(array $row, int $index): array
    {
        $row['total'] = round(((float) ($row['quantidade'] ?? 0)) * ((float) ($row['valor'] ?? 0)), 2);

        return $row;
    }

    /**
     * Quick register do combo de produto (MadQuickRegisterService), chamado
     * pelo <mad-quick-form action="TutorModulosSheet::onQuickAddProduto">
     * dentro da coluna produto_id. Recebe {term, fields, field_name}; retorna
     * {value, label[, toast]}.
     */
    public static function onQuickAddProduto(array $params = []): array
    {
        $nome = trim((string) ($params['fields']['nome'] ?? $params['term'] ?? ''));
        if ($nome === '') {
            throw new \RuntimeException('Informe o nome do produto.');
        }

        $categoriaId = (int) ($params['fields']['categoria_id'] ?? 1);
        $produto     = TutorDemoSheetProduto::query()->create([
            'nome'         => $nome,
            'categoria_id' => $categoriaId > 0 ? $categoriaId : 1,
        ]);

        return ['value' => (string) $produto->id, 'label' => $nome, 'toast' => 'Produto cadastrado.'];
    }

    // ── Fixture ──────────────────────────────────────────────────────────

    private function ensureFixture(): void
    {
        $schema = Schema::connection('business');

        if (!$schema->hasTable('tutor_sheet_categorias')) {
            $schema->create('tutor_sheet_categorias', function ($t) {
                $t->increments('id');
                $t->string('nome');
            });
        }
        if (!$schema->hasTable('tutor_sheet_produtos')) {
            $schema->create('tutor_sheet_produtos', function ($t) {
                $t->increments('id');
                $t->string('nome');
                $t->integer('categoria_id')->default(0);
            });
        }
        if (!$schema->hasTable('tutor_sheet_lancamentos')) {
            $schema->create('tutor_sheet_lancamentos', function ($t) {
                $t->increments('id');
                $t->integer('categoria_id')->default(0);
                $t->integer('produto_id')->default(0);
                $t->decimal('quantidade', 12, 2)->default(0);
                $t->decimal('valor', 12, 2)->default(0);
                $t->decimal('total', 14, 2)->default(0);
                $t->string('data', 10)->nullable();
                $t->string('obs')->nullable();
            });
        }

        if (TutorDemoSheetCategoria::query()->count() === 0) {
            TutorDemoSheetCategoria::query()->insert([
                ['id' => 1, 'nome' => 'Bebidas'],
                ['id' => 2, 'nome' => 'Limpeza'],
            ]);
        }
        if (TutorDemoSheetProduto::query()->count() === 0) {
            TutorDemoSheetProduto::query()->insert([
                ['id' => 1, 'nome' => 'Água mineral 500ml', 'categoria_id' => 1],
                ['id' => 2, 'nome' => 'Suco de laranja 1L',  'categoria_id' => 1],
                ['id' => 3, 'nome' => 'Detergente neutro',   'categoria_id' => 2],
                ['id' => 4, 'nome' => 'Água sanitária 1L',   'categoria_id' => 2],
            ]);
        }
    }

    protected function view(): string|array
    {
        return ['tutor.modulos.sheet', []];
    }
}

<x-tutor-page page="modulos_sheet">
    <x-tutor-demo demo="tutor.examples.modulos-sheet.cascade"
        title="Combo com cascade e busca" desc="mad-sheet zero PHP: categoria filtra produto por linha (depends-on + search)." />

    <x-tutor-demo demo="tutor.examples.modulos-sheet.lote-completo"
        title="Lote completo (combo, número, moeda, data, calculado)" desc="Todos os tipos de mad-sheet-col + quick register na célula + total persistido via beforeSaveRow."
        php="TutorModulosSheet::beforeSaveRow" />
</x-tutor-page>