Update README.md
This commit is contained in:
parent
b1cb5cdc1a
commit
a29fff5540
152
README.md
152
README.md
@ -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
|
||||||
|
|
||||||

|

|
||||||
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
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user