Manajemen Pengguna, Hak Akses & Model Dual-Axis RBAC
Seiring bertumbuhnya organisasi bisnis dari satu toko kecil menjadi perusahaan dengan puluhan staf customer service dan manajer cabang, risiko kebocoran data sensitif dan penyalahgunaan wewenang meningkat pesat. DagangBot mengimplementasikan arsitektur kontrol akses tingkat lanjut: Dual-Axis Role-Based Access Control (RBAC).
Stable1. Ikhtisar & Nilai Bisnis
Pendekatan RBAC konvensional hanya membatasi aksi (misal: "Boleh mengedit katalog produk"). Namun, dalam bisnis retail multi-cabang, hal tersebut belum cukup. Staf di Bandung tidak boleh melihat omset penjualan atau data pelanggan cabang Surabaya. Model Dual-Axis DagangBot memadukan dua dimensi penguncian secara serentak:
- Sumbu 1 - Hak Akses Aksi (Permission Axis): Menentukan apa yang dapat dilakukan pengguna terhadap sumber daya sistem (
read,create,update,delete,export). - Sumbu 2 - Cakupan Cabang (Branch Scope Axis): Menentukan di cabang fisik mana saja pengguna tersebut diizinkan melihat atau memanipulasi data (
ALL_BRANCHESvs cabang spesifik). - Pencegahan Akses Berlebih (Principle of Least Privilege): Memastikan bahwa staf hanya dapat mengakses modul yang relevan. Misalnya, kasir tidak bisa melihat pengaturan integrasi API atau log penagihan (billing).
- Log Jejak Aktivitas (Audit Trail): Setiap perubahan penting pada konfigurasi akan direkam pada audit log (hanya baca).
Di lapisan database, sistem menerapkan PostgreSQL Row-Level Security (RLS) berdasarkan klaim user_id, tenant_id, dan branch_id yang tertera pada token JWT sesi pengguna.
2. Alur Visual & Antarmuka
Berikut adalah tampilan tabel manajemen staf pengguna dan editor konfigurasi hak akses modul (Dual-Axis RBAC):


3. Panduan Langkah-demi-Langkah
Ikuti alur berikut untuk mengundang anggota tim baru dan menetapkan perannya:
- 1
Langkah 1: Akses Menu Manajemen Tim
Buka dasbor merchant di bilah menu kiri, pilih Pengaturan → Pengguna & Staf. Anda akan melihat daftar anggota tim yang aktif saat ini beserta peran masing-masing.
- 2
Langkah 2: Klik Tombol Undang Anggota Tim
Klik tombol biru + Undang Pengguna. Masukkan alamat email staf yang valid dan nama lengkap mereka.
- 3
Langkah 3: Pilih Peran (Role) Sumbu Izin
Pilih salah satu peran standar yang tersedia:
- Owner / Administrator: Hak akses penuh ke seluruh modul, keuangan, dan pengaturan API. Memiliki kapabilitas
GrantsAllResources(akses semua) danCanManageRBAC. - Branch Manager: Akses laporan, katalog, dan pesanan terbatas pada cabangnya sendiri.
- CS / Agen Penjualan: Hanya memiliki akses ke Live Inbox percakapan dan modul Takeover CRM.
- Kasir (Cashier): Akses pembuatan invoice transaksi dan pemeriksaan bukti transfer.
- Owner / Administrator: Hak akses penuh ke seluruh modul, keuangan, dan pengaturan API. Memiliki kapabilitas
- 4
Langkah 4: Tentukan Cakupan Cabang (Scope Axis) & Kirim
Pilih cabang tempat staf tersebut bertugas (contoh: Cabang Jakarta Selatan). Klik Kirim Undangan. Tautan aktivasi akun akan dikirimkan ke email staf tersebut secara otomatis.
4. Parameter & Spesifikasi Matriks Hak Akses
Antarmuka Manajemen Tim dan Editor Konfigurasi Izin memetakan parameter Role yang diinterpretasikan oleh lapisan otorisasi dan keamanan pada sistem backend. Tabel di bawah merangkum parameter dan matriks hak akses nyata (resource keys) beserta efeknya pada sistem:
Matriks Izin, Peran Bawaan, dan Penolakan Akses (403)
Sistem otentikasi membagi pengguna ke dalam peran bawaan (built-in) yang immutable seperti owner, dan peran kustom tingkat staf. Matriks izin dibentuk berdasarkan kombinasi Modul (Resource) dan Aksi (Action) (misal: create, read, update, delete). Hak akses juga dikontrol oleh Cakupan Cabang (Scope Axis) yang menentukan apakah staf dapat melihat data seluruh cabang atau hanya cabangnya saja.
Evaluasi kelayakan perubahan izin ditangani oleh layanan otorisasi peran (RBAC). Jika pengguna melanggar aturan pengelolaan matriks hak akses, sistem memunculkan respons 403 Forbidden dengan galat nyata berikut:
ErrOwnerImmutable403: "owner permissions are immutable: peran owner bersifat immutable dan tidak dapat diubah".ErrCannotManageRBAC403: "peran Anda tidak memiliki wewenang mengubah matriks izin" (dimunculkan saat peran pengguna aktif tidak memiliki deklarasican_manage_rbac).ErrRoleNotJunior403: "hanya peran yang lebih junior yang dapat diubah" (pengguna mencoba mengedit peran dengan tingkat yang sama atau lebih tinggi).ErrGrantExceedsOwn403: "izin yang diberikan melebihi izin pengelola".
Setiap perubahan hak akses oleh pengelola wajib tercatat dalam log melalui fungsi internal writeAuditLog, yang merekam identitas staf, matriks izin baru, serta informasi perangkat (user-agent) untuk keperluan jejak audit yang tidak bisa dimanipulasi.
Sebagian besar aksi delete (hapus permanen) pada tabel data krusial (seperti pesanan e-commerce, catatan laporan transaksi pembayaran finance_global, log tagihan billing) secara arsitektural dinonaktifkan keras (hard-disabled) di tingkat keamanan peladen terlepas dari konfigurasi roles UI, guna mencegah penghapusan jejak manipulasi audit yang dapat merusak integritas keamanan pelaporan keuangan (Immutable Audit Log).
5. Kasus Tepi (Edge Cases)
Dalam operasional organisasi perusahaan tingkat menengah dan atas, banyak situasi tidak lazim (edge cases) yang ditangani oleh komponen Dual-Axis RBAC. Berikut cara sistem menghadapi skenario tersebut:
6. Relasi & Integrasi Hubungan Modular
Sistem kontrol akses terkait erat dengan banyak subsistem lainnya dalam DagangBot:
- Isolasi RLS (Row-Level Security) PostgreSQL: Matriks di atas tidak hanya berkerja di tingkat antarmuka, tetapi diikat langsung sebagai klausul
WHEREpaksa pada database. Cabang A tidak dapat querying pesanan Cabang B meski meng-hack API. - WebSocket & Real-Time Sync: Aktivitas dari staf pada satu cabang (seperti mengubah pesanan) dikomunikasikan secara live lewat WebSocket (
billing_usage,ws_ticket), namun pesannya difilter oleh perizinanbranch_idpenerima agar tidak terjadi kebocoran informasi ke cabang lain. - Audit & Penagihan (Billing): Staf yang membuat pesanan dengan hak aksesnya akan dicatat oleh sistem tagihan (modul
billing) untuk rekap pemotongan kuota layanan bulanan.
7. Pemecahan Masalah (Troubleshooting) Kesalahan Sistem Otentikasi
8. Referensi Terkait Pustaka Pengetahuan
Portal Admin & Self-Service
Pengaturan profil bisnis dan identitas branding toko.
Keamanan & Kepatuhan PDP
Standar perlindungan data pribadi dan enkripsi data karyawan.
Multi-Cabang & Jam Kerja
Alokasi lokasi outlet fisik dan jadwal operasional staf.
Live Inbox & CS Takeover
Ruang kerja interaksi percakapan harian untuk staf CS.
