Update README.md

This commit is contained in:
202310715220 MUHAMMAD FADZEL HADEAN RUKRUS 2026-01-14 21:49:32 +07:00
parent 8d2adb2079
commit 1f10a0c5e5

137
README.md
View File

@ -1,101 +1,78 @@
# 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile) # 📱 Aplikasi Absensi Akademik Berbasis GPS & Foto
## 📌 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**. Project ini dibuat sebagai **Tugas Akhir / UAS Mata Kuliah Pemrograman Mobile**, bertujuan untuk membuat aplikasi **absensi berbasis Android** dengan teknologi:
Aplikasi ini dirancang untuk meningkatkan **validitas kehadiran mahasiswa**, dengan memastikan bahwa absensi hanya dapat dilakukan apabila mahasiswa: - Pengambilan **lokasi GPS (latitude & longitude)** secara realtime
1. Berada pada **lokasi yang telah ditentukan**, dan - Pengambilan **foto mahasiswa saat absensi** sebagai bukti
2. Melakukan **pengambilan foto (selfie) secara langsung saat absensi** - Validasi absensi berdasarkan *location* dan *foto*
- Menampilkan **riwayat absensi** mahasiswa
- Menggunakan **Jetpack Compose** + **Material 3**
- Tersedia fitur **Light / Dark Mode**, **Logout**, dan **Dropdown pilihan mata kuliah** :contentReference[oaicite:1]{index=1}
--- ---
## 🎯 Tujuan Proyek ## 🎯 Tujuan Proyek
- Mengimplementasikan **Location-Based Service (LBS)** pada aplikasi mobile Tujuan utama aplikasi:
- Mengintegrasikan **kamera perangkat** untuk dokumentasi absensi
- Mencegah kecurangan absensi (titip absen) - Mengimplementasikan layanan **absensi berbasis lokasi & foto**
- Mengembangkan aplikasi mobile akademik berbasis Android - Validasi absensi agar mahasiswa tidak **titip absen**
- Melatih kemampuan perancangan dan implementasi aplikasi mobile - Memberikan pengalaman penggunaan yang baik dengan UI Compose
- Meningkatkan pemahaman dan penguasaan Android modern dengan Compose :contentReference[oaicite:2]{index=2}
--- ---
## 🚀 Fitur Utama ## ✅ Fitur Utama
- 🔐 **Login Pengguna (Mahasiswa)** Aplikasi ini memiliki fitur-fitur berikut:
- 📍 **Pengambilan Koordinat Lokasi (Latitude & Longitude)**
- 🏫 **Validasi Lokasi Absensi (Radius Area)** ### 🧩 Authentication
- 📸 **Pengambilan Foto Mahasiswa Saat Absensi** ✔️ Login dengan NPM & password
- 🕒 **Pencatatan Waktu Absensi** ✔️ Ikon login custom dari `drawable`
- 📄 **Riwayat Kehadiran Mahasiswa** ✔️ Show/Hide password dengan animasi ikon mata 👁️
- ⚠️ **Notifikasi Absensi Ditolak jika Tidak Valid** ✔️ Light / Dark Theme toggle
### 📍 Absensi
✔️ Ambil **lokasi GPS** otomatis dengan izin lokasi
✔️ Ambil **foto mahasiswa** dari kamera
✔️ Validasi absensi berdasarkan lokasi dan foto
✔️ Pilihan **mata kuliah** sebelum absensi
✔️ Tampilkan waktu absensi
✔️ Riwayat absensi dengan detail (nama, NPM, foto, lokasi)
### 📤 Logout
✔️ Logout untuk kembali ke halaman login
✔️ Session login akan berakhir dan mencegah tombol back kembali ke Main :contentReference[oaicite:3]{index=3}
--- ---
## 🗺️ Mekanisme Absensi Berbasis Lokasi dan Foto ## 🛠 Teknologi yang Digunakan
1. Mahasiswa melakukan **login** | Teknologi | Keterangan |
2. Memilih menu **Absensi** |-----------|------------|
3. Sistem meminta: | **Android Studio** | IDE utama pengembangan |
- Izin **akses lokasi** | **Kotlin** | Bahasa pemrograman |
- Izin **akses kamera** | **Jetpack Compose** | UI modern deklaratif |
4. Aplikasi mengambil: | **Material3** | UI komponen modern |
- 📍 **Koordinat lokasi mahasiswa** | **Google Location Services** | Ambil lokasi pengguna |
- 📸 **Foto mahasiswa secara real-time** | **Camera API / CameraX** | Ambil foto langsung dari kamera |
5. Sistem melakukan validasi: | **Fused Location Provider** | Lokasi realtime | :contentReference[oaicite:4]{index=4}
- Lokasi berada dalam **radius absensi**
- Foto berhasil diambil
6. Jika valid → **Absensi berhasil**
7. Jika tidak valid → **Absensi ditolak**
--- ---
## 📸 Pengambilan Foto Saat Absensi ## 🎨 Tampilan UI
- Foto diambil menggunakan **kamera depan (selfie)** Login dengan ikon
- Foto hanya dapat diambil **saat proses absensi** Tombol Logout
- Foto disimpan sebagai **bukti kehadiran** Validasi lokasi dan foto saat absensi
- Foto dapat digunakan untuk: Riwayat absensi dengan gambar & detail lokasi
- Verifikasi manual oleh dosen
- Dokumentasi akademik > *(Screenshot bisa ditambahkan di bawah section ini)*
--- ---
## 🛠️ Teknologi yang Digunakan ## 🚀 Cara Menjalankan
- **Platform** : Android 1. **Clone repository**
- **Bahasa Pemrograman** : Kotlin / Java ```bash
- **Location Service** : git clone https://git.lab.ubharajaya.ac.id/202310715220-MUHAMMAD-FADZEL-HADEAN-RUKRUS/EAS-202310715220-MuhammadFadzelHR.git
- Google Maps API
- Fused Location Provider
- **Camera API** : CameraX / Camera2
- **Database** : Firebase / SQLite / MySQL
- **Storage** : Firebase Storage / Local Storage
- **IDE** : Android Studio
--- ## 👤 Author
## 🔐 Izin Aplikasi (Permissions)
Aplikasi memerlukan izin berikut:
- `ACCESS_FINE_LOCATION`
- `ACCESS_COARSE_LOCATION`
- `CAMERA`
- `INTERNET`
- `WRITE_EXTERNAL_STORAGE` (jika diperlukan)
---
## 📂 Mockup
![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:
- https://ntfy.ubharajaya.ac.id/EAS
- https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0
## 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
## AUTHOR
- Muhammad Fadzel Hadean Rukrus - Muhammad Fadzel Hadean Rukrus
- NPM : 202310715220 - NPM: 202310715220