Pusat Notifikasi Tenant
Pusat Notifikasi (Notification Center) berfungsi sebagai wadah tunggal informasi in-app yang dikirimkan oleh sistem DagangBot kepada staf dan pengelola bisnis. Melalui modul ini, pengguna akan langsung mengetahui peristiwa-peristiwa penting harian seperti notifikasi tagihan (billing), saldo kuota limit yang menipis, pengumuman jadwal maintenance, hingga notifikasi lintas-cabang (branch). Modul ini didesain agar mampu menangani ribuan kejadian asinkron tanpa membebani pengalaman pengguna akhir, berkat arsitektur paginasi yang ketat dan keamanan tingkat baris (Row-Level Security).
Stable1. Ikhtisar & Nilai Bisnis
Manajemen informasi masuk yang tertata memastikan kelancaran operasional setiap bisnis yang berskala besar. Nilai utama penggunaan fitur Pusat Notifikasi terletak pada kemampuannya untuk mengumpulkan berbagai sinyal dari sistem internal DagangBot (seperti layanan analitik, layanan integrasi pengiriman, hingga layanan penagihan) menjadi satu aliran informasi yang mudah dicerna oleh operator manusia. Tanpa adanya pusat notifikasi, pengguna harus secara manual memeriksa berbagai modul hanya untuk mengetahui apakah ada masalah atau pembaruan.
Manfaat strategis dan operasional yang dihadirkan oleh modul Pusat Notifikasi ini mencakup:
- Pemantauan Cepat dan Responsif: Anda tidak lagi melewatkan informasi mengenai limit kuota pesan yang mendadak habis atau notifikasi pembayaran yang segera jatuh tempo. Sistem memancarkan pembaruan secara langsung ke antarmuka aplikasi. Keterlambatan respons terhadap peringatan kritis sering kali berujung pada berhentinya layanan bot kepada pelanggan; fitur ini secara drastis mengurangi risiko downtime operasional.
- Batasan Akses Berbasis Cabang (Multi-Tenant Isolation): Karyawan di Cabang A tidak dapat mengintip notifikasi tagihan atau pembaruan saldo milik Cabang B maupun sistem pusat. Kebocoran informasi internal dicegah pada tingkat database. Mekanisme ini krusial untuk struktur bisnis franchise atau multi-lokasi yang mewajibkan isolasi data absolut.
- Pembersihan Otomatis dan Manual: Histori notifikasi yang telah terbaca dapat dikosongkan dengan mudah agar tidak membebani tampilan dasbor dan agar fokus tertuju hanya pada peringatan baru. Sistem menyediakan aksi
clearkhusus yang dioptimalkan untuk membersihkan basis data secara efisien tanpa mengganggu performa. - Tingkat Prioritas Khusus dan Pengelompokan Berbasis Konteks: Notifikasi disaring melalui parameter tipe (type), di mana notifikasi kritis (seperti peringatan penangguhan akun) akan selalu menduduki perhatian paling atas. Pengguna tidak perlu menyelami ratusan pesan informasional untuk menemukan satu peringatan yang mendesak.
Kehadiran fitur ini juga menekan beban layanan dukungan (customer support) platform DagangBot, karena pengguna mendapatkan pemberitahuan swalayan (self-service) terkait kendala yang terjadi pada akun mereka sebelum mereka harus menghubungi tim bantuan. Setiap notifikasi juga dilengkapi dengan tautan tindakan (call-to-action) yang mengarahkan pengguna secara instan ke halaman penyelesaian masalah.
Platform DagangBot menggunakan isolasi ketat terhadap basis data. Seseorang tidak bisa sekadar memalsukan parameter branch_id pada URL tautan API notifikasi karena query basis data dibatasi ketat sesuai hak wewenang akun tersebut (berdasarkan klaim token otorisasi). Upaya akses paksa akan secara otomatis ditolak pada tingkat mesin basis data.
2. Alur Visual & Antarmuka
Panel Pusat Notifikasi ini direpresentasikan melalui dua wujud antarmuka utama yang dirancang untuk kebutuhan yang berbeda: akses cepat dan manajemen komprehensif.
Pendekatan pertama adalah wujud dropdown lonceng notifikasi pada pojok atas kanan layar dashboard Anda. Elemen ini berfungsi sebagai indikator sekilas. Saat sebuah acara penting terpicu di backend, koneksi WebSocket akan mengirimkan sinyal waktu nyata (real-time) yang seketika memperbarui lencana (badge) merah di atas ikon lonceng, tanpa memerlukan penyegaran halaman (refresh). Dropdown ini secara efisien menampilkan maksimal lima hingga sepuluh pesan terbaru, merangkum judul pesan, ikon kategori, dan indikator waktu relatif (misalnya: "5 menit yang lalu").
Pendekatan kedua adalah halaman antarmuka daftar utuh. Ketika pengguna memerlukan kontrol administratif yang lebih mendalam, mereka akan dialihkan ke layar khusus Pusat Notifikasi. Di layar ini, notifikasi dirender dalam bentuk tabel atau daftar kartu bergaya baris. Antarmuka daftar utuh ini mencakup panel penyaringan (filter) di sisi kiri atau atas, yang memungkinkan operator mencari riwayat peringatan berdasarkan rentang tanggal, kategori (system, billing, security, operational), atau status baca. Setiap baris pesan dirancang secara visual dengan latar belakang sedikit digelapkan atau cetak tebal untuk menandai pesan yang belum terbaca (unread), sementara pesan yang telah selesai diulas akan tampil dengan tipografi standar.
Modul antarmuka juga dirancang agar responsif terhadap berbagai ukuran layar (perangkat seluler, tablet, desktop). Jika diakses melalui telepon seluler, lencana notifikasi akan diposisikan pada bilah navigasi bawah, menjamin fleksibilitas operasional bagi staf toko yang sering berpindah tempat dan hanya mengandalkan gawai bergerak.
3. Panduan Langkah-demi-Langkah
Anda dapat mengontrol dengan penuh status pesan baca/belum dibaca pada notifikasi dari dashboard melalui serangkaian interaksi lugas. Berikut adalah tahapan mendetail untuk mengelola aliran informasi pada akun Anda.
- 1
Langkah 1: Mengakses Menu Notifikasi Lonceng
Klik pada ikon lonceng (Bell) di sudut kanan atas menu utama platform. Jika ada pesan yang baru tiba, Anda akan melihat lencana angka warna merah. Mengekliknya akan memperlihatkan jendela pop-up sekilas (dropdown). Panel pratinjau ini memuat daftar urut kronologis menurun (dari yang paling baru). Mengeklik salah satu item di pratinjau ini akan langsung menandai item tersebut sebagai telah dibaca dan segera meluncurkan Anda ke halaman terkait pesan tersebut.
- 2
Langkah 2: Membuka Daftar Seluruh Notifikasi Secara Penuh
Dari menu dropdown lonceng, klik tautan bertuliskan Lihat Semua. Tindakan ini akan meluncurkan antarmuka tabel paginasi layar penuh. Anda dapat memberikan centang pada opsi tuas Unread Only untuk merampingkan antarmuka, sekadar melihat peringatan yang belum Anda sikapi atau tindak lanjuti. Ini sangat berguna ketika Anda baru kembali dari cuti atau libur akhir pekan dan dihadapkan pada tumpukan peringatan.
- 3
Langkah 3: Menggunakan Filter Cabang Secara Spesifik
Bagi akun pemilik (owner) atau admin lintas cabang (misalnya Head Office), Anda diwajibkan menggunakan dropdown Cabang guna memilah dan mencari tahu spesifik problem di cabang tertentu (misal: "Cabang Thamrin Kehabisan Kuota"). Admin reguler hanya akan melihat antarmuka cabangnya sendiri tanpa opsi dropdown tambahan, karena isolasi sistem menonaktifkan tampilan lintas-cabang secara otomatis.
- 4
Langkah 4: Tandai Telah Dibaca Secara Manual
Jika instruksi pesan telah dilaksanakan (misalnya menambah saldo top up tagihan) namun Anda tidak mengeklik tautannya langsung, Anda dapat mengeklik ikon centang ganda di sebelah daftar notifikasi tersebut untuk memicu perintah Mark As Read. Terdapat juga tombol global bertuliskan Tandai Semua Dibaca yang dapat mengeksekusi penandaan massal dalam satu ketukan untuk menyapu bersih indikator visual lencana merah.
- 5
Langkah 5: Mengosongkan Riwayat Lama dengan Aksi Clear
Guna menjaga performa layar dan relevansi historis, gunakan tombol Bersihkan (Clear Read) pada pojok atas antarmuka untuk segera menghapus secara permanen seluruh item riwayat notifikasi yang telah dibaca dalam cakupan cabang tersebut (aksi ini memanggil fungsi API
DELETE /clear). Tindakan ini tidak dapat dibatalkan, namun sistem memastikan pesan bernilai unread tidak akan ikut terhapus.
Skenario Operasional: Cabang Pusat vs Cabang A
Untuk memberikan gambaran konkret mengenai cara fungsi-fungsi di atas bekerja secara harmonis, mari amati skenario operasional antara staf Cabang Pusat (Head Office) dan staf di Cabang A.
Misalkan platform DagangBot mendeteksi dua masalah secara berbarengan:
- Kuota API WhatsApp di Cabang A tersisa 5%.
- Tagihan langganan utama perangkat lunak bulanan untuk seluruh jaringan belum dibayarkan.
Perspektif Staf Cabang A: Ketika Budi (staf Cabang A) masuk ke dashboard, modul Pusat Notifikasi membaca profil akun Budi dan mencatat bahwa Budi hanya memiliki role akses pada entitas Cabang A. Sistem basis data merespons dengan menampilkan badge merah berjumlah "1". Saat Budi membuka menu, dia hanya melihat peringatan: "Peringatan: Kuota WhatsApp Cabang A tersisa 5%. Silakan kurangi aktivitas peladen." Budi sama sekali tidak melihat peringatan penagihan, karena itu berada di luar yurisdiksi branch_id miliknya. Jika Budi mencoba memaksa manipulasi parameter API ke Cabang Pusat, basis data via RLS akan menolak permohonan tersebut secara absolut.
Perspektif Administrator Cabang Pusat: Siti (manajer di Cabang Pusat) login ke dalam sistem. Aksesnya menaungi semua cabang (Head Office + Cabang A, B, C). Lonceng notifikasi Siti memunculkan angka "2". Siti melihat peringatan "Tagihan Langganan Jatuh Tempo" sebagai prioritas tertinggi di tingkat sistem global. Selain itu, sistem juga memperlihatkan "Cabang A: Kuota WhatsApp tersisa 5%". Jika daftar ini tercampur dengan ratusan pesan dari seluruh cabang lain, Siti cukup membuka layar notifikasi utama, menggunakan panel filter, memilih Cabang A di dropdown, dan meninjau masalah operasional Budi. Setelah Siti membayar tagihan pusat dan mereset peringatan kuota Cabang A, ia dapat menekan tombol Clear Read untuk menyingkirkan pesan tersebut selamanya dari dasbor.
4. Parameter & Spesifikasi Teknis
Dalam rangka memastikan stabilitas jaringan latensi rendah dan meminimalkan beban komputasi di pihak peladen basis data PostgreSQL, daftar endpoint penyaring API telah direkayasa dengan batasan yang ketat. Penggunaan endpoint ini mensyaratkan token JWT valid yang membawa atribut kepemilikan struktur multitenant. Mekanika batasan sistem maksimal 100 entri per panggilan melindungi infrastruktur dari permintaan dumping data berskala masif oleh bot siber nakal atau kelemahan iterasi kueri dari aplikasi sisi klien (client-side).
Detail Paginasi Limit 100 dan Atribut unread_only
Paginasi diimplementasikan memakai kombinasi metode standar LIMIT dan OFFSET berbasis kursor parsial di peladen. Parameter per_page tidak akan merespons permintaan yang lebih dari 100. Apabila frontend atau sebuah utilitas API klien (Postman, curl) mencoba menyisipkan muatan per_page=500, peladen Golang akan secara internal memotong (clamp) nilai tersebut ke angka 100 sebelum kueri dieksekusi di database. Hal ini menjamin konsumsi memori alokasi RAM backend (heap allocation) tetap linear dan dapat diprediksi saat ribuan pengguna memuat notifikasi mereka di waktu yang bersamaan.
Di sisi lain, parameter unread_only bukan sekadar penyaring pada tingkat antarmuka, melainkan optimasi modifikasi sintaks kueri langsung di tataran basis data. Saat unread_only=true dikirimkan, layanan backend menambahkan klausa spesifik WHERE is_read = false. Kolom is_read sendiri diindeks menggunakan B-Tree Index di PostgreSQL, memfasilitasi pencarian subdetik meskipun tabel notifikasi mengandung jutaan riwayat historis baris.
RLS untuk Hak Akses Branch ID dan Aksi Hapus Clear
Arsitektur isolasi multitenant bersandar pada pilar kokoh PostgreSQL Row-Level Security (RLS). Ketika sebuah request HTTP masuk dan diverifikasi middleware otentikasi, identifier identitas sesi dikonversi ke variabel lokal sesi database SET LOCAL tenant.current_branch_id = 'xxxx-xxxx'.
Kebijakan keamanan (Policy) menyatakan CREATE POLICY branch_isolation ON notifications FOR SELECT USING (branch_id = current_setting('tenant.current_branch_id')::uuid). Melalui mekanisme tingkat inti ini, parameter branch_id yang diterima dari URL pencarian sekadar berlaku sebagai sub-filter, yang tidak akan pernah bisa melangkahi batasan wewenang wujud RLS aslinya.
Aksi penghapusan melalui instruksi DELETE /clear ditata sedemikian rupa dengan kriteria destruktif bersyarat. Kueri tersebut diprogram agar HANYA menghapus baris-baris yang telah ditandai is_read = true dan mengunci dirinya pada konteks wewenang cabang. Hal ini mencegah skenario yang mana admin secara impulsif menekan tombol Clear lalu mengakibatkan pesan-pesan urgensi tinggi yang bahkan belum sempat dibaca menjadi terhapus secara tragis. Mekanisme ini menggaransi keutuhan jalur informasi operasional yang ditujukan pada end-user.
5. Relasi & Integrasi
Pusat Notifikasi beririsan langsung dan bertindak sebagai konsumen setia (consumer) atas kapabilitas modul-modul lain di balik layar ekosistem platform. Keterikatan komponen ini menciptakan harmoni pertukaran notifikasi lintas-subsistem tanpa jeda waktu.
- Admin & Self-Service Portal Pengaturan Toko: Semua penugasan berbasis peran (role-based access control) dan penentuan batasan wewenang atas tiap entitas branch secara absolut memengaruhi wujud akhir jumlah tabulasi badge notifikasi unread pada akun staf. Jika admin pusat mencabut akses seorang karyawan atas sebuah cabang, badge merah mereka akan menghilang secara instan (real-time).
- Log Aktivitas Tenant: Terdapat kesinambungan pencatatan. Penghapusan riwayat notifikasi (
DELETE /clear) atau eksekusi operasional klik dari tautan yang ada di dalam badan pesan notifikasi akan direkam permanen dalam log aktivitas (audit trail). Ini memastikan tindakan staf pasca-membaca notifikasi tetap terdokumentasi untuk audit. - Manajemen Prompt & Kepribadian Bot: Mesin peladen bot DagangBot dilengkapi sub-modul pemantauan kondisi anomali asinkron. Apabila sistem mendeteksi kondisi gawat seperti ketiadaan saldo untuk pemrosesan teks via LLM, ia akan melaporkannya kepada pelanggan via balasan otomatis saluran WhatsApp, dan bersamaan dengan itu sistem juga menembakkan (dispatch) event webhook agar notifikasi peringatan berprioritas tinggi tertancap langsung di dalam dasbor manajer Pusat Notifikasi tenant.
6. Pemecahan Masalah (Troubleshooting)
Kendala lazim operasional dan komunikasi internal pada infrastruktur layanan pusat notifikasi terdaftar secara komprehensif di bawah ini, beserta langkah prosedur baku perbaikannya (Standard Operating Procedure resolusi cepat). Ikuti rekomendasi di tabel ini sebelum menghubungi lini bantuan dukungan staf teknis tingkat lanjut.
7. Referensi Terkait
Pelajari lebih terperinci mengenai dokumentasi spesifik teknis keamanan siber platform dan tata tertib akses delegasi hak wewenang cabang pada platform distribusi canggih DagangBot melalui rujukan sah di bawah ini.
Admin & Portal Pengaturan Toko
Tata laksana perundang-undangan profil admin manajemen toko daring pusat dan prosedur tata cara perizinan distribusi batasan keamanan tingkat isolasi silang cabang entitas.
Log Aktivitas Tenant
Basis sentral catatan histori permanen menyeluruh mengenai operasi-operasi transaksi kritis administrasi apa saja yang dieksekusi fungsionaris staf selama mengawaki portal.
Broadcast WhatsApp
Panduan implementasi teknikal tentang metode canggih siaran proaktif keluar secara massal untuk kampanye pembaruan penawaran memanfaatkan armada utilitas kuota konektivitas WhatsApp Official API.
