Role dan Permission

Role menentukan menu dan aksi yang bisa dipakai user. KartuStok memakai role access untuk memisahkan tanggung jawab gudang, finance, admin, dan integrasi.

Siapa yang Menggunakan Halaman Ini

Administrator memakai halaman ini untuk membuat paket permission sebelum dipasang ke user. Role yang baik mengurangi kesalahan karena user hanya melihat menu, aksi, dan field harga yang dibutuhkan pekerjaannya.

Lokasi Menu dan Akses

Buka Manage -> Users & Permissions -> Roles & Permissions. Membuat atau mengubah role membutuhkan permission role.

Area Permission

Area	Mengatur
Transaction	Receipt, Issue, Move, dan Adjustment untuk list/create/update/delete.
Master Data	Item, Item Category, Unit of Measure, dan Warehouse.
Report	Akses laporan stok.
Settings	Company settings dan konfigurasi perusahaan.
Dashboard Minimum Quantity	Blok minimum stock di dashboard.
Price	Switch View mengizinkan melihat harga. Switch Update mengizinkan mengubah harga.
Custom Form	Custom field item dan transaksi.
Import	Import item, category, UOM, warehouse, minimum stock, atau transaksi.
Print Template	Mengatur layout print transaksi.
API Access	Mengatur token API.

Membuat Role

1. Buka Roles & Permissions.
2. Pilih Create Role.
3. Isi nama role yang jelas, misalnya Warehouse Staff atau Finance Viewer.
4. Aktifkan hanya permission yang dibutuhkan role tersebut.
5. Simpan role.
6. Assign role ke user test dan cek akses menu.

Pola Role yang Disarankan

Role	Akses Umum
Administrator	Akses penuh settings, master data, user, transaksi, report, import, dan template.
Warehouse Staff	Membuat Receipt/Issue/Move/Adjustment tanpa akses settings atau harga.
Warehouse Supervisor	Akses transaksi dan report, dengan update jika diperlukan.
Finance / Owner	Akses report dan visibilitas harga saat pricing aktif.
Integrator Admin	API Access dan master data pendukung terbatas.

Contoh Role Operasional

Role	Permission Umum	Akses Harga
Admin	Settings, users, roles, semua master data, semua transaksi, report, import, template.	View dan Update jika company mengizinkan harga.
Staff Gudang	Create/update Receipt/Issue/Move, view master data tertentu, tanpa settings.	Biasanya tidak ada.
Supervisor	View/update transaksi, report, dashboard minimum quantity, calendar period jika bertanggung jawab closing.	View saja jika ikut review nilai.
Finance / Owner	Report, print/export, pricing, API access jika perlu.	View, dan Update hanya untuk user tepercaya.

Gunakan ini sebagai contoh, bukan template wajib. Hapus permission yang tidak dibutuhkan pekerjaan harian user.

Row Price

Kolom Role Table	Arti
View	User bisa melihat Default Cost, Unit Price, Amount, dan kolom laporan terkait harga.
Update	User bisa mengubah Default Cost dan Unit Price saat pricing aktif.

Secara teknis aplikasi menyimpan ini sebagai permission harga, tetapi user melihatnya sebagai row Price di tabel role. Permission harga tidak menampilkan apa pun jika pricing perusahaan belum diaktifkan.

Penting: Role access menentukan menu dan aksi yang boleh dibuka user. Ini berbeda dari default operasional seperti Default Warehouse pada profile user.

Gunakan bagian warehouse access pada form role untuk membatasi gudang asal dan tujuan yang boleh diakses user. Gunakan halaman Users hanya untuk assign role dan mengatur default pribadi seperti Default Warehouse.

Masalah Umum

Masalah	Cara Memperbaiki
User melihat terlalu banyak menu	Hapus permission yang tidak diperlukan dari role.
User tidak bisa export atau import	Cek permission aksi spesifik, bukan hanya view.
Price aktif tetapi user tidak melihat harga	Cek Enable Price di settings dan switch View pada row Price.
Perubahan role belum terlihat	Minta user refresh atau login ulang.