Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Dashboard Admin, CRUD & Frontend / Panduan Membuat Dashboard Stat...
Dashboard Admin, CRUD & Frontend

Panduan Membuat Dashboard Statistik Laravel dengan Chart, Filter, dan Data Real-Time

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
20 min read
22 views

Dasbor yang informatif sekaligus ringan: query agregat yang efisien, cache yang bisa diinvalidasi, endpoint JSON per grafik, Chart.js yang mengikuti tema, filter periode dan RT lewat URL, serta pembaruan langsung dengan Laravel Reverb saat ada pembayaran baru.

Overview

Pengurus RW ingin melihat dalam satu layar:

  • berapa iuran yang terkumpul bulan ini dibanding bulan lalu,
  • tren pemasukan dan pengeluaran kas 12 bulan terakhir,
  • RT mana yang paling banyak menunggak,
  • pembayaran terbaru, yang muncul tanpa perlu menekan refresh.

Dasbor seperti ini sering dibangun dengan cara yang tidak bertahan lama:

  • setiap kartu menjalankan query SUM atas seluruh tabel di setiap kunjungan,
  • data dihitung di PHP setelah memuat ribuan model,
  • angka di grafik tidak sesuai dengan angka di kartu karena logikanya ditulis dua kali,
  • filter tersimpan di session sehingga tautan dasbor tidak bisa dibagikan,
  • "real-time" diwujudkan dengan polling setiap 2 detik dari puluhan browser.

Hasil akhir:

  • service statistik terpusat dengan query agregat di database,
  • cache per kombinasi filter dengan invalidasi saat data berubah,
  • endpoint JSON per grafik dan halaman dasbor dengan Chart.js,
  • filter periode dan RT yang tersimpan di URL,
  • pembaruan langsung lewat Laravel Reverb, dengan fallback polling,
  • data yang selalu menghormati cakupan hak akses pengguna.

Prerequisites

Komponen Versi
PHP 8.3+ (disarankan 8.4)
Laravel 13.x
Database MySQL 8.0+ / PostgreSQL 15+
Cache Redis (disarankan)
Chart.js 4.x
Laravel Reverb 1.x, dengan laravel-echo dan pusher-js
Queue worker Wajib untuk broadcasting

Step-by-step Tutorial

Langkah 1: Rancang Metrik Sebelum Menulis Kode

Tulis definisi setiap metrik secara eksplisit. Ini mencegah angka yang berbeda di dua tempat.

Metrik Definisi Sumber
Iuran terkumpul SUM(iuran.jumlah) dengan dibayar_pada dalam periode iuran
Tingkat kepatuhan Keluarga lunas ÷ keluarga yang ditagih pada periode iuran
Kas masuk / keluar SUM(jumlah) transaksi berstatus disetujui, per jenis transaksi_kas
Saldo kas Total masuk − total keluar (status disetujui, sepanjang waktu) transaksi_kas
Tunggakan per RT Jumlah iuran belum dibayar dengan periode < bulan berjalan, per RT iuran + keluarga

Semua metrik dihitung dalam zona waktu Asia/Jakarta; database menyimpan UTC.

Langkah 2: Indeks untuk Query Agregat

Schema::table('iuran', function (Blueprint $table) {
    $table->index(['dibayar_pada', 'jumlah']);          // SUM per rentang tanggal (covering index)
    $table->index(['periode', 'dibayar_pada']);
});

Schema::table('transaksi_kas', function (Blueprint $table) {
    $table->index(['status', 'tanggal', 'jenis', 'jumlah']);
});

Indeks yang memuat semua kolom yang dibutuhkan query (covering index) memungkinkan database menghitung SUM tanpa membaca baris tabel.

Langkah 3: Objek Filter

Filter dibaca dari URL, divalidasi, dan menghasilkan kunci cache yang stabil.

// app/Statistik/FilterDasbor.php
namespace App\Statistik;

use Carbon\CarbonImmutable;
use Illuminate\Http\Request;

final readonly class FilterDasbor
{
    public function __construct(
        public CarbonImmutable $dari,
        public CarbonImmutable $sampai,
        public ?int $rtId,
    ) {}

    public static function fromRequest(Request $request): self
    {
        $data = $request->validate([
            'bulan' => ['nullable', 'date_format:Y-m', 'before_or_equal:'.now()->format('Y-m')],
            'rt'    => ['nullable', 'integer'],
        ]);

        $bulan = CarbonImmutable::createFromFormat('Y-m', $data['bulan'] ?? now()->format('Y-m'), 'Asia/Jakarta')->startOfMonth();

        return new self($bulan, $bulan->endOfMonth(), isset($data['rt']) ? (int) $data['rt'] : null);
    }

    public function sebelumnya(): self
    {
        $awal = $this->dari->subMonthNoOverflow()->startOfMonth();
        return new self($awal, $awal->endOfMonth(), $this->rtId);
    }

    /** Batas dalam UTC untuk query ke database */
    public function rentangUtc(): array
    {
        return [$this->dari->utc(), $this->sampai->utc()];
    }

    public function cacheKey(string $metrik, int $userScope): string
    {
        return implode(':', ['dasbor', $metrik, $this->dari->format('Y-m'), $this->rtId ?? 'semua', "u{$userScope}"]);
    }
}

Langkah 4: Service Statistik dengan Cache Berversi

Semua query statistik ada di satu class. Cache memakai nomor versi: setiap kali data berubah, versi dinaikkan, sehingga semua kunci cache lama otomatis tidak terpakai. Cara ini bekerja di semua driver cache (tidak membutuhkan cache tags).

// app/Statistik/StatistikDasbor.php
namespace App\Statistik;

use App\Models\{Iuran, Keluarga, TransaksiKas, User};
use Illuminate\Support\Facades\{Cache, DB};

final class StatistikDasbor
{
    private const TTL = 600;    // 10 menit sebagai batas atas

    public function __construct(private readonly User $user) {}

    public static function versi(): int
    {
        return (int) Cache::get('dasbor:versi', 1);
    }

    public static function invalidasi(): void
    {
        Cache::add('dasbor:versi', 1);            // pastikan kunci ada (nilai awal sama dengan default versi())
        Cache::increment('dasbor:versi');         // naikkan: semua kunci cache lama tidak terpakai lagi
    }

    private function remember(FilterDasbor $f, string $metrik, \Closure $hitung): mixed
    {
        $scope = $this->user->rukun_tetangga_id ?? 0;      // cakupan RT pengguna memengaruhi hasil
        $key = $f->cacheKey($metrik, $scope).':v'.self::versi();

        return Cache::remember($key, self::TTL, $hitung);
    }

    private function iuranQuery(FilterDasbor $f)
    {
        return Iuran::query()
            ->visibleTo($this->user)
            ->when($f->rtId, fn ($q, $rt) => $q->whereHas('keluarga', fn ($k) => $k->where('rukun_tetangga_id', $rt)));
    }

    public function ringkasan(FilterDasbor $f): array
    {
        return $this->remember($f, 'ringkasan', function () use ($f) {
            [$dari, $sampai] = $f->rentangUtc();
            [$dariLalu, $sampaiLalu] = $f->sebelumnya()->rentangUtc();

            $terkumpul = (int) $this->iuranQuery($f)->whereBetween('dibayar_pada', [$dari, $sampai])->sum('jumlah');
            $terkumpulLalu = (int) $this->iuranQuery($f)->whereBetween('dibayar_pada', [$dariLalu, $sampaiLalu])->sum('jumlah');

            $tagihan = $this->iuranQuery($f)->where('periode', $f->dari->format('Y-m'))
                ->selectRaw('COUNT(*) as total, SUM(CASE WHEN dibayar_pada IS NOT NULL THEN 1 ELSE 0 END) as lunas')
                ->toBase()->first();

            return [
                'terkumpul'      => $terkumpul,
                'terkumpul_lalu' => $terkumpulLalu,
                'kepatuhan'      => $tagihan->total ? round($tagihan->lunas / $tagihan->total * 100, 1) : null,
                'saldo'          => $this->saldo(),
            ];
        });
    }

    public function trenKas(FilterDasbor $f, int $bulan = 12): array
    {
        return $this->remember($f, "tren-kas-{$bulan}", function () use ($f, $bulan) {
            $awal = $f->dari->subMonthsNoOverflow($bulan - 1)->startOfMonth();

            $rows = TransaksiKas::query()
                ->where('status', 'disetujui')
                ->whereBetween('tanggal', [$awal->toDateString(), $f->sampai->toDateString()])
                ->selectRaw("DATE_FORMAT(tanggal, '%Y-%m') as bulan, jenis, SUM(jumlah) as total")
                ->groupBy('bulan', 'jenis')
                ->toBase()
                ->get();

            // Lengkapi bulan yang tidak punya transaksi dengan nol
            $labels = collect(range(0, $bulan - 1))->map(fn ($i) => $awal->addMonthsNoOverflow($i)->format('Y-m'));

            $nilai = fn (string $jenis) => $labels->map(fn ($b) => (int) ($rows->first(fn ($r) => $r->bulan === $b && $r->jenis === $jenis)?->total ?? 0));

            return [
                'labels' => $labels->map(fn ($b) => \Carbon\Carbon::createFromFormat('Y-m', $b)->translatedFormat('M y'))->values(),
                'masuk'  => $nilai('masuk')->values(),
                'keluar' => $nilai('keluar')->values(),
            ];
        });
    }

    public function tunggakanPerRt(FilterDasbor $f): array
    {
        return $this->remember($f, 'tunggakan-rt', function () use ($f) {
            return $this->iuranQuery($f)
                ->join('keluarga', 'keluarga.id', '=', 'iuran.keluarga_id')
                ->join('rukun_tetangga', 'rukun_tetangga.id', '=', 'keluarga.rukun_tetangga_id')
                ->whereNull('iuran.dibayar_pada')
                ->where('iuran.periode', '<=', $f->dari->format('Y-m'))
                ->groupBy('rukun_tetangga.id', 'rukun_tetangga.nomor')
                ->orderBy('rukun_tetangga.nomor')
                ->selectRaw('rukun_tetangga.nomor as rt, COUNT(*) as jumlah, SUM(iuran.jumlah) as nominal')
                ->toBase()
                ->get()
                ->map(fn ($r) => ['rt' => 'RT '.$r->rt, 'jumlah' => (int) $r->jumlah, 'nominal' => (int) $r->nominal])
                ->all();
        });
    }

    private function saldo(): int
    {
        return (int) TransaksiKas::where('status', 'disetujui')
            ->selectRaw("SUM(CASE WHEN jenis = 'masuk' THEN jumlah ELSE -jumlah END) as saldo")
            ->value('saldo');
    }
}

Catatan:

  • DATE_FORMAT khusus MySQL. Untuk PostgreSQL gunakan to_char(tanggal, 'YYYY-MM').
  • Agregasi dilakukan oleh database; PHP hanya merapikan hasil (paling banyak puluhan baris).
  • Kunci cache menyertakan cakupan pengguna. Tanpa itu, pengurus RT 001 bisa melihat angka yang dihitung untuk admin (seluruh RW).

Langkah 5: Invalidasi Saat Data Berubah

// app/Observers/StatistikObserver.php
namespace App\Observers;

use App\Statistik\StatistikDasbor;

class StatistikObserver
{
    public function saved(): void   { StatistikDasbor::invalidasi(); }
    public function deleted(): void { StatistikDasbor::invalidasi(); }
}
// app/Providers/AppServiceProvider.php
use App\Models\{Iuran, TransaksiKas};
use App\Observers\StatistikObserver;

public function boot(): void
{
    Iuran::observe(StatistikObserver::class);
    TransaksiKas::observe(StatistikObserver::class);
}

Untuk pembaruan massal yang melewati event model (misalnya impor lewat Query Builder), panggil StatistikDasbor::invalidasi() secara eksplisit setelahnya.

Langkah 6: Controller dan Endpoint JSON

// app/Http/Controllers/DasborController.php
namespace App\Http\Controllers;

use App\Models\RukunTetangga;
use App\Statistik\{FilterDasbor, StatistikDasbor};
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Gate;

class DasborController extends Controller
{
    public function index(Request $request)
    {
        Gate::authorize('kas.view');

        $filter = FilterDasbor::fromRequest($request);
        $stat = new StatistikDasbor($request->user());

        return view('dasbor.index', [
            'filter'    => $filter,
            'ringkasan' => $stat->ringkasan($filter),
            'daftarRt'  => RukunTetangga::visibleTo($request->user())->orderBy('nomor')->get(['id', 'nomor']),
        ]);
    }

    public function grafik(Request $request, string $nama)
    {
        Gate::authorize('kas.view');

        $filter = FilterDasbor::fromRequest($request);
        $stat = new StatistikDasbor($request->user());

        return response()->json(match ($nama) {
            'tren-kas'     => $stat->trenKas($filter),
            'tunggakan-rt' => $stat->tunggakanPerRt($filter),
            'ringkasan'    => $stat->ringkasan($filter),
            default        => abort(404),
        });
    }
}
// routes/web.php
Route::middleware(['auth', 'active'])->group(function () {
    Route::get('dasbor', [DasborController::class, 'index'])->name('dasbor');
    Route::get('dasbor/data/{nama}', [DasborController::class, 'grafik'])
        ->whereIn('nama', ['tren-kas', 'tunggakan-rt', 'ringkasan'])
        ->middleware('throttle:60,1')
        ->name('dasbor.data');
});

Kartu ringkasan dirender server-side (tampil langsung tanpa menunggu JavaScript), sedangkan grafik dimuat lewat endpoint terpisah agar halaman cepat terbuka.

Langkah 7: Halaman Dasbor dengan Filter di URL

{{-- resources/views/dasbor/index.blade.php --}}
<x-layouts.app title="Dasbor">
    <form method="GET" class="mb-6 flex flex-wrap items-end gap-3" x-data x-on:change="$el.requestSubmit()">
        <x-form.input type="month" name="bulan" label="Bulan" :value="$filter->dari->format('Y-m')" :max="now()->format('Y-m')" />
        <x-form.select name="rt" label="RT" :value="$filter->rtId" placeholder="Semua RT"
                       :options="$daftarRt->mapWithKeys(fn ($rt) => [$rt->id => 'RT '.$rt->nomor])" />
        <noscript><x-button type="submit">Terapkan</x-button></noscript>
    </form>

    <div id="ringkasan" class="grid gap-4 sm:grid-cols-2 xl:grid-cols-4">
        <x-statistik-kartu label="Iuran Terkumpul" format="rupiah"
                           :nilai="$ringkasan['terkumpul']" :sebelumnya="$ringkasan['terkumpul_lalu']"
                           data-metrik="terkumpul" />
        <x-statistik-kartu label="Tingkat Kepatuhan" format="persen" :nilai="$ringkasan['kepatuhan'] ?? 0" data-metrik="kepatuhan" />
        <x-statistik-kartu label="Saldo Kas" format="rupiah" :nilai="$ringkasan['saldo']" data-metrik="saldo" />
    </div>

    <div class="mt-6 grid gap-6 lg:grid-cols-3">
        <x-card class="lg:col-span-2">
            <x-slot:header><h2 class="font-semibold">Kas Masuk dan Keluar (12 bulan)</h2></x-slot:header>
            <div class="relative h-72">
                <canvas id="grafik-tren-kas" role="img" aria-label="Grafik batang kas masuk dan keluar per bulan"></canvas>
            </div>
            <details class="mt-3 text-sm">
                <summary class="cursor-pointer text-slate-500">Lihat sebagai tabel</summary>
                <div id="tabel-tren-kas" class="mt-2"></div>
            </details>
        </x-card>

        <x-card>
            <x-slot:header><h2 class="font-semibold">Tunggakan per RT</h2></x-slot:header>
            <div class="relative h-72"><canvas id="grafik-tunggakan" role="img" aria-label="Grafik tunggakan iuran per RT"></canvas></div>
        </x-card>
    </div>

    <x-card class="mt-6">
        <x-slot:header>
            <h2 class="font-semibold">Pembayaran Terbaru</h2>
            <span id="status-live" class="text-xs text-slate-500">●  Menghubungkan…</span>
        </x-slot:header>
        <ul id="pembayaran-terbaru" class="divide-y divide-slate-100 text-sm"></ul>
    </x-card>

    @push('scripts')
        @vite('resources/js/dasbor.js')
    @endpush
</x-layouts.app>

Filter memakai GET, sehingga URL seperti /dasbor?bulan=2026-09&rt=3 bisa disimpan atau dibagikan, dan tombol kembali di browser bekerja sebagaimana mestinya. Formulir dikirim otomatis saat nilai berubah, dengan tombol cadangan bila JavaScript mati.

Komponen <x-statistik-kartu> dan <x-layouts.app> berasal dari artikel Membuat Reusable Blade Components. Pastikan layout menyediakan @stack('scripts').

Langkah 8: Grafik dengan Chart.js

npm install chart.js
// resources/js/dasbor.js
import {
    Chart, BarController, BarElement, LineController, LineElement, PointElement,
    CategoryScale, LinearScale, Tooltip, Legend,
} from 'chart.js';

Chart.register(BarController, BarElement, LineController, LineElement, PointElement, CategoryScale, LinearScale, Tooltip, Legend);

const css = getComputedStyle(document.documentElement);
const warna = (nama, cadangan) => css.getPropertyValue(nama).trim() || cadangan;
const rupiah = (v) => 'Rp ' + new Intl.NumberFormat('id-ID').format(v);
const singkat = (v) => new Intl.NumberFormat('id-ID', { notation: 'compact' }).format(v);

Chart.defaults.font.family = warna('--font-sans', 'system-ui');
Chart.defaults.color = warna('--color-slate-500', '#64748b');

const query = window.location.search;          // filter ikut dikirim ke endpoint
const grafik = {};

async function ambil(nama) {
    const res = await fetch(`/dasbor/data/${nama}${query}`, { headers: { Accept: 'application/json' } });
    if (!res.ok) throw new Error(`Gagal memuat ${nama}`);
    return res.json();
}

async function trenKas() {
    const data = await ambil('tren-kas');

    grafik.tren = new Chart(document.getElementById('grafik-tren-kas'), {
        type: 'bar',
        data: {
            labels: data.labels,
            datasets: [
                { label: 'Masuk', data: data.masuk, backgroundColor: warna('--color-emerald-500', '#10b981'), borderRadius: 4 },
                { label: 'Keluar', data: data.keluar, backgroundColor: warna('--color-rose-500', '#f43f5e'), borderRadius: 4 },
            ],
        },
        options: {
            maintainAspectRatio: false,
            interaction: { mode: 'index', intersect: false },
            scales: { y: { ticks: { callback: singkat } } },
            plugins: { tooltip: { callbacks: { label: (c) => `${c.dataset.label}: ${rupiah(c.parsed.y)}` } } },
        },
    });

    // Tabel alternatif untuk aksesibilitas
    const tabel = document.getElementById('tabel-tren-kas');
    const t = document.createElement('table');
    t.className = 'w-full text-left';
    t.innerHTML = '<thead><tr><th>Bulan</th><th class="text-right">Masuk</th><th class="text-right">Keluar</th></tr></thead>';
    const tbody = t.createTBody();
    data.labels.forEach((label, i) => {
        const tr = tbody.insertRow();
        [label, rupiah(data.masuk[i]), rupiah(data.keluar[i])].forEach((teks, j) => {
            const td = tr.insertCell();
            td.textContent = teks;                 // textContent: aman dari XSS
            if (j > 0) td.className = 'text-right tabular-nums';
        });
    });
    tabel.replaceChildren(t);
}

async function tunggakan() {
    const data = await ambil('tunggakan-rt');

    grafik.tunggakan = new Chart(document.getElementById('grafik-tunggakan'), {
        type: 'bar',
        data: {
            labels: data.map((r) => r.rt),
            datasets: [{ label: 'Iuran belum dibayar', data: data.map((r) => r.jumlah), backgroundColor: warna('--color-amber-500', '#f59e0b') }],
        },
        options: {
            indexAxis: 'y',
            maintainAspectRatio: false,
            plugins: {
                legend: { display: false },
                tooltip: { callbacks: { afterLabel: (c) => `Nominal: ${rupiah(data[c.dataIndex].nominal)}` } },
            },
        },
    });
}

Promise.allSettled([trenKas(), tunggakan()]).then((hasil) => {
    hasil.filter((h) => h.status === 'rejected').forEach((h) => console.error(h.reason));
});

Hal yang perlu diperhatikan:

  • Impor komponen Chart.js yang dipakai saja (tree-shaking), bukan chart.js/auto, agar bundel lebih kecil.
  • Warna diambil dari variabel tema Tailwind sehingga grafik konsisten dengan desain, termasuk ketika tema diganti.
  • Setiap grafik punya teks alternatif (aria-label) dan tabel data untuk pembaca layar.
  • Kegagalan satu grafik tidak menghentikan grafik lain (Promise.allSettled).

Langkah 9: Pembaruan Real-Time dengan Laravel Reverb

Pasang broadcasting:

php artisan install:broadcasting --reverb

Perintah ini memasang Reverb, laravel-echo, dan pusher-js, menambah variabel REVERB_* dan VITE_REVERB_* ke .env, serta menyiapkan konfigurasi Echo di JavaScript. Pastikan:

BROADCAST_CONNECTION=reverb
QUEUE_CONNECTION=redis

Buat event yang dikirim saat iuran dibayar:

// app/Events/IuranDibayar.php
namespace App\Events;

use App\Models\Iuran;
use Illuminate\Broadcasting\{InteractsWithSockets, PrivateChannel};
use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;

class IuranDibayar implements ShouldBroadcast
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    public bool $afterCommit = true;            // kirim hanya setelah transaksi database berhasil

    public function __construct(public Iuran $iuran) {}

    public function broadcastOn(): array
    {
        $rtId = $this->iuran->keluarga->rukun_tetangga_id;

        return [
            new PrivateChannel('dasbor.rw'),             // admin, bendahara
            new PrivateChannel("dasbor.rt.{$rtId}"),     // pengurus RT terkait
        ];
    }

    public function broadcastAs(): string
    {
        return 'iuran.dibayar';
    }

    public function broadcastWith(): array
    {
        // Kirim hanya data yang perlu ditampilkan; jangan seluruh model
        return [
            'kepala_keluarga' => $this->iuran->keluarga->kepala_keluarga,
            'rt'              => $this->iuran->keluarga->rukunTetangga->nomor,
            'periode'         => $this->iuran->periode,
            'jumlah'          => $this->iuran->jumlah,
            'waktu'           => $this->iuran->dibayar_pada->timezone('Asia/Jakarta')->format('H:i'),
        ];
    }
}

Otorisasi channel:

// routes/channels.php
use App\Models\User;
use Illuminate\Support\Facades\Broadcast;

Broadcast::channel('dasbor.rw', fn (User $user) => $user->hasAnyRole(['admin', 'bendahara']));

Broadcast::channel('dasbor.rt.{rtId}', fn (User $user, int $rtId) =>
    $user->can('kas.view') && (int) $user->rukun_tetangga_id === $rtId);

Kirim event saat pembayaran dicatat:

// di service pencatatan pembayaran
DB::transaction(function () use ($iuran) {
    $iuran->update(['dibayar_pada' => now()]);
    IuranDibayar::dispatch($iuran->load('keluarga.rukunTetangga'));
});

Dengarkan di browser dan perbarui tampilan:

// resources/js/dasbor.js (lanjutan, di file yang sama sehingga ambil() dan rupiah() bisa dipakai langsung)
const ambilData = ambil;
const fmt = rupiah;

const statusEl = document.getElementById('status-live');
const daftar = document.getElementById('pembayaran-terbaru');
const kanal = document.body.dataset.kanalDasbor;               // 'dasbor.rw' atau 'dasbor.rt.3', diisi server

function tambahPembayaran(e) {
    const li = document.createElement('li');
    li.className = 'flex justify-between py-2';
    li.textContent = `${e.waktu} · ${e.kepala_keluarga} (RT ${e.rt}) · ${e.periode}`;
    const nominal = document.createElement('span');
    nominal.className = 'font-semibold tabular-nums';
    nominal.textContent = fmt(e.jumlah);
    li.append(nominal);
    daftar.prepend(li);
    while (daftar.children.length > 10) daftar.lastElementChild.remove();
}

let tundaSegarkan;
function segarkanRingkasan() {
    clearTimeout(tundaSegarkan);
    tundaSegarkan = setTimeout(async () => {                 // gabungkan banyak event menjadi satu request
        const r = await ambilData('ringkasan');
        document.querySelector('[data-metrik="terkumpul"] .text-2xl').textContent = fmt(r.terkumpul);
        document.querySelector('[data-metrik="saldo"] .text-2xl').textContent = fmt(r.saldo);
    }, 2000);
}

if (window.Echo && kanal) {
    window.Echo.private(kanal)
        .listen('.iuran.dibayar', (e) => { tambahPembayaran(e); segarkanRingkasan(); });

    const pusher = window.Echo.connector.pusher;
    pusher.connection.bind('state_change', ({ current }) => {
        statusEl.textContent = current === 'connected' ? '● Langsung' : '○ Terputus, mencoba lagi…';
    });
} else {
    // Fallback: polling setiap 60 detik bila websocket tidak tersedia
    setInterval(segarkanRingkasan, 60_000);
    statusEl.textContent = '○ Diperbarui tiap menit';
}

Isi atribut data-kanal-dasbor pada <body> dari server sesuai peran pengguna (misalnya dasbor.rw untuk admin dan dasbor.rt.{id} untuk pengurus RT). Server juga yang menentukan apakah pengguna boleh bergabung ke kanal tersebut lewat routes/channels.php.

Perhatikan prefiks titik pada .iuran.dibayar: karena event memakai broadcastAs(), nama event harus diawali titik agar Echo tidak menambahkan namespace App\Events.

Menjalankan Reverb di production:

php artisan reverb:start --host=0.0.0.0 --port=8080

Jalankan di bawah Supervisor (seperti queue worker), dan pasang reverse proxy Nginx untuk koneksi WebSocket di wss://rw.contoh.id/app/.... Konfigurasi lengkapnya ada di dokumentasi resmi Laravel Reverb.

Langkah 10: Test

// tests/Feature/Dasbor/StatistikTest.php
use App\Statistik\{FilterDasbor, StatistikDasbor};

it('menghitung iuran terkumpul sesuai rentang bulan di zona Jakarta', function () {
    $admin = User::factory()->create()->assignRole('admin');
    Iuran::factory()->create(['jumlah' => 50000, 'dibayar_pada' => '2026-09-30 18:00:00']);   // 1 Okt 01.00 WIB
    Iuran::factory()->create(['jumlah' => 30000, 'dibayar_pada' => '2026-09-15 03:00:00']);

    $filter = FilterDasbor::fromRequest(request()->merge(['bulan' => '2026-10']));
    $hasil = (new StatistikDasbor($admin))->ringkasan($filter);

    expect($hasil['terkumpul'])->toBe(50000)
        ->and($hasil['terkumpul_lalu'])->toBe(30000);
});

it('pengurus RT hanya melihat statistik RT-nya', function () {
    $rt1 = RukunTetangga::factory()->create();
    $pengurus = User::factory()->create(['rukun_tetangga_id' => $rt1->id])->assignRole('pengurus');
    Iuran::factory()->for(Keluarga::factory()->for($rt1))->create(['jumlah' => 20000, 'dibayar_pada' => now()]);
    Iuran::factory()->create(['jumlah' => 99000, 'dibayar_pada' => now()]);       // RT lain

    $this->actingAs($pengurus)->getJson('/dasbor/data/ringkasan')
        ->assertOk()
        ->assertJsonPath('terkumpul', 20000);
});

it('cache diperbarui setelah ada pembayaran baru', function () {
    $admin = User::factory()->create()->assignRole('admin');
    $this->actingAs($admin)->getJson('/dasbor/data/ringkasan')->assertJsonPath('terkumpul', 0);

    Iuran::factory()->create(['jumlah' => 25000, 'dibayar_pada' => now()]);

    $this->actingAs($admin)->getJson('/dasbor/data/ringkasan')->assertJsonPath('terkumpul', 25000);
});

it('menyiarkan event pembayaran setelah commit', function () {
    Event::fake([IuranDibayar::class]);
    $iuran = Iuran::factory()->create(['dibayar_pada' => null]);

    app(\App\Services\CatatPembayaranIuran::class)->handle($iuran);

    Event::assertDispatched(IuranDibayar::class, fn ($e) => $e->iuran->is($iuran));
});

Troubleshooting

Error / Gejala Penyebab Solusi
Angka di kartu dan grafik berbeda Logika metrik ditulis dua kali Semua metrik dari StatistikDasbor; hapus perhitungan di view/JS
Pembayaran pukul 23.30 WIB masuk ke bulan berikutnya/sebelumnya Rentang tanggal dihitung dalam UTC Bentuk rentang dalam Asia/Jakarta, konversi ke UTC sebelum query
Angka tidak berubah setelah input data Cache tidak diinvalidasi Daftarkan observer; panggil invalidasi() setelah update massal
Pengurus RT melihat angka seluruh RW Kunci cache tidak menyertakan cakupan pengguna Tambahkan cakupan ke kunci cache dan scope ke query
Grafik terus membesar / meregang Kanvas tanpa kontainer bertinggi tetap Bungkus <canvas> dengan elemen relative bertinggi tetap dan maintainAspectRatio: false
"bar" is not a registered controller Komponen Chart.js belum didaftarkan Chart.register(BarController, BarElement, ...)
Event tidak diterima di browser Queue worker atau Reverb tidak berjalan Jalankan queue:work dan reverb:start; periksa tab WS di DevTools
403 pada /broadcasting/auth Callback channel menolak atau pengguna tidak login Periksa routes/channels.php dan sesi pengguna
Listener tidak terpanggil walau event terkirim Lupa titik pada nama event dengan broadcastAs Gunakan .listen('.iuran.dibayar', ...)
Event terkirim padahal transaksi gagal Event dikirim sebelum commit Set $afterCommit = true pada event

Best Practices

Keamanan

  • Semua query statistik melewati scope cakupan pengguna, dan kunci cache menyertakan cakupan tersebut.
  • Gunakan private channel dengan otorisasi untuk data RW; jangan menyiarkan data warga lewat public channel.
  • broadcastWith() hanya mengirim field yang dibutuhkan tampilan.
  • Endpoint grafik memakai daftar nama yang diizinkan (whereIn) dan rate limit.

Performa

  • Agregasi di database dengan indeks yang sesuai; jangan memuat model untuk menghitung.
  • Cache berversi dengan TTL sebagai batas atas, invalidasi saat data berubah.
  • Render kartu di server, muat grafik secara terpisah.
  • Gabungkan banyak event real-time menjadi satu pembaruan (debounce), dan pakai polling jarang sebagai cadangan.

Maintainability

  • Definisi metrik tertulis dan diimplementasikan di satu service.
  • Filter sebagai objek bernilai (FilterDasbor) yang menghasilkan rentang tanggal dan kunci cache.
  • Warna grafik dari token tema, bukan nilai heksadesimal tersebar.
  • Test untuk batas waktu (zona waktu), cakupan pengguna, dan invalidasi cache.

Related Articles

Last Tested

Komponen Versi
Laravel 13.x
PHP 8.4
MySQL 8.4 LTS
Redis 7.x
Chart.js 4.x
Laravel Reverb 1.x
Tanggal 19 Oktober 2026

Bagikan artikel:

Artikel lainnya