Lokasi Kantor (Office Locations)

Modul Office Locations memungkinkan pengelolaan lokasi kantor fisik untuk validasi kehadiran berbasis GPS. Setiap lokasi memiliki koordinat dan radius yang mendefinisikan area kehadiran yang valid (Geofence).

Buat lokasi baru

1. Langkah 1 — Buka Office Locations

   

   

   Dari sidebar, buka HRIS › Office Locations. Daftar semua lokasi kantor aktif dan tidak aktif ditampilkan di sini.

2. Langkah 2 — Klik Add Location

   Klik Add Location dan isi formulir:

   • Location Name — nama deskriptif (misalnya, “Kantor Pusat Jakarta”)
   • Address — alamat lengkap sebagai referensi
   • Coordinates — cari nama lokasi di kolom pencarian peta (autocomplete Google Maps) lalu pilih hasilnya, atau jatuhkan/geser pin langsung di peta. Koordinat hanya diambil dari peta — isian latitude/longitude manual telah dihapus agar titik selalu presisi penuh.
   • Radius — radius dalam meter dari titik koordinat (misalnya, 100m, 200m)

3. Langkah 3 — Simpan dan aktifkan

   Klik Save. Tombol Save aktif hanya setelah koordinat terisi dari peta. Koordinat terpilih ditampilkan (read-only) di bawah peta sebagai konfirmasi.

Cara Geofence bekerja

Geofence adalah batas lingkaran yang terbentuk dari koordinat pusat dan radius_meters sebuah lokasi kantor. Saat karyawan check-in:

• Sistem menghitung jarak antara posisi GPS karyawan dan koordinat kantor menggunakan formula Haversine.
• Pengecekan bersifat accuracy-aware: posisi diterima jika jarak ≤ radius + min(akurasi yang dilaporkan, batas toleransi). Ini mencegah penolakan salah pada perangkat kelas bawah yang memiliki fix GPS kurang presisi di tepi radius.
• Jika karyawan berada di luar radius, check-in diblokir keras (HTTP 400) — bukan sekadar peringatan.

Kaitkan dengan departemen

Setiap lokasi dapat dikaitkan dengan satu atau lebih departemen. Pengaitan departemen-lokasi ini adalah mekanisme department-derived — berbeda dari Assigned Office yang ditentukan per karyawan.

Assigned Office sekarang bersifat eksklusif

Menugaskan karyawan ke satu atau lebih Assigned Office kini membuat penugasan itu eksklusif. Assigned Office karyawan — ditambah Work Visit yang disetujui — adalah satu-satunya tempat ia boleh check-in tanpa persetujuan (disebut Allowed Set). Kantor berbasis departemen dan kantor “global” tidak lagi otomatis memenuhi syarat.

• Karyawan dengan Assigned Office → hanya boleh absen di Assigned Office-nya (atau Work Visit yang disetujui).
• Karyawan tanpa Assigned Office → fallback ke satu kantor rumah dari departemennya, bukan gabungan semua kantor departemen/global.

Jika karyawan berdiri di dalam Geofence kantor yang bukan Allowed Set-nya, ia tidak bisa check-in diam-diam — di halaman check-in ia mendapat rekomendasi untuk mengajukan Work Visit (dengan formulir yang sudah terisi sebagian).

Assigned Office vs lokasi berbasis departemen

Mekanisme	Cara kerja	Diatur di
Assigned Office	Per karyawan, tanpa persetujuan, permanen, eksklusif (department/global tidak ikut)	Profil karyawan (admin)
Department-derived	Fallback satu kantor rumah hanya untuk karyawan tanpa Assigned Office	Halaman ini (Office Locations)
Nearby Attendance	Karyawan fisik berada di dalam Geofence kantor di luar Allowed Set (default OFF)	Pengaturan Attendance Rules
Work Visit	Per karyawan, memerlukan persetujuan, sementara	Modul Work Visit Requests