Lewati ke konten
Nur Amin
← Semua proyek
P-11Sistem Presensi Sekolah2025

Presensi Sekolah Berbasis Geolokasi

Presensi yang terikat pada lokasi. Siswa mengisi dari ponsel sendiri di dalam radius yang ditetapkan; sekolah mengelola semuanya dari satu dasbor.

Peran saya
Pengembang tunggal — back end Laravel, kedua antarmuka, dan API mobile.
Bidang
Pengembangan Web
Teknologi
  • Laravel 12
  • PHP 8.2
  • MySQL
  • Sanctum
  • Leaflet
  • Tailwind CSS
  • Alpine.js
  • Laravel Excel
  • DomPDF

Tinjauan

Membiarkan siswa mengisi presensinya sendiri dari ponsel sendiri menghapus antrean di gerbang sekaligus membuka lubang yang jelas. Geolokasi menutupnya dengan murah: halaman presensi menampilkan peta Leaflet live berisi sekolah, lingkaran yang diizinkan, serta posisi dan akurasi siswa, dan server hanya menerima kiriman bila jarak Haversine dari titik sekolah berada di dalam radius. Penilaian browser hanya untuk kenyamanan; server menghitung ulang dari koordinat yang diterimanya dan menjelaskan penolakan dalam meter.

Koordinat, radius, toleransi terlambat, dan batas presensi masuk adalah pengaturan yang dipilih lewat peta di panel admin, karena tidak ada dua sekolah dengan bentang dan jam pelajaran yang sama. Status diambil dari jadwal kelas: hadir sampai jam pelajaran pertama ditambah toleransi, terlambat setelahnya, dan ditutup setelah batas. Pulang sebelum pelajaran terakhir selesai tetap diterima tetapi diberi keterangan, dan perintah terjadwal menandai siswa yang belum tercatat pada 23:59 sebagai Alpa — kecuali di hari libur atau hari yang tercakup izin yang disetujui.

Presensi tak pernah sekadar kehadiran. Siswa mengajukan izin dengan lampiran foto atau PDF dan bisa membatalkannya selama menunggu; admin menyetujuinya, yang membuat rekap Izin atau Sakit untuk setiap hari dalam rentangnya di dalam satu transaksi, atau menolaknya dengan catatan. Dasbor admin menampilkan angka hari ini, tren tujuh hari, izin yang menunggu, dan aktivitas terbaru, dan rekap dapat diekspor ke Excel atau PDF dengan filter yang sama seperti di layar.

Aturannya tinggal di service, bukan di controller. Halaman web dan REST API — token Sanctum dengan ability admin atau siswa — memakai Form Request yang sama dan memanggil PresensiService serta IzinService yang sama, sehingga aplikasi mobile nantinya tidak mungkin berbeda hasil dengan situsnya. Login memakai guard Laravel terpisah dengan pembatasan percobaan, dan feature test mencakup radius, keterlambatan, presensi pulang, hari libur, izin, serta render seluruh halaman.

Dalam gambar

Judul GeoPresensi dengan dasbor admin — angka hari ini, tren tujuh hari, dan izin menunggu — serta beranda siswa di ponsel dengan tombol Presensi Masuk.
FIG. 01Dasbor admin dan portal siswa. Tangkapan layar asli dengan data contoh.
Dua ponsel di halaman presensi: satu berjarak 37 m di dalam lingkaran, satu 423 m di luar, di samping tiga langkah dari browser hingga pemeriksaan di server.
FIG. 02Peta untuk siswa; server menghitung ulang jaraknya dan memutuskan.
Garis waktu: Hadir sampai 07:15, Terlambat sampai 12:00, ditutup setelahnya, Alpa ditandai pukul 23:59; kasus hari libur, izin, dan pulang lebih awal; serta rekap admin dengan filter status.
FIG. 03Satu set aturan menentukan setiap status, untuk web maupun API.
Halaman izin siswa dengan pengajuan menunggu, tiga langkah ajukan–tinjau–tercatat, dan daftar pengajuan admin dengan tombol setujui dan tolak.
FIG. 04Izin yang disetujui menjadi rekap Izin atau Sakit, sehingga tidak ada yang salah ditandai Alpa.
Halaman pengaturan dengan titik dan radius sekolah di peta, slider radius, dan aturan waktu, di atas diagram web dan API Sanctum yang memakai satu lapisan service.
FIG. 05Lokasi, radius, dan waktu adalah pengaturan; web dan API memakai satu lapisan service.

Fungsi

Batasan
Jarak Haversine diperiksa di server terhadap titik dan radius sekolah yang diatur di peta
Aturan
Hadir, terlambat, atau ditutup berdasarkan jadwal; Alpa ditandai otomatis pukul 23:59
Jangkauan
Portal web dan REST API Sanctum yang memanggil service yang sama

Yang dikerjakan

  1. 01Presensi masuk dan pulang dari ponsel siswa, dengan peta live, jarak, dan akurasi GPS.
  2. 02Pemeriksaan radius di server (Haversine) terhadap titik dan radius sekolah yang dipilih di peta.
  3. 03Status Hadir atau Terlambat otomatis dari jam pelajaran pertama ditambah toleransi, serta batas presensi masuk.
  4. 04Alpa ditandai otomatis setiap hari pukul 23:59; nonaktif di hari libur.
  5. 05Pengajuan izin dengan lampiran, bisa dibatalkan selama menunggu; persetujuan membuat rekap Izin/Sakit per hari.
  6. 06Dasbor admin dengan angka hari ini, tren tujuh hari, izin menunggu, dan aktivitas terbaru.
  7. 07Manajemen siswa, kelas, jadwal (dengan cek bentrok), hari libur, dan rekap, termasuk koreksi manual.
  8. 08Ekspor rekap ke Excel dan PDF sesuai filter di layar.
  9. 09Portal siswa dengan riwayat bulanan, jadwal, dan profil.
  10. 10REST API dengan token ability Sanctum untuk klien admin dan siswa, serta log aktivitas.

Catatan teknis

Bawaan
Radius 100 m, toleransi 15 menit, presensi masuk ditutup 12:00
API presensi
POST /api/siswa/presensi { latitude, longitude } — masuk atau pulang diputuskan server
Terjadwal
php artisan rekap:alpa, setiap hari pukul 23:59