102 lines
3.7 KiB
Markdown

# 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile)## 👤 Identitas Mahasiswa
- **Nama:** Fadlan Rivaldi
- **NPM:** 202310715280
---
## 📌 Deskripsi Proyek
Proyek ini merupakan **Tugas Project Akhir Mata Kuliah Pemrograman Mobile** yang bertujuan untuk membangun **aplikasi akademik berbasis mobile** dengan fokus pada **fitur absensi menggunakan data koordinat (GPS) dan pengambilan foto mahasiswa**.
Aplikasi ini dirancang untuk meningkatkan **validitas kehadiran mahasiswa**, dengan memastikan bahwa absensi hanya dapat dilakukan apabila mahasiswa:
1. Berada pada **lokasi yang telah ditentukan**, dan
2. Melakukan **pengambilan foto (selfie) secara langsung saat absensi**
---
## 🎯 Tujuan Proyek
- Mengimplementasikan **Location-Based Service (LBS)** pada aplikasi mobile
- Mengintegrasikan **kamera perangkat** untuk dokumentasi absensi
- Mencegah kecurangan absensi (titip absen)
- Mengembangkan aplikasi mobile akademik berbasis Android
- Melatih kemampuan perancangan dan implementasi aplikasi mobile
---
## 🚀 Fitur Utama
- 🔐 **Login Pengguna (Mahasiswa)**
- 📍 **Pengambilan Koordinat Lokasi (Latitude & Longitude)**
- 🏫 **Validasi Lokasi Absensi (Radius Area)**
- 📸 **Pengambilan Foto Mahasiswa Saat Absensi**
- 🕒 **Pencatatan Waktu Absensi**
- 📄 **Riwayat Kehadiran Mahasiswa**
- ⚠️ **Notifikasi Absensi Ditolak jika Tidak Valid**
---
## 🗺️ Mekanisme Absensi Berbasis Lokasi dan Foto
1. Mahasiswa melakukan **login**
2. Memilih menu **Absensi**
3. Sistem meminta:
- Izin **akses lokasi**
- Izin **akses kamera**
4. Aplikasi mengambil:
- 📍 **Koordinat lokasi mahasiswa**
- 📸 **Foto mahasiswa secara real-time**
5. Sistem melakukan validasi:
- Lokasi berada dalam **radius absensi**
- Foto berhasil diambil
6. Jika valid → **Absensi berhasil**
7. Jika tidak valid → **Absensi ditolak**
---
## 📸 Pengambilan Foto Saat Absensi
- Foto diambil menggunakan **kamera depan (selfie)**
- Foto hanya dapat diambil **saat proses absensi**
- Foto disimpan sebagai **bukti kehadiran**
- Foto dapat digunakan untuk verifikasi manual dan dokumentasi akademik.
---
## 🛠️ Teknologi yang Digunakan
- **Platform**: Android
- **Bahasa Pemrograman**: Kotlin
- **Location Service**: Google Maps API / Fused Location Provider
- **Camera API**: CameraX
- **Architecture**: MVVM / View System & Jetpack Compose
- **IDE**: Android Studio
---
## 🔐 Izin Aplikasi (Permissions)
Aplikasi memerlukan izin berikut:
- `ACCESS_FINE_LOCATION` & `ACCESS_COARSE_LOCATION`
- `CAMERA`
- `INTERNET`
---
## 📂 Mockup
![mockup](Mockup.png)
*Gambar mockup dibuat oleh AI*
---
## ⚠️ Disclaimer & Catatan Penting
- **PENGGUNAAN AI**: Proyek ini dikembangkan dengan bantuan **Kecerdasan Buatan (AI)** dalam proses debugging, pembuatan starter project, dan penyusunan dokumentasi.
- **PENGEMBANGAN**: Proyek ini dikembangkan dari *starter project* yang disediakan dan tidak dibuat dari nol.
- **PRIVASI KOORDINAT**: Untuk alasan keamanan/privasi, angka koordinat GPS dapat dimodifikasi sedikit agar tidak menunjukkan lokasi rumah pribadi secara presisi.
---
## 🔗 Link Pengecekan & Webhook
- **Monitoring**: [ntfy.ubharajaya.ac.id/EAS](https://ntfy.ubharajaya.ac.id/EAS)
- **Data Spreadsheet**: [Google Sheets](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`
---
“⚠️ Disclaimer & Catatan Penting”
Proyek ini dikembangkan dengan bantuan Kecerdasan Buatan (AI) sebagai asisten dalam proses debugging dan dokumentasi. Seluruh implementasi, pemahaman konsep,
dan pengembangan fitur dilakukan oleh penulis secara mandiri.
*Dibuat untuk memenuhi Tugas Project Akhir EAS 2025/2026.*