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

# Manajemen Pengguna

> Cara membuat, mengatur, dan mengelola pengguna di CMS OpteraOne.

Manajemen Pengguna adalah proses mendaftarkan dan mengelola semua pengguna yang akan mengakses platform OpteraOne — baik melalui CMS maupun aplikasi mobile. Setiap pengguna memerlukan data yang lengkap dan Hak Akses yang sesuai sebelum dapat mulai menggunakan sistem.

<Note>
  Pastikan **Hak Akses** sudah dikonfigurasi sebelum membuat pengguna baru. Pengguna baru wajib diberikan Hak Akses saat proses pembuatan. Jika Hak Akses belum ada, ikuti panduan [Manajemen Hak Akses →](/manajemen-hak-akses) terlebih dahulu.
</Note>

***

## Alur Pembuatan Pengguna

Berikut alur lengkap dari pendaftaran hingga pengguna dapat menggunakan platform:

```mermaid theme={null}
flowchart LR
  A[Admin membuat\nakun pengguna] --> B[Sistem menyimpan\ndengan status\nTidak Aktif]
  B --> C[Sistem mengirim\nemail aktivasi\notomatis]
  C --> D[Pengguna membuka\nemail & aktivasi\nakun]
  D --> E[Pengguna aktif\n& dapat login]
```

<Note>
  Pengguna baru yang baru dibuat akan berstatus **"Tidak Aktif"** hingga mereka menyelesaikan proses aktivasi melalui email undangan yang dikirim sistem secara otomatis.
</Note>

***

## Mengakses Halaman Manajemen Pengguna

<Steps>
  <Step title="Buka Menu Pengguna">
    Dari halaman mana pun di CMS, klik menu **Pengguna** pada navigasi utama.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/ViMnJY-OkabehrKi/images/user.png?fit=max&auto=format&n=ViMnJY-OkabehrKi&q=85&s=6d36ea4d10fbd402249532dc6abb1f6c" alt="User" width="1440" height="900" data-path="images/user.png" />
    </Frame>
  </Step>
</Steps>

***

## Halaman Daftar Pengguna

Halaman ini menampilkan semua pengguna yang terdaftar dalam sistem, lengkap dengan status, hak akses, dan informasi terakhir login mereka.

<Frame>
  <img src="https://mintcdn.com/ait-8f7a7cd9/ViMnJY-OkabehrKi/images/user.png?fit=max&auto=format&n=ViMnJY-OkabehrKi&q=85&s=6d36ea4d10fbd402249532dc6abb1f6c" alt="User" width="1440" height="900" data-path="images/user.png" />
</Frame>

Halaman Daftar Pengguna memiliki 9 fungsi utama:

| #      | Fungsi             | Keterangan                                                                                                                      |
| ------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| **#1** | Pencarian nama     | Cari pengguna berdasarkan nama                                                                                                  |
| **#2** | Pengurutan         | Urutkan berdasarkan: Nama, Status, Hak Akses, Perusahaan, Tanggal Pembuatan, Tanggal Login Terakhir, Tanggal Perubahan Terakhir |
| **#3** | Jumlah baris data  | Default 10 baris — dapat diubah ke 25, 50, atau 100                                                                             |
| **#4** | Filter data        | Kombinasi pencarian menggunakan menu filter                                                                                     |
| **#5** | Buat pengguna baru | Tombol untuk mendaftarkan pengguna baru                                                                                         |
| **#6** | Aksi ubah          | Mengubah data pengguna yang sudah ada                                                                                           |
| **#7** | Aksi nonaktifkan   | Menonaktifkan akun pengguna yang aktif                                                                                          |
| **#8** | Aksi aktifkan      | Mengaktifkan kembali akun pengguna yang nonaktif                                                                                |
| **#9** | Detail pengguna    | Klik nama pengguna untuk melihat detailnya                                                                                      |

***

## Fungsi Pencarian Pengguna

<Steps>
  <Step title="Klik Kolom Cari">
    Klik kolom **"Cari"** yang ada di bagian atas halaman Daftar Pengguna.
  </Step>

  <Step title="Ketik Kata Pencarian">
    Mulai ketik nama pengguna yang ingin dicari. Hasil pencarian ditampilkan secara real-time sesuai kata yang diketik.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/ViMnJY-OkabehrKi/images/search.png?fit=max&auto=format&n=ViMnJY-OkabehrKi&q=85&s=a06e97563514b4c5b06589a2c1cbfd37" alt="Search" width="1440" height="900" data-path="images/search.png" />
    </Frame>
  </Step>

  <Step title="Tidak Ada Hasil">
    Jika tidak ada pengguna yang cocok, halaman akan menampilkan tampilan kosong. Periksa kembali ejaan nama yang dicari.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/ViMnJY-OkabehrKi/images/search-1.png?fit=max&auto=format&n=ViMnJY-OkabehrKi&q=85&s=82d66bd34308a3d8bcfda3a012b69363" alt="Search 1" width="1440" height="900" data-path="images/search-1.png" />
    </Frame>
  </Step>
</Steps>

***

## Fungsi Filter Pengguna

<Steps>
  <Step title="Klik Ikon Filter">
    Klik ikon **Filter** di bagian atas halaman Daftar Pengguna. Panel filter akan muncul dari sisi kanan layar.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/ViMnJY-OkabehrKi/images/filter.png?fit=max&auto=format&n=ViMnJY-OkabehrKi&q=85&s=2f4f07c1486a119baa0746991d18453e" alt="Filter" width="1440" height="900" data-path="images/filter.png" />
    </Frame>
  </Step>

  <Step title="Pilih Kombinasi Filter">
    Anda dapat memfilter pengguna berdasarkan kombinasi kriteria berikut:

    | Filter                     | Keterangan                                     |
    | -------------------------- | ---------------------------------------------- |
    | **Status**                 | Aktif atau Tidak Aktif                         |
    | **Hak Akses**              | Filter berdasarkan role yang dimiliki          |
    | **Perusahaan**             | Filter berdasarkan perusahaan pengguna         |
    | **Tag**                    | Filter berdasarkan tag yang diberikan          |
    | **Tim**                    | Filter berdasarkan tim yang pengguna bergabung |
    | **Zona Waktu**             | Filter berdasarkan zona waktu pengguna         |
    | **Tanggal Pembuatan**      | Filter berdasarkan rentang tanggal akun dibuat |
    | **Tanggal Login Terakhir** | Filter berdasarkan kapan terakhir kali login   |
  </Step>

  <Step title="Terapkan atau Atur Ulang">
    * Klik **"Terapkan"** untuk menerapkan filter yang dipilih
    * Klik **"Atur Ulang"** untuk menghapus semua pilihan filter
    * Klik ikon **✕** di sudut kanan atas panel untuk menutup tanpa menerapkan perubahan
  </Step>
</Steps>

***

## Membuat Pengguna Baru

<Steps>
  <Step title="Klik Tombol 'Buat Pengguna'">
    Dari halaman Daftar Pengguna, klik tombol **"Buat Pengguna"** di bagian kanan atas halaman.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/ViMnJY-OkabehrKi/images/user.png?fit=max&auto=format&n=ViMnJY-OkabehrKi&q=85&s=6d36ea4d10fbd402249532dc6abb1f6c" alt="User" width="1440" height="900" data-path="images/user.png" />
    </Frame>
  </Step>

  <Step title="Isi Data Pengguna">
    Lengkapi semua field yang wajib diisi pada form pembuatan pengguna:

    | Field          | Keterangan                                          | Wajib |
    | -------------- | --------------------------------------------------- | ----- |
    | **Nama**       | Nama lengkap pengguna                               | ✅ Ya  |
    | **Email**      | Alamat email aktif untuk menerima undangan aktivasi | ✅ Ya  |
    | **Nomor HP**   | Nomor telepon pengguna                              | ✅ Ya  |
    | **Hak Akses**  | Pilih role yang sesuai dengan posisi pengguna       | ✅ Ya  |
    | **Zona Waktu** | Zona waktu lokasi pengguna bekerja                  | ✅ Ya  |
    | **Bahasa**     | Bahasa antarmuka yang digunakan pengguna            | ✅ Ya  |

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/ViMnJY-OkabehrKi/images/create-8.png?fit=max&auto=format&n=ViMnJY-OkabehrKi&q=85&s=a91324dd00a0e60a4c5b7079eb181306" alt="Create 8" width="1440" height="900" data-path="images/create-8.png" />
    </Frame>

    <Tip>
      Pilih **Hak Akses** yang sesuai dengan tanggung jawab pengguna. Jika pengguna adalah Agen/Teknisi lapangan, pastikan Hak Akses yang dipilih memiliki **Akses ke Aplikasi Mobile** yang sudah dicentang saat konfigurasi Hak Akses.
    </Tip>
  </Step>

  <Step title="Klik Simpan">
    Scroll ke bagian bawah halaman dan klik tombol **"Simpan"**. Konfirmasi simpan akan muncul menampilkan data yang dimasukkan.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/jmV2nMD-LnvhUPT7/images/create-9.png?fit=max&auto=format&n=jmV2nMD-LnvhUPT7&q=85&s=4613bda50c9eb0cce9a46c3337f752e5" alt="Create 9" width="1441" height="901" data-path="images/create-9.png" />
    </Frame>
  </Step>

  <Step title="Konfirmasi Data">
    Periksa kembali semua data yang ditampilkan pada konfirmasi. Pastikan email sudah benar karena email aktivasi akan dikirim ke alamat ini.

    Jika sudah sesuai, klik **"Simpan"** untuk menyimpan.
  </Step>

  <Step title="Akun Tersimpan dan Email Aktivasi Terkirim">
    Setelah disimpan, pengguna baru tersimpan dengan status **"Tidak Aktif"** dan sistem akan mengirimkan **email aktivasi** secara otomatis ke alamat email yang didaftarkan.

    <Note>
      Pengguna baru perlu menyelesaikan proses aktivasi melalui email yang diterima sebelum dapat login ke platform. Panduan aktivasi untuk pengguna CMS tersedia di [Aktivasi Pengguna CMS →](/aktivasi-pengguna-cms), dan untuk pengguna aplikasi mobile di [Aktivasi Pengguna Aplikasi →](/aktivasi-pengguna-aplikasi).
    </Note>
  </Step>
</Steps>

<Note>
  Jika ingin membatalkan proses pembuatan di langkah mana pun, klik tombol **"Batal"** untuk kembali ke halaman Daftar Pengguna tanpa ada data yang tersimpan.
</Note>

***

## Melihat Detail Pengguna

Klik **nama pengguna** pada tabel Daftar Pengguna untuk membuka halaman Detail Pengguna.

<Frame>
  <img src="https://mintcdn.com/ait-8f7a7cd9/jmV2nMD-LnvhUPT7/images/details-4.png?fit=max&auto=format&n=jmV2nMD-LnvhUPT7&q=85&s=ea64161e0610fc3d1bb4115e89ccd656" alt="Details 4" width="1440" height="770" data-path="images/details-4.png" />
</Frame>

Halaman detail menampilkan semua informasi terkait pengguna tersebut:

* Data pribadi (nama, email, nomor HP)
* Hak Akses yang dimiliki
* Tim yang diikuti
* Zona waktu dan bahasa
* Status akun dan riwayat aktivitas

Untuk mengubah data, klik tombol **"Lainnya"** → pilih **"Ubah Pengguna"**.

***

## Mengubah Data Pengguna

Perubahan data pengguna dapat dilakukan melalui **dua cara**:

<Tabs>
  <Tab title="Via Ikon Edit di Daftar">
    Dari halaman Daftar Pengguna, klik ikon **Edit (✏️)** pada kolom Aksi di baris pengguna yang ingin diubah.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/ViMnJY-OkabehrKi/images/user.png?fit=max&auto=format&n=ViMnJY-OkabehrKi&q=85&s=6d36ea4d10fbd402249532dc6abb1f6c" alt="User" width="1440" height="900" data-path="images/user.png" />
    </Frame>
  </Tab>

  <Tab title="Via Halaman Detail">
    Dari halaman Detail Pengguna, klik tombol **"Lainnya"** → pilih **"Ubah Pengguna"**.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/user-edit-detail.png" alt="Menu ubah pengguna dari halaman detail" />
    </Frame>
  </Tab>
</Tabs>

Setelah mengklik salah satu opsi, Anda akan diarahkan ke halaman **Ubah Pengguna**:

<Frame>
  <img src="https://mintcdn.com/ait-8f7a7cd9/jmV2nMD-LnvhUPT7/images/edit-4.png?fit=max&auto=format&n=jmV2nMD-LnvhUPT7&q=85&s=437da7a9c4c6746f00a09317a295d6fe" alt="Edit 4" width="1440" height="900" data-path="images/edit-4.png" />
</Frame>

<Steps>
  <Step title="Lakukan Perubahan">
    Ubah data yang diperlukan. Field yang dapat diubah:

    | Field          | Keterangan                                              |
    | -------------- | ------------------------------------------------------- |
    | **Nama**       | Perbarui nama lengkap pengguna                          |
    | **Email**      | Perbarui alamat email pengguna                          |
    | **Nomor HP**   | Perbarui nomor telepon                                  |
    | **Hak Akses**  | Ubah role jika ada perubahan posisi atau tanggung jawab |
    | **Tag**        | Tambah atau hapus tag untuk kategorisasi                |
    | **Tim**        | Pindahkan pengguna ke tim yang berbeda                  |
    | **Zona Waktu** | Sesuaikan jika pengguna berpindah lokasi kerja          |
    | **Bahasa**     | Ubah preferensi bahasa antarmuka                        |

    <Warning>
      Mengubah **Hak Akses** pengguna akan langsung mempengaruhi akses mereka ke modul dan fitur platform pada sesi login berikutnya.
    </Warning>
  </Step>

  <Step title="Klik Simpan">
    Scroll ke bagian bawah halaman dan klik tombol **"Simpan"**. Konfirmasi perubahan akan ditampilkan.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/jmV2nMD-LnvhUPT7/images/edit-5.png?fit=max&auto=format&n=jmV2nMD-LnvhUPT7&q=85&s=cf9abee1abba584ba009c38239d49789" alt="Edit 5" width="1440" height="900" data-path="images/edit-5.png" />
    </Frame>
  </Step>

  <Step title="Konfirmasi Perubahan">
    Periksa data yang ditampilkan. Jika sudah sesuai, klik **"Simpan"** untuk menyimpan perubahan.
  </Step>
</Steps>

***

## Menonaktifkan Pengguna

Gunakan fitur nonaktifkan jika pengguna tidak lagi memerlukan akses ke platform — misalnya karyawan yang resign atau kontraktor yang sudah selesai kontrak.

<Steps>
  <Step title="Klik Ikon Nonaktifkan">
    Dari halaman Daftar Pengguna, klik ikon **Nonaktifkan** pada kolom Aksi di baris pengguna yang ingin dinonaktifkan.
  </Step>

  <Step title="Konfirmasi Aksi">
    Dialog konfirmasi akan muncul. Klik **"Nonaktifkan"** untuk melanjutkan.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/jmV2nMD-LnvhUPT7/images/pengguna.png?fit=max&auto=format&n=jmV2nMD-LnvhUPT7&q=85&s=6dd76ff6131d71d8b43f8597ddc551e6" alt="Pengguna" width="1441" height="901" data-path="images/pengguna.png" />
    </Frame>
  </Step>

  <Step title="Status Berubah">
    Setelah dinonaktifkan, status pengguna berubah menjadi **"Tidak Aktif"**.

    <Warning>
      Pengguna yang dinonaktifkan **tidak dapat login** dan tidak dapat menggunakan platform — baik CMS maupun aplikasi mobile. Semua tugas yang sebelumnya ditugaskan kepada mereka tidak akan terpengaruh, namun perlu di-reassign ke pengguna lain.
    </Warning>
  </Step>
</Steps>

***

## Mengaktifkan Kembali Pengguna

<Steps>
  <Step title="Klik Ikon Aktifkan">
    Dari halaman Daftar Pengguna, klik ikon **Aktifkan** pada kolom Aksi di baris pengguna yang ingin diaktifkan kembali.
  </Step>

  <Step title="Konfirmasi Aksi">
    Dialog konfirmasi akan muncul. Klik **"Aktifkan"** untuk melanjutkan.

    <Frame>
      <img src="https://mintcdn.com/ait-8f7a7cd9/jmV2nMD-LnvhUPT7/images/pengguna-1.png?fit=max&auto=format&n=jmV2nMD-LnvhUPT7&q=85&s=7b880efa3a0a074237f67f451d305268" alt="Pengguna 1" width="1441" height="901" data-path="images/pengguna-1.png" />
    </Frame>
  </Step>

  <Step title="Status Berubah">
    Setelah diaktifkan, status pengguna kembali menjadi **"Aktif"** dan pengguna dapat kembali login serta menggunakan platform.

    <Note>
      Pengguna yang diaktifkan kembali dapat langsung login menggunakan kredensial mereka yang lama tanpa perlu melewati proses aktivasi ulang.
    </Note>
  </Step>
</Steps>

***

## Langkah Selanjutnya

<Card title="Manajemen Tugas →" icon="clipboard-plus" href="/manajemen-tugas">
  Pengguna sudah terdaftar dan aktif? Mulai buat tugas pertama dan tugaskan ke Agen/Teknisi.
</Card>