|
|
|
|
@ -1,97 +1,83 @@
|
|
|
|
|
# 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile)
|
|
|
|
|
|
|
|
|
|
## 📌 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**
|
|
|
|
|
## 👤 Identitas Mahasiswa
|
|
|
|
|
- **Nama:** Fadlan Rivaldi
|
|
|
|
|
- **NPM:** 202310715280
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 🎯 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
|
|
|
|
|
## 📌 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 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 oleh dosen
|
|
|
|
|
- Dokumentasi akademik
|
|
|
|
|
- 🔐 **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
|
|
|
|
|
- **Platform** : Android
|
|
|
|
|
- **Bahasa Pemrograman** : Kotlin / Java
|
|
|
|
|
- **Location Service** :
|
|
|
|
|
- Google Maps API
|
|
|
|
|
- Fused Location Provider
|
|
|
|
|
- **Camera API** : CameraX / Camera2
|
|
|
|
|
- **Database** : Firebase / SQLite / MySQL
|
|
|
|
|
- **Storage** : Firebase Storage / Local Storage
|
|
|
|
|
- **IDE** : Android Studio
|
|
|
|
|
- **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 izin berikut:
|
|
|
|
|
- `ACCESS_FINE_LOCATION`
|
|
|
|
|
- `ACCESS_COARSE_LOCATION`
|
|
|
|
|
- `CAMERA`
|
|
|
|
|
- `INTERNET`
|
|
|
|
|
- `WRITE_EXTERNAL_STORAGE` (jika diperlukan)
|
|
|
|
|
Aplikasi memerlukan akses:
|
|
|
|
|
- `CAMERA`: Untuk mengambil foto selfie.
|
|
|
|
|
- `ACCESS_FINE_LOCATION`: Untuk validasi lokasi kampus.
|
|
|
|
|
- `INTERNET`: Untuk mengirim data absensi ke server.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 📂 Mockup
|
|
|
|
|
|
|
|
|
|
gambar mockup dibuat oleh AI
|
|
|
|
|
## ⚠️ 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.
|
|
|
|
|
|
|
|
|
|
## Catatan:
|
|
|
|
|
- Starter project ini dibuat berbantukan AI
|
|
|
|
|
- Kembangkan project dari starter yang sudah disediakan, jangan membuat dari awal.
|
|
|
|
|
- Untuk koordinat bisa ditambah/kurangi angka tertentu agar tidak memunculkan koordinat rumah masing-masing, data awal tetap dari GPS.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## Pengecekan:
|
|
|
|
|
- https://ntfy.ubharajaya.ac.id/EAS
|
|
|
|
|
- https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0
|
|
|
|
|
## 🔗 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`
|
|
|
|
|
|
|
|
|
|
## Webhook:
|
|
|
|
|
- test: https://n8n.lab.ubharajaya.ac.id/webhook-test/23c6993d-1792-48fb-ad1c-ffc78a3e6254
|
|
|
|
|
- production: https://n8n.lab.ubharajaya.ac.id/webhook/23c6993d-1792-48fb-ad1c-ffc78a3e6254
|
|
|
|
|
---
|
|
|
|
|
*Dibuat untuk memenuhi Tugas Project Akhir EAS 2025/2026.*
|
