📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile)

👤 Identitas Mahasiswa

• Nama: Fadlan Rivaldi
• NPM: 202310715280

---

📌 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:

1. Mahasiswa berada dalam radius lokasi kampus yang telah ditentukan.
2. Mahasiswa mengambil foto selfie sebagai bukti kehadiran fisik pada saat jam mata kuliah berlangsung.

---

📝 Change Log (Modifikasi & Pengembangan)

Berdasarkan starter project yang disediakan, berikut adalah perubahan dan fitur yang telah saya implementasikan:

1. Otomatisasi Data Profil: Melakukan hardcode data profil pada AbsensiViewModel agar saat login, data Nama (Fadlan Rivaldi) dan NPM (202310715280) langsung terisi secara otomatis.
2. Manajemen State dengan StateFlow: Mengimplementasikan MutableStateFlow pada AbsensiViewModel untuk menangani data reaktif seperti list Mata Kuliah, Lokasi terkini, dan status Foto yang diambil.
3. Integrasi Kamera Modern (CameraX): Mengimplementasikan fungsionalitas pengambilan gambar menggunakan library CameraX dan menyimpannya ke dalam State aplikasi (capturedPhoto).
4. Sistem Lokasi Presisi: Menggunakan play-services-location untuk mendapatkan titik koordinat Latitude dan Longitude secara real-time.
5. Manajemen History Dinamis: Menambahkan logika untuk memasukkan data absensi yang baru dikirim ke dalam daftar riwayat (_absensiHistory) secara instan di dalam aplikasi.
6. Penyelesaian Bug XML & Gradle:
   • Memperbaiki error Unresolved reference 'R' melalui sinkronisasi namespace.
   • Memperbaiki error XMLStreamException pada file layout fragment_preview.xml.
   • Merapikan struktur plugin pada build.gradle.kts.

---

🚀 Fitur Utama

• 🔐 Login Mahasiswa: Autentikasi dummy yang langsung mengarahkan ke profil mahasiswa.
• 🎓 Pemilihan Mata Kuliah: Daftar mata kuliah dinamis (Pemrograman Mobile, Basis Data, dll).
• 📍 LBS (Location Based Service): Deteksi otomatis lokasi mahasiswa.
• 📸 Selfie Verification: Integrasi kamera depan untuk pengambilan foto bukti kehadiran.
• 📄 History Absensi: Menampilkan riwayat absensi (Mata kuliah, Tanggal, Waktu, dan Status).
• 🕒 Auto Timestamp: Pencatatan waktu otomatis saat tombol "Submit" ditekan.

---

🛠️ Teknologi yang Digunakan

• Bahasa: Kotlin
• UI Framework: Jetpack Compose (Modern UI) & XML Layout (Interoperability).
• Architecture: MVVM (Model-View-ViewModel).
• State Management: StateFlow & LiveData.
• Kamera: CameraX API.
• Lokasi: Fused Location Provider.
• Dependency Management: Gradle Version Catalog (libs.versions.toml).

---

🗺️ Mekanisme Absensi

1. Login dengan NIM dan Password.
2. Aplikasi mendeteksi lokasi dan meminta izin kamera.
3. Pilih Mata Kuliah yang sedang berlangsung.
4. Ambil foto selfie.
5. Tekan tombol Submit. Sistem akan mengirimkan data (Nama, NPM, Koordinat, Foto, dan Matkul) ke server melalui Webhook.

---

🔐 Izin Aplikasi (Permissions)

Aplikasi memerlukan akses:

• CAMERA: Untuk mengambil foto selfie.
• ACCESS_FINE_LOCATION: Untuk validasi lokasi kampus.
• INTERNET: Untuk mengirim data absensi ke server.

---

⚠️ Disclaimer & Catatan

• PENGGUNAAN AI: Proyek ini dikembangkan dengan bantuan Kecerdasan Buatan (AI) (ChatGPT/Claude) dalam proses debugging Gradle, perbaikan error XML, dan penyusunan struktur dokumentasi ini.
• PENGEMBANGAN: Aplikasi dikembangkan dari starter project dengan modifikasi pada bagian logika ViewModel dan UI Composable untuk menyesuaikan kebutuhan tugas.

---

🔗 Link Monitoring & Data

• Monitoring (ntfy): ntfy.ubharajaya.ac.id/EAS
• Data Spreadsheet: Cek Data Absensi
• Webhook Production: https://n8n.lab.ubharajaya.ac.id/webhook/23c6993d-1792-48fb-ad1c-ffc78a3e6254

---

Dibuat untuk memenuhi Tugas Project Akhir EAS 2025/2026.