# Dashboard Supervisor


## Ringkasan

Halaman **Dashboard** adalah titik masuk utama bagi supervisor untuk memantau operasional tim setiap pagi. Berbeda dengan dashboard agent biasa yang hanya menampilkan kotak masuk pribadi, supervisor mendapat tambahan **Platform Overview**, daftar **Agent Status** dengan indikator online/offline real-time, serta ringkasan metrik tingkat platform. Semua data diperbarui secara langsung melalui WebSocket — Anda tidak perlu me-refresh halaman untuk melihat agent baru yang login atau percakapan baru yang masuk.

Halaman ini tersedia di rute frontend `/dashboard` dan merender data tambahan hanya jika peran pengguna adalah `supervisor` atau `admin`. Agent reguler yang membuka rute yang sama akan melihat versi dashboard yang lebih ringkas.

:::info
**Hak akses:** Bagian *Platform Overview* dan *Agent Status* hanya muncul untuk peran **supervisor** dan **admin**. Agent reguler hanya melihat kotak "My Open", "Unassigned", dan daftar percakapan pribadinya.
:::

## Langkah-langkah

1. Login ke aplikasi melalui halaman `/login`, lalu pilih menu **Dashboard** dari sidebar (atau buka langsung `/dashboard`).
2. Periksa kartu **Platform Overview** di bagian atas. Empat metrik yang ditampilkan:
   - **Total Conversations** — jumlah seluruh percakapan (open + resolved) yang tercatat di database.
   - **Messages Today** — jumlah pesan masuk dan keluar yang diproses dalam 24 jam terakhir.
   - **Agents Online** — rasio agent yang sedang online terhadap total agent aktif (mis. `3/8`).
   - **Resolution Rate** — persentase percakapan yang telah diselesaikan.
3. Gulir ke bawah untuk melihat panel **Agent Status**. Agent yang sedang online tampil di bagian atas dengan titik hijau, sementara agent offline di bawah dengan timestamp `Last seen`. Status ini diperbarui langsung saat ada event `agent_presence` dari WebSocket — perubahan akan muncul dalam hitungan detik tanpa refresh.
4. Di bagian **My Recent Conversations**, klik salah satu percakapan untuk melompat ke inbox pribadi. Ini berguna saat supervisor juga ikut menangani percakapan.
5. Untuk melihat metrik yang lebih detail (grafik tren 7/30/90 hari, performa per-agent, distribusi kanal), buka menu **Analytics** dari sidebar — lihat halaman [Analytics](/panduan/supervisor/analytics).

![Screenshot dashboard supervisor](/screenshots/dashboard.png)

## Data yang ditampilkan

| Bagian | Sumber API | Diperbarui oleh |
|---|---|---|
| Platform Overview | `GET /api/analytics/overview` (tag **Analytics**) | Fetch saat mount + event WebSocket `agent_presence` |
| Agent Status roster | `GET /api/agents` (tag **Agents**) | WebSocket `conversation_updates` channel |
| My Recent Conversations | `GET /api/conversations?status=open&assigned_to=me` (tag **Conversations**) | Polling manual (klik refresh) |
| Unassigned counter | `GET /api/conversations?status=open&assigned_to=none` | Sama dengan di atas |

Endpoint-endpoint ini didokumentasikan lengkap di [API Reference — Analytics](/api) dan [API Reference — Agents](/api).

## Cara membaca metrik

- **Resolution Rate rendah (< 50%)** → Biasanya menandakan antrian percakapan menumpuk atau SLA terbengkalai. Buka halaman [Pemantauan SLA](/panduan/supervisor/pemantauan-sla) untuk melihat apakah ada breach aktif.
- **Agents Online < 50% total** → Mungkin jadwal shift sedang transisi atau ada masalah koneksi. Hubungi administrator jika kondisi berlanjut.
- **Messages Today tiba-tiba melonjak** → Bisa jadi kampanye baru sedang berjalan atau ada insiden. Cek halaman [Campaign](/panduan/supervisor/campaign) untuk konteks.

:::tip
Jika Agent Status tidak berubah secara real-time, coba refresh halaman atau periksa koneksi internet Anda. Jika masalah berlanjut, hubungi administrator.
:::

## Rute terkait

- [Analytics](/panduan/supervisor/analytics) — dashboard metrik lengkap dengan grafik tren
- [Pemantauan SLA](/panduan/supervisor/pemantauan-sla) — konfigurasi dan monitoring SLA
- [Kinerja Agent](/panduan/supervisor/kinerja-agent) — tabel performa per-agent dan CSAT
