202310715130-DWI-FEBRYANTI/202310715130-Dwifebbryanti-EAS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
202310715130-Dwifebbryanti-EAS/DEVELOPMENT_GUIDE.md
Arif Dwiyanto fc812be1ae update readme
2026-01-14 21:33:58 +07:00

7.4 KiB
Raw Blame History

📱 Aplikasi Absensi Akademik - Development Guide

📋 Ringkasan Perubahan dan Fitur yang Ditambahkan

Dokumentasi ini menjelaskan semua fitur yang telah dikembangkan dalam proyek starter ini.

✅ Fitur yang Sudah Diimplementasikan

1. Autentikasi Pengguna (Login & Register)

  • Login dengan NPM dan Password
  • Registrasi pengguna baru
  • Validasi data input
  • Toast notifications untuk feedback

2. Pengambilan Data Lokasi (GPS)

  • Menggunakan Google Play Services Location API
  • Otomatis mengambil last known location
  • Menampilkan latitude dan longitude
  • Handling permission requests

3. Pengambilan Foto (Selfie)

  • Akses kamera perangkat
  • Mengambil foto dengan kamera bawaan
  • Menyimpan bitmap hasil foto
  • Handling camera permissions

4. Validasi Lokasi Berbasis Radius

  • ✨ FITUR BARU: Fungsi isWithinAbsensiRadius() untuk validasi lokasi
  • Radius default: 100 meter dari UBH campus
  • Lokasi default UBH: Lat -6.2030, Lon 107.0045
  • Dapat dikustomisasi sesuai kebutuhan

5. Obfuscasi Koordinat untuk Privacy

  • ✨ FITUR BARU: Fungsi obfuscateCoordinates()
  • Menambahkan offset random pada koordinat
  • Mencegah kebocoran lokasi rumah mahasiswa
  • Offset default: 0.002 derajat (~200 meter)

6. Penyimpanan Riwayat Absensi Lokal

  • ✨ FITUR BARU: Database table attendance
  • Menyimpan: timestamp, latitude, longitude, status
  • Tracking absensi yang diterima/ditolak
  • Akses cepat tanpa koneksi internet

7. Riwayat Absensi (History Screen)

  • ✨ FITUR BARU: Screen untuk melihat riwayat absensi
  • Menampilkan list attendance dengan detail
  • Status visual: ✓ Diterima (hijau) / ✗ Ditolak (merah)
  • Sorting: Absensi terbaru di atas
  • Formatted timestamp: dd/MM/yyyy HH:mm:ss

8. Pengiriman Data ke n8n Webhook

  • Mengirim data ke webhook: https://n8n.lab.ubharajaya.ac.id/webhook/...
  • Data yang dikirim:
    • NPM & Nama mahasiswa
    • Latitude & Longitude
    • Foto dalam format Base64
    • Timestamp
    • Validation status
    • Is within radius flag
  • Error handling dengan try-catch

🗂️ Struktur Database

Table: users

CREATE TABLE users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    username TEXT,
    npm TEXT UNIQUE,
    password TEXT
)

Table: attendance (NEW)

CREATE TABLE attendance (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    npm TEXT,
    timestamp INTEGER,
    latitude REAL,
    longitude REAL,
    status TEXT,
    FOREIGN KEY(npm) REFERENCES users(npm)
)

🔧 Utility Functions

calculateDistance(lat1, lon1, lat2, lon2): Float

Menghitung jarak dalam meter antara dua koordinat menggunakan formula haversine.

isWithinAbsensiRadius(studentLat, studentLon, campusLat, campusLon, radiusMeters): Boolean

Mengecek apakah mahasiswa berada dalam radius absensi. Default: 100 meter dari UBH.

obfuscateCoordinates(latitude, longitude, offsetDegrees): Pair<Double, Double>

Menambahkan offset random pada koordinat untuk privacy. Default offset: 0.002 derajat.

bitmapToBase64(bitmap): String

Mengkonversi Bitmap foto ke String Base64 untuk pengiriman via JSON.

kirimKeN8n(context, db, npm, nama, latitude, longitude, foto)

Mengirim data absensi ke webhook n8n dengan validasi dan penyimpanan lokal.

📱 Screen Navigation

┌─────────┐
│ LOGIN   │ ←→ REGISTER
└────┬────┘
     │
     ↓
┌──────────────┐
│ ABSENSI      │ → HISTORY
│ (Ambil Foto, │   (Lihat Riwayat)
│  Ambil Lokasi,
│  Kirim Data) │
└──────────────┘

🎯 Cara Menggunakan Aplikasi

1. Registrasi Akun Baru

  • Klik "Belum punya akun? Daftar"
  • Isi Nama Lengkap, NPM, dan Password
  • Klik tombol "Daftar"

2. Login

  • Masukkan NPM dan Password
  • Klik tombol "Login"

3. Melakukan Absensi

  • Aplikasi otomatis meminta izin lokasi
  • Klik "📷 Ambil Foto" untuk mengambil selfie
  • Foto akan ditampilkan (jika berhasil)
  • Klik "Kirim Absensi" untuk mengirim data
  • Sistem akan:
    • Validasi lokasi (harus dalam radius 100m)
    • Menyimpan ke database lokal
    • Mengirim ke server n8n
    • Menampilkan feedback status

4. Melihat Riwayat

  • Klik tombol "Lihat Riwayat" di halaman absensi
  • List akan menampilkan semua absensi dengan status
  • Kembali ke halaman absensi dengan tombol back

🔐 Permissions yang Diperlukan

Aplikasi membutuhkan permissions berikut (di AndroidManifest.xml):

  • ACCESS_FINE_LOCATION - Akses GPS presisi tinggi
  • ACCESS_COARSE_LOCATION - Akses lokasi kasar
  • CAMERA - Akses kamera
  • INTERNET - Koneksi internet untuk webhook

⚙️ Konfigurasi yang Dapat Disesuaikan

Campus Location (di MainActivity.kt)

fun isWithinAbsensiRadius(
    studentLat: Double,
    studentLon: Double,
    campusLat: Double = -6.2030,      // ← Ubah sesuai lokasi
    campusLon: Double = 107.0045,     // ← Ubah sesuai lokasi
    radiusMeters: Float = 100f        // ← Ubah radius (default 100m)
)

Webhook URL (di MainActivity.kt)

val url = URL("https://n8n.lab.ubharajaya.ac.id/webhook/23c6993d-1792-48fb-ad1c-ffc78a3e6254")
// Ganti dengan URL production jika diperlukan

Coordinate Obfuscation (di MainActivity.kt)

fun obfuscateCoordinates(
    latitude: Double,
    longitude: Double,
    offsetDegrees: Double = 0.002  // ← Ubah offset (default ~200m)
)

📊 Data Flow

User Input (Foto + Lokasi)
        ↓
Validasi Lokasi (dalam radius?)
        ↓
    ├─ YA → Status: "success"
    └─ TIDAK → Status: "invalid_location"
        ↓
Simpan ke Database Lokal
        ↓
Konversi Foto ke Base64
        ↓
Kirim JSON ke n8n Webhook
        ↓
Tampilkan Feedback ke User
        ↓
Data Tersimpan di Riwayat

🐛 Troubleshooting

Lokasi tidak terdeteksi

  • Pastikan GPS aktif di perangkat
  • Beri izin lokasi ke aplikasi
  • Tunggu beberapa detik untuk GPS lock

Foto tidak terekam

  • Pastikan kamera dan izin camera aktif
  • Perangkat harus memiliki kamera depan
  • Coba restart aplikasi

Data tidak terkirim ke server

  • Pastikan koneksi internet aktif
  • Periksa webhook URL di code
  • Data tetap tersimpan lokal dan bisa dikirim ulang

Aplikasi crash saat login

  • Pastikan database sudah terinisialisasi
  • Clear app data dan coba lagi

📦 Dependencies

// Compose UI
androidx.compose.ui
androidx.compose.material3

// Location Services
com.google.android.gms:play-services-location:21.0.1

// Material Icons
androidx.compose.material:material-icons-extended:1.6.0

// Core Android
androidx.activity:activity-compose:1.9.0
androidx.core:core-ktx
androidx.lifecycle:lifecycle-runtime-ktx

🚀 Langkah Selanjutnya (Optional Enhancements)

  1. Camera Preview: Tampilkan preview kamera sebelum ambil foto
  2. Photo Gallery: Simpan foto ke galeri perangkat
  3. Map Integration: Tampilkan lokasi di Google Maps
  4. Biometric Auth: Login dengan fingerprint
  5. Offline Queue: Antrian pengiriman data saat offline
  6. Statistics: Dashboard statistik absensi
  7. QR Code: Verifikasi dengan QR code

📝 Development Notes

  • Proyek menggunakan Jetpack Compose untuk UI
  • Database menggunakan SQLite
  • Location API menggunakan Google Play Services
  • Thread untuk operasi jaringan agar tidak freeze UI
  • Format tanggal Indonesia dengan java.util.Locale("id", "ID")

Terakhir diupdate: 14 Januari 2026 Developer: AI Assistant (GitHub Copilot)