Kanban

<?php

namespace App\Control\Tutor;

use App\Models\TutorDemo\TutorKanbanCard;
use App\Models\TutorDemo\TutorKanbanEstado;
use App\Support\Tutor\TutorCatalog;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Schema;
use Mad\Calendar\MadKanban;
use Mad\Http\MadResponse;

/**
 * TutorModulosKanban — página "Kanban" do MAD Lab (LOTE L9 / Onda 1).
 *
 * Estende Mad\Calendar\MadKanban diretamente (molde: app/control/Sys/
 * KanbanDevView.php) em vez de TutorPage — MadKanban já É a base do módulo,
 * então o par catalogKey/view() de TutorPage é reimplementado aqui à mão
 * (PHP não tem herança múltipla).
 *
 * Board ÚNICO na página, de propósito: MadKanban guarda model/stageModel/
 * stageField/etc como props MUTÁVEIS no host a cada `<mad-kanban>` compilado
 * (_applyInlineKanbanConfig) e persiste a config do board mais recente em
 * sessão sob a chave `mad_kb_cfg_latest.<classe>` (MadKanban.php:1560) — o
 * fallback que a ação assíncrona de drag/load-more usa quando o wire-state
 * ainda não trouxe o `kbCfgKey` do board certo. Um SEGUNDO `<mad-kanban>` no
 * mesmo host sobrescreveria esse "latest" e quebraria as ações do primeiro
 * board. Por isso as 4 tags do catálogo (mad-kanban, mad-kanban-card,
 * mad-kanban-toolbar, mad-kanban-filters) vivem juntas em UM board só —
 * ver relatório do lote para o detalhe completo.
 */
class TutorModulosKanban extends MadKanban
{
    protected static string $wrapper = self::INTERNAL;

    protected string $catalogKey = 'modulos_kanban';

    protected string $model          = 'TutorKanbanCard';
    protected string $database       = 'business';
    protected string $stageModel     = 'TutorKanbanEstado';
    protected string $stageField     = 'estado_id';
    protected string $cardOrderField = 'ordem';
    protected string $valueField     = 'valor';
    protected string $valueFormat    = 'currency:R$ :2';

    /** Filtro auto-aplicado via MadFiltersTrait (<mad-kanban-filters>) — casa com a coluna `prioridade`. */
    public string $prioridade = '';

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

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

    // ── Ações de card / coluna (mad-kanban-action / mad-kanban-stage-action) ──

    public function onAprovar(int $id): MadResponse
    {
        TutorKanbanCard::query()->whereKey($id)->update(['estado_id' => 4]);

        return (new MadResponse())
            ->toast("Card #{$id} aprovado", 'success')
            ->manageCard($id, static::class, $this);
    }

    public function onArquivar(int $id): MadResponse
    {
        TutorKanbanCard::query()->whereKey($id)->update(['estado_id' => 5]);

        return (new MadResponse())
            ->toast("Card #{$id} arquivado", 'warning')
            ->manageCard($id, static::class, $this);
    }

    public function onNovoCard(string $id): MadResponse
    {
        $card = TutorKanbanCard::query()->create([
            'titulo'      => 'Novo card',
            'estado_id'   => (int) $id,
            'ordem'       => 999,
            'valor'       => 0,
            'cliente'     => '—',
            'prioridade'  => 'media',
            'dt_prevista' => date('Y-m-d', strtotime('+7 days')),
        ]);

        return (new MadResponse())
            ->toast("Card #{$card->id} criado", 'success')
            ->manageCard((int) $card->id, static::class, $this);
    }

    // ── Fixture (molde: KanbanDevView::ensureFixture) ───────────────────────

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

        if (!$schema->hasTable('tutor_kanban_estados')) {
            $schema->create('tutor_kanban_estados', function ($t) {
                $t->increments('id');
                $t->string('nome');
                $t->string('cor', 16);
                $t->integer('ordem');
            });
        }
        if (!$schema->hasTable('tutor_kanban_cards')) {
            $schema->create('tutor_kanban_cards', function ($t) {
                $t->increments('id');
                $t->string('titulo');
                $t->integer('estado_id');
                $t->integer('ordem');
                $t->decimal('valor', 12, 2)->default(0);
                $t->string('cliente')->nullable();
                $t->string('prioridade', 16)->default('media');
                $t->string('dt_prevista', 10)->nullable();
            });
        }

        if (TutorKanbanEstado::query()->count() > 0) {
            return;
        }

        mt_srand(9001);

        DB::connection('business')->table('tutor_kanban_estados')->insert([
            ['id' => 1, 'nome' => 'Backlog',      'cor' => '#64748b', 'ordem' => 1],
            ['id' => 2, 'nome' => 'Em andamento', 'cor' => '#f59e0b', 'ordem' => 2],
            ['id' => 3, 'nome' => 'Revisão',      'cor' => '#8b5cf6', 'ordem' => 3],
            ['id' => 4, 'nome' => 'Concluído',    'cor' => '#16a34a', 'ordem' => 4],
            ['id' => 5, 'nome' => 'Arquivado',    'cor' => '#ef4444', 'ordem' => 5],
        ]);

        $clientes    = ['Ana Souza', 'Bruno Lima', 'Carla Dias', 'Diego Alves', 'Elaine Melo', 'Fábio Rocha'];
        $prioridades = ['baixa', 'media', 'alta'];
        $porEstado   = [1 => 7, 2 => 4, 3 => 3, 4 => 5, 5 => 0];

        $rows  = [];
        $count = 0;
        foreach ($porEstado as $estadoId => $qtd) {
            for ($i = 1; $i <= $qtd; $i++) {
                $count++;
                $rows[] = [
                    'titulo'      => "Tarefa {$count}",
                    'estado_id'   => $estadoId,
                    'ordem'       => $i,
                    'valor'       => round(mt_rand(500, 8000) / 10, 2),
                    'cliente'     => $clientes[$count % count($clientes)],
                    'prioridade'  => $prioridades[$count % count($prioridades)],
                    'dt_prevista' => date('Y-m-d', strtotime('+' . mt_rand(1, 20) . ' days')),
                ];
            }
        }
        DB::connection('business')->table('tutor_kanban_cards')->insert($rows);
    }
}

<x-tutor-page page="modulos_kanban">
    <x-tutor-demo demo="tutor.examples.modulos-kanban.board"
        title="Board completo" desc="mad-kanban com filtros, toolbar, cards ricos (badges/meta/rodapé) e ações de card/coluna — mad-kanban-filters, mad-kanban-toolbar e mad-kanban-card juntos no mesmo board (ver nota de instância única no código-fonte do controller)." />
</x-tutor-page>