title: “RBAC & User Management” description: “Role-Based Access Control: RoleManager 1398 baris, 13 role templates, 38 permissions, 3 SoD rules, ERPAccessGuard, MenuAccessProfile, dan real-time sync.”

RBAC & User Management

Quinn of Spicy menggunakan Role-Based Access Control (RBAC) yang sophisticated untuk mengontrol akses user berdasarkan peran dan tanggung jawab masing-masing. RoleManager.jsx (1398 baris) adalah komponen inti yang mengelola member invitation, role assignment, dan permission matrix dengan 13 role templates dan 38 granular permissions. Sistem ini juga mengimplementasikan Segregation of Duties (SoD) — 3 aturan kritis yang mencegah conflict of interest: stock opname counter tidak bisa jadi approver, production operator tidak bisa jadi QC approver, dan CS tidak bisa verifikasi transaksi tunai. Permission resolution menggunakan useCompanyRole.jsx hook (524 baris) dengan aggressive caching (60-second TTL), deduplication of in-flight fetches, dan real-time cache invalidation via BroadcastChannel. Sistem RBAC Quinn of Spicy dibangun di atas lima entitas inti yang saling terhubung: User, Company, CompanyMember, CompanyInvitation, dan MenuAccessProfile. Kelima entitas ini membentuk fondasi kontrol akses multi-tenant yang memastikan setiap pengguna hanya dapat mengakses fitur, menu, dan data sesuai dengan peran dan izin yang diberikan.

Arsitektur Komponen

Ringkasan Alur Kontrol Akses

Sistem RBAC bekerja dalam tiga lapisan utama:

Lapisan Autentikasi — User login dan sistem memverifikasi identitas melalui entity User. Setiap user memiliki admin_type dan admin_tier yang menentukan hak akses di level platform.
Lapisan Keanggotaan Company — Entity CompanyMember menghubungkan user ke company tertentu dengan role dan permissions. Satu user bisa menjadi member di beberapa company sekaligus.
Lapisan Akses Menu — Entity MenuAccessProfile memetakan role ke daftar menu yang boleh ditampilkan, sehingga sidebar navigasi otomatis menyesuaikan dengan hak akses pengguna.

Entity Relationship Diagram

Entity Schema Tables

User

Entitas User merepresentasikan akun pengguna platform. Setiap pengguna memiliki identitas unik, preferensi subscription, dan hak akses administratif di level platform (berbeda dengan hak akses di level company).

Field	Tipe	Required	Default	Deskripsi
`id`	string (UUID)	Ya	Auto-generated	Primary key unik untuk setiap user
`email`	string	Ya	—	Alamat email pengguna (unique)
`full_name`	string	Ya	—	Nama lengkap pengguna
`role`	enum	Tidak	—	Role di level aplikasi: `admin` atau `user`
`admin_type`	enum	Tidak	—	Tipe admin platform: `owner` (full access aplikasi) atau `basic` (hanya transaksi produk digital). Berbeda dengan company owner
`admin_tier`	enum	Tidak	`none`	Tier admin untuk company management: `none`, `business`, `advanced`, `enterprise`
`subscription_plan`	enum	Tidak	`free`	Plan membership aktif: `free`, `pro`, `business`, `advanced`, `enterprise`
`subscription_start`	date-time	Tidak	—	Tanggal mulai subscription aktif
`subscription_end`	date-time	Tidak	—	Tanggal berakhir subscription aktif
`membership_duration_type`	enum	Tidak	—	Durasi membership: `monthly`, `yearly`, `custom`, `lifetime`
`membership_start_date`	date	Tidak	—	Tanggal mulai membership
`membership_end_date`	date	Tidak	—	Tanggal berakhir membership
`is_readonly_mode`	boolean	Tidak	`false`	Mode read-only saat expired dalam grace period 3 hari
`active_company_id`	string	Tidak	—	ID company yang sedang aktif untuk Business+ users
`company_slots_purchased`	number	Tidak	`0`	Slot company tambahan yang dibeli di luar limit plan
`balance`	number	Tidak	`0`	Saldo deposit untuk membeli membership/addon
`commission_balance`	number	Tidak	`0`	Saldo komisi referral yang dapat ditarik
`admin_commission_balance`	number	Tidak	`0`	Saldo komisi admin basic dari proses transaksi
`total_earnings`	number	Tidak	`0`	Total komisi yang pernah diterima (akumulasi)
`productivity_score`	number	Tidak	`0`	Skor produktivitas pengguna
`user_level`	number	Tidak	`1`	Level pengguna berdasarkan achievement points
`preferences`	object	Tidak	—	Preferensi UI: `theme`, `primary_color`, `wallpaper_url`, `referral_modal_dismissed`

Company

Entitas Company merepresentasikan perusahaan atau organisasi yang menggunakan sistem ERP. Setiap company memiliki owner, konfigurasi modul aktif, dan pengaturan operasional.

Field	Tipe	Required	Default	Deskripsi
`id`	string (UUID)	Ya	Auto-generated	Primary key unik untuk setiap company
`name`	string	Ya	—	Nama perusahaan
`owner_id`	string	Ya	—	ID user yang menjadi pemilik company
`owner_email`	string	Ya	—	Email pemilik company
`owner_subscription_plan`	enum	Tidak	—	Plan membership owner: `free`, `pro`, `business`, `advanced`, `enterprise`
`description`	string	Tidak	—	Deskripsi perusahaan
`industry`	enum	Tidak	—	Sektor industri: `retail`, `manufacturing`, `services`, `technology`, `food_beverage`, `healthcare`, `education`, `other`
`address`	string	Tidak	—	Alamat fisik perusahaan
`phone`	string	Tidak	—	Nomor telepon perusahaan
`email`	string	Tidak	—	Alamat email perusahaan
`website`	string	Tidak	—	URL website perusahaan
`logo_url`	string	Tidak	—	URL logo perusahaan
`tax_id`	string	Tidak	—	NPWP perusahaan
`employee_count`	number	Tidak	`0`	Jumlah karyawan
`business_type`	string	Tidak	—	Kategori bisnis yang dipilih saat onboarding
`active_modules`	string	Tidak	—	JSON string berisi array ID modul yang aktif
`metadata`	object	Tidak	—	Data tambahan / legacy
`landing_page_config`	object	Tidak	—	Konfigurasi landing page perusahaan
`settings`	object	Tidak	—	Pengaturan operasional: jam kerja, kebijakan cuti, threshold expiry, strategi alokasi batch, konfigurasi pajak, perlakuan spoilage

CompanyMember

Entitas CompanyMember adalah jantung dari sistem RBAC — menghubungkan user ke company dengan role dan 38 permission flags yang sangat granular.

Field	Tipe	Required	Default	Deskripsi
`id`	string (UUID)	Ya	Auto-generated	Primary key unik
`company_id`	string	Ya	—	ID company tempat user menjadi member
`user_id`	string	Tidak	—	ID user yang menjadi member
`user_email`	string	Ya	—	Email user yang menjadi member
`user_name`	string	Tidak	—	Nama lengkap user
`role`	enum	Tidak	`employee`	Role dalam perusahaan (lihat tabel role di bawah)
`employee_id`	string	Tidak	—	Link ke entitas Employee untuk integrasi HR
`department`	string	Tidak	—	Departemen tempat member bekerja
`position`	string	Tidak	—	Jabatan/posisi member
`status`	enum	Tidak	`active`	Status keanggotaan: `active`, `inactive`, `pending`
`joined_date`	date	Tidak	—	Tanggal bergabung ke company
`invited_by`	string	Tidak	—	Email user yang mengundang member ini
`permissions`	object	Tidak	—	38 flag hak akses detail (lihat tabel lengkap di bawah)
`assigned_locations`	array[string]	Tidak	—	Daftar ID lokasi gudang/outlet yang diizinkan (RBAC-01)
`working_hours`	object	Tidak	—	Jam kerja: `start` (default `09:00`) dan `end` (default `17:00`)
`salary`	number	Tidak	—	Gaji karyawan (opsional)
`notes`	string	Tidak	—	Catatan tambahan mengenai member

CompanyInvitation

Entitas CompanyInvitation merepresentasikan undangan keanggotaan yang dikirimkan kepada user yang belum bergabung. Invitation memiliki lifecycle status yang jelas dan akan expired setelah waktu yang ditentukan.

Field	Tipe	Required	Default	Deskripsi
`id`	string (UUID)	Ya	Auto-generated	Primary key unik
`company_id`	string	Ya	—	ID company yang mengirim undangan
`company_name`	string	Tidak	—	Nama company (untuk tampilan)
`invited_email`	string	Ya	—	Email calon member yang diundang
`invited_by`	string	Ya	—	Email user yang mengirim undangan
`invited_by_name`	string	Tidak	—	Nama pengundang
`role`	enum	Tidak	`employee`	Role yang ditawarkan: `owner`, `admin`, `supervisor`, `store_admin`, `stock_admin`, `finance_admin`, `hr_admin`, `transaction_admin`, `employee`
`department`	string	Tidak	—	Departemen yang ditawarkan
`position`	string	Tidak	—	Jabatan yang ditawarkan
`description`	string	Tidak	—	Pesan tambahan dalam undangan (maks. 1000 karakter)
`permissions`	object	Tidak	—	Hak akses awal yang ditawarkan (24 flag dasar)
`message`	string	Tidak	—	Pesan personal untuk invitee
`status`	enum	Tidak	`pending`	Status undangan: `pending`, `accepted`, `rejected`, `expired`, `cancelled`
`expires_at`	date-time	Tidak	—	Waktu kedaluwarsa undangan
`accepted_at`	date-time	Tidak	—	Timestamp saat undangan diterima
`rejected_at`	date-time	Tidak	—	Timestamp saat undangan ditolak
`cancelled_at`	date-time	Tidak	—	Timestamp saat undangan dibatalkan

MenuAccessProfile

Entitas MenuAccessProfile mendefinisikan profil akses menu per role — menentukan menu/sidebar mana saja yang boleh ditampilkan untuk setiap role dalam suatu company.

Field	Tipe	Required	Default	Deskripsi
`id`	string (UUID)	Ya	Auto-generated	Primary key unik
`company_id`	string	Ya	—	ID perusahaan (isolasi data per company)
`role`	enum	Ya	—	Role yang menggunakan profil: `owner`, `admin`, `supervisor`, `store_admin`, `stock_admin`, `finance_admin`, `hr_admin`, `transaction_admin`, `employee`
`profile_name`	string	Ya	—	Nama profil akses menu
`description`	string	Tidak	—	Penjelasan hak akses menu (maks. 1000 karakter)
`allowed_menus`	array[string]	Ya	—	Daftar ID menu yang diizinkan untuk role ini
`dashboard_type`	enum	Tidak	`employee`	Tipe tampilan dashboard: `owner`, `admin`, `supervisor`, `employee`, `cashier`, `finance`, `hr`, `inventory`
`is_default`	boolean	Tidak	`true`	Apakah ini profil default untuk role ini
`created_by`	string	Tidak	—	Email owner yang membuat profil

13 Role Templates

Sistem RBAC Quinn of Spicy mendukung 13 role templates yang dirancang untuk mencakup berbagai fungsi operasional dalam perusahaan ERP. Setiap role memiliki set permission default yang dapat dikustomisasi lebih lanjut.

Role	Emoji	Akses Utama	Key Permissions
Owner	👑	Full access	Semua permissions — bypass semua check
Admin	🛡️	Operational + reporting	Semua kecuali settings edit dan role management
Supervisor	👁️	Read-only oversight	Read-only finance/inventory/HR
Store Admin	🏪	Toko & outlet	POS management, shift cashier, store settings
Stock Admin	📦	Warehouse ops	Stock management, movements, barcode, suppliers
Finance Admin	💳	Accounting	Invoices, expenses, bank accounts, GL, reports
HR Admin	👥	Human resources	Employees, attendance, payroll, leave management
Transaction Admin	🧾	Transaksi	POS create orders, process payments, view products
Employee	👤	Basic access	Dashboard, tasks, notes — akses dasar
Production Operator	🏭	Manufacturing	Production orders, BOM view, batch creation
QC Inspector	🔬	Quality control	QC records, batch verification, release approval
Sales & Marketing	📈	Sales channel	Channel pricing, distribution, B2B invoices
Partner/Distributor	🤝	B2B partnership	Distribution shipment, B2B invoice view

38 Permission Flags — Matriks Lengkap

Berikut adalah seluruh 38 permission flags yang tersedia dalam CompanyMember.permissions dan CompanyInvitation.permissions. Setiap flag bertipe boolean dan dapat diaktifkan/nonaktifkan secara independen.

Dashboard & Tugas

Permission	Tipe	Default	Deskripsi
`can_view_dashboard`	boolean	`true`	Akses untuk melihat dashboard utama company
`can_view_tasks`	boolean	`true`	Akses untuk melihat daftar tugas
`can_create_tasks`	boolean	`true`	Akses untuk membuat tugas baru
`can_edit_tasks`	boolean	`true`	Akses untuk mengedit tugas yang ada
`can_delete_tasks`	boolean	`false`	Akses untuk menghapus tugas

Catatan (Notes)

Permission	Tipe	Default	Deskripsi
`can_view_notes`	boolean	`true`	Akses untuk melihat catatan
`can_create_notes`	boolean	`true`	Akses untuk membuat catatan baru
`can_edit_notes`	boolean	`true`	Akses untuk mengedit catatan
`can_delete_notes`	boolean	`false`	Akses untuk menghapus catatan

HR & Payroll

Permission	Tipe	Default	Deskripsi
`can_view_hr`	boolean	`false`	Akses untuk melihat data karyawan, absensi, dan payroll
`can_edit_hr`	boolean	`false`	Akses untuk mengedit data karyawan, memproses absensi dan payroll

Keuangan (Finance)

Permission	Tipe	Default	Deskripsi
`can_view_finance`	boolean	`false`	Akses untuk melihat invoice, expense, bank account, dan laporan keuangan
`can_edit_finance`	boolean	`false`	Akses untuk membuat/mengedit transaksi keuangan, expense, dan journal entry

Inventaris (Inventory)

Permission	Tipe	Default	Deskripsi
`can_view_inventory`	boolean	`false`	Akses untuk melihat stok, lokasi gudang, dan pergerakan inventaris
`can_edit_inventory`	boolean	`false`	Akses untuk mengelola stok, membuat pergerakan, dan mengedit data inventaris
`can_transfer_inventory`	boolean	`false`	Akses untuk melakukan transfer stok antar gudang/outlet
`can_approve_stock_opname`	boolean	`false`	Akses untuk menyetujui hasil stock opname (SoD: tidak boleh sama dengan `can_count_stock_opname`)
`can_count_stock_opname`	boolean	`false`	Akses untuk menghitung stok saat stock opname (SoD: tidak boleh sama dengan `can_approve_stock_opname`)

Proyek (Projects)

Permission	Tipe	Default	Deskripsi
`can_view_projects`	boolean	`false`	Akses untuk melihat daftar dan detail proyek
`can_edit_projects`	boolean	`false`	Akses untuk membuat dan mengedit proyek

POS / Kasir

Permission	Tipe	Default	Deskripsi
`can_view_pos`	boolean	`false`	Akses untuk melihat halaman POS dan transaksi
`can_use_pos`	boolean	`false`	Akses untuk menggunakan POS: membuat order, memproses pembayaran
`can_manage_cashier_shift`	boolean	`false`	Akses untuk mengelola shift kasir: buka/tutup shift, setoran

Laporan (Reports)

Permission	Tipe	Default	Deskripsi
`can_view_reports`	boolean	`false`	Akses untuk melihat laporan analitik dan reporting

Manajemen User & Settings

Permission	Tipe	Default	Deskripsi
`can_manage_members`	boolean	`false`	Akses untuk mengundang, mengedit, dan menghapus member company
`can_manage_roles`	boolean	`false`	Akses untuk mengelola role dan permission templates
`can_view_settings`	boolean	`false`	Akses untuk melihat halaman pengaturan company
`can_edit_settings`	boolean	`false`	Akses untuk mengubah pengaturan company

Produksi (Manufacturing)

Permission	Tipe	Default	Deskripsi
`can_create_production_batch`	boolean	`false`	Akses untuk membuat batch produksi baru
`can_release_production_qc`	boolean	`false`	Akses untuk merilis batch setelah QC (SoD: tidak boleh sama dengan `can_create_production_batch`)
`can_view_hpp`	boolean	`false`	Akses untuk melihat perhitungan HPP (Harga Pokok Produksi)

Distribusi & Sales Channel

Permission	Tipe	Default	Deskripsi
`can_manage_channel_pricing`	boolean	`false`	Akses untuk mengelola harga per sales channel
`can_view_distribution`	boolean	`false`	Akses untuk melihat data distribusi dan shipment
`can_create_distribution_shipment`	boolean	`false`	Akses untuk membuat shipment distribusi baru
`can_confirm_distribution_shipment`	boolean	`false`	Akses untuk mengkonfirmasi penerimaan shipment distribusi

B2B & Invoice

Permission	Tipe	Default	Deskripsi
`can_view_b2b_invoices`	boolean	`false`	Akses untuk melihat invoice B2B
`can_create_b2b_invoice`	boolean	`false`	Akses untuk membuat invoice B2B baru
`can_verify_b2b_payment`	boolean	`false`	Akses untuk memverifikasi pembayaran B2B (SoD: tidak boleh dipegang oleh CS Agent)

Enum Reference Tables

CompanyMember.role

Nilai	Deskripsi
`owner`	Pemilik company — akses penuh tanpa batasan
`admin`	Administrator operasional — akses luas kecuali ownership
`supervisor`	Pengawas — akses read-only ke sebagian besar modul
`store_admin`	Administrator toko — mengelola POS dan outlet
`stock_admin`	Administrator gudang — mengelola inventaris
`finance_admin`	Administrator keuangan — mengelola invoice, expense, GL
`hr_admin`	Administrator HR — mengelola karyawan, absensi, payroll
`transaction_admin`	Administrator transaksi — mengelola order POS dan pembayaran
`employee`	Karyawan biasa — akses dasar dashboard dan tugas
`production_operator`	Operator produksi — mengelola batch produksi
`qc_inspector`	Inspector QC — verifikasi kualitas dan rilis batch
`sales_marketing`	Sales & marketing — mengelola pricing channel dan distribusi
`partner_distributor`	Partner/distributor — akses terbatas untuk B2B

CompanyInvitation.role

Nilai	Deskripsi
`owner`	Pemilik company
`admin`	Administrator operasional
`supervisor`	Pengawas read-only
`store_admin`	Administrator toko
`stock_admin`	Administrator gudang
`finance_admin`	Administrator keuangan
`hr_admin`	Administrator HR
`transaction_admin`	Administrator transaksi
`employee`	Karyawan biasa (default)

CompanyMember.status

Nilai	Deskripsi
`active`	Member aktif — memiliki akses penuh sesuai permissions
`inactive`	Member nonaktif — akses ditolak
`pending`	Member menunggu konfirmasi — akses terbatas

CompanyInvitation.status

Nilai	Deskripsi
`pending`	Undangan belum direspon
`accepted`	Undangan diterima — CompanyMember dibuat
`rejected`	Undangan ditolak oleh invitee
`expired`	Undangan kedaluwarsa sebelum direspon
`cancelled`	Undangan dibatalkan oleh pengirim

User.role

Nilai	Deskripsi
`admin`	Administrator platform — akses ke manajemen seluruh company
`user`	Pengguna biasa — hanya mengakses company yang menjadi member

User.admin_type

Nilai	Deskripsi
`owner`	Owner platform — full access ke seluruh fitur aplikasi
`basic`	Admin basic — hanya akses transaksi produk digital

Catatan Penting: admin_type adalah hak akses di level platform/aplikasi, bukan di level company. Company owner ditentukan oleh field Company.owner_id.

User.admin_tier

Nilai	Deskripsi
`none`	Tidak memiliki hak admin company (default)
`business`	Admin tier business — company management dasar
`advanced`	Admin tier advanced — company management lanjutan
`enterprise`	Admin tier enterprise — company management penuh

User.subscription_plan

Nilai	Deskripsi
`free`	Plan gratis — fitur dasar
`pro`	Plan profesional — fitur lanjutan
`business`	Plan bisnis — multi-company, RBAC penuh
`advanced`	Plan advanced — fitur enterprise parsial
`enterprise`	Plan enterprise — semua fitur tanpa batasan

User.membership_duration_type

Nilai	Deskripsi
`monthly`	Membership bulanan
`yearly`	Membership tahunan
`custom`	Durasi kustom
`lifetime`	Membership seumur hidup

Company.industry

Nilai	Deskripsi
`retail`	Ritel dan perdagangan
`manufacturing`	Manufaktur dan produksi
`services`	Jasa dan layanan
`technology`	Teknologi dan perangkat lunak
`food_beverage`	Makanan dan minuman (F&B)
`healthcare`	Kesehatan dan farmasi
`education`	Pendidikan dan pelatihan
`other`	Industri lainnya

MenuAccessProfile.role

Nilai	Deskripsi
`owner`	Profil akses untuk role owner
`admin`	Profil akses untuk role admin
`supervisor`	Profil akses untuk role supervisor
`store_admin`	Profil akses untuk role store admin
`stock_admin`	Profil akses untuk role stock admin
`finance_admin`	Profil akses untuk role finance admin
`hr_admin`	Profil akses untuk role HR admin
`transaction_admin`	Profil akses untuk role transaction admin
`employee`	Profil akses untuk role employee

MenuAccessProfile.dashboard_type

Nilai	Deskripsi
`owner`	Dashboard pemilik — ringkasan seluruh aspek bisnis
`admin`	Dashboard admin — ringkasan operasional
`supervisor`	Dashboard supervisor — monitoring read-only
`employee`	Dashboard karyawan — tugas dan aktivitas pribadi (default)
`cashier`	Dashboard kasir — antrian dan transaksi POS
`finance`	Dashboard keuangan — arus kas, invoice, expense
`hr`	Dashboard HR — absensi, payroll, leave
`inventory`	Dashboard inventaris — stok, pergerakan, alert

Role Assignment Lifecycle — State Diagram

Sequence Diagrams — Alur Utama

1. Member Invitation Flow

2. Permission Check Flow

4. Role Assignment Flow

Segregation of Duties (SoD)

3 aturan kritis untuk mencegah fraud dan conflict of interest:

Rule ID	Rule	Permission yang Bertentangan	Rationale
OPN-02	Stock Opname counter tidak bisa jadi approver	`can_count_stock_opname` vs `can_approve_stock_opname`	Mencegah self-approval — orang yang hitung tidak boleh approve hasil hitung
MFG-07	Production operator tidak bisa jadi QC approver	`can_create_production_batch` vs `can_release_production_qc`	Mencegah self-verification — orang yang produksi tidak boleh approve kualitas
CUS-01	CS tidak bisa verifikasi transaksi tunai	`can_verify_b2b_payment` tidak boleh untuk CS Agent	Mencegah fraud — customer service tidak boleh handle cash verification

SoD Validation Matrix:

Validasi SoD di Level Server

Validasi SoD dilakukan di dua lapisan:

Client-side (RoleManager.jsx) — Memberikan warning visual saat admin mengatur permissions yang bertentangan. Admin harus konfirmasi eksplisit untuk melanjutkan.
Server-side (Server Function) — Menolak request yang melanggar aturan SoD dengan error message yang jelas. Ini adalah lapisan pertahanan terakhir yang tidak bisa di-bypass dari client.

Fitur Utama

1. Member Invitation Flow

Proses invitation menggunakan idempotency key untuk mencegah duplikasi:

2. Permission Resolution

useCompanyRole.jsx hook menggunakan aggressive caching untuk performa:

Feature	Value	Deskripsi
Cache TTL	60 seconds	Permission data cached 60 detik
Auto-refresh	10 seconds	Polling setiap 10 detik
Deduplication	In-flight Map	Mencegah duplicate fetches
Invalidation	BroadcastChannel	Instant cache clear on changes

Resolution Flow:

3. Owner Role Protection

Hanya original company owner yang bisa assign role owner: Check: selectedCompany.owner_email === currentUser.email

4. ERPAccessGuard

ERPAccessGuard.jsx (569 baris) melindungi company-specific pages: Features:

Feature	Deskripsi
Authentication check	Verifikasi user sudah login
Company context check	Verifikasi active company exists
Membership check	Verifikasi user adalah member company
Permission check	Verifikasi user memiliki permissions yang dibutuhkan
Grace period	3-day read-only setelah membership expired
Real-time sync	Listen BroadcastChannel untuk permission updates

Grace Period:

5. Multi-Role Support

Satu user bisa memiliki lebih dari satu role di company yang berbeda: Permission Merging:

Role A	Role B	Hasil Merge
View inventory	Edit inventory	Edit inventory (higher wins)
View finance	No access	View finance (union)
Create orders	Process payments	Kedua permissions

Example:

User: Budi
Company A: Kasir (can_view_pos, can_use_pos)
Company B: Stock Admin (can_view_inventory, can_edit_inventory)
Hasil:
  - Di Company A: Hanya bisa akses POS
  - Di Company B: Hanya bisa akses inventaris
  - active_company_id menentukan company mana yang sedang aktif

6. Audit Trail

Setiap perubahan user/role dicatat di audit log:

Action	Description
`create_company_invitation`	Undang member baru
`update_member_role`	Ubah role member
`delete_company_member`	Hapus member dari company

Audit Log Detail:

Field	Deskripsi
Actor	User yang melakukan aksi
Action	Jenis aksi yang dilakukan
Target	Member yang diubah
Old Value	Role/permissions sebelum perubahan
New Value	Role/permissions setelah perubahan
Timestamp	Waktu aksi dilakukan
IP Address	IP address dari actor

Cara Akses

Menu: Admin > User Management atau Settings > Company Settings > Members & Roles

Flow Penggunaan

Admin / Owner

Buka User Management dari sidebar
Klik “Invite Member” untuk invite user baru
Enter email dan pilih role dari 13 role templates
Customize permissions dari matrix 38 flag
Send invitation — sistem otomatis cek apakah user sudah terdaftar
Monitor invitation status (pending/accepted/rejected/expired)
Untuk existing members: edit role dan permissions sesuai kebutuhan
Review audit trail untuk security monitoring
Pastikan SoD rules tidak dilanggar saat assign permissions

Member

Terima invitation email
Click accept link
Login atau register jika belum punya akun
Auto-joined ke company dengan role yang di-assign
Akses fitur sesuai permissions yang diberikan
Sidebar navigasi otomatis ter-filter sesuai MenuAccessProfile

Integrasi Cross-Module

Hubungan dengan Modul Lain

Modul	Integrasi RBAC	Deskripsi
POS/Kasir	`can_view_pos`, `can_use_pos`, `can_manage_cashier_shift`	Kontrol akses ke fitur POS dan shift management
Inventaris	`can_view_inventory`, `can_edit_inventory`, `can_transfer_inventory`	Kontrol akses ke stok, pergerakan, dan transfer
Manufacturing	`can_create_production_batch`, `can_release_production_qc`	Kontrol akses ke produksi dan QC dengan SoD
Finance	`can_view_finance`, `can_edit_finance`	Kontrol akses ke invoice, expense, dan laporan keuangan
HR	`can_view_hr`, `can_edit_hr`	Kontrol akses ke data karyawan, absensi, dan payroll
Stock Opname	`can_count_stock_opname`, `can_approve_stock_opname`	Kontrol akses dengan SoD: counter tidak bisa jadi approver
Distribution	`can_view_distribution`, `can_create_distribution_shipment`, `can_confirm_distribution_shipment`	Kontrol akses ke distribusi dan shipment
B2B	`can_view_b2b_invoices`, `can_create_b2b_invoice`, `can_verify_b2b_payment`	Kontrol akses ke invoice dan pembayaran B2B
Settings	`can_view_settings`, `can_edit_settings`	Kontrol akses ke pengaturan company
Dashboard	`dashboard_type` dari MenuAccessProfile	Menentukan variant dashboard yang ditampilkan

Row-Level Security (RLS)

Entitas CompanyMember dan CompanyInvitation dilindungi oleh Row-Level Security policies yang memastikan setiap user hanya bisa mengakses data yang relevan:

Kondisi Akses CompanyMember

Sebuah record CompanyMember dapat dibaca/ditulis jika salah satu kondisi berikut terpenuhi:

Active company match: data.company_id === user.active_company_id dan company_id tidak null/kosong
Creator: created_by_id === user.id — user yang membuat record
Self-access: data.user_email === user.email atau data.user_id === user.id — data milik sendiri
Platform admin: user.role === 'admin' — administrator platform

Kondisi Akses CompanyInvitation

Sebuah record CompanyInvitation dapat dibaca/ditulis jika salah satu kondisi berikut terpenuhi:

Active company match: data.company_id === user.active_company_id dan company_id tidak null/kosong
Creator: created_by_id === user.id — user yang mengirim undangan
Invitee: data.invited_email === user.email — user yang diundang
Platform admin: user.role === 'admin' — administrator platform

Security Best Practices

1. Principle of Least Privilege

Beri akses minimal yang dibutuhkan untuk pekerjaan. Jangan beri Admin role kalau cuma butuh Kasir.

2. Regular Review

Review user roles setiap bulan:

Hapus user yang sudah resign
Adjust role jika ada perubahan tanggung jawab
Cek audit log untuk aktivitas mencurigakan
Pastikan assigned_locations masih relevan

3. SoD Enforcement

Selalu enforce Segregation of Duties:

Stock opname: counter ≠ approver
Manufacturing: operator ≠ QC
Finance: CS ≠ cash verifier

4. Owner Protection

Hanya transfer ownership setelah pertimbangan matang — original owner punya kontrol penuh atas company.

5. Location-Based Access

Gunakan assigned_locations untuk membatasi akses gudang/outlet per member. Ini penting untuk perusahaan multi-cabang yang ingin memastikan setiap staff hanya mengakses lokasi yang menjadi tanggung jawabnya.

6. Invitation Hygiene

Set expires_at yang wajar (rekomendasi: 7 hari)
Cancel undangan yang tidak direspon dalam waktu lama
Jangan share invitation link di channel yang tidak aman
Verifikasi email invitee sebelum mengirim undangan

Tips

13 role templates mencakup sebagian besar use case — buat custom role hanya jika benar-benar butuh
SoD rules adalah anti-fraud control — jangan bypass kecuali ada alasan kuat dan compensating control
BroadcastChannel sync memastikan permission changes propagate instantly ke semua tabs
Grace period 3 hari memberi waktu untuk renew membership sebelum user terblokir total
Audit trail bersifat append-only — tidak bisa dihapus, memastikan forensic integrity
Permission caching (60s TTL) balancing antara performa dan freshness — adjust jika perlu
Gunakan MenuAccessProfile untuk mengontrol visibility sidebar per role — lebih fleksibel daripada hardcode
Field assigned_locations pada CompanyMember mendukung RBAC berbasis lokasi — ideal untuk bisnis multi-cabang
working_hours pada CompanyMember dapat digunakan untuk time-based access control di masa depan
dashboard_type pada MenuAccessProfile memungkinkan setiap role melihat dashboard yang berbeda dan relevan dengan fungsinya

​title: “RBAC & User Management” description: “Role-Based Access Control: RoleManager 1398 baris, 13 role templates, 38 permissions, 3 SoD rules, ERPAccessGuard, MenuAccessProfile, dan real-time sync.”

​RBAC & User Management

​Arsitektur Komponen

​Ringkasan Alur Kontrol Akses

​Entity Relationship Diagram

​Entity Schema Tables

​User

​Company

​CompanyMember

​CompanyInvitation

​MenuAccessProfile

​13 Role Templates

​38 Permission Flags — Matriks Lengkap

​Dashboard & Tugas

​Catatan (Notes)

​HR & Payroll

​Keuangan (Finance)

​Inventaris (Inventory)

​Proyek (Projects)

​POS / Kasir

​Laporan (Reports)

​Manajemen User & Settings

​Produksi (Manufacturing)

​Distribusi & Sales Channel

​B2B & Invoice

​Enum Reference Tables

​CompanyMember.role

​CompanyInvitation.role

​CompanyMember.status

​CompanyInvitation.status

​User.role

​User.admin_type

​User.admin_tier

​User.subscription_plan

​User.membership_duration_type

​Company.industry

​MenuAccessProfile.role

​MenuAccessProfile.dashboard_type

​Role Assignment Lifecycle — State Diagram

​Sequence Diagrams — Alur Utama

​1. Member Invitation Flow

​2. Permission Check Flow

​3. Menu Access Filtering Flow

​4. Role Assignment Flow

​Segregation of Duties (SoD)

​Validasi SoD di Level Server

​Fitur Utama

​1. Member Invitation Flow

​2. Permission Resolution

​3. Owner Role Protection

​4. ERPAccessGuard

​5. Multi-Role Support

​6. Audit Trail

​Cara Akses

​Flow Penggunaan

​Admin / Owner

​Member

​Integrasi Cross-Module

​Hubungan dengan Modul Lain

​Row-Level Security (RLS)

​Kondisi Akses CompanyMember

​Kondisi Akses CompanyInvitation

​Security Best Practices

​1. Principle of Least Privilege

​2. Regular Review

​3. SoD Enforcement

​4. Owner Protection

​5. Location-Based Access

​6. Invitation Hygiene

​Tips

title: “RBAC & User Management” description: “Role-Based Access Control: RoleManager 1398 baris, 13 role templates, 38 permissions, 3 SoD rules, ERPAccessGuard, MenuAccessProfile, dan real-time sync.”

RBAC & User Management

Arsitektur Komponen

Ringkasan Alur Kontrol Akses

Entity Relationship Diagram

Entity Schema Tables

User

Company

CompanyMember

CompanyInvitation

MenuAccessProfile

13 Role Templates

38 Permission Flags — Matriks Lengkap

Dashboard & Tugas

Catatan (Notes)

HR & Payroll

Keuangan (Finance)

Inventaris (Inventory)

Proyek (Projects)

POS / Kasir

Laporan (Reports)

Manajemen User & Settings

Produksi (Manufacturing)

Distribusi & Sales Channel

B2B & Invoice

Enum Reference Tables

CompanyMember.role

CompanyInvitation.role

CompanyMember.status

CompanyInvitation.status

User.role

User.admin_type

User.admin_tier

User.subscription_plan

User.membership_duration_type

Company.industry

MenuAccessProfile.role

MenuAccessProfile.dashboard_type

Role Assignment Lifecycle — State Diagram

Sequence Diagrams — Alur Utama

1. Member Invitation Flow

2. Permission Check Flow

3. Menu Access Filtering Flow

4. Role Assignment Flow

Segregation of Duties (SoD)

Validasi SoD di Level Server

Fitur Utama

1. Member Invitation Flow

2. Permission Resolution

3. Owner Role Protection

4. ERPAccessGuard

5. Multi-Role Support

6. Audit Trail

Cara Akses

Flow Penggunaan

Admin / Owner

Member

Integrasi Cross-Module

Hubungan dengan Modul Lain

Row-Level Security (RLS)

Kondisi Akses CompanyMember

Kondisi Akses CompanyInvitation

Security Best Practices

1. Principle of Least Privilege

2. Regular Review

3. SoD Enforcement

4. Owner Protection

5. Location-Based Access

6. Invitation Hygiene

Tips