Troubleshooting

Deskripsi Singkat

Kumpulan solusi untuk masalah teknis yang umum terjadi saat menggunakan aplikasi presensi.

---

1. Offline Sync Gagal

Masalah: Setelah absen secara offline, data tidak tersinkronisasi saat koneksi kembali.

Solusi:

1. Periksa koneksi internet — pastikan HP terhubung ke internet (WiFi/data seluler).
2. Buka aplikasi dan pull-to-refresh (tarik layar ke bawah) pada halaman utama.
3. Buka menu Riwayat dan periksa apakah status presensi masih Pending (ikon jam).
4. Jika masih pending, klik tombol Sync Ulang atau Coba Lagi.
5. Jika tetap gagal:
   • Tutup aplikasi dan buka kembali.
   • Hapus cache browser (untuk web app): Settings > Apps > Browser > Clear Cache.
   • Coba gunakan koneksi internet lain.

Pencegahan:

• Pastikan mode offline diaktifkan saat koneksi masih bagus.
• Jangan keluar dari halaman absen sebelum status berubah menjadi Tersimpan.

---

2. Device Tidak Terotorisasi

Masalah: Muncul pesan "Perangkat Tidak Terdaftar" atau "Device Not Authorized" saat login.

Solusi:

1. Periksa apakah Anda login menggunakan akun yang benar.
2. Jika menggunakan HP baru, mungkin perlu registrasi ulang.
3. Hubungi Admin Sekolah atau Operator untuk:
   • Mendaftarkan perangkat baru Anda.
   • Menghapus perangkat lama dari daftar perangkat terotorisasi.
4. Jika fitur device binding tidak aktif, abaikan pesan ini (beberapa sekolah tidak menggunakan fitur ini).

---

3. Data Tidak Muncul di Dashboard / Laporan

Masalah: Halaman kosong atau data tidak tampil.

Solusi:

1. Periksa filter Tanggal dan Tahun Akademik yang dipilih.
2. Pastikan Anda memilih filter yang benar:
   • Untuk siswa, pilih kelas yang sesuai.
   • Untuk guru, pilih tanggal yang benar.
3. Refresh halaman (F5 atau tarik layar ke bawah).
4. Logout dan login kembali.
5. Bersihkan cache browser:
   • Chrome: Settings > Privacy & Security > Clear Browsing Data.
   • Pilih All Time dan centang Cached Images and Files.
6. Jika masih kosong, coba akses dari browser atau perangkat lain.

---

4. Aplikasi Sangat Lambat

Masalah: Aplikasi berjalan lambat, loading lama.

Solusi:

1. Periksa kecepatan internet Anda (coba buka website lain).
2. Tutup tab browser yang tidak perlu.
3. Kurangi penggunaan aplikasi berat di HP yang sama.
4. Bersihkan cache browser.
5. Jika menggunakan WiFi, coba ganti ke data seluler atau sebaliknya.
6. Laporkan ke Admin jika aplikasi lambat terus-menerus — mungkin server perlu di-upgrade.

---

5. GPS Tidak Akurat

Masalah: Lokasi absen terdeteksi di luar area sekolah padahal sedang di sekolah.

Solusi:

1. Nyalakan mode Akurasi Tinggi di pengaturan lokasi HP:
   • Android: Settings > Location > Mode > High Accuracy.
   • iOS: Settings > Privacy > Location Services > On.
2. Kalibrasi kompas HP dengan menggambar angka 8 di udara (gerakan memutar).
3. Pastikan HP tidak dalam mode Hemat Daya (membatasi GPS).
4. Coba restart HP.
5. Jika masih tidak akurat, gunakan metode absen QR Code atau Manual.

---

6. Kamera Tidak Terdeteksi

Masalah: Saat mencoba absen dengan selfie atau QR, kamera tidak muncul.

Solusi:

1. Periksa izin kamera untuk browser/aplikasi:
   • Chrome: Settings > Site Settings > Camera > Allow.
   • Pastikan tidak ada aplikasi lain yang menggunakan kamera.
2. Tutup aplikasi kamera lain yang mungkin berjalan di latar belakang.
3. Coba gunakan browser yang berbeda.
4. Restart HP.
5. Jika masih gagal, gunakan metode absen alternatif (QR atau Manual).

---

7. Notifikasi Tidak Terkirim

Masalah: Notifikasi absen (misal: ke orang tua) tidak diterima.

Solusi:

1. Periksa apakah nomor HP tujuan sudah benar di data user.
2. Pastikan fitur WA Gateway masih terhubung (cek status di menu pengaturan Admin).
3. Periksa Log Pengiriman di menu WA Gateway — cari pesan yang gagal.
4. Jika banyak gagal, restart koneksi WA Gateway:
   • Scan ulang QR Code.
   • Atau restart server (untuk API Gateway).
5. Pastikan nomor pengirim tidak diblokir oleh penerima.

---

8. Terkunci Akun (Account Locked)

Masalah: Akun terkunci karena terlalu sering salah password.

Solusi:

1. Tunggu 30 menit, coba login kembali.
2. Jika masih terkunci, hubungi Operator atau Admin untuk membuka kunci.
3. Setelah terbuka, login dengan password yang benar.
4. Jika lupa password, minta reset ke Operator.

---

9. Halaman Error 500 / Internal Server Error

Masalah: Halaman menampilkan error 500 atau pesan server error.

Solusi:

1. Tunggu beberapa menit dan refresh halaman.
2. Jika masih error, laporkan ke Admin Sekolah atau Super Admin.
3. Admin dapat memeriksa log error di server.
4. Untuk sementara, gunakan metode absen alternatif.

---

10. Data Presensi Saya Berbeda dengan Teman

Masalah: Status kehadiran berbeda dengan teman sekelas yang hadir bersamaan.

Solusi:

1. Periksa kembali waktu absen masing-masing.
2. Jika Anda absen setelah batas waktu, status Anda mungkin Terlambat sedangkan teman yang absen lebih awal statusnya Hadir.
3. Jika ada keanehan, laporkan ke Operator untuk dilakukan pengecekan dan koreksi.

---

11. Tidak Bisa Login setelah Update Aplikasi

Masalah: Setelah aplikasi di-update, tidak bisa login.

Solusi:

1. Bersihkan cache browser sepenuhnya.
2. Coba gunakan mode Incognito / Private Window.
3. Jika berhasil di incognito, berarti cache lama mengganggu — hapus semua data browser.
4. Jika tetap tidak bisa, hubungi Super Admin — mungkin ada perubahan pada sistem login.

---

12. QR Code di Kartu Fisik Rusak / Luntur

Masalah: Kartu QR Code sudah buram atau rusak sehingga tidak terbaca.

Solusi:

1. Minta Admin atau Operator untuk mencetak ulang kartu QR.
2. Sementara waktu, minta Operator melakukan Absensi Manual.
3. Simpan kartu baru di tempat yang aman (dompet kartu atau laminating).

---

Kontak Dukungan

Jika masalah belum terselesaikan, hubungi:

Level	Kontak
Masalah akun/data	Operator sekolah
Masalah pengaturan	Admin Sekolah
Masalah sistem/server	Super Admin
Masalah kritis/teknis	Tim Support (kontak tertera di halaman login)