Update README dan penyesuaian deskripsi proyek

This commit is contained in:
202310715200 INDRIS ALPASELA 2026-01-14 21:28:35 +07:00
parent ca6d6e2d33
commit 1c86cd1ce6

129
README.md
View File

@ -1,118 +1,101 @@
# 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile) # 📱 Aplikasi Absensi Akademik Berbasis Lokasi dan Foto (Android)
## 📌 Deskripsi Proyek ## 📌 Gambaran Umum Proyek
Proyek ini merupakan **Tugas Akhir EAS (Evaluasi Akhir Semester)** yang dikembangkan oleh: Aplikasi ini dibuat sebagai **proyek Evaluasi Akhir Semester (EAS)** dengan pengembang:
- **Nama** : Faris Naufal Priatna - **Nama** : Indris Alpasela
- **NPM** : 202310715123 - **NPM** : 202310715200
Tujuan proyek ini adalah membangun **aplikasi akademik berbasis mobile** dengan fokus pada **fitur absensi menggunakan data koordinat (GPS) dan pengambilan foto mahasiswa**. Aplikasi ini merupakan **aplikasi mobile berbasis Android** yang dirancang untuk mendukung sistem absensi akademik dengan memanfaatkan **lokasi GPS** dan **pengambilan foto mahasiswa secara langsung**.
Aplikasi ini dirancang untuk meningkatkan **validitas kehadiran mahasiswa**, dengan memastikan bahwa absensi hanya dapat dilakukan apabila mahasiswa: Tujuan utama pengembangan aplikasi ini adalah untuk **meningkatkan keakuratan dan kejujuran absensi**, sehingga kehadiran hanya dapat tercatat apabila:
1. Mahasiswa berada di **lokasi yang sesuai**, dan
2. Mahasiswa melakukan **pengambilan foto (selfie) saat absensi berlangsung**
1. Berada pada **lokasi yang telah ditentukan**, dan Pengembangan aplikasi dilakukan dengan **memodifikasi starter project yang telah disediakan**, serta dibantu oleh **AI ChatGPT** sebagai pendukung pembelajaran dan pengembangan kode.
2. Melakukan **pengambilan foto (selfie) secara langsung saat absensi**
Aplikasi ini **dibantu dikembangkan oleh AI ChatGPT** untuk memberikan saran teknis, struktur kode, dan pengembangan fitur tambahan.
--- ---
## 🎯 Tujuan Proyek ## 🎯 Tujuan Pengembangan
- Mengimplementasikan **Location-Based Service (LBS)** pada aplikasi mobile - Menerapkan konsep **Location-Based Service (LBS)** pada aplikasi Android
- Mengintegrasikan **kamera perangkat** untuk dokumentasi absensi - Mengintegrasikan fitur **kamera** untuk dokumentasi kehadiran
- Mencegah kecurangan absensi (titip absen) - Mengurangi potensi kecurangan dalam proses absensi
- Mengembangkan aplikasi mobile akademik berbasis Android - Melatih kemampuan pengembangan aplikasi mobile berbasis Android
- Melatih kemampuan perancangan dan implementasi aplikasi mobile - Mengimplementasikan logika validasi absensi secara sederhana
--- ---
## 🚀 Fitur Utama ## 🚀 Fitur Aplikasi
- 🔐 **Login Pengguna (Mahasiswa)** - 🔐 **Autentikasi Login Mahasiswa**
- 📍 **Pengambilan Koordinat Lokasi (Latitude & Longitude)** - 📍 **Deteksi Lokasi Mahasiswa (GPS)**
- 🏫 **Validasi Lokasi Absensi (Radius Area)** - 🏫 **Validasi Area Absensi**
- 📸 **Pengambilan Foto Mahasiswa Saat Absensi** - 📸 **Pengambilan Foto Saat Absensi**
- 🕒 **Pencatatan Waktu Absensi** - 🕒 **Pencatatan Waktu Kehadiran**
- 📄 **Riwayat Kehadiran Mahasiswa** - 📄 **Riwayat Data Absensi**
- ⚠️ **Notifikasi Absensi Ditolak jika Tidak Valid** - ⚠️ **Peringatan Jika Absensi Tidak Valid**
--- ---
## 🗺️ Mekanisme Absensi Berbasis Lokasi dan Foto ## 🗺️ Alur Proses Absensi
1. Mahasiswa melakukan **login** 1. Mahasiswa melakukan login ke aplikasi
2. Memilih menu **Absensi** 2. Memilih menu **Absensi**
3. Sistem meminta: 3. Aplikasi meminta izin:
- Izin **akses lokasi** - Akses lokasi
- Izin **akses kamera** - Akses kamera
4. Aplikasi mengambil: 4. Sistem mengambil:
- 📍 **Koordinat lokasi mahasiswa** - Koordinat lokasi pengguna
- 📸 **Foto mahasiswa secara real-time** - Foto mahasiswa secara real-time
5. Sistem melakukan validasi: 5. Sistem memvalidasi data absensi
- Absensi harus menggunakan foto 6. Jika memenuhi syarat → absensi berhasil
- Foto berhasil diambil 7. Jika tidak → absensi dibatalkan
6. Jika valid → **Absensi berhasil**
7. Jika tidak valid → **Absensi ditolak**
--- ---
## 📸 Pengambilan Foto Saat Absensi ## 📸 Dokumentasi Foto
- Foto diambil menggunakan **kamera depan (selfie)** - Foto diambil menggunakan **kamera depan**
- Foto hanya dapat diambil **saat proses absensi** - Pengambilan foto hanya dapat dilakukan saat proses absensi
- Foto disimpan sebagai **bukti kehadiran** - Foto disimpan sebagai **bukti kehadiran**
- Foto dapat digunakan untuk: - Dapat digunakan sebagai bahan verifikasi oleh pihak akademik
- Verifikasi manual oleh dosen
- Dokumentasi akademik
--- ---
## 🛠️ Teknologi yang Digunakan ## 🛠️ Teknologi yang Digunakan
- **Platform** : Android - **Platform** : Android
- **Bahasa Pemrograman** : Kotlin / Java - **Bahasa** : Kotlin / Java
- **Location Service** : - **Layanan Lokasi** :
- Google Maps API - Google Maps API
- Fused Location Provider - Fused Location Provider
- **Camera API** : CameraX / Camera2 - **Kamera** : CameraX / Camera2
- **Database** : Firebase / SQLite / MySQL - **Penyimpanan Data** : Firebase / SQLite / MySQL
- **Storage** : Firebase Storage / Local Storage
- **IDE** : Android Studio - **IDE** : Android Studio
--- ---
## 🔐 Izin Aplikasi (Permissions) ## 🔐 Permission Aplikasi
Aplikasi memerlukan izin berikut: Aplikasi membutuhkan beberapa izin berikut:
- `ACCESS_FINE_LOCATION` - `ACCESS_FINE_LOCATION`
- `ACCESS_COARSE_LOCATION` - `ACCESS_COARSE_LOCATION`
- `CAMERA` - `CAMERA`
- `INTERNET` - `INTERNET`
- `WRITE_EXTERNAL_STORAGE` (opsional, jika diperlukan) - `WRITE_EXTERNAL_STORAGE` (opsional)
--- ---
## 📂 Mockup ## 📂 Mockup Tampilan
![mockup](Mockup.png) ![mockup](Mockup.png)
--- ---
## Catatan ## 📄 Catatan Tambahan
- Kembangkan project dari starter yang sudah disediakan, **tidak membuat dari awal**. - Project dikembangkan dari **starter project resmi**
- Koordinat bisa ditambah/kurangi sedikit agar tidak memunculkan lokasi rumah masing-masing, data awal tetap diambil dari GPS. - Lokasi dapat disesuaikan untuk menjaga privasi pengguna
- Data lokasi tetap diperoleh dari GPS perangkat
---
## Pengecekan
- https://ntfy.ubharajaya.ac.id/EAS
- https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfFUHCEFbCmg8afTyyLZs/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
--- ---
## 📄 Identitas Pengembang ## 📄 Identitas Pengembang
- **Nama** : Faris Naufal Priatna - **Nama** : Indris Alpasela
- **NPM** : 202310715123 - **NPM** : 202310715200
- **Jenis Proyek** : Tugas Akhir EAS - **Jenis Proyek** : Evaluasi Akhir Semester (EAS)
- **Bantuan Pengembangan** : AI ChatGPT - **Pendukung Pengembangan** : AI ChatGPT
Output Aplikasi yang sudah jadi