Panduan Penggunaan
Web App Absensi QR Code

1. Masukkan NIS / NISN: Ketik nomor NISN (atau NIS untuk kelas 10) di kolom login siswa → klik Login Siswa.

2. Konfirmasi Identitas: Sistem akan menampilkan Nama, NISN, dan Kelas Anda. Pastikan data sudah sesuai.

3. Buat Password Pertama Kali: Jika baru pertama kali login, buat kata sandi pribadi (8–16 karakter) dan konfirmasi. Password akan langsung diamankan dengan enkripsi SHA-256.

4. Lupa Kata Sandi: Klik tombol "Buat / Lupa Password?" → pilih tanggal lahir Anda dan masukkan password baru → sistem akan mengirimkan tiket permohonan ke Admin. Konfirmasikan langsung ke Admin/Wali Kelas untuk persetujuan.

Menampilkan Kartu Absen Digital Modern lengkap dengan Foto Profil Siswa, NISN, Kelas, status siswa aktif, dan Barcode QR pribadi.

Cara Pakai di Gerbang: Tunjukkan barcode QR ke scanner Petugas OSIS / Guru Piket di gerbang sekolah hingga berbunyi/terkonfirmasi hadir.

Langkah presensi mandiri saat berada di area SMKN 20 Jakarta (pada jam operasionalnya):

1. Buka menu Absen Mandiri di dashboard siswa. Sistem otomatis memilih sesi (Masuk/Pulang).
2. Izinkan akses lokasi/GPS pada browser HP Anda dengan saklar Precise Location aktif.
3. Peta interaktif akan mengukur jarak ke pusat sekolah. Jika berada dalam batas toleransi radius (≤ 100m), tombol "Kirim Absen Sekarang" akan aktif.
4. Tekan tombol untuk mengirim presensi mandiri.

Siswa dapat menyampaikan saran perbaikan, kendala aplikasi, atau pertanyaan ke pihak sekolah:

• Riwayat Masukan: Seluruh tiket masukan yang pernah dikirim akan tercatat dengan ID Tiket unik (misal #TKT-FDB-A1B2) beserta status tanggapannya (Menunggu Respon / Ditanggapi / Selesai).
• Batasan Kirim: Setiap siswa dapat mengirim maksimal 1 masukan per hari untuk mencegah spam.
• Balasan Admin: Jika Admin membalas masukan, siswa akan menerima notifikasi pesan personal pada akunnya.

Menampilkan histori presensi lengkap dari hari ke hari — status Hadir, Terlambat (beserta menit keterlambatan), Sakit, Izin, atau Alpa beserta jam masuk dan jam pulang.

Pengumuman penting dari pihak sekolah atau wali kelas akan muncul di sini. Ikon lonceng hijau di pojok kanan atas akan menampilkan tanda notifikasi baru.

Login menggunakan username & password khusus akun Petugas OSIS yang telah didaftarkan oleh Admin.

Petugas OSIS bertugas memindai kartu siswa saat jam kedatangan pagi maupun kepulangan sore:

1. Klik tombol 📷 Buka Scanner QR pada dashboard untuk membuka kamera pemindai.
2. Izinkan akses kamera perangkat. Disarankan menggunakan kamera belakang dengan pencahayaan yang cukup.
3. Arahkan kamera ke barcode QR Code pada kartu pelajar fisik atau layar HP siswa.
4. Pencatatan Otomatis Real-time: Sistem otomatis mengenali status siswa:
   • Pagi Hari: Mencatat jam kedatangan (Tepat Waktu / Terlambat) secara langsung.
   • Sore Hari: Mencatat jam kepulangan siswa secara otomatis pada jam pulang yang diizinkan.
5. Setiap pemindaian berhasil akan langsung menampilkan konfirmasi nama, kelas, jam presisi, dan scanner langsung siap memindai siswa berikutnya.

Jika barcode kartu siswa pudar, rusak, atau kamera HP mengalami kendala fokus, petugas OSIS dapat mengetikkan Nomor Induk Siswa Nasional (NISN) pada kolom input manual lalu tekan Submit/Enter. Kehadiran akan langsung tercatat dan tetap terhitung sebagai poin keaktifan petugas.

Login menggunakan username & password yang telah dibuatkan oleh Admin (TU). Jika lupa password, hubungi Admin untuk direset.

Ringkasan kehadiran hari ini dari semua kelas (tidak terbatas kelas tertentu), karena Guru Piket bertugas mengawasi kehadiran seluruh siswa di sekolah.

Pilih dulu kelas & tanggal, lalu pilih mode Absen Masuk atau Absen Pulang (tombol toggle).

Cara 1 — Scan QR (direkomendasikan): klik 📷 Buka Kamera Live → izinkan akses kamera & pop-up → arahkan kamera ke QR Code siswa. Begitu terdeteksi, kehadiran langsung otomatis tersimpan ke database saat itu juga — tidak perlu klik tombol simpan/kirim lagi setelah scan.

Cara 2 — Input manual: ketik NISN di kolom input manual (kalau kamera bermasalah/cahaya kurang), atau klik langsung nama siswa di tabel untuk set status Hadir/Sakit/Izin/Alpa, klik Tandai Semua kalau semua hadir, lalu klik 💾 Kirim Absensi — tombol ini hanya diperlukan untuk metode input manual, bukan untuk hasil scan QR.

Mencatat kehadiran sholat berjamaah siswa (misal Sholat Dhuha, Dzuhur berjamaah), terpisah dari absensi harian. Input dilakukan per kelas dan per waktu sholat yang dipilih.

Memantau kehadiran semua kelas secara real-time dengan filter: Semua/Hadir, Belum Absen, Terlambat, Belum Pulang, Sakit/Izin/Alpa. Kolom Keterangan Waktu otomatis menampilkan "Terlambat X menit" kalau siswa datang melewati jam yang dikonfigurasi Admin, atau "Pulang Cepat" kalau pulang lebih awal dari jadwal.

Saat filter Belum Absen atau Belum Pulang aktif, muncul tombol Forward WA untuk mengirim daftar nama tersebut ke grup wali murid (via WhatsApp Web, Copy Template, atau Broadcast Gateway/WABLAS yang masih dalam pengembangan). Filter Belum Pulang hanya menampilkan siswa yang sudah tercatat datang tapi belum pulang — siswa Sakit/Izin/Alpa tidak ikut muncul di sini.

Pilih bulan, tahun, dan kelas (opsional) → klik Tampilkan → sistem merangkum jumlah hadir/sakit/izin/alpa tiap siswa dalam satu bulan. Bisa diekspor ke Excel/PDF.

Login menggunakan username & password yang dibuatkan Admin (TU). Jika lupa password, hubungi Admin untuk direset.

Ringkasan kehadiran hari ini khusus kelas yang diampu — akses Guru Wali Kelas terbatas hanya pada kelasnya sendiri.

Klik menu Daftar Hadir — kelas otomatis terisi sesuai kelas yang diampu (kalau cuma pegang satu kelas, langsung terpilih otomatis). Pilih dulu mode Absen Masuk atau Absen Pulang.

Cara 1 — Scan QR: klik 📷 Buka Kamera Live → izinkan akses kamera & pop-up → arahkan ke QR Code siswa. Kehadiran langsung otomatis tersimpan begitu terdeteksi, tanpa perlu klik tombol simpan lagi.

Cara 2 — Manual: ketik NISN di kolom input manual, atau klik nama siswa di tabel untuk set status (Hadir Sakit Izin Alpa), lalu klik 💾 Kirim Absensi. Sistem otomatis menolak penyimpanan jika hari itu ditandai libur. Menu ini juga dipakai mencatat jam pulang siswa.

Mencatat kehadiran sholat berjamaah untuk siswa di kelas yang diampu.

Mengirim pesan/pengumuman ke siswa tertentu atau ke seluruh siswa di kelas yang diampu sekaligus. Pesan ini akan langsung muncul di ikon notifikasi lonceng pada dashboard siswa penerima.

Memantau kehadiran real-time khusus kelas sendiri dengan filter Belum Absen/Belum Pulang/Terlambat, dll. Kolom Keterangan Waktu otomatis menampilkan "Terlambat X menit" atau "Pulang Cepat" sesuai jam yang dikonfigurasi Admin. Tombol Forward WA muncul untuk mengirim notifikasi ke wali murid kelasnya — juga tersedia sebagai tombol pintasan langsung di dashboard.

Rekap kehadiran bulanan untuk siswa di kelas yang diampu — pilih bulan & tahun, lalu ekspor ke Excel/PDF untuk keperluan rapor.

Mengatur teks header & footer template pesan WhatsApp (untuk template Absen dan Pulang) yang dipakai tombol Forward WA. Template yang diatur di sini hanya berlaku untuk akun Guru tersebut, tidak memengaruhi guru lain.

Login menggunakan username & password yang dibuatkan Admin (TU).

Ringkasan kehadiran seluruh sekolah — peran ini bersifat read-only (hanya memantau), tidak dapat mengubah data absensi maupun data pengguna.

Dilengkapi Widget Highlight Apresiasi di bagian bawah grafik: menampilkan 5 Siswa Hadir Paling Pagi hari ini dan 5 Petugas Scanner (OSIS/Piket) teraktif.

Pusat apresiasi kedisiplinan siswa dan pemantauan keaktifan petugas piket gerbang:

• Mode Ganda (Harian & Rentang Waktu):
  • 📅 Mode Harian (Default): Menampilkan 10 Siswa Hadir Paling Awal hari ini dan total scan petugas OSIS hari ini.
  • 📆 Mode Rentang Waktu (Mingguan / Bulanan / Kustom): Menghitung peringkat Siswa Terdisiplin berdasarkan Total Hari Hadir terbanyak dan Rata-rata Jam Masuk Terpagi, serta akumulasi total scan dan hari aktif bertugas petugas OSIS.
• Podium Visual Top 3 Card (🥇 Juara 1 Emas, 🥈 Perak, 🥉 Perunggu): Tersedia untuk tab Siswa Terdisiplin maupun tab Keaktifan Petugas OSIS dengan badge mahkota emas dan sub-metrik interaktif.
• Tabel Peringkat Lanjutan: Menampilkan ranking 4 s/d 30 siswa terdisiplin dan daftar seluruh petugas OSIS aktif di bagian bawah podium.
• Export Rekap Multi-Sheet Excel: Tombol Export Rekap langsung mengunduh file spreadsheet (.xlsx) berisi 2 sheet terstruktur: Sheet 1: Rekap Siswa Terdisiplin dan Sheet 2: Rekap Keaktifan Petugas.

Cara pakai: klik menu Laporan → atur filter tanggal mulai & akhir, serta kelas (kosongkan untuk semua kelas) → klik 🔍 Cari → setelah data tampil, klik 📊 Export Excel atau 📄 Export PDF untuk mengunduh.

Pilih bulan & tahun, serta kelas (opsional) → klik Tampilkan. Menampilkan jumlah hari hadir, sakit, izin, alpa tiap siswa dalam satu bulan — bisa diekspor Excel/PDF untuk pelaporan ke dinas.

Login menggunakan username & password Admin. Admin adalah satu-satunya peran yang bisa menambah/mengubah akun pengguna lain.

Halaman "Direktori Siswa" — tempat mengelola seluruh data induk siswa. Ada 2 baris kontrol: toolbar tombol aksi massal di atas, dan tombol aksi per-baris di kolom "Aksi" tabel.

Halaman ini mengelola akun Guru sekaligus akun Guru Piket dan Petugas OSIS dari satu tempat yang sama. Ada toolbar tombol aksi massal di atas, serta tombol aksi per-baris di tabel.

Tidak ada tombol "backup" khusus di dalam webapp. Cara paling aman adalah backup langsung dari Google Drive, bukan dari dalam sistem absensi:

Sama seperti peran Wakil Kepala Sekolah: filter tanggal/kelas → Cari → Export Excel/PDF. Admin bisa melihat laporan seluruh kelas kapan saja.

Fitur akhir tahun ajaran untuk memproses perpindahan kelas siswa secara massal sesuai pemetaan kenaikan yang ditentukan.

Menentukan jam toleransi keterlambatan, jadwal harian, daftar tanggal merah, serta jam operasional Absen Mandiri GPS. Tersimpan di sheet konfigurasi.

Admin mengelola dua jenis tiket dari pengguna:

• Tiket Lupa Password: Siswa/Guru yang mengajukan reset password akan masuk ke daftar pending. Admin memverifikasi identitas tatap muka lalu menekan tombol Setujui (Approve) untuk mengenkripsi password baru ke hash SHA-256 dan menghapus tiket pending.
• Tiket Kritik & Saran: Seluruh masukan dan feedback siswa tertampung dengan nama pengirim lengkap. Admin dapat menekan tombol 💬 Balas Cepat untuk langsung mengirim pesan balasan ke akun siswa bersangkutan.

Mengatur template pesan WA (Absen & Pulang). Berbeda dari versi Guru: template yang disimpan Admin di sini berlaku untuk seluruh akun Guru Piket sekaligus.

Menambah, mengubah nama, atau menghapus kelas — daftar kelas di sini muncul di semua dropdown pemilihan kelas di seluruh sistem.

Admin memiliki akses yang sama seperti Guru Piket untuk ketiga menu ini — bisa scan QR/input manual absensi semua kelas, mencatat absensi sholat, dan mengirim pesan/pengumuman ke siswa manapun.

Untuk Daftar Hadir: hasil scan QR (mode Absen Masuk maupun Absen Pulang) langsung otomatis tersimpan ke database begitu terdeteksi — tombol 💾 Kirim Absensi hanya diperlukan untuk metode input manual. Kolom Anomali juga tersedia di sebelah kiri kolom Status: kalau ada siswa berstatus Hadir tapi ternyata tidak ada secara fisik saat dicek ulang, klik tombol A untuk mengubah statusnya jadi Alpa (detail lengkap ada di tab Proses Absensi).