Integrasi Perangkat Fingerprint (ADMS)

SekolahIn mendukung integrasi langsung dengan mesin absensi sidik jari (fingerprint) fisik seperti tipe Solution X105 (atau tipe lain yang mendukung protokol ADMS/iClock).

Melalui integrasi ini, data kehadiran yang direkam pada perangkat sidik jari di sekolah akan dikirimkan secara langsung (real-time) ke server SekolahIn dan dikonsolidasikan ke dalam Laporan Kehadiran Harian.

---

1. Konfigurasi Awal Mesin Fisik (ADMS)

Agar mesin fingerprint dapat berkomunikasi dengan server SekolahIn, Anda perlu mengatur menu ADMS / Pemberian Data langsung pada mesin fisik:

1. Masuk ke Menu Utama pada mesin fingerprint Anda.
2. Cari menu Komunikasi -> Server ADMS (atau Pemberian Data / Web Setup).
3. Atur parameter berikut:
   • Alamat Server (Server IP/Host): Masukkan domain utama aplikasi SekolahIn (misalnya: sekolah-in.id atau IP server Anda).
   • Port Server: Masukkan port server web Anda (default: 80 atau 443 jika menggunakan HTTPS).
   • Gunakan HTTPS: Aktifkan (Pilih Ya) jika server Anda menggunakan sertifikat SSL/HTTPS.
   • URL Path / Sub-directory: Biarkan kosong atau pastikan rute utama mengarah ke /iclock.
4. Hubungkan mesin ke jaringan internet melalui kabel LAN atau Wi-Fi. Setelah terhubung, mesin akan mengirimkan heartbeat secara periodik ke server SekolahIn.

---

2. Manajemen Perangkat di Panel Admin

Semua pengelolaan perangkat sidik jari dapat diakses melalui menu Perangkat Fingerprint di panel admin.

A. Pendaftaran Perangkat Baru

1. Klik tombol Tambah Perangkat di kanan atas.
2. Isi kolom data berikut:
   • Nomor Seri (Serial Number): Masukkan nomor seri unik mesin Anda (dapat dilihat di bagian belakang mesin fisik atau pada menu System Info di mesin). Penting: Nomor seri harus sangat akurat karena digunakan sebagai pengidentifikasi unik komunikasi data.
   • Nama Perangkat: Berikan nama yang mudah dikenali (misalnya: "Mesin Pintu Utama" atau "Fingerprint Guru").
   • Lokasi: Lokasi fisik mesin dipasang (misalnya: "Gedung A Lantai 1").
3. Klik Simpan.

B. Fitur Deteksi Perangkat Otomatis (Auto-Discovery)

Jika mesin fisik sudah dikonfigurasi ADMS-nya namun belum didaftarkan di admin panel, sistem SekolahIn akan mendeteksi upaya koneksi mesin tersebut secara otomatis.

• Perangkat yang belum terdaftar akan muncul di bagian bawah halaman pada area Perangkat Ditemukan (Belum Terdaftar).
• Admin cukup mengeklik tombol Daftarkan untuk langsung menyimpan perangkat tersebut ke dalam sistem tanpa perlu mengetik ulang nomor serinya.

C. Pemantauan Status Koneksi (Heartbeat)

Setiap perangkat menampilkan status keaktifannya berdasarkan heartbeat terakhir yang dikirim ke server:

• Hijau (Aktif): Perangkat sedang online dan mengirimkan data dalam 5 menit terakhir.
• Kuning (Siaga): Perangkat belum mengirimkan data antara 5 hingga 30 menit terakhir.
• Merah (Offline): Perangkat tidak aktif atau terputus selama lebih dari 30 menit.

---

3. Pemetaan Pengguna (User Mapping)

Setiap pengguna di mesin sidik jari memiliki PIN (User ID numeric) yang unik. Agar sistem mengetahui sidik jari milik siapa yang dipindai, Anda harus memetakan PIN tersebut ke pengguna sistem (Siswa, Guru, atau Staf).

1. Pada kartu perangkat yang diinginkan, klik ikon Pemetaan Pengguna (ikon Kunci/Pengguna).
2. Di dalam modal Pemetaan Pengguna:
   • Masukkan PIN yang digunakan pengguna pada mesin fisik.
   • Pilih nama Siswa/Guru/Staf yang bersesuaian. Pilihan nama telah difilter secara cerdas untuk meminimalkan duplikasi data.
3. Klik Simpan Pemetaan.

Konsolidasi Riwayat Otomatis

Ketika Anda berhasil memetakan PIN baru ke seorang pengguna, sistem SekolahIn secara otomatis menjalankan konsolidasi retrospektif. Artinya, semua data riwayat absensi yang pernah direkam oleh PIN tersebut sebelumnya (yang berstatus belum terpetakan) akan langsung diproses dan dimasukkan ke Laporan Kehadiran Harian pengguna tersebut secara otomatis.

---

4. Konsolidasi Kehadiran & Notifikasi Pengaturan

Sistem SekolahIn memiliki pengaturan konsolidasi global untuk menentukan apakah data fingerprint akan digabungkan secara otomatis ke rekap absen harian.

• Status Default: Fitur konsolidasi ini Aktif secara Bawaan (Enabled by Default) untuk memastikan semua log kehadiran sidik jari langsung tercatat pada laporan harian tanpa konfigurasi tambahan.
• Pengaturan Konsolidasi: Anda dapat menonaktifkan atau mengaktifkan kembali fitur ini melalui halaman Pengaturan Absensi (/face-attendance/settings).

Pemberitahuan Status Dinonaktifkan

Jika fitur konsolidasi otomatis dimatikan oleh sekolah:

• Halaman Perangkat Fingerprint akan menampilkan Spanduk Peringatan Informasional (Alert Notice) yang cukup jelas.
• Peringatan tersebut menginformasikan bahwa konsolidasi otomatis sedang dinonaktifkan, sehingga log sidik jari baru tidak akan masuk ke rekap absensi harian sampai fitur tersebut diaktifkan kembali.
• Disediakan tombol jalan pintas langsung di dalam peringatan untuk mengarahkan admin ke halaman pengaturan.

---

5. Sinkronisasi Real-Time (Laravel Reverb)

Sistem absensi SekolahIn didukung oleh teknologi WebSocket via Laravel Reverb. Setiap kali mesin fingerprint mengirimkan log absen baru atau admin melakukan pemetaan pengguna, perubahan data kehadiran akan disiarkan (broadcasted) dan layar laporan admin (seperti Log Kehadiran dan Laporan Kehadiran Harian) akan diperbarui secara otomatis dalam hitungan detik tanpa perlu memuat ulang halaman (refresh).