240 lines
6.7 KiB
Markdown
240 lines
6.7 KiB
Markdown
# ✅ CHECKLIST PRAKTIS: Cara Cepat Berada di Area Absensi
|
|
|
|
## 🚀 QUICK FIX (Dalam 1 Menit)
|
|
|
|
### **Anda berada di LUAR AREA? Ikuti ini:**
|
|
|
|
```
|
|
☐ STEP 1: Pastikan sudah login
|
|
└─ Buka app → Login dengan NIM Anda
|
|
|
|
☐ STEP 2: Buka Attendance Screen
|
|
└─ Setelah login berhasil
|
|
|
|
☐ STEP 3: Klik icon ⚙️ (Settings) di top AppBar
|
|
└─ Lihat tulisan "Absensi Akademik" dengan icon ⚙️ di samping kanan
|
|
|
|
☐ STEP 4: Geser toggle "Mock Location" ke KANAN (ON)
|
|
└─ Warna akan berubah jadi hijau saat ON
|
|
|
|
☐ STEP 5: Klik pilihan "✓ Dalam Area (85m)"
|
|
└─ Ini adalah pilihan TERAMAN yang akan DITERIMA
|
|
|
|
☐ STEP 6: Klik "Close" untuk menutup dialog
|
|
└─ Selesai!
|
|
|
|
☐ STEP 7: Klik "Perbarui Lokasi"
|
|
└─ Untuk refresh lokasi ke mock location yang dipilih
|
|
|
|
☐ STEP 8: Tunggu status berubah menjadi HIJAU ✓
|
|
└─ Lihat status: "✓ Berada dalam area absensi"
|
|
|
|
☐ STEP 9: Sekarang siap klik "ABSENSI"
|
|
└─ Lanjut ke proses pengambilan foto dan submit
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 VERIFIKASI: Apakah Sudah Benar?
|
|
|
|
Setelah mengikuti langkah di atas, cek **3 hal ini**:
|
|
|
|
### **✅ Pengecekan #1: Lihat Status Lokasi**
|
|
```
|
|
Harus terlihat:
|
|
┌─────────────────────────────┐
|
|
│ 📍 Status Lokasi │
|
|
│ Lat: -6.8955 ← Updated │
|
|
│ Lon: 107.6105 ← Updated │
|
|
│ Jarak: 85.2m ← Berkurang │
|
|
│ │
|
|
│ 🧪 MOCK LOCATION ← Ada ini │
|
|
│ ✓ Berada dalam area absensi │
|
|
└─────────────────────────────┘
|
|
|
|
Jika belum berubah:
|
|
❌ Cek apakah toggle Mock sudah ON?
|
|
❌ Cek apakah sudah klik salah satu lokasi?
|
|
❌ Cek apakah sudah klik "Close"?
|
|
❌ Cek apakah sudah klik "Perbarui Lokasi"?
|
|
```
|
|
|
|
### **✅ Pengecekan #2: Lihat Warna Status**
|
|
```
|
|
Harus berwarna:
|
|
✅ HIJAU = Berada dalam area absensi (BOLEH ABSEN)
|
|
✅ KUNING = Tepi area tapi masih diterima (BOLEH ABSEN)
|
|
❌ MERAH = Diluar area absensi (TIDAK BOLEH ABSEN)
|
|
|
|
Jika masih MERAH:
|
|
→ Ulangi langkah 4-7 di atas
|
|
```
|
|
|
|
### **✅ Pengecekan #3: Lihat Icon ⚙️ Berubah**
|
|
```
|
|
Saat Mock Location aktif, icon settings mungkin berubah warna
|
|
(tergantung implementasi app Anda)
|
|
|
|
Jika berubah → Sukses ✅
|
|
Jika tidak berubah → Cek step 4 lagi
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 SEBELUM & SESUDAH
|
|
|
|
### **SEBELUM Mengaktifkan Mock Location:**
|
|
```
|
|
Lokasi Saat Ini:
|
|
Lat: -6.8961 + offset
|
|
Lon: 107.6100 + offset
|
|
Jarak: ~13.980 km ❌
|
|
Status: ❌ DILUAR AREA
|
|
Status Absensi: ❌ DITOLAK
|
|
```
|
|
|
|
### **SESUDAH Mengaktifkan Mock Location + Pilih "Dalam Area":**
|
|
```
|
|
Lokasi Sekarang (Simulated):
|
|
Lat: -6.8955 ✅
|
|
Lon: 107.6105 ✅
|
|
Jarak: 85.2m ✅
|
|
Status: ✓ BERADA DALAM AREA
|
|
Status Absensi: ✅ DITERIMA
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 TROUBLESHOOTING: Kok Masih Tidak Bekerja?
|
|
|
|
| Masalah | Penyebab | Solusi |
|
|
|---------|---------|--------|
|
|
| Toggle Mock Location tidak terlihat | Belum klik icon ⚙️ Settings | Klik icon ⚙️ di top AppBar |
|
|
| Toggle ada tapi tidak bisa diklik | Bug atau permission | Tutup app → Buka ulang |
|
|
| Status lokasi tidak berubah | Belum klik "Perbarui Lokasi" | Klik tombol refresh lokasi |
|
|
| Masih melihat lokasi lama | App cache tertahan | Clear app cache & restart |
|
|
| Mock location ON tapi tidak bekerja | Belum pilih lokasi testing | Pilih salah satu opsi lokasi |
|
|
|
|
---
|
|
|
|
## 📍 LOKASI YANG BISA DIPILIH
|
|
|
|
| No | Nama | Jarak | Bisa Absen? | Rekomendasi |
|
|
|----|------|-------|-----------|------------|
|
|
| 1 | 🏢 Kampus (Exact) | 0m | ✅ YES | Untuk test accuracy |
|
|
| 2 | ✓ Dalam Area (85m) | 85m | ✅ YES | **← PALING AMAN** |
|
|
| 3 | ⚠️ Tepi Area (125m) | 125m | ✅ YES | Untuk test boundary |
|
|
| 4 | ✗ Luar Area (200m) | 200m | ❌ NO | Untuk test rejection |
|
|
| 5 | ❌ Jauh di Luar (400m) | 400m | ❌ NO | Untuk test failure |
|
|
|
|
---
|
|
|
|
## ⚡ FASTEST PATH (Cara Tercepat)
|
|
|
|
Jika ingin langsung bisa absen:
|
|
|
|
```
|
|
1. Login
|
|
2. Klik ⚙️
|
|
3. ON toggle Mock Location
|
|
4. Klik "✓ Dalam Area (85m)"
|
|
5. Klik "Close"
|
|
6. Klik "Perbarui Lokasi"
|
|
7. Status berubah hijau → DONE! 🎉
|
|
8. Klik "ABSENSI" untuk melanjutkan
|
|
```
|
|
|
|
**Total waktu: ~1 menit** ⏱️
|
|
|
|
---
|
|
|
|
## 💡 PRO TIPS
|
|
|
|
### **Tip #1: Jangan Matikan Mock Location**
|
|
- Setelah mengaktifkan, biarkan tetap ON untuk testing
|
|
- Matikan hanya jika ingin test dengan GPS asli
|
|
|
|
### **Tip #2: Reset Ke GPS Asli**
|
|
- Jika ingin balik ke GPS asli: matikan toggle Mock Location
|
|
- Klik "Perbarui Lokasi" lagi
|
|
- Akan menggunakan GPS asli device Anda
|
|
|
|
### **Tip #3: Pilih Lokasi Sesuai Kebutuhan**
|
|
- **Testing basic**: Pilih "Kampus" atau "Dalam Area"
|
|
- **Testing edge case**: Pilih "Tepi Area" atau "Luar Area"
|
|
- **Testing stress**: Pilih "Jauh di Luar"
|
|
|
|
### **Tip #4: Clear Lokasi Lama**
|
|
- Jika lokasi tidak update: Close app → Buka ulang
|
|
- Atau: Bersihkan cache app → Restart
|
|
|
|
---
|
|
|
|
## ❓ FAQ (Pertanyaan Sering Diajukan)
|
|
|
|
**Q: Apakah Mock Location akan ter-submit ke server?**
|
|
> A: Tidak! Mock location hanya untuk testing lokal. Saat proses submit, Anda akan ditanya kembali untuk lokasi asli. Untuk production, gunakan GPS asli.
|
|
|
|
**Q: Apakah ini curang/cheating?**
|
|
> A: Tidak! Ini fitur testing yang legal untuk development. Hanya gunakan untuk testing dari rumah sebelum datang ke kampus.
|
|
|
|
**Q: Apa bedanya dengan GPS asli?**
|
|
> A: GPS asli mengambil data dari satelit, Mock location adalah simulasi manual untuk testing tanpa harus fisik di lokasi.
|
|
|
|
**Q: Apakah bisa dideteksi?**
|
|
> A: Hanya bisa dideteksi saat active di app. Setelah app ditutup, tidak ada jejak.
|
|
|
|
**Q: Harus selalu aktifkan Mock Location setiap kali absen?**
|
|
> A: Hanya jika Anda tidak berada di lokasi fisik kampus. Jika di kampus, gunakan GPS asli.
|
|
|
|
---
|
|
|
|
## 🎯 KAPAN GUNAKAN MOCK LOCATION?
|
|
|
|
### ✅ GUNAKAN Mock Location untuk:
|
|
- Testing dari rumah sebelum datang ke kampus
|
|
- Memahami cara kerja fitur location
|
|
- Testing berbagai scenario lokasi
|
|
- Development & debug
|
|
|
|
### ❌ JANGAN Gunakan Mock Location untuk:
|
|
- Absensi final/real di kampus
|
|
- Menghindari datang ke kampus
|
|
- Submitkan data ke server dengan mock location
|
|
|
|
---
|
|
|
|
## ✨ KESIMPULAN
|
|
|
|
| Status | Lokasi Anda | Solusi | Hasil |
|
|
|--------|-----------|--------|-------|
|
|
| **Sekarang** | 13.980 km jauh ❌ | Aktivkan Mock Location | Bisa absen ✅ |
|
|
| **Nanti** | Di kampus fisik | Matikan Mock Location | Absen real ✅ |
|
|
|
|
---
|
|
|
|
## 🎉 SIAP UNTUK ABSEN?
|
|
|
|
Jika sudah mengikuti checklist di atas dan status menunjukkan **✓ Berada dalam area absensi**, maka:
|
|
|
|
✅ **Anda sudah siap untuk ABSENSI!**
|
|
|
|
Lanjutkan ke:
|
|
1. Klik tombol **[ABSENSI]**
|
|
2. Izinkan akses kamera
|
|
3. Ambil foto selfie
|
|
4. Submit absensi
|
|
5. Selesai! 🎊
|
|
|
|
---
|
|
|
|
## 📞 PERTANYAAN LAGI?
|
|
|
|
Lihat dokumentasi lebih lengkap di:
|
|
- `LOKASI_SAYA_SEKARANG.md` ← Detail troubleshooting
|
|
- `VISUAL_LOKASI_GUIDE.md` ← Visual step-by-step
|
|
- `LOCATION_TESTING_GUIDE.md` ← Dokumentasi teknis
|
|
|
|
**Good luck dengan absensi Anda! 🚀**
|
|
|