PANDUAN FITUR PEMBATASAN LOKASI GPS PPG CALON GURU

A. TUJUAN
Fitur ini membatasi peserta agar hanya dapat melakukan presensi jika berada di dalam radius lokasi kegiatan.

B. CARA MENGATUR LOKASI
1. Login sebagai Admin.
2. Buka menu PPG Calon Guru.
3. Klik Detail pada kegiatan.
4. Klik tombol Atur Lokasi GPS.
5. Pilih:
   Ya, wajib berada dalam radius lokasi kegiatan.
6. Isi:
   - Nama Lokasi
   - Latitude Lokasi
   - Longitude Lokasi
   - Radius Presensi Diizinkan dalam meter
7. Admin dapat memakai tombol:
   Ambil Lokasi Saya Saat Ini
   untuk mengisi latitude dan longitude otomatis.
8. Klik Simpan Lokasi Presensi.

C. SAAT INPUT KEGIATAN BARU
Pada form tambah kegiatan, admin juga dapat langsung mengisi:
1. Batasi presensi berdasarkan lokasi.
2. Nama lokasi.
3. Latitude.
4. Longitude.
5. Radius.

D. CARA KERJA DI SISI PESERTA
1. Peserta login sebagai Peserta.
2. Buka Presensi PPG Calon Guru.
3. Klik Presensi Materi Ini.
4. Jika lokasi diwajibkan:
   - Browser meminta izin lokasi.
   - Peserta harus mengaktifkan GPS/lokasi HP.
   - Sistem menghitung jarak peserta dari titik kegiatan.
5. Jika dalam radius, presensi diterima.
6. Jika di luar radius, presensi ditolak.
7. Jika lokasi tidak diizinkan/tidak terdeteksi, presensi ditolak.

E. DATA YANG DISIMPAN
Saat presensi berhasil, sistem menyimpan:
1. Latitude peserta.
2. Longitude peserta.
3. Akurasi lokasi.
4. Jarak peserta dari titik kegiatan.
5. Status lokasi:
   - Dalam Radius
   - Luar Radius
   - Lokasi Tidak Terdeteksi
   - Tidak Dibatasi

F. REKAP DAN LAPORAN
1. Rekap presensi menampilkan status lokasi dan jarak.
2. Export Excel menampilkan status lokasi dan jarak.
3. PDF menampilkan informasi apakah lokasi kegiatan dibatasi radius.

G. CATATAN PENTING
1. Fitur GPS membutuhkan HTTPS.
2. Pada domain https://ppgunm.online/presensi fitur ini dapat berjalan karena sudah HTTPS.
3. Akurasi GPS tergantung perangkat, sinyal, dan izin lokasi.
4. Radius disarankan:
   - 50–100 meter untuk ruang/gedung kecil.
   - 100–300 meter untuk area kampus/gedung luas.
5. Untuk keamanan lebih kuat, gunakan kombinasi:
   GPS lokasi + batas jam materi + login peserta.

H. DATABASE
Untuk database lama, jalankan:
migrasi_ppg_cagur_lokasi.sql

Untuk instalasi baru dari awal, cukup gunakan database.sql.
