TavpHub

TavpHub adalah admin panel gratis untuk ekosistem TAVP — "Laravel Nova-nya Phalcon", tapi open source dan bebas biaya (Nova berbayar per project, TavpHub MIT). Cukup definisikan satu Resource per model, panelnya (dashboard, CRUD, filter, metrik, aksi, lensa, relasi, otorisasi) langsung jadi.

Install

composer require tavp/tavphub
tavp hub:install

hub:install akan: menambahkan dependency, membuat config/hub.php (dengan auto-discovery aktif), dan mendaftarkan route di routes/web.php (HubModule::routes($router) + ResourceRegistry::discover(...)).

TavpHub butuh tavp/core (otomatis) dan opsional tavp/tavpblocks untuk komponen UI siap pakai (StatCard, Pagination, Badge, Dropdown, SearchBar, Chart, dsb).

1. Buat Resource

Satu class = satu menu admin. Mirip Nova. Cara paling cepat — pakai generator CLI:

tavp hub:make:resource Product
tavp hub:make:resource Product --model=App\Models\Product --icon=cube

Perintah di atas membuat app/Resources/ProductResource.php (dengan columns, fields, filters, metrics, searchableColumns) dan — bila auto-discovery aktif di config/hub.php — langsung muncul di sidebar tanpa edit config.

Atau tulis manual:

use Tavp\Hub\Resource;

class UserResource extends Resource
{
    public function label(): string   { return 'Users'; }
    public function model(): string   { return 'App\\Models\\User'; }

    public function columns(): array
    {
        return [
            ['key' => 'id',         'label' => 'ID',    'sortable' => true],
            ['key' => 'name',       'label' => 'Name',  'sortable' => true],
            ['key' => 'email',      'label' => 'Email', 'sortable' => false],
            ['key' => 'created_at', 'label' => 'Joined', 'sortable' => true],
        ];
    }

    public function fields(): array
    {
        return [
            ['name' => 'name',  'type' => 'text',     'label' => 'Name',  'required' => true],
            ['name' => 'email', 'type' => 'email',    'label' => 'Email', 'required' => true],
            ['name' => 'active','type' => 'toggle',   'label' => 'Active'],
        ];
    }
}

Daftarkan lewat auto-discovery (default dari hub:install) atau manual:

// Auto-discovery: scan folder berisi Resource (sudah dijalankan di routes/web.php)
\Tavp\Hub\ResourceRegistry::discover(
    __DIR__ . '/../app/Resources',
    'App\\Resources'
);

// Atau manual satu per satu
\Tavp\Hub\ResourceRegistry::register(new UserResource());

// Atau via config('hub.resources') => ['user' => \App\Resources\UserResource::class]

Setelah terdaftar, menu muncul di sidebar dan route /admin/resource/users aktif otomatis. Tidak perlu wiring route manual.

Backwards compatible: resource bisa didaftarkan lewat ResourceRegistry, discover(), maupun config('hub.resources'). TavpHub membaca ketiganya.

2. Filters

Saring tabel index. Filter sudah bisa dipakai langsung (default: where(column, value)), subclass kalau butuh logika custom.

use Tavp\Hub\Filter;

public function filters(): array
{
    return [
        (new Filter('status'))
            ->type('select')
            ->options(['active', 'inactive', 'banned'])
            ->default('active'),

        (new Filter('created_from'))->type('date'),

        // Custom: subclass untuk range tanggal, raw SQL, dsb
        new class('premium') extends Filter {
            public function apply($query, $value): void {
                if ($value) { $query->where('plan', '!=', 'free'); }
            }
        },
    ];
}

3. Metrics (Dashboard)

Kartu angka di dashboard (dan di atas tabel resource). Mirip "Metrics"-nya Nova.

use Tavp\Hub\ValueMetric;
use Tavp\Hub\TrendMetric;

public function metrics(): array
{
    return [
        (new ValueMetric('total', 'Total Users'))
            ->aggregate('count'),

        (new ValueMetric('mrr', 'MRR'))
            ->aggregate('sum', 'revenue')
            ->suffix(' USD')
            ->compareTo(fn ($m) => /* nilai periode lalu */ 0), // munculkan delta +12%

        (new TrendMetric('signups', 'Signups'))->range('30d'),
    ];
}

compareTo() membandingkan dengan periode sebelumnya dan menampilkan badge delta hijau/merah.

4. Actions (Bulk)

Jalankan aksi massal terhadap baris terpilih (export, publish, ban, dsb).

use Tavp\Hub\Action;

public function actions(): array
{
    return [
        new class('export_csv', 'Export CSV') extends Action {
            public function handle(array $ids, string $modelClass): void {
                // $ids = id terpilih; $modelClass = model resource
            }
        },
    ];
}

Centang baris di tabel → pilih aksi di dropdown → jalan.

5. Lenses

Tampilan alternatif yang sudah difilter dari satu resource (Nova-style lenses).

use Tavp\Hub\Lens;

public function lenses(): array
{
    return [
        new class('admins', 'Admins') extends Lens {
            public function query($query): void {
                $query->where('role', 'admin');
            }
            // optional: kolom berbeda untuk lensa ini
            public function columns(): array { return [/* ... */]; }
        },
    ];
}

Akses lewat tombol switcher di atas tabel: /admin/resource/users/lens/admins.

6. Relationships

Field belongsTo otomatis jadi dropdown yang diisi dari resource terkait.

public function fields(): array
{
    return [
        ['name' => 'name', 'type' => 'text'],
        // dropdown diisi dari resource 'roles'
        ['name' => 'role_id', 'type' => 'belongsTo',
         'resource' => 'roles', 'label_column' => 'name'],
    ];
}

// Atau deklaratif lewat relations():
public function relations(): array
{
    return [
        new \Tavp\Hub\Relation('role_id', 'belongsTo', 'roles', 'name', 'role_id'),
    ];
}

7. Policies (Authorization)

Kontrol akses per ability. before() bisa short-circuit semua.

use Tavp\Hub\Policy;

class UserPolicy extends Policy
{
    public function before(mixed $user): ?bool
    {
        return $user?->isSuperAdmin() ? true : null;
    }
    public function delete(mixed $user, mixed $model): bool
    {
        return $user !== null && $user->id !== $model->id;
    }
}

// di Resource:
public function policy(): ?string { return UserPolicy::class; }

Ability yang didukung: viewAny, view, create, update, delete, restore, forceDelete.

8. Search

Aktifkan pencarian global antar kolom:

public function searchableColumns(): array
{
    return ['name', 'email'];
}

Kotak search di atas tabel akan mencari ke semua kolom tersebut (OR).

Komponen UI (tavpblocks)

TavpHub merender metrik, pagination, badge, dan alert lewat tavpblocks bila terpasang. Tanpa tavpblocks, TavpHub fallback ke HTML Tailwind biasa — panel tetap jalan.

Lisensi

MIT — gratis selamanya, boleh komersial.