Kiosk Absensi - Dokumentasi Zayeen

Dipakai Oleh

Karyawan, operator front desk, HR, dan admin absensi

operasional kiosk

kamera, device kiosk aktif, jam kerja, dan izin browser

Saat perusahaan ingin absensi dilakukan dari satu perangkat bersama di pintu masuk, lobi, toko, gudang, atau lokasi proyek.
Saat employee attendance biasa tidak cocok dipakai karena perangkat dipakai bergantian oleh banyak karyawan.
Saat proses absensi perlu foto proof atau verifikasi wajah sebelum check in atau check out disimpan.

Siapkan jadwal kerja di Daftar Jam Kerja dan hari libur di Daftar Hari Libur.
Pastikan data karyawan sudah lengkap dan employee ID yang dipakai di lapangan konsisten.
Buat minimal satu device di Perangkat Kiosk Absensi.
Jika device memakai verifikasi wajah, lakukan pendaftaran wajah lebih dulu di Face Enrollment.
Buka halaman kiosk dengan query ?deviceid=... agar device yang dipakai langsung dipilih.

Buka menu SDM & Payroll / Absensi / Kiosk Absensi.
Pastikan device sudah terpilih. Jika belum, pilih device yang sesuai lokasi kiosk.
Masukkan ID karyawan secara manual atau scan QR code bila device mendukung scan kamera.
Tekan tombol pemeriksaan ID atau scan sampai sistem menampilkan nama karyawan dan status absensi.
Jika status sudah siap, tekan Start Check-In atau Start Check-Out.
Baca instruksi verifikasi yang tampil di atas panel kamera. Live preview hanya menampilkan frame wajah agar tampilan kamera tetap bersih.
Saat kamera siap, arahkan wajah ke frame. Tersenyum, berkedip, atau gerakkan kepala sedikit bila mode verifikasi meminta langkah liveness tambahan.
Tekan Ambil Foto hanya saat status capture sudah siap. Untuk mode face_api dan webhook, verifikasi wajah berlanjut otomatis setelah foto proof diambil.
Jika berhasil, sistem menyimpan absensi, menampilkan tombol Selesai, lalu menjalankan countdown auto reset 30 detik.

Mode	Penjelasan	Kapan Dipakai
photo_only	Device hanya mengambil foto proof. Tidak ada pencocokan wajah ke template karyawan.	Untuk kiosk sederhana yang hanya butuh dokumentasi foto check in dan check out.
face_api	Pencocokan wajah dilakukan langsung di browser memakai template hasil enrollment.	Untuk kiosk yang ingin face matching tanpa server face recognition khusus.
webhook	Foto proof dikirim ke engine eksternal melalui konfigurasi di device.	Untuk perusahaan yang sudah punya service face recognition sendiri atau integrasi pihak ketiga.

Query yang dipakai kiosk sekarang hanya deviceid. Query lain untuk tenant atau device lama diabaikan.
Jika deviceid tidak ada, halaman memaksa user memilih device dari daftar.
Tombol Ganti Device dan keluar halaman diproteksi PIN admin dari master device.
Pembatalan absensi dari kiosk memakai PIN admin dan alasan pembatalan, karena proses ini ditujukan untuk koreksi yang diawasi pada device bersama.
Master device dapat menampilkan HTML informasi tambahan pada panel samping kiosk, misalnya pengumuman cabang, instruksi antrean, atau catatan internal.
Jika verifikasi wajah gagal, foto proof tidak dipertahankan untuk absensi tersebut.
Untuk face mismatch, sistem tidak langsung membuat countdown selesai; user bisa langsung ulangi proses verifikasi.
Setelah sukses, kiosk menyembunyikan banner blokir verifikasi agar state akhir lebih mudah dipahami user sebelum perangkat reset kembali.

Tidak bisa mulai verifikasi: cek apakah status absensi memang sedang dalam window check in atau check out yang aktif.
Wajah tidak bisa diverifikasi: cek apakah employee sudah punya template wajah aktif dan izin kamera browser sudah diberikan.
QR scan tidak muncul: aktifkan opsi Scan ID dengan Kamera pada device kiosk.
Karyawan selalu ditolak check out: cek apakah ada data check in yang terbuka dan belum ditutup.
Menu berubah device tanpa sengaja: aktifkan dan jaga PIN admin di master device.

Face Enrollment untuk membuat template wajah karyawan.
Perangkat Kiosk Absensi untuk pengaturan mode verifikasi, PIN admin, dan scan kamera.
Absensi Karyawan untuk absensi personal di device masing-masing, bukan kiosk bersama.