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

Blog / Dashboard Admin, CRUD & Frontend / Cara Membuat Sistem Notifikasi...
Dashboard Admin, CRUD & Frontend

Cara Membuat Sistem Notifikasi Laravel untuk Admin dan Pengguna

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
16 min read
15 views

Sistem notifikasi lengkap dengan Laravel Notifications: notifikasi di aplikasi (lonceng dengan jumlah belum dibaca), email, dan real-time lewat Reverb; preferensi saluran per pengguna; pengiriman ke kelompok berdasarkan izin; pengingat terjadwal; pencegahan spam; serta pembersihan data lama.

Overview

Di aplikasi RW, banyak kejadian yang perlu diketahui orang yang tepat pada waktu yang tepat:

Kejadian Penerima Saluran
Pengeluaran kas menunggu persetujuan Semua pengurus yang berhak menyetujui Aplikasi, real-time, email
Pengeluaran disetujui / ditolak Bendahara yang mencatat Aplikasi, email
Iuran bulan ini jatuh tempo Warga yang belum membayar Email (pengingat terjadwal)
Pembayaran iuran diterima Warga yang membayar Aplikasi, email
Pengumuman baru Semua warga Aplikasi

Masalah yang sering muncul saat membangunnya:

  • email dikirim langsung di dalam request, sehingga simpan data terasa lambat atau gagal bila SMTP bermasalah,
  • notifikasi terkirim padahal transaksi database gagal dan dibatalkan,
  • pengurus menerima puluhan email untuk hal yang sama,
  • pengguna tidak bisa mematikan email tertentu,
  • tabel notifikasi tumbuh tanpa batas,
  • endpoint "tandai dibaca" bisa dipakai untuk menandai notifikasi milik orang lain.

Hasil akhir:

  • tabel dan model notifikasi bawaan Laravel,
  • kelas notifikasi dengan saluran database, mail, dan broadcast, berjalan di queue setelah commit,
  • preferensi saluran per pengguna,
  • pengiriman ke kelompok berdasarkan permission,
  • lonceng notifikasi dengan jumlah belum dibaca, tandai dibaca, dan pembaruan real-time,
  • pengingat iuran terjadwal dengan pencegahan duplikat,
  • pembersihan notifikasi lama dan test.

Prerequisites

Komponen Versi
PHP 8.3+ (disarankan 8.4)
Laravel 13.x
Database MySQL 8.0+ / PostgreSQL 15+
Queue Redis atau database, worker berjalan
Mail SMTP / layanan email transaksional
Laravel Reverb 1.x (untuk real-time, opsional)
spatie/laravel-permission ^8.0 (untuk pengiriman berdasarkan izin)
Alpine.js 3.x

Step-by-step Tutorial

Langkah 1: Tabel Notifikasi

php artisan make:notifications-table
php artisan migrate

Tabel notifications menyimpan type, notifiable_type, notifiable_id, data (JSON), read_at, dan timestamp. Model User bawaan sudah memakai trait Notifiable, yang menyediakan relasi notifications, unreadNotifications, dan method notify().

Tambahkan indeks untuk query lonceng (belum dibaca per pengguna, terbaru):

Schema::table('notifications', function (Blueprint $table) {
    $table->index(['notifiable_type', 'notifiable_id', 'read_at', 'created_at'], 'notif_pengguna_idx');
});

Langkah 2: Preferensi Saluran Pengguna

Schema::create('preferensi_notifikasi', function (Blueprint $table) {
    $table->id();
    $table->foreignId('user_id')->constrained()->cascadeOnDelete();
    $table->string('jenis', 50);             // kas.menunggu, iuran.pengingat, ...
    $table->boolean('email')->default(true);
    $table->boolean('aplikasi')->default(true);
    $table->timestamps();

    $table->unique(['user_id', 'jenis']);
});
// app/Models/User.php
public function preferensiNotifikasi(): HasMany
{
    return $this->hasMany(PreferensiNotifikasi::class);
}

/** Saluran yang diizinkan pengguna untuk jenis notifikasi tertentu */
public function saluranUntuk(string $jenis, array $bawaan): array
{
    $pref = $this->relationLoaded('preferensiNotifikasi')
        ? $this->preferensiNotifikasi->firstWhere('jenis', $jenis)
        : $this->preferensiNotifikasi()->where('jenis', $jenis)->first();

    if (! $pref) {
        return $bawaan;
    }

    return array_values(array_filter($bawaan, fn ($s) => match ($s) {
        'mail'                  => $pref->email,
        'database', 'broadcast' => $pref->aplikasi,
        default                 => true,
    }));
}

Langkah 3: Kelas Notifikasi

php artisan make:notification PengeluaranMenungguPersetujuan
// app/Notifications/PengeluaranMenungguPersetujuan.php
namespace App\Notifications;

use App\Models\TransaksiKas;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Notifications\Messages\{BroadcastMessage, MailMessage};
use Illuminate\Notifications\Notification;

class PengeluaranMenungguPersetujuan extends Notification implements ShouldQueue
{
    use Queueable;

    public const JENIS = 'kas.menunggu';

    public function __construct(public TransaksiKas $transaksi)
    {
        $this->afterCommit();                    // kirim hanya setelah transaksi DB berhasil
        $this->onQueue('notifikasi');
    }

    public function via(object $notifiable): array
    {
        return $notifiable->saluranUntuk(self::JENIS, ['database', 'broadcast', 'mail']);
    }

    /** Jangan kirim bila kondisi sudah tidak relevan saat job dijalankan */
    public function shouldSend(object $notifiable, string $channel): bool
    {
        return $this->transaksi->fresh()?->status === 'menunggu';
    }

    public function toArray(object $notifiable): array
    {
        return [
            'jenis'   => self::JENIS,
            'judul'   => 'Pengeluaran menunggu persetujuan',
            'pesan'   => sprintf('%s ยท Rp %s', $this->transaksi->keterangan, number_format($this->transaksi->jumlah, 0, ',', '.')),
            'url'     => route('kas.show', $this->transaksi, absolute: false),
            'ikon'    => 'hourglass',
            'subjek'  => ['tipe' => 'transaksi_kas', 'id' => $this->transaksi->id],
        ];
    }

    public function toBroadcast(object $notifiable): BroadcastMessage
    {
        return new BroadcastMessage($this->toArray($notifiable));
    }

    public function toMail(object $notifiable): MailMessage
    {
        return (new MailMessage)
            ->subject('Pengeluaran kas menunggu persetujuan Anda')
            ->greeting('Halo '.$notifiable->name.',')
            ->line('Ada pengeluaran kas yang menunggu persetujuan:')
            ->line('**'.e($this->transaksi->keterangan).'** sebesar Rp '.number_format($this->transaksi->jumlah, 0, ',', '.'))
            ->action('Tinjau Transaksi', route('kas.show', $this->transaksi))
            ->line('Pengeluaran di atas batas tertentu wajib disetujui pengurus.');
    }

    public function databaseType(object $notifiable): string
    {
        return self::JENIS;                      // kolom `type` berisi kode pendek, bukan nama class
    }
}

Hal penting:

  • ShouldQueue: email dan broadcast dikirim oleh worker, bukan di dalam request.
  • afterCommit(): bila transaksi database dibatalkan, notifikasi tidak terkirim.
  • shouldSend(): notifikasi yang terlambat diproses (misalnya transaksi sudah disetujui orang lain) tidak dikirim.
  • toArray() menyimpan data ringkas yang cukup untuk ditampilkan, termasuk URL relatif. Jangan menyimpan seluruh model; data di tabel notifikasi tidak ikut berubah ketika model berubah.
  • databaseType() membuat kolom type stabil walaupun class dipindah atau diganti nama.
  • e() di email meng-escape teks dari pengguna yang dimasukkan ke markdown email.

Langkah 4: Kirim ke Kelompok Berdasarkan Izin

// app/Services/AjukanPengeluaran.php
use Illuminate\Support\Facades\{DB, Notification};

public function handle(TransaksiKas $trx): void
{
    DB::transaction(function () use ($trx) {
        $trx->update(['status' => 'menunggu']);

        $penyetuju = User::permission('kas.approve')        // scope dari spatie/laravel-permission
            ->where('is_active', true)
            ->whereKeyNot($trx->dicatat_oleh)                // pencatat tidak perlu diberi tahu
            ->with('preferensiNotifikasi')
            ->get();

        Notification::send($penyetuju, new PengeluaranMenungguPersetujuan($trx));
    });
}

User::permission('kas.approve') mengambil pengguna yang memiliki izin tersebut lewat role maupun langsung. Pengguna dengan akses lewat Gate::before (super admin) tidak termasuk; tambahkan secara eksplisit bila perlu.

Notifikasi untuk satu orang:

$trx->pencatat->notify(new PengeluaranDiputuskan($trx, disetujui: true));

Langkah 5: Endpoint Lonceng Notifikasi

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

use Illuminate\Http\Request;

class NotifikasiController extends Controller
{
    public function index(Request $request)
    {
        $user = $request->user();

        return response()->json([
            'belum_dibaca' => $user->unreadNotifications()->count(),
            'data' => $user->notifications()
                ->latest()
                ->limit(15)
                ->get(['id', 'data', 'read_at', 'created_at'])
                ->map(fn ($n) => [
                    'id'      => $n->id,
                    'judul'   => $n->data['judul'] ?? '',
                    'pesan'   => $n->data['pesan'] ?? '',
                    'url'     => $n->data['url'] ?? null,
                    'dibaca'  => $n->read_at !== null,
                    'waktu'   => $n->created_at->diffForHumans(),
                ]),
        ]);
    }

    public function baca(Request $request, string $id)
    {
        // Cari HANYA di notifikasi milik pengguna yang login
        $notif = $request->user()->notifications()->whereKey($id)->firstOrFail();
        $notif->markAsRead();

        $url = $notif->data['url'] ?? '/';

        // Hanya izinkan URL internal untuk mencegah open redirect
        return redirect()->to(str_starts_with($url, '/') && ! str_starts_with($url, '//') ? $url : '/');
    }

    public function semua(Request $request)
    {
        return view('notifikasi.index', [
            'notifikasi' => $request->user()->notifications()->latest()->paginate(20),
        ]);
    }

    public function bacaSemua(Request $request)
    {
        $request->user()->unreadNotifications()->update(['read_at' => now()]);

        return response()->noContent();
    }
}
// routes/web.php
Route::middleware(['auth', 'active'])->prefix('notifikasi')->name('notifikasi.')->group(function () {
    Route::get('/', [NotifikasiController::class, 'index'])->name('index');            // JSON untuk lonceng
    Route::get('semua', [NotifikasiController::class, 'semua'])->name('semua');        // halaman daftar lengkap
    Route::post('{id}/baca', [NotifikasiController::class, 'baca'])->whereUuid('id')->name('baca');
    Route::post('baca-semua', [NotifikasiController::class, 'bacaSemua'])->name('baca-semua');
});

Dua pengaman penting:

  • $request->user()->notifications()->whereKey($id) memastikan pengguna hanya bisa mengakses notifikasinya sendiri. DatabaseNotification::find($id) tanpa batasan pemilik adalah celah IDOR.
  • URL tujuan divalidasi sebagai path internal sebelum redirect.

Aksi "tandai dibaca" memakai POST karena mengubah data.

Langkah 6: Komponen Lonceng dengan Alpine dan Real-Time

// resources/js/components/lonceng-notifikasi.js
export default ({ userId }) => ({
    buka: false,
    belumDibaca: 0,
    daftar: [],
    dimuat: false,

    async init() {
        await this.muat();

        // Real-time lewat Reverb bila tersedia (lihat artikel Dashboard Statistik untuk setup)
        if (window.Echo) {
            window.Echo.private(`App.Models.User.${userId}`).notification((n) => {
                this.belumDibaca++;
                this.daftar.unshift({ id: n.id, judul: n.judul, pesan: n.pesan, url: n.url, dibaca: false, waktu: 'baru saja' });
                this.daftar = this.daftar.slice(0, 15);
            });
        } else {
            setInterval(() => this.muat(), 120_000);       // cadangan: polling tiap 2 menit
        }
    },

    async muat() {
        const res = await fetch('/notifikasi', { headers: { Accept: 'application/json' } });
        if (!res.ok) return;
        const data = await res.json();
        this.belumDibaca = data.belum_dibaca;
        this.daftar = data.data;
        this.dimuat = true;
    },

    async bacaSemua() {
        await fetch('/notifikasi/baca-semua', {
            method: 'POST',
            headers: { 'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content, Accept: 'application/json' },
        });
        this.daftar.forEach((n) => (n.dibaca = true));
        this.belumDibaca = 0;
    },
});
{{-- resources/views/components/lonceng-notifikasi.blade.php --}}
<div x-data="loncengNotifikasi(@js(['userId' => auth()->id()]))" class="relative" x-on:keydown.escape="buka = false">
    <button type="button" x-on:click="buka = !buka" class="relative rounded-full p-2 hover:bg-slate-100"
            :aria-expanded="buka" aria-haspopup="true"
            :aria-label="belumDibaca ? `Notifikasi, ${belumDibaca} belum dibaca` : 'Notifikasi'">
        <x-icon.bell class="size-6" />
        <span x-show="belumDibaca > 0" x-cloak x-text="belumDibaca > 99 ? '99+' : belumDibaca"
              class="absolute -right-0.5 -top-0.5 min-w-5 rounded-full bg-red-600 px-1 text-center text-xs font-bold text-white"></span>
    </button>

    <div x-show="buka" x-cloak x-transition x-on:click.outside="buka = false"
         class="absolute right-0 z-40 mt-2 w-80 overflow-hidden rounded-card bg-white shadow-xl ring-1 ring-black/5">
        <div class="flex items-center justify-between border-b px-4 py-3">
            <span class="font-semibold">Notifikasi</span>
            <button type="button" x-show="belumDibaca > 0" x-on:click="bacaSemua" class="text-sm text-brand-600">Tandai semua dibaca</button>
        </div>

        <ul class="max-h-96 divide-y overflow-y-auto">
            <template x-for="n in daftar" :key="n.id">
                <li>
                    <form method="POST" :action="`/notifikasi/${n.id}/baca`">
                        @csrf
                        <button type="submit" class="block w-full px-4 py-3 text-left hover:bg-slate-50"
                                :class="!n.dibaca && 'bg-brand-50/60'">
                            <p class="text-sm font-medium" x-text="n.judul"></p>
                            <p class="text-sm text-slate-600" x-text="n.pesan"></p>
                            <p class="mt-1 text-xs text-slate-400" x-text="n.waktu"></p>
                        </button>
                    </form>
                </li>
            </template>
            <li x-show="dimuat && daftar.length === 0" class="px-4 py-8 text-center text-sm text-slate-500">Belum ada notifikasi.</li>
        </ul>

        <a href="{{ route('notifikasi.semua') }}" class="block border-t px-4 py-2 text-center text-sm text-brand-600">Lihat semua</a>
    </div>
</div>

Semua teks ditampilkan dengan x-text, sehingga isi notifikasi tidak bisa menyisipkan HTML. Kanal privat App.Models.User.{id} sudah diotorisasi di routes/channels.php bawaan Laravel saat broadcasting dipasang.

Langkah 7: Halaman Preferensi

// app/Http/Controllers/PreferensiNotifikasiController.php
private const JENIS = [
    'kas.menunggu'     => 'Pengeluaran menunggu persetujuan',
    'kas.diputuskan'   => 'Keputusan atas pengeluaran yang saya catat',
    'iuran.pengingat'  => 'Pengingat iuran jatuh tempo',
    'iuran.diterima'   => 'Konfirmasi pembayaran iuran',
    'pengumuman.baru'  => 'Pengumuman baru',
];

public function edit(Request $request)
{
    return view('profil.notifikasi', [
        'jenis' => self::JENIS,
        'pref'  => $request->user()->preferensiNotifikasi->keyBy('jenis'),
    ]);
}

public function update(Request $request)
{
    $data = $request->validate([
        'pref'              => ['array'],
        'pref.*.email'      => ['boolean'],
        'pref.*.aplikasi'   => ['boolean'],
    ]);

    foreach (self::JENIS as $kode => $label) {
        $request->user()->preferensiNotifikasi()->updateOrCreate(
            ['jenis' => $kode],
            [
                'email'    => (bool) ($data['pref'][$kode]['email'] ?? false),
                'aplikasi' => (bool) ($data['pref'][$kode]['aplikasi'] ?? false),
            ],
        );
    }

    return back()->with('status', 'Preferensi notifikasi disimpan.');
}

Hanya kode jenis yang dikenal (self::JENIS) yang disimpan; kunci lain dari input diabaikan. Untuk notifikasi yang wajib (misalnya keamanan akun), jangan tampilkan opsi mematikannya.

Langkah 8: Pengingat Terjadwal Tanpa Duplikat

// app/Console/Commands/KirimPengingatIuran.php
namespace App\Console\Commands;

use App\Models\Iuran;
use App\Notifications\PengingatIuran;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\Cache;

class KirimPengingatIuran extends Command
{
    protected $signature = 'iuran:kirim-pengingat';
    protected $description = 'Mengirim pengingat iuran yang belum dibayar';

    public function handle(): int
    {
        $periode = now('Asia/Jakarta')->format('Y-m');
        $terkirim = 0;

        Iuran::query()
            ->where('periode', $periode)
            ->whereNull('dibayar_pada')
            ->with('keluarga.anggotaPenerimaNotifikasi.preferensiNotifikasi')
            ->lazyById(200)
            ->each(function (Iuran $iuran) use ($periode, &$terkirim) {
                // Kunci idempoten: satu pengingat per keluarga per periode per minggu
                $kunci = "pengingat:{$iuran->keluarga_id}:{$periode}:".now()->isoWeek();

                if (! Cache::add($kunci, true, now()->addDays(8))) {
                    return;                                   // sudah dikirim minggu ini
                }

                foreach ($iuran->keluarga->anggotaPenerimaNotifikasi as $user) {
                    $user->notify(new PengingatIuran($iuran));
                    $terkirim++;
                }
            });

        $this->info("Pengingat terkirim: {$terkirim}");

        return self::SUCCESS;
    }
}
// routes/console.php
use Illuminate\Support\Facades\Schedule;

Schedule::command('iuran:kirim-pengingat')
    ->weeklyOn(1, '08:00')                  // Senin 08.00
    ->timezone('Asia/Jakarta')
    ->onOneServer()                          // hanya satu server yang menjalankan
    ->withoutOverlapping();

Relasi anggotaPenerimaNotifikasi pada model Keluarga mengembalikan akun pengguna anggota keluarga yang aktif:

// app/Models/Keluarga.php
public function anggotaPenerimaNotifikasi(): HasMany
{
    return $this->hasMany(User::class)->where('is_active', true);
}

Cache::add() hanya berhasil bila kunci belum ada, sehingga menjalankan perintah dua kali (misalnya deploy ulang tepat saat jadwal) tidak mengirim pengingat ganda.

Langkah 9: Cegah Banjir Notifikasi

Bila satu kejadian bisa terjadi berkali-kali dalam waktu singkat (misalnya 20 transaksi diajukan sekaligus lewat impor), kirim ringkasan, bukan 20 email:

// Saat impor massal selesai
Notification::send($penyetuju, new RingkasanPengeluaranMenunggu(jumlah: $trxBaru->count()));

Atau batasi frekuensi email per penerima:

public function via(object $notifiable): array
{
    $saluran = $notifiable->saluranUntuk(self::JENIS, ['database', 'broadcast', 'mail']);

    // Maksimal satu email jenis ini per 15 menit per pengguna; notifikasi aplikasi tetap masuk
    if (in_array('mail', $saluran, true) && ! Cache::add("mail:{$notifiable->id}:".self::JENIS, true, 900)) {
        $saluran = array_values(array_diff($saluran, ['mail']));
    }

    return $saluran;
}

Karena via() dipanggil saat job diproses oleh worker, pembatasan berlaku pada waktu pengiriman sebenarnya.

Langkah 10: Pembersihan Notifikasi Lama

// app/Models/Notifikasi.php
namespace App\Models;

use Illuminate\Database\Eloquent\{Builder, MassPrunable};
use Illuminate\Notifications\DatabaseNotification;

class Notifikasi extends DatabaseNotification
{
    use MassPrunable;

    public function prunable(): Builder
    {
        return static::query()
            ->where(fn ($q) => $q
                ->where('read_at', '<', now()->subDays(90))                 // sudah dibaca > 90 hari
                ->orWhere('created_at', '<', now()->subDays(365)));         // apa pun > 1 tahun
    }
}
// routes/console.php
Schedule::command('model:prune', ['--model' => [\App\Models\Notifikasi::class]])->daily();

Langkah 11: Test

// tests/Feature/Notifikasi/NotifikasiTest.php
use Illuminate\Support\Facades\Notification;

beforeEach(fn () => $this->seed(\Database\Seeders\RolePermissionSeeder::class));

it('memberi tahu semua penyetuju kecuali pencatat', function () {
    Notification::fake();
    $bendahara = User::factory()->create()->assignRole(['bendahara', 'pengurus']);
    $pengurus  = User::factory()->count(2)->create()->each->assignRole('pengurus');
    $warga     = User::factory()->create()->assignRole('warga');
    $trx = TransaksiKas::factory()->create(['dicatat_oleh' => $bendahara->id, 'status' => 'draft']);

    app(\App\Services\AjukanPengeluaran::class)->handle($trx);

    Notification::assertSentTo($pengurus, PengeluaranMenungguPersetujuan::class);
    Notification::assertNotSentTo([$bendahara, $warga], PengeluaranMenungguPersetujuan::class);
});

it('menghormati preferensi email pengguna', function () {
    $user = User::factory()->create();
    $user->preferensiNotifikasi()->create(['jenis' => 'kas.menunggu', 'email' => false, 'aplikasi' => true]);
    $notif = new PengeluaranMenungguPersetujuan(TransaksiKas::factory()->create(['status' => 'menunggu']));

    expect($notif->via($user))->toContain('database')->not->toContain('mail');
});

it('tidak bisa menandai notifikasi milik orang lain', function () {
    $a = User::factory()->create();
    $b = User::factory()->create();
    $b->notify(new PengeluaranMenungguPersetujuan(TransaksiKas::factory()->create(['status' => 'menunggu'])));
    $idMilikB = $b->notifications()->first()->id;

    $this->actingAs($a)->post("/notifikasi/{$idMilikB}/baca")->assertNotFound();
    expect($b->fresh()->unreadNotifications)->toHaveCount(1);
});

it('tidak mengirim pengingat dua kali dalam minggu yang sama', function () {
    Notification::fake();
    $keluarga = Keluarga::factory()->create();
    User::factory()->create(['keluarga_id' => $keluarga->id]);       // satu anggota penerima
    Iuran::factory()->for($keluarga)->create(['periode' => now('Asia/Jakarta')->format('Y-m'), 'dibayar_pada' => null]);

    $this->artisan('iuran:kirim-pengingat');
    $this->artisan('iuran:kirim-pengingat');

    Notification::assertCount(1);
});

Pada test pertama, assertSentTo dengan koleksi memeriksa setiap pengguna di dalamnya. Karena notifikasi memakai afterCommit(), Notification::fake() tetap mencatat pengiriman saat transaksi test berhasil di-commit.

Troubleshooting

Error / Gejala Penyebab Solusi
Notifikasi tidak pernah terkirim Queue worker tidak memproses antrean notifikasi Jalankan queue:work --queue=notifikasi,default; periksa failed_jobs
Notifikasi terkirim untuk transaksi yang dibatalkan Dikirim sebelum commit Gunakan afterCommit()
Email berisi data lama Notifikasi diproses setelah data berubah Ambil data segar di toMail() atau periksa di shouldSend()
Lonceng tidak bertambah secara real-time Reverb/queue tidak berjalan, atau saluran broadcast tidak ada di via() Jalankan reverb:start dan worker; pastikan broadcast di via()
403 pada /broadcasting/auth untuk kanal pengguna Callback App.Models.User.{id} hilang Periksa routes/channels.php
Pengingat terkirim ganda Perintah berjalan dua kali / di dua server onOneServer(), withoutOverlapping(), dan kunci idempoten Cache::add()
User::permission() mengembalikan kosong Cache permission belum diperbarui php artisan permission:cache-reset
Kolom type berisi nama class panjang databaseType() tidak didefinisikan Tambahkan databaseType() dengan kode pendek
Tabel notifications sangat besar Tidak ada pembersihan Jadwalkan model:prune dengan model Notifikasi

Best Practices

Keamanan

  • Akses notifikasi selalu lewat relasi milik pengguna ($user->notifications()), tidak pernah lewat ID global.
  • Validasi URL tujuan notifikasi sebagai path internal sebelum redirect.
  • Gunakan kanal privat untuk broadcast; jangan menyiarkan data pribadi lewat kanal publik.
  • Simpan data ringkas di notifikasi; hindari NIK atau data sensitif lain di isi notifikasi dan email.
  • Escape teks dari pengguna yang masuk ke template email.

Performa

  • Semua notifikasi ShouldQueue dengan antrean tersendiri.
  • Indeks (notifiable_type, notifiable_id, read_at, created_at) untuk lonceng.
  • Hitungan belum dibaca bisa di-cache singkat bila pengguna sangat banyak.
  • Gunakan lazyById untuk pengiriman massal terjadwal.

Maintainability

  • Kode jenis notifikasi (kas.menunggu) sebagai konstanta, dipakai untuk preferensi dan databaseType().
  • Satu method saluranUntuk() yang menentukan saluran berdasarkan preferensi.
  • Perintah terjadwal idempoten, berjalan di satu server.
  • Test untuk penerima yang benar, preferensi, kepemilikan, dan duplikasi.

Related Articles

Last Tested

Komponen Versi
Laravel 13.x
PHP 8.4
Laravel Reverb 1.x
spatie/laravel-permission 8.x
Alpine.js 3.x
Pest 4.x
Tanggal 19 Oktober 2026

Bagikan artikel:

Artikel lainnya