🛠️ Alur Update Struktur Organisasi & Role

Dokumen ini menjelaskan langkah-langkah teknis untuk menambah, mengubah, atau menghapus peran (role) dalam sistem ERP BUMDes.

---

1. Update Database (Supabase)#

Peran disimpan dalam tipe ENUM user_role. Untuk menambah role baru:

sql
-- Contoh: Menambah role 'kepala_gudang'
ALTER TYPE user_role ADD VALUE 'kepala_gudang';

Jika ada policy RLS baru yang spesifik:

• Update tabel journal_entries, products, atau biological_assets.
• Gunakan fungsi has_unit_access(unit_id) untuk memastikan isolasi data.

---

2. Update Source Code (React/Next.js)#

A. Definisi Tipe

Buka file lib/types.ts dan tambahkan role baru ke type UserRole:

typescript
export type UserRole =
    | 'super_admin'
    | ...
    | 'kepala_gudang' // Tambahkan di sini

B. Grup Akses

Update konstanta grup di file yang sama jika role tersebut masuk dalam kategori tertentu (Staff, Manajer, dll):

typescript
export const ROLES_STAFF: UserRole[] = [..., 'kepala_gudang']

---

3. Update Label UI#

Buka lib/constants.ts untuk menambahkan label yang ramah pengguna:

typescript
export const ROLE_LABELS: Record<UserRole, string> = {
    super_admin: 'Super Admin',
    ...,
    kepala_gudang: 'Kepala Gudang Unit'
}

---

4. Verifikasi Sidebar#

Cek components/dashboard/Sidebar.tsx untuk memastikan menu yang relevan ditampilkan untuk role tersebut menggunakan properti allowedRoles.

tsx
{
    name: 'Inventori & Logistik',
    href: '/dashboard/inventori/stok',
    icon: Boxes,
    allowedRoles: ['super_admin', 'kepala_gudang'], // Update di sini
    ...
}

---

5. Dokumentasi#

Update file docs/ARCHITECTURE_SDM_RBAC.md untuk mencerminkan hirarki dan kewenangan baru dalam matriks RBAC.