Update README.md

This commit is contained in:
202310715002 RAFI FATTAN FITRIARDI 2026-01-14 15:43:43 +07:00
parent b1cb5cdc1a
commit a29fff5540

152
README.md
View File

@ -1,97 +1,141 @@
Oke! Aku buatkan versi **README.md** yang sudah disesuaikan dengan **aplikasi absensi kita**, termasuk nama, NPM, kredit AI, dan lisensi FOSS. Kamu bisa langsung pakai ini:
---
# 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile) # 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile)
## 📌 Deskripsi Proyek ## 📌 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: Proyek ini merupakan **Tugas Akhir / Project Akhir Mata Kuliah Pemrograman Mobile** oleh:
1. Berada pada **lokasi yang telah ditentukan**, dan
2. Melakukan **pengambilan foto (selfie) secara langsung saat absensi** **Nama:** Rafi Fattan Fitriardi
**NPM:** 202310715002
Aplikasi ini adalah **aplikasi mobile akademik berbasis Android** yang memungkinkan mahasiswa melakukan **absensi dengan validasi lokasi GPS dan pengambilan foto selfie**. Aplikasi dirancang untuk meningkatkan **validitas kehadiran mahasiswa**, sehingga absensi hanya dapat dilakukan apabila mahasiswa:
1. Berada di **lokasi yang telah ditentukan**
2. Mengambil **foto selfie secara langsung** saat absensi
--- ---
## 🎯 Tujuan Proyek ## 🎯 Tujuan Proyek
- Mengimplementasikan **Location-Based Service (LBS)** pada aplikasi mobile
- Mengintegrasikan **kamera perangkat** untuk dokumentasi absensi * Mengimplementasikan **Location-Based Service (LBS)** pada aplikasi mobile
- Mencegah kecurangan absensi (titip absen) * Mengintegrasikan **kamera perangkat** untuk dokumentasi absensi
- Mengembangkan aplikasi mobile akademik berbasis Android * Mencegah kecurangan absensi (titip absen)
- Melatih kemampuan perancangan dan implementasi aplikasi mobile * Mengembangkan aplikasi mobile akademik berbasis Android
* Melatih kemampuan perancangan dan implementasi aplikasi mobile
--- ---
## 🚀 Fitur Utama ## 🚀 Fitur Utama
- 🔐 **Login Pengguna (Mahasiswa)**
- 📍 **Pengambilan Koordinat Lokasi (Latitude & Longitude)** * 🔐 **Login Pengguna (Mahasiswa)**
- 🏫 **Validasi Lokasi Absensi (Radius Area)** * 📍 **Pengambilan Koordinat Lokasi (Latitude & Longitude)**
- 📸 **Pengambilan Foto Mahasiswa Saat Absensi** * 🏫 **Validasi Lokasi Absensi (Radius Area)**
- 🕒 **Pencatatan Waktu Absensi** * 📸 **Pengambilan Foto Mahasiswa Saat Absensi**
- 📄 **Riwayat Kehadiran Mahasiswa** * 🕒 **Pencatatan Waktu Absensi**
- ⚠️ **Notifikasi Absensi Ditolak jika Tidak Valid** * 📄 **Riwayat Kehadiran Mahasiswa**
* ⚠️ **Notifikasi Absensi Ditolak jika Tidak Valid**
* 🎓 **Pemilihan Mata Kuliah** sebelum absensi
--- ---
## 🗺️ Mekanisme Absensi Berbasis Lokasi dan Foto ## 🗺️ Mekanisme Absensi Berbasis Lokasi dan Foto
1. Mahasiswa melakukan **login** 1. Mahasiswa melakukan **login**
2. Memilih menu **Absensi** 2. Memilih menu **Absensi**
3. Sistem meminta: 3. Sistem meminta izin:
- Izin **akses lokasi**
- Izin **akses kamera** * **akses lokasi**
* **akses kamera**
4. Aplikasi mengambil: 4. Aplikasi mengambil:
- 📍 **Koordinat lokasi mahasiswa**
- 📸 **Foto mahasiswa secara real-time** * 📍 **Koordinat lokasi mahasiswa**
* 📸 **Foto mahasiswa secara real-time**
5. Sistem melakukan validasi: 5. Sistem melakukan validasi:
- Lokasi berada dalam **radius absensi**
- Foto berhasil diambil * Lokasi berada dalam **radius absensi**
* Foto berhasil diambil
* Mata kuliah yang dipilih valid
6. Jika valid → **Absensi berhasil** 6. Jika valid → **Absensi berhasil**
7. Jika tidak valid → **Absensi ditolak** 7. Jika tidak valid → **Absensi ditolak**
--- ---
## 📸 Pengambilan Foto Saat Absensi ## 📸 Pengambilan Foto Saat Absensi
- Foto diambil menggunakan **kamera depan (selfie)**
- Foto hanya dapat diambil **saat proses absensi** * Foto diambil menggunakan **kamera depan (selfie)**
- Foto disimpan sebagai **bukti kehadiran** * Foto hanya dapat diambil **saat proses absensi**
- Foto dapat digunakan untuk: * Foto disimpan sebagai **bukti kehadiran**
- Verifikasi manual oleh dosen * Foto dapat digunakan untuk:
- Dokumentasi akademik
* Verifikasi manual oleh dosen
* Dokumentasi akademik
--- ---
## 🛠️ Teknologi yang Digunakan ## 🛠️ Teknologi yang Digunakan
- **Platform** : Android
- **Bahasa Pemrograman** : Kotlin / Java * **Platform** : Android
- **Location Service** : * **Bahasa Pemrograman** : Kotlin
- Google Maps API * **Location Service** : Google Fused Location Provider
- Fused Location Provider * **Camera API** : CameraX / Camera2
- **Camera API** : CameraX / Camera2 * **Database** : Google Sheets (via n8n)
- **Database** : Firebase / SQLite / MySQL * **Storage** : Local / Base64 dikirim ke server
- **Storage** : Firebase Storage / Local Storage * **IDE** : Android Studio
- **IDE** : Android Studio
--- ---
## 🔐 Izin Aplikasi (Permissions) ## 🔐 Izin Aplikasi (Permissions)
Aplikasi memerlukan izin berikut: Aplikasi memerlukan izin berikut:
- `ACCESS_FINE_LOCATION`
- `ACCESS_COARSE_LOCATION` * `ACCESS_FINE_LOCATION`
- `CAMERA` * `ACCESS_COARSE_LOCATION`
- `INTERNET` * `CAMERA`
- `WRITE_EXTERNAL_STORAGE` (jika diperlukan) * `INTERNET`
--- ---
## 📂 Mockup ## 📂 Mockup
![mockup](Mockup.png) ![mockup](Mockup.png)
gambar mockup dibuat oleh AI
## 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: ## ⚡ Pengecekan & Data
- https://ntfy.ubharajaya.ac.id/EAS
- https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0
## Webhook: * Absensi dapat dicek di: [ntfy.ubharajaya.ac.id/EAS](https://ntfy.ubharajaya.ac.id/EAS)
- test: https://n8n.lab.ubharajaya.ac.id/webhook-test/23c6993d-1792-48fb-ad1c-ffc78a3e6254 * Data absensi tersimpan di Google Sheet: [Spreadsheet](https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0)
- 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](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](https://n8n.lab.ubharajaya.ac.id/webhook/23c6993d-1792-48fb-ad1c-ffc78a3e6254)
---
## 📝 Catatan
* Starter project dibuat **menggunakan bantuan AI**
* Kembangkan aplikasi dari starter yang sudah disediakan, **tidak membuat dari awal**
* Untuk koordinat, bisa ditambah/kurangi angka tertentu agar tidak menampilkan koordinat rumah mahasiswa; data awal tetap dari GPS
---
## ⚖️ Lisensi
Aplikasi ini dirilis di bawah **FOSS License (MIT)**.
Bebas **menggunakan, memodifikasi, dan mendistribusikan** selama menyertakan kredit:
```
© 2026 Rafi Fattan Fitriardi (NPM 202310715002)
AI assistance: ChatGPT (OpenAI)
License: MIT
```
---