Skip to Content

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

  1. Nama Peran — Admin memberi nama peran sesuai tanggung jawabnya, misalnya Kepala Toko atau Purchasing.
  2. Pilih Modul — Hak akses ditelusuri per modul, dan seluruh aksi dalam satu modul bisa dipilih sekaligus.
  3. Pilih Aksi — Di dalam modul, aksi dipilih per fitur atau satu per satu, sesuai kewenangan yang ingin diberikan.
  4. Validasi — Peran wajib punya nama dan sedikitnya satu hak akses sebelum bisa disimpan.
  5. Peran Tersimpan — Peran siap diberikan ke pengguna.
  6. Penugasan ke Pengguna — Peran dipilihkan untuk pengguna dari menu Pengguna, dan hak aksesnya langsung berlaku.

6. Document Structure

6.1 General

FieldTipeWajibDefaultAturan
Nama PeranTeksYa—— (BR-01)
Hak AksesRef. Aksi, banyakYa, minimal 1—Dipilih dari katalog hak akses (BR-01)

6.2 Hak Akses

LevelIsiKetentuan
ModulNama modul dan daftar fiturnyaMisalnya Purchase, Settings
FiturNama fitur dan daftar aksinyaMisalnya Purchase Order
AksiNama aksiYang 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

KolomSortableContoh NilaiKomponen
Nama Peran—Kepala TokoText
Hak Akses—24 hak aksesText
Aksi—Lihat · Ubah · HapusAction 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.

FieldKontrolSumber PilihanPerilaku
Nama PeranText Input——
Hak AksesTab per Modul, kartu per Fitur, chip per AksiKatalog 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.

IDKriteria penerimaan
AC-01.1Form berisi nama peran dan pemilih hak akses bertingkat Modul → Fitur → Aksi.
AC-01.2Nama peran wajib; minimal satu hak akses wajib dipilih.
AC-01.3Checkbox modul memilih/melepas semua aksi di modul; checkbox fitur memilih/melepas semua aksi di fitur.
AC-01.4Setiap fitur menampilkan jumlah aksi dan kotak pencarian aksi; semua fitur terbuka saat pertama dimuat.
AC-01.5Setelah berhasil, toast sukses tampil dan pengguna diarahkan ke daftar peran.
AC-01.6Nama peran duplikat — Perlu dikonfirmasi: apakah ditolak sebagai duplikat; error tampil pada field.
AC-01.7Katalog 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.

IDKriteria penerimaan
AC-02.1Detail hanya menampilkan modul dan fitur yang punya minimal satu aksi terpilih.
AC-02.2Checkbox 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.

IDKriteria penerimaan
AC-03.1Tombol Ubah Data hanya tampil untuk pengguna dengan izin update.
AC-03.2Validasi sama dengan pembuatan; tombol simpan aktif hanya jika ada perubahan.
AC-03.3Perubahan hak akses berlaku untuk semua pengguna yang memiliki peran tersebut.
AC-03.4Menghapus 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.5Hak akses peran diubah saat penggunanya sedang login — berlaku pada pemeriksaan permission berikutnya (render halaman atau panggilan API).
AC-03.6Perubahan peran tidak tercatat — peran belum memiliki log aktivitas di UI.

US-04 - Daftar peran

Sebagai owner, saya ingin melihat semua peran, agar mudah mengelolanya.

IDKriteria penerimaan
AC-04.1Kolom: nama peran dan jumlah hak akses.
AC-04.2Pencarian kata kunci dan paginasi.
AC-04.3Aksi baris: Lihat, Ubah, Hapus sesuai izin; hapus massal dari baris terpilih.

US-05 - Menghapus peran

Sebagai owner, saya ingin menghapus peran yang tidak dipakai.

IDKriteria penerimaan
AC-05.1Hapus satuan dan massal memerlukan konfirmasi dan izin delete.
AC-05.2Bila penghapusan ditolak, misalnya karena peran masih dipakai, pesan error tampil sebagai toast.

9. User Scenarios

RoleScenario
OwnerMembuat peran “Kasir” yang hanya boleh mengakses modul Sales
OwnerMembuat peran “Purchasing” dengan semua aksi PO kecuali Tutup
AdminMemeriksa hak akses peran “Kepala Toko” sebelum menugaskannya ke pengguna baru
OwnerMenghapus peran lama yang sudah tidak dipakai

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat List Peransettings:role:list:any—
Lihat Detail Peransettings:role:view:any—
Buat Peransettings:role:create:any—
Ubah Peransettings:role:update:any—
Hapus Peransettings: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.
Terakhir diperbarui