Panduan Membuat Dashboard Statistik Laravel dengan Chart, Filter, dan Data Real-Time
Admin HijrahKreativa
Penulis
Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk
Admin HijrahKreativa
Penulis
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.
Pengurus RW ingin melihat dalam satu layar:
Dasbor seperti ini sering dibangun dengan cara yang tidak bertahan lama:
SUM atas seluruh tabel di setiap kunjungan,Hasil akhir:
| 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 |
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.
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.
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}"]);
}
}
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').// 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.
// 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.
{{-- 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').
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:
chart.js/auto, agar bundel lebih kecil.aria-label) dan tabel data untuk pembaca layar.Promise.allSettled).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.
// 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));
});
| 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 |
Keamanan
broadcastWith() hanya mengirim field yang dibutuhkan tampilan.whereIn) dan rate limit.Performa
Maintainability
FilterDasbor) yang menghasilkan rentang tanggal dan kunci cache.| 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 |
Sebelumnya
Membuat Reusable Blade Components untuk Mempercepat Pengembangan UI Laravel
Berikutnya
Cara Membuat Filter, Search, Sorting, dan Pagination yang Efisien di Laravel
Dokumen ini menjelaskan prosedur konfigurasi autentikasi SSH Key antara server Ubuntu dan GitHub untuk memungkinkan server melakukan operasi Git, seperti clone, pull, dan fetch tanpa menggunakan username dan password akun GitHub.
Peta jalan arsitektur dari satu server hingga banyak server: tahapan pertumbuhan dan sinyal kapan naik tahap, prinsip yang sebaiknya diterapkan sejak awal (stateless, asinkron, data ber-tenant), read replica, pengelolaan data yang terus tumbuh, degradasi yang anggun saat layanan bermasalah, feature...
Menyiapkan lingkungan uji yang jujur, mengukur satu endpoint dengan ApacheBench, mensimulasikan perilaku pengguna sungguhan dengan k6 (skenario, threshold, autentikasi token), menelusuri penyebab request lambat dengan Telescope, memantau server selama pengujian, serta menulis laporan hasil dan angga...
Bagaimana Octane membuat Laravel lebih cepat dengan mem-boot aplikasi sekali dan menyimpannya di memori, apa yang sebenarnya dipercepat (dan yang tidak), risiko kebocoran state antar-request yang wajib dipahami, cara memeriksa kode agar aman untuk Octane, pemasangan dengan FrankenPHP di production,...
03 Nov 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
HijrahKreativa
Kami balas secepatnya
Masuk dulu untuk chat dengan tim kami. Riwayat chat Anda tersimpan di akun.
Masuk