> ## 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.

# Live Tracking

> Pantau posisi agen lapangan secara real-time melalui peta interaktif di CMS OpteraOne.

# User Tracking

> Lihat lokasi terkini agen lapangan Anda secara langsung di peta — tanpa perlu menghubungi mereka satu per satu.

Fitur **User Tracking** memungkinkan Admin, Manajer, dan Supervisor untuk memantau posisi agen atau teknisi secara real-time langsung dari CMS. Dengan tampilan peta interaktif, Anda dapat melihat di mana setiap agen berada saat ini dan mengakses detail informasi mereka hanya dengan satu klik.

<Note>
  Posisi agen diperbarui secara otomatis selama agen aktif menggunakan aplikasi mobile OpteraOne dan mengizinkan akses lokasi di perangkat mereka.
</Note>

***

## Mengakses Halaman User Tracking

<Steps>
  <Step title="Login ke CMS">
    Masuk ke CMS OpteraOne menggunakan email dan kata sandi Anda melalui browser desktop.

    Setelah login, sistem akan menampilkan dialog pemilihan peran jika akun Anda memiliki lebih dari satu peran aktif (misalnya Supervisor, Teknisi, atau Admin).

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/user-tracking-login.png" alt="Login dan pemilihan peran" />
    </Frame>
  </Step>

  <Step title="Pilih Peran">
    Jika muncul dialog **"Switch Role"**, pilih peran yang sesuai — misalnya **Supervisor** atau **Admin** — untuk mengakses fitur User Tracking.

    <Tip>
      Pastikan peran yang dipilih memiliki hak akses ke fitur User Tracking. Hubungi Administrator jika menu User Tracking tidak muncul setelah login.
    </Tip>
  </Step>

  <Step title="Buka Menu User Tracking">
    Dari halaman mana pun di CMS, klik menu **User Tracking** pada navigasi utama di sisi kiri layar.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/user-tracking-main.png" alt="Halaman utama User Tracking" />
    </Frame>
  </Step>
</Steps>

***

## Tampilan Halaman User Tracking

Halaman User Tracking terdiri dari dua bagian utama yang ditampilkan secara berdampingan:

<CardGroup cols={2}>
  <Card title="Panel Peta" icon="map">
    Menampilkan posisi semua agen aktif secara real-time di atas peta. Setiap agen ditandai dengan avatar inisial berwarna.
  </Card>

  <Card title="Panel Daftar Agen" icon="list">
    Menampilkan daftar agen beserta nama, status, dan informasi ringkas. Dapat digunakan untuk mencari dan memilih agen tertentu.
  </Card>
</CardGroup>

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/user-tracking-overview.png" alt="Tampilan halaman User Tracking dengan peta dan daftar agen" />
</Frame>

### Keterangan Elemen Peta

| Elemen                 | Keterangan                                                                           |
| ---------------------- | ------------------------------------------------------------------------------------ |
| **Avatar berwarna**    | Menandai posisi terkini agen di peta. Inisial nama agen ditampilkan di dalam avatar. |
| **Zoom in / Zoom out** | Gunakan kontrol zoom untuk memperbesar atau memperkecil tampilan peta.               |
| **Navigasi peta**      | Klik dan seret peta untuk menggeser area yang ditampilkan.                           |

***

## Memilih Agen untuk Dipantau

<Steps>
  <Step title="Cari Agen di Panel Daftar">
    Di panel daftar sebelah kanan, gunakan kolom **pencarian** untuk menemukan agen berdasarkan nama.

    Hasil pencarian diperbarui secara real-time saat Anda mengetik.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/user-tracking-search.png" alt="Pencarian agen di panel daftar" />
    </Frame>
  </Step>

  <Step title="Klik Nama Agen">
    Klik nama atau baris agen yang ingin dipantau dari daftar. Peta akan secara otomatis berpindah dan memperbesar tampilan ke lokasi agen tersebut.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/user-tracking-selected.png" alt="Peta berpindah ke lokasi agen yang dipilih" />
    </Frame>

    <Note>
      Sistem akan menampilkan titik lokasi agen yang dipilih beserta panel informasi singkat di sisi peta.
    </Note>
  </Step>

  <Step title="Peta Berpindah ke Lokasi Agen">
    Peta akan otomatis memperbesar dan memusatkan tampilan pada posisi terkini agen yang dipilih.

    Avatar agen akan terlihat jelas di peta beserta area sekitar lokasi mereka.
  </Step>
</Steps>

***

## Melihat Detail Informasi Agen

Setelah memilih agen dari daftar atau mengklik avatar agen di peta, panel detail akan muncul.

<Steps>
  <Step title="Klik Avatar Agen di Peta atau Pilih dari Daftar">
    Klik langsung pada avatar agen di peta, atau klik nama agen di panel daftar untuk membuka informasi singkatnya.
  </Step>

  <Step title="Klik Tombol 'Lihat Detail'">
    Pada panel informasi yang muncul, klik tombol **"Lihat Detail"** untuk membuka halaman profil lengkap agen.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/user-tracking-detail-button.png" alt="Panel informasi agen dengan tombol Lihat Detail" />
    </Frame>
  </Step>

  <Step title="Halaman Detail Agen">
    Halaman ini menampilkan informasi lengkap agen, termasuk:

    * **Nama lengkap** dan foto profil
    * **Nomor HP** dan informasi kontak
    * **Status aktif/nonaktif**
    * **Peran dan hak akses** yang dimiliki
    * **Riwayat aktivitas** terkini

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/user-tracking-user-detail.png" alt="Halaman detail informasi agen" />
    </Frame>
  </Step>
</Steps>

***

## Kondisi Agen yang Muncul di Peta

<Warning>
  Tidak semua agen akan terlihat di peta. Berikut kondisi yang mempengaruhi visibilitas agen:
</Warning>

| Kondisi                             | Terlihat di Peta? | Keterangan                                                          |
| ----------------------------------- | ----------------- | ------------------------------------------------------------------- |
| Agen aktif & aplikasi terbuka       | ✅ Ya              | Posisi diperbarui secara real-time                                  |
| Agen aktif & aplikasi di-background | ✅ Ya              | Posisi diperbarui sesuai interval sistem                            |
| Agen menonaktifkan izin lokasi      | ❌ Tidak           | Agen perlu mengaktifkan kembali izin lokasi di pengaturan perangkat |
| Agen nonaktif / akun dinonaktifkan  | ❌ Tidak           | Agen tidak dapat masuk ke aplikasi                                  |
| Tidak ada sinyal / offline          | ❌ Tidak           | Posisi terakhir tidak diperbarui hingga kembali online              |

<Tip>
  Jika agen tidak muncul di peta padahal sedang bertugas, minta agen untuk memastikan fitur lokasi di perangkat mereka aktif dan aplikasi OpteraOne memiliki izin untuk mengakses lokasi.
</Tip>

***

## Filter Tampilan Daftar Agen

Panel daftar agen di halaman User Tracking dapat difilter untuk memudahkan pencarian.

<Steps>
  <Step title="Klik Ikon Filter">
    Klik ikon **Filter** di bagian atas panel daftar agen. Panel filter akan muncul.
  </Step>

  <Step title="Pilih Kriteria Filter">
    Pilih kriteria filter yang diinginkan:

    | Filter        | Keterangan                 |
    | ------------- | -------------------------- |
    | **Nama Agen** | Cari berdasarkan nama agen |
    | **Status**    | Aktif atau Nonaktif        |
  </Step>

  <Step title="Terapkan Filter">
    Klik **"Terapkan"** untuk menerapkan filter. Daftar agen akan diperbarui sesuai kriteria yang dipilih.

    Klik **"Atur Ulang"** untuk menghapus semua filter dan menampilkan semua agen kembali.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/ait-8f7a7cd9/images/user-tracking-filter.png" alt="Panel filter daftar agen" />
    </Frame>
  </Step>
</Steps>

***

## Ringkasan Alur User Tracking

```text theme={null}
Login CMS → Pilih Peran → Buka Menu User Tracking
      ↓
Lihat semua agen aktif di peta
      ↓
Cari atau pilih agen dari daftar
      ↓
Peta berpindah ke lokasi agen
      ↓
Klik "Lihat Detail" untuk info lengkap agen
```

***

## Pertanyaan Umum

<AccordionGroup>
  <Accordion title="Mengapa posisi agen tidak bergerak di peta?" icon="location-dot">
    Kemungkinan penyebabnya:

    * Agen sedang berada di area dengan sinyal lemah atau tidak ada internet
    * Izin lokasi di perangkat agen dinonaktifkan
    * Aplikasi mobile agen tidak sedang aktif berjalan

    Minta agen untuk memastikan koneksi internet dan izin lokasi aktif di perangkat mereka.
  </Accordion>

  <Accordion title="Berapa sering posisi agen diperbarui?" icon="rotate">
    Posisi agen diperbarui secara otomatis oleh sistem selama agen aktif menggunakan aplikasi mobile dengan koneksi internet yang stabil. Interval pembaruan ditentukan oleh konfigurasi sistem OpteraOne di organisasi Anda.
  </Accordion>

  <Accordion title="Apakah agen tahu bahwa posisi mereka dipantau?" icon="eye">
    Ya. Agen diberitahu saat pertama kali menginstal aplikasi bahwa fitur pelacakan lokasi aktif selama mereka menggunakan aplikasi. Transparansi ini merupakan bagian dari kebijakan penggunaan OpteraOne.
  </Accordion>

  <Accordion title="Apakah semua peran CMS bisa mengakses User Tracking?" icon="shield-check">
    Akses ke fitur User Tracking bergantung pada hak akses yang dikonfigurasi oleh Administrator. Hubungi Admin Anda jika menu User Tracking tidak tersedia di akun Anda.
  </Accordion>
</AccordionGroup>

***

## Langkah Selanjutnya

<CardGroup cols={2}>
  <Card title="Manajemen Pengguna" icon="users" href="/manajemen-pengguna">
    Kelola data agen dan teknisi — tambah, ubah, atau nonaktifkan pengguna di sistem.
  </Card>

  <Card title="Manajemen Tugas" icon="clipboard-list" href="/manajemen-tugas">
    Buat dan tugaskan pekerjaan ke agen yang sudah Anda pantau posisinya.
  </Card>
</CardGroup>