> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mertani.co.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit Role

Fitur **Edit Role** digunakan untuk memperbarui nama role agar lebih sesuai dengan struktur organisasi atau perubahan kebutuhan operasional.\
Perubahan ini bersifat administratif dan tidak mempengaruhi konfigurasi akses yang sudah ada.

***

## Tujuan dan Use Case

Pengubahan nama role biasanya dilakukan dalam kondisi berikut:

* Penyesuaian terminologi internal organisasi
* Restrukturisasi tim atau divisi
* Klarifikasi fungsi role agar lebih deskriptif
* Standarisasi penamaan role

***

## Behavior Sistem

Saat melakukan edit role, sistem memiliki karakteristik berikut:

* Hanya **nama role** yang berubah
* Permission yang sudah ada **tidak berubah**
* Semua user yang menggunakan role tersebut **tetap terhubung**
* Perubahan langsung terlihat di seluruh sistem (real-time)

<info>
  Mengubah nama role tidak akan mempengaruhi akses pengguna, karena permission tetap sama.
</info>

***

## Prasyarat

Sebelum mengubah nama role:

* Anda memiliki akses untuk mengelola role
* Role yang akan diubah bukan role yang dikunci oleh sistem (jika ada)
* Nama baru tidak duplikat dengan role lain

***

## Langkah Edit Role

<Steps>
  <Step title="Access Role Management Page" toc={false}>
    Buka **Instansi** → **Peran Pengguna**
  </Step>

  <Step title="Search Role" toc={false}>
    Temukan role yang ingin diubah dari daftar
  </Step>

  <Step title="Open Action Menu" toc={false}>
    Klik ikon `...` pada role
  </Step>

  <Step title="Select Edit Role" toc={false}>
    Pilih opsi `Edit Role`
  </Step>

  <Step title="Update Role Name" toc={false}>
    Masukkan nama baru yang lebih sesuai dan deskriptif
  </Step>

  <Step title="Save Role Changes" toc={false}>
    Klik tombol **Simpan** untuk menerapkan perubahan

    <Frame>
      <video src="https://mintcdn.com/mertani/yrybY0Cd-4ZXOwAB/assets/dashboard-guides/access-control/edit-userrole.webm?fit=max&auto=format&n=yrybY0Cd-4ZXOwAB&q=85&s=811db6e35988d1cad30ccf9fa498da6d" controls autoPlay loop playsInline muted data-path="assets/dashboard-guides/access-control/edit-userrole.webm" />
    </Frame>
  </Step>
</Steps>

***

## Dampak Perubahan

Setelah nama role diperbarui:

* Nama baru akan muncul di seluruh sistem
* Tidak ada perubahan pada:
  * Permission
  * Hak akses user
  * Struktur kontrol akses

***

## Best Practice

Untuk menjaga konsistensi sistem:

* Gunakan nama role yang jelas dan spesifik
* Hindari penggunaan istilah umum seperti “User” atau “Staff” tanpa konteks
* Terapkan standar penamaan (misalnya: `Admin Operasional`, `Supervisor Lapangan`)
* Dokumentasikan perubahan jika digunakan dalam skala besar

***

## Note

* Edit role hanya mempengaruhi label, bukan fungsi
* Aman dilakukan tanpa risiko perubahan akses
* Sangat berguna untuk menjaga dokumentasi dan struktur tetap relevan