Fitur

Karyawan Lapangan & Jadwal Kunjungan

Pantau karyawan lapangan secara real-time, kelola lokasi kerja, dan buat jadwal kunjungan terencana — tanpa biaya Google Maps API.

Untuk Siapa Fitur Ini?

Fitur ini dirancang untuk perusahaan dengan karyawan yang bekerja di luar kantor — sales, teknisi, kurir, security, atau tim survei lapangan.

Tipe Karyawan	Mode Tracking	Yang Dipantau
Security / booth attendant	`stay`	Konfirmasi kehadiran berkala (push notif)
Sales / surveyor	`journey_off`	Foto + GPS tiap kunjungan
Driver / teknisi SLA	`journey_active`	Stream GPS aktif saat bergerak
Karyawan kantor biasa	`none`	Tidak ada tracking khusus

💡

Mode tracking diatur HR Admin di Pengaturan → Metode Absensi → Field Tracking. Berlaku untuk semua karyawan tenant, bukan per-karyawan.

Job Sites — Lokasi Kerja Lapangan

Job Site adalah titik lokasi yang terdaftar dengan nama, alamat, dan radius geofence. HR dapat assign satu atau beberapa karyawan ke site tertentu.

Membuat Job Site (HR Admin)

Menu Jobsites → klik Tambah Lokasi
Isi nama lokasi dan alamat (opsional)
Isi Koordinat:
1. Klik Buka Google Maps (tab baru)
2. Cari dan temukan lokasi di Google Maps
3. Klik kanan tepat di lokasi → pilih Salin koordinat
4. Kembali ke form → paste di field “Tempel Koordinat dari Google Maps”
5. Latitude & Longitude terisi otomatis ✓
Set radius geofence (meter) — default 100m
Simpan

🎯

Field koordinat menerima dua format Google Maps:

Decimal: -7.005156, 107.748792
DMS: 7°00′22.0″S 107°44′58.9″E

Cukup copy-paste dari Google Maps — sistem otomatis parse kedua format.

Lihat Lokasi di Maps

Tiap job site di daftar punya link Lihat yang membuka Google Maps di browser dengan pin tepat di koordinat tersebut.

Mode Tracking

Stay Mode

Untuk karyawan yang diam di satu lokasi sepanjang shift (security, resepsionis booth).

Karyawan clock-in seperti biasa
Secara berkala (default setiap 2 jam) karyawan menerima push notification konfirmasi
Tap notifikasi → konfirmasi masih di lokasi
Tidak merespons atau berada di luar geofence → anomali otomatis tercatat

Journey Off Mode

Untuk karyawan yang berpindah lokasi tapi bukti foto per kunjungan sudah cukup (sales, surveyor).

Karyawan clock-in seperti biasa
Di setiap lokasi kunjungan: tap tombol + → ambil foto (wajib) + notes
Sistem catat GPS saat foto diambil
Foto otomatis diberi watermark timestamp + koordinat

Journey Active Mode

Untuk karyawan yang rutenya penting dipantau (driver, teknisi SLA). GPS di-stream secara aktif.

Karyawan clock-in → GPS mulai direkam otomatis di background
App bar menampilkan chip “🟢 GPS Aktif”
Rute lengkap bisa dilihat manager di web
Karyawan tetap bisa submit kunjungan dengan foto seperti journey_off
Clock-out → GPS berhenti otomatis

💡

GPS aktif memerlukan Android Foreground Service agar tidak mati saat app di-background. iOS background location belum didukung.

Jadwal Kunjungan (Visit Plans)

HR / Atasan dapat membuat jadwal kunjungan terencana untuk karyawan lapangan. Sistem secara otomatis mencocokkan kunjungan aktual dengan stop yang direncanakan.

Membuat Jadwal (HR Admin / Manager)

Menu Jadwal Kunjungan → klik Buat Plan
Pilih karyawan → isi judul rencana
Pilih tipe:
- Tanggal spesifik — berlaku hanya pada tanggal tersebut
- Rekuren mingguan — berlaku setiap hari tertentu (mis. setiap Senin) dalam rentang tanggal
Tambah stops — tiap stop berisi:
- Nama lokasi (wajib)
- Alamat (opsional)
- Koordinat — paste dari Google Maps (sama seperti Job Sites di atas)
- Jam ekspektasi tiba & durasi minimum
- Wajib dikunjungi (checklist)
Simpan → plan langsung aktif

Karyawan Lihat Jadwal (Mobile)

Di halaman Absensi muncul card “Jadwal Kunjungan Hari Ini” secara otomatis jika ada plan aktif.

✅ = sudah dikunjungi
⏳ = belum
❌ = terlewat (sudah lewat jam ekspektasi + 30 menit)

Tiap stop ada tombol Buka Maps yang langsung membuka navigasi di Google Maps native di HP — tanpa perlu API key, tanpa biaya.

🎯

Saat karyawan submit kunjungan dan berada dalam 500m dari stop yang direncanakan, sistem otomatis mencocokkan kunjungan ke stop tersebut. HR bisa lihat mana yang sesuai rencana vs spontan.

Deteksi Stop Terlewat

Setiap hari pukul 21:00, sistem memeriksa stop wajib yang belum dikunjungi. Jika ada, anomali missed_stop otomatis tercatat dan notifikasi dikirim ke manager.

Memantau Karyawan Lapangan (Manager / HR)

Menu Kehadiran → klik baris karyawan lapangan
Tab Kunjungan → timeline lengkap dengan foto, waktu tiba, nama lokasi, anomali
Tab Peta → panel lokasi kunjungan:
- Tiap kunjungan: koordinat + tombol Buka → Google Maps tab baru
- Tombol Lihat Semua Rute di Google Maps → rute lengkap semua kunjungan hari itu

💡

Tidak ada embed peta di dashboard web — semua berbasis link ke Google Maps di browser. Tidak perlu API key, tidak ada biaya tambahan.

Anomali Field Tracking

Lihat di Kehadiran → Anomali:

Tipe	Artinya
`fake_gps`	Mock location terdeteksi dari sensor atau akurasi mencurigakan
`impossible_travel`	Perpindahan antar lokasi terlalu cepat (kecepatan > 150 km/jam)
`same_location`	Dua kunjungan berbeda kurang dari 20m — terindikasi duplikat
`presence_missed`	Stay mode: tidak merespons konfirmasi atau berada di luar geofence
`missed_stop`	Stop wajib di jadwal kunjungan tidak dikunjungi sampai EOD

Consent Tracking (UU PDP)

Karyawan harus memberikan consent sebelum tracking aktif, sesuai UU Perlindungan Data Pribadi (UU PDP). Dialog muncul sekali saat pertama kali mode tracking aktif. Jika karyawan menolak, tracking tidak aktif — karyawan tetap bisa absen seperti biasa.