Peran & Izin
- Code: SET-ROL
- Module: Settings
- Type: Master Data
1. Overview
Peran adalah kumpulan hak akses yang diberikan ke pengguna. Admin membuat peran seperti “Kepala Toko” atau “Purchasing”, lalu memilih hak aksesnya dari katalog yang disusun bertingkat: Modul → Fitur → Aksi. Pengguna bisa punya lebih dari satu peran, dan hak aksesnya adalah gabungan semua perannya. Setiap hak akses juga punya cakupan: berlaku untuk semua toko, atau terbatas pada toko tempat pengguna ditugaskan.
Hasil yang diharapkan: tenant bisa mengatur siapa boleh melakukan apa tanpa perubahan kode, dengan granularitas sampai level aksi.
2. Problem
Tanpa pengelompokan hak akses berbasis peran, mengatur siapa boleh melakukan apa harus dilakukan satu per satu untuk setiap orang, dan sulit diskalakan. Akibatnya:
- Tugas staf berbeda-beda; memberi semua akses ke semua orang berisiko.
- Hak akses yang hanya dibedakan per modul terlalu kasar, misalnya staf boleh membuat PO tetapi tidak boleh mengajukannya.
- Mengatur hak akses per orang tidak bisa diskalakan; perlu dikelompokkan per peran.
3. Goals & Non-goals
3.1 Goals
- Akses bisa dibatasi sampai level aksi, misalnya boleh membuat pesanan tetapi tidak boleh mengajukannya.
- Kewenangan diatur sekali per peran, lalu dipakai ulang untuk semua orang dengan tanggung jawab yang sama.
- Isi kewenangan sebuah peran bisa diperiksa sebelum diberikan ke orang lain.
- Perubahan kewenangan bisa dilakukan sendiri oleh tenant, tanpa melibatkan tim teknis.
3.2 Non-goals
- Membuat jenis hak akses baru dari dalam aplikasi; katalognya sudah ditentukan lebih dulu.
- Pemberian hak akses langsung ke pengguna di luar peran.
- Pembatasan ke toko tertentu di level peran; cakupan toko mengikuti penugasan penggunanya.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Peran di seluruh aplikasi, pada semua layar dan aksi yang melibatkannya, siapa pun yang melakukannya. Aturan ini menjadi sumber kebenaran tunggal: bila bagian lain di PRD ini tampak berbeda, aturan di sinilah yang berlaku.
- BR-01 Setiap peran wajib memiliki nama dan sedikitnya satu hak akses.
- BR-02 Setiap hak akses berlaku untuk satu aksi pada satu fitur, dengan cakupan seluruh data atau terbatas pada toko tempat pengguna ditugaskan.
- BR-03 Hak akses yang berlaku bagi seorang pengguna adalah gabungan dari seluruh perannya.
- BR-04 Katalog hak akses sudah ditentukan lebih dulu dan tidak bisa ditambah atau diubah dari halaman ini.
- BR-05 Pengguna tanpa hak akses tidak bisa membuka halaman atau menjalankan aksi terkait, dari jalur mana pun aksi itu dipicu.
- BR-06 Menu navigasi hanya menampilkan item yang hak aksesnya dimiliki pengguna.
5. Flow
5.1 Main Flowchart
- Nama Peran — Admin memberi nama peran sesuai tanggung jawabnya, misalnya Kepala Toko atau Purchasing.
- Pilih Modul — Hak akses ditelusuri per modul, dan seluruh aksi dalam satu modul bisa dipilih sekaligus.
- Pilih Aksi — Di dalam modul, aksi dipilih per fitur atau satu per satu, sesuai kewenangan yang ingin diberikan.
- Validasi — Peran wajib punya nama dan sedikitnya satu hak akses sebelum bisa disimpan.
- Peran Tersimpan — Peran siap diberikan ke pengguna.
- Penugasan ke Pengguna — Peran dipilihkan untuk pengguna dari menu Pengguna, dan hak aksesnya langsung berlaku.
6. Document Structure
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Nama Peran | Teks | Ya | — | — (BR-01) |
| Hak Akses | Ref. Aksi, banyak | Ya, minimal 1 | — | Dipilih dari katalog hak akses (BR-01) |
6.2 Hak Akses
| Level | Isi | Ketentuan |
|---|---|---|
| Modul | Nama modul dan daftar fiturnya | Misalnya Purchase, Settings |
| Fitur | Nama fitur dan daftar aksinya | Misalnya Purchase Order |
| Aksi | Nama aksi | Yang tersimpan di peran, ditampilkan dan bisa dicari |
7. UI Structure
Bagian ini mendefinisikan cara Peran ditampilkan dan dioperasikan: kolom pada daftar dan kontrol form beserta sumber pilihannya. Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.
7.1 Datatable
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Nama Peran | — | Kepala Toko | Text |
| Hak Akses | — | 24 hak akses | Text |
| Aksi | — | Lihat · Ubah · Hapus | Action Menu |
7.2 Form & Details
Buat — Form Nama Peran, diikuti pemilih hak akses bertingkat: tab per Modul, di dalamnya kartu per Fitur, dan chip per Aksi. Aksi: Simpan.
Ubah — Susunan sama seperti Buat, terisi hak akses yang sudah dipilih. Aksi: Simpan, aktif hanya jika ada perubahan.
Detail — Susunan sama, tetapi checkbox disembunyikan dan hanya modul serta fitur yang punya aksi terpilih yang ditampilkan. Aksi: Ubah Data, Hapus.
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Nama Peran | Text Input | — | — |
| Hak Akses | Tab per Modul, kartu per Fitur, chip per Aksi | Katalog hak akses (Modul → Fitur → Aksi) | Checkbox Modul memilih semua aksi di modul; checkbox Fitur memilih semua aksi di fitur; tiap kartu Fitur punya kotak pencarian aksi |
8. User Stories
US-01 - Membuat peran
Sebagai owner, saya ingin membuat peran dengan hak akses tertentu, agar bisa diberikan ke pengguna.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Form berisi nama peran dan pemilih hak akses bertingkat Modul → Fitur → Aksi. |
| AC-01.2 | Nama peran wajib; minimal satu hak akses wajib dipilih. |
| AC-01.3 | Checkbox modul memilih/melepas semua aksi di modul; checkbox fitur memilih/melepas semua aksi di fitur. |
| AC-01.4 | Setiap fitur menampilkan jumlah aksi dan kotak pencarian aksi; semua fitur terbuka saat pertama dimuat. |
| AC-01.5 | Setelah berhasil, toast sukses tampil dan pengguna diarahkan ke daftar peran. |
| AC-01.6 | Nama peran duplikat — Perlu dikonfirmasi: apakah ditolak sebagai duplikat; error tampil pada field. |
| AC-01.7 | Katalog permission kosong — tampil “Data tidak ditemukan” di pemilih hak akses. |
US-02 - Melihat detail peran
Sebagai admin, saya ingin melihat hak akses sebuah peran, agar yakin sebelum menugaskannya.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Detail hanya menampilkan modul dan fitur yang punya minimal satu aksi terpilih. |
| AC-02.2 | Checkbox tidak tampil dan tab modul tidak bisa mengubah pilihan. |
US-03 - Mengubah peran
Sebagai owner, saya ingin mengubah nama atau hak akses peran, agar sesuai kebutuhan terbaru.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Tombol Ubah Data hanya tampil untuk pengguna dengan izin update. |
| AC-03.2 | Validasi sama dengan pembuatan; tombol simpan aktif hanya jika ada perubahan. |
| AC-03.3 | Perubahan hak akses berlaku untuk semua pengguna yang memiliki peran tersebut. |
| AC-03.4 | Menghapus atau mengurangi hak akses peran milik admin yang sedang login — tidak dicegah saat pengisian; harus ditolak saat disimpan agar tenant tidak kehilangan seluruh akses Settings. |
| AC-03.5 | Hak akses peran diubah saat penggunanya sedang login — berlaku pada pemeriksaan permission berikutnya (render halaman atau panggilan API). |
| AC-03.6 | Perubahan peran tidak tercatat — peran belum memiliki log aktivitas di UI. |
US-04 - Daftar peran
Sebagai owner, saya ingin melihat semua peran, agar mudah mengelolanya.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Kolom: nama peran dan jumlah hak akses. |
| AC-04.2 | Pencarian kata kunci dan paginasi. |
| AC-04.3 | Aksi baris: Lihat, Ubah, Hapus sesuai izin; hapus massal dari baris terpilih. |
US-05 - Menghapus peran
Sebagai owner, saya ingin menghapus peran yang tidak dipakai.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | Hapus satuan dan massal memerlukan konfirmasi dan izin delete. |
| AC-05.2 | Bila penghapusan ditolak, misalnya karena peran masih dipakai, pesan error tampil sebagai toast. |
9. User Scenarios
| Role | Scenario |
|---|---|
| Owner | Membuat peran “Kasir” yang hanya boleh mengakses modul Sales |
| Owner | Membuat peran “Purchasing” dengan semua aksi PO kecuali Tutup |
| Admin | Memeriksa hak akses peran “Kepala Toko” sebelum menugaskannya ke pengguna baru |
| Owner | Menghapus peran lama yang sudah tidak dipakai |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Peran | settings:role:list:any | — |
| Lihat Detail Peran | settings:role:view:any | — |
| Buat Peran | settings:role:create:any | — |
| Ubah Peran | settings:role:update:any | — |
| Hapus Peran | settings:role:delete:any | — |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- Users — peran ditugaskan ke pengguna.
- Semua modul — setiap halaman dan aksi dijaga kunci permission.
Efek ke modul lain
- Perubahan peran langsung memengaruhi menu sidebar dan aksi yang tersedia bagi semua pengguna pemilik peran tersebut.