Update README.md
This commit is contained in:
parent
8d2adb2079
commit
1f10a0c5e5
137
README.md
137
README.md
@ -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
|
|
||||||

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