# 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile)

## 👤 Identitas Mahasiswa
- **Nama:** Dirson Ali Wardana
- **NPM:** 202310715246---

## 📌 Deskripsi Proyek
Proyek ini merupakan **Tugas Akhir / Project Akhir Mata Kuliah Pemrograman Mobile**. Aplikasi ini dikembangkan untuk mengelola absensi mahasiswa secara cerdas dengan validasi ganda: **Lokasi GPS (Geofencing)** dan **Verifikasi Wajah (Selfie)**.

Aplikasi memastikan kehadiran mahasiswa valid apabila mahasiswa berada dalam radius lokasi kampus dan melakukan pengambilan foto selfie sebagai bukti kehadiran fisik yang kemudian dikirimkan ke server pemantau (n8n & Google Sheets).

---

## 📝 Change Log (Modifikasi & Pengembangan)
Berdasarkan *starter project* yang disediakan, berikut adalah catatan perubahan signifikan yang telah saya implementasikan:

I. **Dropdown Mata Kuliah & Integrasi Data**: Menambahkan fitur pilihan mata kuliah dan memastikan data `namaMatkul` terkirim dengan benar ke server melalui payload JSON.
II. **Fragment Preview (History Logic)**: Mengimplementasikan `PreviewFragment` yang merangkum seluruh data (Foto, Koordinat, Timestamp) sebelum dikirim, serta menambahkan logika penyimpanan otomatis ke `DataHolder.historyList` setelah pengiriman berhasil.
III. **Konversi Base64**: Mengimplementasikan fungsi `base64ToBitmap` dan pengiriman `foto_base64` agar foto selfie mahasiswa dapat tersimpan dan dilihat di server.
IV. **Modernisasi UI (Material Card & Progress Bar)**: Menggunakan `MaterialCardView` untuk tampilan foto preview dan menambahkan `ProgressBar` (Loading) untuk memberikan feedback visual saat proses pengiriman data ke server.
V. **Network Threading**: Menggunakan `kotlin.concurrent.thread` untuk menangani proses pengiriman data ke Webhook agar aplikasi tidak *freeze* (ANR) saat melakukan request jaringan.

---

## 🚀 Fitur Utama
- 🔐 **Login Mahasiswa**: Autentikasi otomatis dengan data profil tetap (Hardcoded).
- 🎓 **Mata Kuliah Selector**: Memilih mata kuliah aktif sebelum melakukan absensi.
- 📍 **GPS Tracking**: Pengambilan koordinat Latitude dan Longitude secara presisi.
- 📸 **Selfie Verification**: Pratinjau foto selfie sebelum data dikirim ke server.
- 📄 **Real-time History**: Daftar riwayat absensi yang langsung terupdate menggunakan `RecyclerView` / `LazyColumn`.
- 📡 **Webhook Integration**: Pengiriman data langsung ke sistem n8n Ubhara Jaya.

---

## 🛠️ Teknologi yang Digunakan
- **Bahasa**: Kotlin
- **UI Framework**: Android XML (View System) & Jetpack Compose (Interoperability).
- **Network**: `HttpURLConnection` dengan format data **JSON**.
- **Kamera**: CameraX API.
- **Lokasi**: Fused Location Provider Client.
- **Data Manager**: `DataHolder` (Singleton) untuk manajemen data antar layar.

---

## 🗺️ Mekanisme Absensi
1. Mahasiswa memilih mata kuliah.
2. Aplikasi mengambil lokasi dan mahasiswa melakukan foto selfie.
3. Di halaman **Preview**, mahasiswa memvalidasi data (Nama, NPM, Lokasi, dan Foto).
4. Klik **Submit**: Data dikonversi ke JSON dan dikirim ke Webhook.
5. Jika berhasil (Response 200), data otomatis masuk ke menu **Riwayat**.

---

## 🔐 Izin Aplikasi (Permissions)
Aplikasi memerlukan akses berikut:
- `android.permission.CAMERA`: Untuk mengambil foto selfie.
- `android.permission.ACCESS_FINE_LOCATION`: Untuk validasi lokasi presisi.
- `android.permission.INTERNET`: Untuk mengirim data absensi ke n8n.

---

## ⚠️ Disclaimer & Catatan
- **PENGGUNAAN AI**: Proyek ini dikembangkan dengan bantuan **Kecerdasan Buatan (AI)** (ChatGPT/Claude) dalam proses debugging Gradle, perbaikan error `XMLStreamException`, dan penyusunan struktur pengiriman data JSON pada `PreviewFragment.kt`.
- **PENGEMBANGAN**: Aplikasi ini merupakan hasil modifikasi intensif dari *starter project* yang disediakan untuk memenuhi standar capaian project akhir EAS 2025/2026.

---

## 🔗 Link Monitoring & Data
- **Monitoring (ntfy)**: [ntfy.ubharajaya.ac.id/EAS](https://ntfy.ubharajaya.ac.id/EAS)
- **Data Spreadsheet**: [Cek Data Absensi](https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0)
- **Webhook Production**: `https://n8n.lab.ubharajaya.ac.id/webhook/23c6993d-1792-48fb-ad1c-ffc78a3e6254`

---
*Dibuat untuk memenuhi Tugas Project Akhir Mata Kuliah Pemrograman Mobile.*