Hak Akses (Permission)

Kelola daftar izin detail — view, create, edit, delete, manage — per modul aplikasi.

Hak Akses (Permission)

Menu Permission (/settings/permissions) menampilkan seluruh izin granular di Maparel. Permission diberi nama terstruktur (mis. master.product.view) dan dikelompokkan per modul.

Assign permission ke role dilakukan di halaman Role — centang izin yang diinginkan saat buat/edit role. Halaman ini untuk melihat, menambah, atau mengubah daftar permission itu sendiri.

Hak akses halaman: setting.permissions.view · aksi: permissions.create, permissions.edit, permissions.delete

---

Fungsi menu

• Melihat daftar lengkap permission yang tersedia di sistem.
• Menambah permission kustom (jika diperlukan pengembangan khusus).
• Mengelompokkan permission per modul (Master Data, Penjualan, Inventori, dll.).
• Memfilter berdasarkan grup atau tipe aksi (Lihat, Buat, Edit, Hapus, Kelola).

---

Prasyarat

• Login sebagai administrator atau pengguna dengan setting.permissions.view.
• Untuk tambah/edit/hapus: hak permissions.create, permissions.edit, atau permissions.delete.
• Pemahaman dasar role → lihat Pengguna & Hak Akses.

---

1. Daftar permission

Buka Pengaturan → Permission.

Screenshot diperlukan

Daftar Permission

Menu: Pengaturan → Permission (/settings/permissions)

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

Yang di-capture: Halaman list: kartu KPI (Total Permission, Grup Modul, Akses Lihat, Akses Kelola), filter grup, tabel Nama Permission (monospace), Deskripsi, Tipe (pill Lihat/Buat/Edit), Grup, Aksi.

Kolom	Keterangan
Nama Permission	Kode izin — format modul.submodul.aksi
Deskripsi	Penjelasan fungsi izin
Tipe	Badge aksi: Lihat, Buat, Edit, Hapus, Kelola, Export, Import, Akses
Grup	Kelompok modul — Master Data, Order, Inventori, Pengaturan, dll.
Aksi	Edit / Hapus (jika punya hak)

Filter: Cari nama/deskripsi/grup · Dropdown Grup (dinamis dari data).

---

2. Tambah permission

Klik Tambah Permission → panel kanan terbuka.

Screenshot diperlukan

Form Tambah Permission

Menu: Pengaturan → Permission → Tambah Permission

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

Yang di-capture: Panel kanan: field Nama (placeholder modul.submodul.aksi), Deskripsi, Grup. Tombol Simpan dan Batal.

Field	Wajib	Keterangan
Nama	Ya	Format modul.submodul.aksi — contoh: inventory.stock.view
Deskripsi	Tidak	Penjelasan kapan izin ini dipakai
Grup	Tidak	Kelompok modul — contoh: master, order, inventory, setting

Klik Simpan. Permission baru bisa langsung di-assign ke role.

---

3. Edit permission

Klik ikon edit pada baris permission.

Screenshot diperlukan

Form Edit Permission

Menu: Pengaturan → Permission → Edit

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

Yang di-capture: Panel edit: Nama readonly (tidak bisa diubah), Deskripsi dan Grup bisa diedit.

Nama permission tidak bisa diubah setelah dibuat — hanya deskripsi dan grup.

---

4. Hapus permission

Klik ikon hapus → konfirmasi dialog.

Screenshot diperlukan

Konfirmasi Hapus Permission

Menu: Pengaturan → Permission → Hapus

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

Yang di-capture: Dialog: pesan Yakin ingin menghapus permission [nama], tombol konfirmasi dan batal.

Hindari menghapus permission yang masih di-assign ke role aktif.

---

Cara assign permission ke role

Permission tidak di-assign langsung di halaman ini. Alurnya:

1. Buka Pengaturan → Role → Tambah atau Edit role
2. Scroll ke section Permission — dikelompokkan per modul
3. Centang izin yang dibutuhkan role tersebut
4. Simpan — sistem memanggil API update permission role

Screenshot diperlukan

Matriks Permission di Form Role

Menu: Pengaturan → Role → Edit Role

Simpan sebagai: /images/permission/permission-matrix.png

Yang di-capture: Section permission di form role: grup Master Data, Penjualan, dll. dengan checkbox card per permission. Tampilkan beberapa centang aktif.

---

Pola penamaan permission

Segmen	Contoh	Arti
Modul	master	Area fitur utama
Submodul	product	Menu atau entitas spesifik
Aksi	view	Hak melihat daftar/detail
Aksi	create / edit / delete	Hak tambah / ubah / hapus data
Aksi	manage	Hak kelola penuh submodul

Contoh lengkap: master.product.view, order.sales.create, pos.shift.open, staff.attendance.clock, setting.roles.view.

---

Grup modul umum

Grup	Cakupan
dashboard	Widget dan ringkasan dashboard
master	Master Data — produk, gudang, user, dll.
order / pos	Penjualan, kasir, shift POS (pos.shift.*)
staff	Staf/karyawan, absensi (staff.attendance.*)
inventory	Stok, mutasi, koreksi
production	Work order, resep, produksi
accounting / reports	Akuntansi dan laporan
setting	Role, permission, menu, kebijakan

---

Tips keamanan

Least privilege: Jangan beri permission manage atau delete kecuali benar-benar diperlukan. Permission kustom sebaiknya dibuat oleh tim teknis yang paham dampaknya ke seluruh sistem.

Lanjutkan: Role → untuk assign permission, lalu Manajemen Pengguna → untuk membuat akun.