EAS-202310715274-DimasHendr.../VISUAL_LOKASI_GUIDE.md
2026-01-14 21:13:18 +07:00

266 lines
13 KiB
Markdown

# 🗺️ VISUAL GUIDE: Lokasi Anda vs Area Absensi
## 🔴 SITUASI SEKARANG
```
╔════════════════════════════════════════════════════════════╗
║ LOKASI ANDA SEKARANG ║
╠════════════════════════════════════════════════════════════╣
║ ║
║ Device Location (GPS Asli): ║
║ ┌─────────────────────────────────────────────────────┐ ║
║ │ Latitude: -6.8961 + JARAK = ~RUMAH ANDA (JAUH) │ ║
║ │ Longitude: 107.6100 │ ║
║ │ Jarak ke Kampus: ~13.980 km ❌ DILUAR AREA │ ║
║ └─────────────────────────────────────────────────────┘ ║
║ ║
║ Status Absensi: ║
║ ┌─────────────────────────────────────────────────────┐ ║
║ │ ❌ DILUAR AREA ABSENSI │ ║
║ │ │ ║
║ │ Radius Penerimaan: 125m dari Kampus │ ║
║ │ Lokasi Anda: 13.980 km jauhnya │ ║
║ │ │ ║
║ │ HASIL: ABSENSI DITOLAK ❌ │ ║
║ └─────────────────────────────────────────────────────┘ ║
║ ║
╚════════════════════════════════════════════════════════════╝
```
---
## ✅ SOLUSI: GUNAKAN MOCK LOCATION
```
╔════════════════════════════════════════════════════════════╗
║ SETELAH MENGAKTIFKAN MOCK LOCATION ║
╠════════════════════════════════════════════════════════════╣
║ ║
║ Mock Location (Simulated): ║
║ ┌─────────────────────────────────────────────────────┐ ║
║ │ 🧪 MOCK LOCATION DIAKTIFKAN │ ║
║ │ │ ║
║ │ Pilihan 1: 🏢 Kampus │ ║
║ │ Lat: -6.8961 | Lon: 107.6100 | Jarak: 0m │ ║
║ │ Status: ✅ DITERIMA │ ║
║ │ │ ║
║ │ Pilihan 2: ✓ Dalam Area (PILIH INI) │ ║
║ │ Lat: -6.8955 | Lon: 107.6105 | Jarak: 85m │ ║
║ │ Status: ✅ DITERIMA (PALING AMAN) │ ║
║ │ │ ║
║ │ Pilihan 3: ⚠️ Tepi Area │ ║
║ │ Lat: -6.8948 | Lon: 107.6110 | Jarak: 125m │ ║
║ │ Status: ✅ DITERIMA (dengan warning) │ ║
║ └─────────────────────────────────────────────────────┘ ║
║ ║
║ Hasil: ║
║ ┌─────────────────────────────────────────────────────┐ ║
║ │ ✅ BERADA DALAM AREA ABSENSI │ ║
║ │ ✅ ABSENSI DITERIMA │ ║
║ └─────────────────────────────────────────────────────┘ ║
║ ║
╚════════════════════════════════════════════════════════════╝
```
---
## 📍 PETA AREA ABSENSI (Simulated)
```
Ubharajaya Campus
🏢
-6.8961, 107.6100
┌─────────────────────────┐
│ │
✓ │ ⚠️ │ ✓
-85m │ -125m +125m │ +85m
│ ↓ ↓ │
│ ───────────── │
│ │ AREA VALID│ │
│ ───────────── │
│ │
└─────────────────────────┘
Radius Penerimaan: ≤ 125m ✅
✓ Dalam Area (85m) → DITERIMA ✅
⚠️ Tepi Area (125m) → DITERIMA ✅ (warning)
✗ Luar Area (200m) → DITOLAK ❌
❌ Jauh di Luar (400m) → DITOLAK ❌
Lokasi Anda Sekarang: 13.980 km JAUH ❌
```
---
## 🎯 LANGKAH-LANGKAH (STEP BY STEP)
### **Step 1: Buka App dan Login**
```
┌──────────────────────────┐
│ 📱 Aplikasi Absensi │
│ │
│ Login Screen: │
│ NIM: [________________]│
│ Password: [____________]│
│ [Login] │
└──────────────────────────┘
↓ Klik Login
┌──────────────────────────┐
│ Attendance Screen │
│ ⚙️ ← KLIK SINI │
└──────────────────────────┘
```
### **Step 2: Klik Icon ⚙️ Settings**
```
┌──────────────────────────────┐
│ Absensi Akademik ⚙️ ✕ │
│ ↑ KLIK INI │
├──────────────────────────────┤
│ 📍 Status Lokasi │
│ Lat: -6.8961 │
│ Lon: 107.6100 │
│ Jarak: 13.980 km ❌ │
└──────────────────────────────┘
```
### **Step 3: Dialog Akan Muncul**
```
┌──────────────────────────────────┐
│ 📍 Location Debug Menu │
├──────────────────────────────────┤
│ Mock Location: ☐ ← OFF │
│ │
│ Keterangan: │
│ Geser toggle ke kanan untuk ON │
└──────────────────────────────────┘
↓ Geser ke kanan
┌──────────────────────────────────┐
│ 📍 Location Debug Menu │
├──────────────────────────────────┤
│ Mock Location: ☑ ← ON ✅ │
│ │
│ Pilih Lokasi Testing: │
│ ▭ 🏢 Kampus (Exact) │
│ ▭ ✓ Dalam Area (85m) │ ← PILIH
│ ▭ ⚠️ Tepi Area (125m) │
│ ▭ ✗ Luar Area (200m) │
│ ▭ ❌ Jauh di Luar (400m) │
└──────────────────────────────────┘
```
### **Step 4: Pilih "Dalam Area (85m)"**
```
┌──────────────────────────────────┐
│ 📍 Location Debug Menu │
├──────────────────────────────────┤
│ Mock Location: ☑ ON │
│ │
│ Pilih Lokasi Testing: │
│ ▭ 🏢 Kampus (Exact) │
│ ☑ ✓ Dalam Area (85m) │ ← SELECTED
│ Lat: -6.8955 │
│ Lon: 107.6105 │
│ Status: DITERIMA │
│ ▭ ⚠️ Tepi Area (125m) │
│ ▭ ✗ Luar Area (200m) │
│ ▭ ❌ Jauh di Luar (400m) │
│ │
│ [Close] │
└──────────────────────────────────┘
↓ Klik Close
```
### **Step 5: Dialog Ditutup & Update Lokasi**
```
┌──────────────────────────────┐
│ Absensi Akademik ⚙️ ✕ │
├──────────────────────────────┤
│ 📍 Status Lokasi │
│ Lat: -6.8955 │
│ Lon: 107.6105 │
│ Jarak: 85.2m ✓ │
│ │
│ 🧪 MOCK LOCATION │
│ ✓ Berada dalam area absensi │
│ │
│ [Perbarui Lokasi] │
│ [ABSENSI] ← SEKARANG AKTIF │
└──────────────────────────────┘
↓ Klik Perbarui Lokasi
┌──────────────────────────────┐
│ Absensi Akademik ⚙️ ✕ │
├──────────────────────────────┤
│ 📍 Status Lokasi │
│ Lat: -6.8955 │
│ Lon: 107.6105 │
│ Jarak: 85.2m ✓ UPDATED │
│ │
│ 🧪 MOCK LOCATION │
│ ✓ Berada dalam area absensi │
│ (status sudah hijau ✓) │
│ │
│ [Perbarui Lokasi] │
│ [ABSENSI] ← SIAP DIGUNAKAN │
└──────────────────────────────┘
```
### **Step 6: Sekarang Anda Siap Absen!**
```
┌──────────────────────────────┐
│ Absensi Akademik ⚙️ ✕ │
├──────────────────────────────┤
│ ✅ Status Lokasi │
│ Berada dalam area absensi │
│ 85.2m dari kampus │
│ │
│ [Perbarui Lokasi] │
│ [ABSENSI] ← KLIK INI! │
│ [Riwayat] │
└──────────────────────────────┘
↓ Klik ABSENSI
```
---
## ❗ PENTING: APA YANG TERJADI?
### **Sebelum Mock Location Diaktifkan:**
- Device menggunakan GPS asli dari sistem Android
- Lokasi Anda: **13.980 km jauh dari kampus**
- Status: **DILUAR AREA ABSENSI**
- Hasil: **ABSENSI DITOLAK**
### **Setelah Mock Location Diaktifkan:**
- Device menggunakan lokasi simulasi/testing (**hanya untuk development**)
- Lokasi Anda: **85m dari kampus (simulated)**
- Status: **BERADA DALAM AREA ABSENSI**
- Hasil: **ABSENSI DITERIMA**
---
## 🔐 CATATAN KEAMANAN
> ⚠️ **Mock Location hanya untuk TESTING & DEVELOPMENT**
>
> - Jangan gunakan di production
> - Setelah testing selesai, matikan mock location
> - Untuk absensi real, datang ke kampus fisik dengan GPS asli
> - Mock location hanya simulasi untuk development
---
## ✨ SELAMAT!
Sekarang Anda tahu:
- ✅ Lokasi Anda sekarang di mana (13.980 km jauh)
- ✅ Kenapa tidak bisa absen (diluar area)
- ✅ Bagaimana cara mengatasinya (gunakan mock location)
- ✅ Langkah-langkah detail untuk berada di area absensi
**Ikuti langkah-langkah di atas dan sekarang Anda bisa testing dari rumah! 🎉**