Role

Definisikan peran (Sales, Gudang, Admin) dan tentukan permission yang boleh diakses.

Role

Menu Role (/settings/roles) digunakan untuk membuat peran dan mengatur izin akses per modul. Setiap pengguna memiliki satu role yang menentukan menu apa saja yang tampil setelah login.

Untuk membuat akun login, lanjut ke Manajemen Pengguna. Untuk konsep dasar, baca Pengguna & Hak Akses.

Hak akses halaman: setting.roles.view · aksi form: roles.create, roles.edit

---

Fungsi menu

• Membuat role kustom sesuai divisi perusahaan (Sales, Gudang, Finance, dll.).
• Menetapkan permission per modul lewat matriks checkbox.
• Mengatur halaman default setelah login (otomatis atau manual).
• Melihat ringkasan jumlah user dan permission per role.

---

Prasyarat

• Login sebagai administrator atau pengguna dengan hak setting.roles.view.
• Untuk tambah/edit role: hak roles.create / roles.edit.
• Permission master sudah tersedia di sistem (bawaan atau dikustom di menu Hak Akses).

---

1. Daftar role

Buka Pengaturan → Role.

Screenshot diperlukan

Daftar Role

Menu: Pengaturan → Role (/settings/roles)

Simpan sebagai: /images/role/role-list.png

Yang di-capture: Halaman list penuh: kartu KPI (Total Role, User Terhubung, Permission Aktif), filter status, tabel dengan kolom Kode Role, Nama, Deskripsi, User, Permission, Status, Terakhir Diubah, Aksi. Isi 2–3 role contoh.

Kolom	Keterangan
Kode Role	Kode unik + tag Sistem jika role terkunci
Nama Role	Nama tampilan, mis. Sales, Admin Gudang
Deskripsi	Catatan fungsi role
User	Jumlah pengguna yang memakai role ini
Permission	Jumlah permission yang di-assign
Status	Aktif / Nonaktif
Terakhir Diubah	Tanggal dan waktu update terakhir
Aksi	Lihat · Edit · Menu lain (hapus)

Filter: Cari kode/nama/deskripsi · Status (Semua / Aktif / Nonaktif).

Klik baris role untuk membuka panel Lihat di sisi kanan.

---

2. Lihat detail role

Screenshot diperlukan

Detail Role (sidebar)

Menu: Pengaturan → Role → klik baris

Simpan sebagai: /images/role/role-detail.png

Yang di-capture: Panel kanan read-only: identitas role + daftar permission dikelompokkan per modul (Master Data, Penjualan, dll.) dengan badge aksi (Lihat, Buat, Edit). Tampilkan kotak pencarian permission.

Panel menampilkan permission yang sudah di-assign, dikelompokkan per modul. Gunakan kotak Cari untuk filter nama permission.

---

3. Tambah role

Klik Tambah Role → halaman form (/settings/roles/tambah).

Screenshot diperlukan

Form Tambah Role

Menu: Pengaturan → Role → Tambah Role

Simpan sebagai: /images/role/role-tambah.png

Yang di-capture: Form penuh: field Kode, Nama, Deskripsi, Mode Halaman Default, section permission ber-checkbox per grup modul (grid 2–3 kolom). Centang beberapa permission contoh.

Field	Wajib	Keterangan
Kode	Ya (buat baru)	Singkatan unik — contoh: sales, gudang, admin. Tidak bisa diubah setelah dibuat.
Nama	Ya	Nama role yang mudah dikenali tim
Deskripsi	Tidak	Catatan fungsi atau cakupan kerja
Mode Halaman Default	Tidak	Otomatis (dashboard pertama) atau Manual
Halaman Default	Tidak	Muncul jika mode Manual — pilih route landing setelah login
Permission	Tidak	Centang izin per modul — dikelompokkan: Dashboard, Master Data, Order, Inventori, dll.

Klik Simpan — sistem menyimpan role dan permission yang dipilih.

---

4. Edit role

Buka role dari daftar → Edit (/settings/roles/edit/:id).

Screenshot diperlukan

Form Edit Role

Menu: Pengaturan → Role → Edit

Simpan sebagai: /images/role/role-edit.png

Yang di-capture: Form edit dengan Kode readonly, checkbox permission terisi sebagian, tombol Simpan di bawah.

Perbarui nama, deskripsi, halaman default, atau centang/uncentang permission. Klik Simpan.

---

5. Hapus role

Dari menu aksi (⋯) pada baris role → Hapus → konfirmasi dialog.

Screenshot diperlukan

Konfirmasi Hapus Role

Menu: Pengaturan → Role → menu Hapus

Simpan sebagai: /images/role/role-hapus.png

Yang di-capture: Dialog konfirmasi: judul Konfirmasi Hapus, pesan Yakin ingin menghapus role [nama], tombol Ya Hapus dan Batal.

Role yang masih dipakai pengguna tidak bisa dihapus.

---

Contoh role umum

Gunakan sebagai acuan — sesuaikan permission dengan kebutuhan perusahaan Anda:

Role	Fokus kerja	Akses tipikal
Sales	Penjualan & pelanggan	Order, POS, pelanggan, laporan penjualan — tanpa akses akuntansi penuh
Gudang	Inventori & stok	Stok masuk/keluar, mutasi, koreksi — tanpa pengaturan role
Finance	Keuangan & laporan	Akuntansi, kas/bank, hutang/piutang, laporan keuangan
Admin	Konfigurasi sistem	Master data, pengaturan role, manajemen user — hampir semua modul

---

Role sistem vs role kustom

Jenis	Ciri	Batasan
Role sistem (terkunci)	Tag Sistem di daftar	Hanya akun developer yang bisa edit/hapus
Role bawaan	owner, admin, cashier, operator	Bisa diedit pengguna dengan hak roles.edit
Role kustom	Dibuat via form Tambah Role	Kode tidak bisa diubah setelah dibuat; hapus hanya jika tidak dipakai user

Keamanan — least privilege: Berikan permission seminimal mungkin. Jangan edit role sistem sembarangan. Uji dengan akun percobaan sebelum assign ke staf produksi.

Lanjutkan: Hak Akses (Permission) → atau Manajemen Pengguna →