🔧 Panduan Troubleshooting

Versi 4.6 | 29 April 2026 — Solusi cepat untuk masalah yang sering terjadi

⚡ Solusi Cepat (90% Masalah)

Sebelum baca panduan di bawah, coba ini dulu:

MasalahSolusi Pertama
Tombol tidak meresponsTekan Ctrl + F5 (hard refresh)
Suara tidak keluarKlik layar display 1 kali
Counter terkunciMinta staff yang lock untuk logout, atau admin unlock
Data statistik 0Cek tanggal di date picker → klik Refresh
Tiba-tiba logoutAkun login di perangkat lain → 1 akun = 1 perangkat
Antrian tidak munculCounter 1-5 hanya tampil A-xxx, Counter 6 hanya B-xxx, Counter 7 hanya C-xxx
Halaman blankCek koneksi WiFi

Jika solusi cepat di atas tidak berhasil, baca panduan detail di bawah:

KRITIS

1. Halaman tidak bisa dibuka / blank / error

Penyebab: Koneksi internet terputus atau server sedang down.
Cara fix:
  1. Cek WiFi — pastikan perangkat terhubung ke jaringan
  2. Coba buka http://129.226.200.209/ di browser — jika tetap gagal, internet bermasalah
  3. Coba buka di browser lain (Edge / Firefox)
  4. Jika semua perangkat gagal → kemungkinan server down → hubungi admin IT
SEDANG

2. Login gagal — "Username atau password salah"

Penyebab: Salah ketik, Caps Lock nyala, atau akun belum dibuat.
Cara fix:
  1. Pastikan Caps Lock mati — password case-sensitive (huruf besar/kecil berpengaruh)
  2. Username biasanya huruf kecil semua (contoh: silvia, bukan Silvia)
  3. Jika tetap gagal → minta admin reset password di Admin Dashboard → Kelola Staff
SEDANG

3. Counter terkunci — "Counter sudah digunakan oleh [nama]"

Penyebab: Staff lain sudah login di counter tersebut, atau staff sebelumnya lupa logout.
Cara fix:
  1. Tanya staff yang namanya tercantum → minta dia logout
  2. Jika staff tidak ada / sudah pulang → minta admin buka paksa:
    • Admin Dashboard → scroll bawah → Kelola Counter → klik 🔓 Unlock
  3. Jika tombol unlock tidak ada, jalankan SQL ini di Supabase: 
    UPDATE counters SET locked_by = NULL, lock_owner = NULL WHERE id = [nomor counter];
KRITIS

4. Tombol tidak merespons sama sekali

Penyebab: Browser masih menyimpan versi lama sistem (cache). Kode JavaScript tidak bisa jalan karena cache belum diperbarui.
Cara fix:
  1. Tekan Ctrl + F5 — ini memaksa browser download ulang semua file terbaru
  2. Jika masih gagal → bersihkan cache manual:
    • Chrome → Ctrl + Shift + Delete → centang "Cached images and files" → Clear
  3. Masih gagal? Buka DevTools (F12 → tab Console) — lihat apakah ada tulisan merah. Screenshot error-nya dan kirim ke admin IT
SEDANG

5. Suara pengumuman tidak keluar di TV

Penyebab umum: Layar belum diklik setelah halaman dibuka, atau volume mati.
Cara fix:
  1. Pastikan Anda sudah klik layar display minimal 1 kali setelah halaman terbuka
  2. Cek volume speaker TV / speaker eksternal — naikkan hingga terdengar
  3. Cek volume sistem di Mini PC — pastikan tidak di-mute
  4. Jika halaman baru saja di-refresh, klik layar lagi — suara reset setiap refresh
  5. Habis hapus history Chrome? Permission suara ter-reset. Klik layar display lagi untuk mengaktifkan ulang
  6. Klik kanan tab display.html → pastikan tidak ada tulisan "Mute site"
Kenapa harus diklik? Ini kebijakan keamanan browser — browser tidak boleh memutar suara otomatis sebelum pengguna berinteraksi dengan halaman. Bukan bug sistem.
SEDANG

6. Data statistik admin semua 0

Penyebab: Tanggal di date picker tidak sesuai hari ini, atau memang belum ada data.
Cara fix:
  1. Lihat tanggal di date picker (pojok kanan atas) — pastikan sesuai hari ini
  2. Klik 🔄 Refresh
  3. Jika tanggal benar tapi tetap 0 → memang belum ada pelanggan hari ini
  4. Untuk verifikasi: buat antrian test di Kiosk, lalu cek lagi dashboard
SEDANG

7. Antrian tidak muncul di sidebar counter

Penyebab: Tipe counter tidak cocok dengan kode antrian.
Penjelasan:

Setiap counter hanya menampilkan antrian yang sesuai tipenya:

Counter 1–5Hanya tampil antrian A-xxx (Pembelian)
Counter 6Hanya tampil antrian B-xxx (Pengambilan)
Counter 7Hanya tampil antrian C-xxx (Layanan Pelanggan)

Jika counter 2 tidak menunjukkan antrian, tapi ada antrian C-xxx menunggu — itu karena C-xxx hanya bisa dilayani di counter 7.

RINGAN

8. Video promo tidak tampil di display

Penyebab: File video belum diupload atau nama file salah.
Cara fix:
  1. File harus bernama promo.mp4 (huruf kecil semua)
  2. Taruh di folder /var/www/antrian/assets/ di VPS
  3. Upload: scp promo.mp4 ubuntu@129.226.200.209:/var/www/antrian/assets/
  4. Refresh display.html (F5) — video otomatis tampil
  5. Jika tidak ada file video, panel video otomatis hilang — ini normal, bukan error
RINGAN

8. Staff tiba-tiba ter-logout sendiri

Penyebab: Akun yang sama login di perangkat lain.
Penjelasan:

Ini bukan bug — ini fitur keamanan Single Session. Sistem hanya mengizinkan 1 akun aktif di 1 perangkat. Jika akun Anda login di laptop lain, laptop Anda otomatis logout dalam 30 detik.

Solusi: Pastikan setiap staff hanya login di 1 perangkat. Jika yakin tidak login di tempat lain, hubungi admin untuk investigasi.

RINGAN

9. Export CSV tidak terdownload

Penyebab: Tanggal belum dipilih atau browser memblokir download.
Cara fix:
  1. Pastikan tanggal mulai dan akhir sudah dipilih sebelum klik Download
  2. Cek apakah browser memblokir popup/download → izinkan dari situs ini
  3. Jika muncul toast "Tidak ada data" → tidak ada transaksi di rentang tanggal tersebut
SEDANG

10. Gudang tidak menerima pesanan dari counter

Penyebab: Halaman gudang belum dibuka atau belum di-refresh.
Cara fix:
  1. Staff gudang: pastikan warehouse.html sudah terbuka dan sudah login
  2. Tekan Ctrl + F5 untuk refresh
  3. Cek tab "Masuk" — pesanan baru muncul di sini
  4. Staff counter: pastikan nomor pesanan berhasil dikirim (lihat toast notification hijau)
SEDANG

11. Display TV freeze / tidak update

Penyebab: Koneksi real-time terputus (WiFi tidak stabil) atau browser kehabisan memori.
Cara fix:
  1. Tekan F5 untuk refresh halaman
  2. Setelah refresh, WAJIB klik layar lagi untuk aktifkan suara
  3. Jika masih freeze → tutup Chrome dan buka ulang
  4. Cek koneksi WiFi Mini PC
KRITIS

12. Kiosk tidak bisa ambil antrian

Penyebab: Koneksi internet tablet terputus atau browser crash.
Cara fix:
  1. Cek WiFi tablet — pastikan terhubung
  2. Refresh halaman (Ctrl + F5 atau geser dari atas ke bawah)
  3. Jika masih gagal → tutup Chrome → buka ulang http://129.226.200.209/kiosk.html
  4. Restart tablet jika semua cara di atas gagal

✅ Checklist Harian — Sebelum Buka Toko

Lakukan pengecekan ini setiap pagi sebelum pelanggan datang:

Jika semua cara di atas gagal:
  1. Screenshot pesan error yang muncul
  2. Catat halaman mana yang bermasalah
  3. Hubungi admin IT / developer dengan info tersebut