Sistem Notifikasi & Alert

Gambaran Umum

Menjalankan operasional bisnis sehari-hari tanpa sistem peringatan yang proaktif ibarat menerbangkan sebuah pesawat terbang dengan mata tertutup—Anda tidak akan pernah tahu ada gunung di depan hingga tabrakan itu terjadi. Untuk menghindari kekacauan informasi seperti barang yang tiba-tiba habis tanpa diketahui atau pelanggan VIP yang mengamuk karena tagihannya terabaikan, aplikasi Temuya POS dilengkapi dengan Sistem Notifikasi dan Peringatan (Alert) Cerdas yang dirancang secara holistik. Fitur ini berfungsi sebagai pusat sistem saraf simpatik bagi operasional toko; ia berjaga tanpa henti untuk merasakan, mengevaluasi, dan mengirimkan impuls informasi krusial kepada pengelola bisnis secara seketika (real-time).

Diwakili oleh ikon lonceng (Bell Icon) kecil nan elegan yang bersandar di sudut atas area header antarmuka aplikasi kasir, sistem ini secara diam-diam terus menyusun daftar peristiwa prioritas yang terjadi di balik layar. Sistem tidak sekadar mengirimkan hujan pesan sampah (spam) yang tidak berguna; ia dirancang dengan kecerdasan logika filter untuk hanya memunculkan peristiwa yang menuntut perhatian atau tindakan cepat (Call to Action). Tipe peringatan ini bervariasi mulai dari peringatan stok inventaris yang mulai menyentuh titik kritis kelangkaan (Minimum Stock Alert), peringatan administratif seperti tagihan jatuh tempo langganan peranti lunak (Invoice Due Date), hingga jejak keamanan sistem seperti ada login tidak biasa pada jam tiga pagi.

Dengan adanya lonceng Notifikasi terpusat ini, manajer operasional dan kasir tidak lagi membuang-buang waktu memeriksa secara manual setiap laci pelaporan halaman demi halaman untuk mencari anomali bisnis. Sistem ini membalikkan paradigma: masalah akan mengejar Anda, memastikan efisiensi tenaga kerja dan memberikan jaminan ketenangan batin (peace of mind) mutlak.

Skenario Bisnis Nyata

Simak rutinitas harian operasional di “Gudang Sepatu Langkah Pasti”, sebuah butik ritel independen skala menengah yang menjual sepatu sneakers edisi terbatas dan sangat mahal. Manajemen rantai pasok (supply chain) mereka menuntut kehati-hatian luar biasa, karena menimbun stok sepatu akan membakar uang modal (mati di gudang), namun kekurangan stok berarti membuang peluang keuntungan jutaan rupiah saat pelanggan eksklusif mereka tiba.

Bapak Yanto, sang manajer toko utama (Store Manager), menggunakan komputer administrasi di ruangan belakang (Back Office) dengan antarmuka Temuya POS terbuka. Di saat yang sama, tiga karyawannya sibuk memproses pembayaran dari pelanggan di terminal kasir area pameran. Tiba-tiba, tanpa harus menekan tombol segarkan (refresh) layar (browser) komputernya, sebuah lencana merah terang bergambar angka “1” muncul berkedip elegan di atas ikon lonceng layar komputer Bapak Yanto, disertai dengan dentingan efek suara sapa (ping) lembut.

Bapak Yanto segera mengklik ikon tersebut. Sebuah panel pop-down memanjang memperlihatkan pesan berlabel oranye tegas: “⚠️ Peringatan Stok Kritis! Sepatu Jordan Air V2 (Ukuran 42) hanya tersisa 2 Pasang. Segera lakukan Order Pembelian Ulang ke Pemasok”. Menyadari tingkat kepentingannya, beliau mengklik notifikasi tersebut, yang langsung melompat memindahkannya ke halaman Manajemen Produk (Detail Sepatu Jordan). Dalam hitungan menit, beliau berhasil menghubungi distributor pusat untuk menahan (booking) stok tiga karton tambahan, mencegah kiamat kehabisan stok akhir pekan. Setelah urusan pembelian selesai, beliau menekan tombol centang (Mark as Read) di panel notifikasi, yang mengubah warna notifikasi dari tegas ke abu-abu usang (Read status), membersihkan lencana merah di lonceng. Berkat mekanisme Notifikasi Otomatis, Gudang Sepatu Langkah Pasti menyelamatkan perputaran modal omzet akhir pekannya yang nyaris hilang, karena mereka memenangkan perlombaan balap waktu dalam merespon tren penjualan.

Alur Kerja Polling & Reaksi

Bagan alir (Flowchart) arsitektur teknis berikut mendemonstrasikan secara transparan mekanisme “percakapan detak jantung” (heartbeat polling) antara komponen visual (React Notification Bell) dengan mesin kecerdasan pengirim pesan Hono API secara terus menerus di balik layar.

flowchart TD
    UI_Bell((Komponen:\nNotificationBell.tsx)) --> Timer[SetInterval: Timer 60 Detik]
    Timer --> CallAPI[Kirim Request: GET /api/notifications]
    
    CallAPI --> ServerWorker(Hono Backend & Database D1)
    
    ServerWorker --> CekEvent{Adakah Notifikasi Unread\nuntuk Tenant/User Ini?}
    
    CekEvent -- Tidak (Kosong) --> UI_Sleep[Kembalikan Array Kosong, Tidur Kembali]
    UI_Sleep --> Timer
    
    CekEvent -- Ya (Ada Data) --> UI_Update[Response: Array Objek Notifikasi & Hitungan 'Unread']
    
    UI_Update --> RenderRedBadge["Render Badge Merah & Mainkan Efek Suara (Ping)"]
    
    RenderRedBadge --> UserAction{"Aksi Pengguna (Klik)"}
    
    UserAction -- Klik Buka Laci --> Dropdown[Tampilkan Daftar Kartu Notifikasi]
    UserAction -- Klik Tandai Dibaca --> PutReq[Kirim Request: PUT /api/notifications/:id/read]
    
    PutReq --> UpdateDB[Update Database D1:\n'is_read' = true]
    UpdateDB --> UI_RemoveBadge[Kurangi Hitungan Badge Merah, Refresh UI]

Teknologi & Infrastruktur (Mekanisme Penyampaian)

Menjaga kelancaran lalu lintas notifikasi skala besar (at scale) tanpa mencekik peladen (server bottleneck) membutuhkan strategi arsitektur perpesanan yang matang.

Lapisan Sistem (Layer)	Konfigurasi Teknis / Standar Komputasi	Alasan Desain Strategis
Generasi Event Server (Pemicu)	Job Schedulers (CRON) / Background Worker	Trigger stok tipis tidak membebani transaksi kasir. Sistem (Cloudflare Cron Triggers) secara rutin mensapu bersih (sweeping) tabel di malam hari untuk mencari barang menipis dan mencetak/menyuntik baris pesan merah ke basis data Notifikasi.
*Metode Penarikan (Fetching)*	Long/Short HTTP Polling berbasis React Query (SWR)	Mengingat keterbatasan Websocket di lingkungan Edge (serverless), sistem menggunakan metode pengambilan polling cerdas berbasis interval (misal: interval tiap 60 detik) yang memberikan sensasi real-time sempurna namun tidak menghancurkan tagihan penggunaan komputasi server.
Penyimpanan Pesan Sentral	Tabel D1 Database `tenant_notifications`	Menjamin ketekunan (persistence) pesan. Bahkan bila kasir menutup tab browsernya lalu pulang, dan keesokan paginya ia menyalakan komputer lagi, pesan notifikasi “Tagihan Belum Dibayar” itu akan menantinya di antrean tanpa pernah hilang (karena bukan disimpan di RAM browser murni).
Status Pembacaan (Read Status)	Kolom Boolean `is_read` & Timestamp	Mekanisme standar industri (Mirip Facebook) yang membedakan pesan yang sudah diurus/diketahui dari pesan yang baru mendarat, yang mengatur visibilitas hitungan jumlah lencana bulat (Badge Counter).
Sistem Kategorisasi Peringatan	Kolom Enum `notification_type`	Memberikan label visual berbeda pada pesan (misal: warna teks MERAH BOLD untuk status darurat “INVOICE OVERDUE” (Tagihan Tertunggak), dan teks BIRU standar untuk laporan informasional biasa (“Shift Telah Ditutup”)).

Keterkaitan dengan Fitur Lain

Notifikasi adalah jaringan saraf pengamat yang sulurnya menjulur ke hamparan fitur-fitur krusial Temuya POS lainnya, bertindak sebagai juru bicara bagi komponen diam:

Modul Produk & Manajemen Inventori: Modul produk menyuplai darah informasi yang menghidupi sistem notifikasi ini. Jika seorang manajer toko sengaja tidak menyetel angka “Minimum Stok” (misalnya disetel menjadi 0) pada form edit produk, maka algoritma peringatan kelangkaan stok tidak akan memiliki parameter patokan apa-apa, membuat notifikasi stok tipis tidak akan pernah berbunyi.
Manajemen Token & Kuota Premium: Sistem penagihan (billing) di latar belakang mengandalkan bel notifikasi secara intens. Ia adalah perpanjangan lidah mesin yang memperingatkan “Token Fitur Premium Anda tersisa 10%, harap isi ulang! (Top Up)”.
Webhook & Event Push Eksternal (API Developer): Mekanisme internal lonceng bel notifikasi web (frontend) dan fitur webhook eksternal sering kali berjalan secara paralel. Kejadian meledaknya “Stok Menipis” tidak saja memunculkan bel di antarmuka komputer, namun dalam waktu bersamaan menembakkan peluru JSON asinkron ke server ERP raksasa klien jika mereka menyetel pengait URL Webhook mereka.

Hal Penting yang Perlu Diketahui

Untuk menjamin ekosistem sistem yang bebas dari “Kelelahan Peringatan (Alert Fatigue)”, pemahaman akan aturan berikut diwajibkan bagi setiap administrator sistem pengelola toko:

Penyakit Kelelahan Notifikasi (Alert Fatigue): Ini adalah bahaya psikologis nyata di lapangan. Jika pengelola menyetel peringatan ambang batas Minimum Stok produk terlalu tinggi secara tidak wajar pada ratusan item barang (misalnya: peringatan menyala padahal sisa sabun mandi masih 50 kotak!), maka lonceng aplikasi kasir akan meraung berdenting sepanjang jam tiada henti setiap hari. Kasir dan manajer akan menjadi kebas (kebal) secara psikologis dan secara refleks mengabaikan peringatan tersebut selamanya, membuat fungsi lonceng peringatan sesungguhnya (untuk mencegah kehancuran stok nol mutlak) menjadi cacat dan mati fungsi. Setel ambang peringatan pada tingkat darurat yang benar-benar esensial saja.
Hak Istimewa Peran (Role-Based Visibility): Harus dipahami bahwa Notifikasi memiliki hak visibilitas privasi yang ketat. Peringatan krisis operasional (seperti kehabisan stok) hanya akan dikirim (di-broadcast) kepada gawai dan akun pengguna yang minimal menyandang pangkat wewenang tingkat Manajer (Manager Role) atau Pemilik Bisnis Tertinggi (Owner). Kasir tingkat satu yang sedang melayani tamu tidak akan diganggu atau dipertontonkan rahasia teguran lonceng tagihan platform Temuya (Billing Invoices) yang macet—karena itu murni bukan kapasitas wewenang mereka untuk mengurusinya.
Sampah Riwayat Kadaluarsa (Data Pruning): Tolong jangan jadikan panel notifikasi ini sebagai laci pengarsipan buku harian jangka panjang Anda. Untuk memastikan database berlari sekencang kilat dan beban respon kueri UI tetap super ringan, mesin (Cloudflare Background Task) Temuya akan tanpa ampun menghapus (flush/pruning purge) secara otomatis segala jenis notifikasi yang umurnya telah lewat dari ambang historis tertentu (misalnya pesan-pesan yang lebih tua dari batas 30 hari kalender berlalu). Jika Anda ingin menyimpan arsip, simpan di fitur pelaporan (Reports) khusus, bukan lonceng.
Pemecahan Masalah Koneksi Bisu (Silenced App): Jika staf lapangan tiba-tiba melapor bahwa mereka tidak pernah lagi mendengarkan bel notifikasi pop-up stok menipis, langkah diagnosa paling krusial pertama adalah menginstruksikan mereka untuk menekan tombol bulat “Tandai Telah Dibaca Semua (Mark All as Read)” pada laci menu dropdown bel tersebut, membersihkan cache penyimpanan sesi (clear browser session state), menyegarkan (refresh/F5) layar, dan memastikan sakelar speaker suara Windows/Mac OS mereka (Audio Context Tab Browser) tidak sengaja tertekan secara tak sengaja menjadi Bisu (Muted).
Pertempuran Rebutan Fokus Tab (Tab Focus Inactivity): Mesin modern (browser semacam Chrome versi termutakhir) mengimplementasikan aturan agresif di mana mereka secara sepihak akan memberhentikan sementara skrip latar (Javascript interval timer) penarik ping notifikasi otomatis, jika jendela Tab aplikasi POS tersebut dibiarkan terkubur tertutup oleh lapisan tab Facebook atau YouTube berjam-jam (Throttle Background Tabs). Akibatnya, notifikasi Anda bisa datang terlambat. Jadi pastikan jendela Temuya POS disematkan (Pinned Window) menjadi halaman terdepan absolut atau layar yang mendedikasikan satu unit tablet utuh khusus untuk operasional kasir (Kiosk Mode).