Update README.md
This commit is contained in:
parent
5989cb38b0
commit
242cd76fa2
237
README.md
237
README.md
@ -1,97 +1,190 @@
|
|||||||
# 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile)
|
# 📱 Sistem Absensi Akademik
|
||||||
|
|
||||||
## 📌 Deskripsi Proyek
|
Aplikasi mobile berbasis Android untuk sistem absensi mahasiswa dengan validasi lokasi GPS dan pengambilan foto.
|
||||||
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:
|
|
||||||
1. Berada pada **lokasi yang telah ditentukan**, dan
|
|
||||||
2. Melakukan **pengambilan foto (selfie) secara langsung saat absensi**
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🎯 Tujuan Proyek
|
## 🎯 Fitur Utama
|
||||||
- Mengimplementasikan **Location-Based Service (LBS)** pada aplikasi mobile
|
|
||||||
- Mengintegrasikan **kamera perangkat** untuk dokumentasi absensi
|
- 🔐 **Login Pengguna** - Autentikasi dengan NPM dan Password
|
||||||
- Mencegah kecurangan absensi (titip absen)
|
- 📍 **Pengambilan Lokasi** - Deteksi GPS real-time (Latitude & Longitude)
|
||||||
- Mengembangkan aplikasi mobile akademik berbasis Android
|
- 🏫 **Validasi Radius** - Validasi lokasi dalam radius 100m dari kampus
|
||||||
- Melatih kemampuan perancangan dan implementasi aplikasi mobile
|
- 📸 **Foto Mahasiswa** - Pengambilan foto saat absensi
|
||||||
|
- 🕒 **Pencatatan Waktu** - Timestamp otomatis setiap absensi
|
||||||
|
- 📄 **Riwayat Kehadiran** - History absensi tersimpan lokal
|
||||||
|
- ⚠️ **Notifikasi** - Alert jika absensi ditolak (lokasi tidak valid)
|
||||||
|
- 🌐 **Integrasi Server** - Kirim data ke webhook n8n
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🚀 Fitur Utama
|
## 🛠️ Tech Stack
|
||||||
- 🔐 **Login Pengguna (Mahasiswa)**
|
|
||||||
- 📍 **Pengambilan Koordinat Lokasi (Latitude & Longitude)**
|
- **Language:** Kotlin
|
||||||
- 🏫 **Validasi Lokasi Absensi (Radius Area)**
|
- **UI Framework:** Jetpack Compose
|
||||||
- 📸 **Pengambilan Foto Mahasiswa Saat Absensi**
|
- **Design:** Material Design 3
|
||||||
- 🕒 **Pencatatan Waktu Absensi**
|
- **Location:** Google Play Services (Fused Location Provider)
|
||||||
- 📄 **Riwayat Kehadiran Mahasiswa**
|
- **Storage:** SharedPreferences
|
||||||
- ⚠️ **Notifikasi Absensi Ditolak jika Tidak Valid**
|
- **Network:** HttpURLConnection
|
||||||
|
- **Min SDK:** API 24 (Android 7.0)
|
||||||
|
- **Target SDK:** API 34 (Android 14)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🗺️ Mekanisme Absensi Berbasis Lokasi dan Foto
|
## 📁 Struktur Project
|
||||||
1. Mahasiswa melakukan **login**
|
|
||||||
2. Memilih menu **Absensi**
|
```
|
||||||
3. Sistem meminta:
|
app/src/main/java/id/ac/ubharajaya/sistemakademik/
|
||||||
- Izin **akses lokasi**
|
│
|
||||||
- Izin **akses kamera**
|
├── MainActivity.kt # Entry point & navigation
|
||||||
4. Aplikasi mengambil:
|
│
|
||||||
- 📍 **Koordinat lokasi mahasiswa**
|
├── models/
|
||||||
- 📸 **Foto mahasiswa secara real-time**
|
│ └── DataModels.kt # Data class (User, AbsensiRecord)
|
||||||
5. Sistem melakukan validasi:
|
│
|
||||||
- Lokasi berada dalam **radius absensi**
|
├── utils/
|
||||||
- Foto berhasil diambil
|
│ ├── SessionManager.kt # Manajemen sesi login
|
||||||
6. Jika valid → **Absensi berhasil**
|
│ ├── LocationUtils.kt # Validasi lokasi & radius
|
||||||
7. Jika tidak valid → **Absensi ditolak**
|
│ ├── NetworkUtils.kt # HTTP request ke server
|
||||||
|
│ └── Constants.kt # Konstanta (dummy users)
|
||||||
|
│
|
||||||
|
└── ui/
|
||||||
|
└── screens/
|
||||||
|
├── LoginScreen.kt # Halaman login
|
||||||
|
├── AbsensiScreen.kt # Halaman absensi utama
|
||||||
|
├── RiwayatScreen.kt # Halaman riwayat
|
||||||
|
└── ProfilScreen.kt # Halaman profil & logout
|
||||||
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📸 Pengambilan Foto Saat Absensi
|
## 🚀 Instalasi & Setup
|
||||||
- Foto diambil menggunakan **kamera depan (selfie)**
|
|
||||||
- Foto hanya dapat diambil **saat proses absensi**
|
### 1. Clone Repository
|
||||||
- Foto disimpan sebagai **bukti kehadiran**
|
```bash
|
||||||
- Foto dapat digunakan untuk:
|
git clone https://github.com/username/sistem-absensi-akademik.git
|
||||||
- Verifikasi manual oleh dosen
|
cd sistem-absensi-akademik
|
||||||
- Dokumentasi akademik
|
```
|
||||||
|
|
||||||
|
### 2. Buka di Android Studio
|
||||||
|
- Buka Android Studio
|
||||||
|
- File → Open → Pilih folder project
|
||||||
|
- Tunggu Gradle sync selesai
|
||||||
|
|
||||||
|
### 3. Konfigurasi
|
||||||
|
Edit file `utils/LocationUtils.kt`:
|
||||||
|
```kotlin
|
||||||
|
const val KAMPUS_LAT = -6.175392 // Koordinat kampus Anda
|
||||||
|
const val KAMPUS_LON = 106.827153 // Koordinat kampus Anda
|
||||||
|
const val RADIUS_METER = 100.0 // Radius dalam meter
|
||||||
|
```
|
||||||
|
|
||||||
|
Edit file `utils/NetworkUtils.kt`:
|
||||||
|
```kotlin
|
||||||
|
private const val WEBHOOK_URL = "https://your-webhook-url.com"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Build & Run
|
||||||
|
- Sambungkan device Android atau jalankan emulator
|
||||||
|
- Run → Run 'app'
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🛠️ Teknologi yang Digunakan
|
## 📱 Cara Penggunaan
|
||||||
- **Platform** : Android
|
|
||||||
- **Bahasa Pemrograman** : Kotlin / Java
|
### Login
|
||||||
- **Location Service** :
|
1. Buka aplikasi
|
||||||
- Google Maps API
|
2. Masukkan NPM dan Password
|
||||||
- Fused Location Provider
|
3. Tekan **Login**
|
||||||
- **Camera API** : CameraX / Camera2
|
|
||||||
- **Database** : Firebase / SQLite / MySQL
|
**Demo Account:**
|
||||||
- **Storage** : Firebase Storage / Local Storage
|
- NPM: `2024001` | Password: `password123`
|
||||||
- **IDE** : Android Studio
|
- NPM: `2024002` | Password: `password123`
|
||||||
|
- NPM: `2024003` | Password: `password123`
|
||||||
|
|
||||||
|
### Absensi
|
||||||
|
1. Izinkan akses **Lokasi** (GPS)
|
||||||
|
2. Tunggu hingga lokasi **Valid** (hijau)
|
||||||
|
3. Tekan **Ambil Foto**
|
||||||
|
4. Izinkan akses **Kamera**
|
||||||
|
5. Ambil foto selfie
|
||||||
|
6. Tekan **Kirim Absensi**
|
||||||
|
|
||||||
|
### Riwayat & Profil
|
||||||
|
- Tab **Riwayat**: Lihat history absensi
|
||||||
|
- Tab **Profil**: Info user & logout
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🔐 Izin Aplikasi (Permissions)
|
## 🔑 Permissions
|
||||||
Aplikasi memerlukan izin berikut:
|
|
||||||
- `ACCESS_FINE_LOCATION`
|
Aplikasi memerlukan permission berikut:
|
||||||
- `ACCESS_COARSE_LOCATION`
|
- ✅ `INTERNET` - Kirim data ke server
|
||||||
- `CAMERA`
|
- ✅ `ACCESS_FINE_LOCATION` - GPS akurasi tinggi
|
||||||
- `INTERNET`
|
- ✅ `ACCESS_COARSE_LOCATION` - GPS fallback
|
||||||
- `WRITE_EXTERNAL_STORAGE` (jika diperlukan)
|
- ✅ `CAMERA` - Ambil foto mahasiswa
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📂 Mockup
|
## 📊 Data Format (Server)
|
||||||
|
|
||||||
gambar mockup dibuat oleh AI
|
|
||||||
|
|
||||||
## Catatan:
|
JSON yang dikirim ke webhook:
|
||||||
- Starter project ini dibuat berbantukan AI
|
```json
|
||||||
- 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.
|
"npm": "202310715043",
|
||||||
|
"nama": "Muhammad Rafly Al Fathir",
|
||||||
|
"latitude": -6.175392,
|
||||||
|
"longitude": 106.827153,
|
||||||
|
"timestamp": 1705244400000,
|
||||||
|
"foto_base64": "base64_encoded_image...",
|
||||||
|
"jarak_meter": 45
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
## Pengecekan:
|
---
|
||||||
- https://ntfy.ubharajaya.ac.id/EAS
|
|
||||||
- https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0
|
|
||||||
|
|
||||||
## Webhook:
|
## 📝 Changelog
|
||||||
- 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
|
### Version 1.0.0 (14 Januari 2026)
|
||||||
|
- ✨ Implementasi sistem login
|
||||||
|
- ✨ Validasi lokasi dengan radius
|
||||||
|
- ✨ Pengambilan foto mahasiswa
|
||||||
|
- ✨ Riwayat absensi lokal
|
||||||
|
- ✨ Integrasi webhook n8n
|
||||||
|
- 🐛 Fixed Android 13+ compatibility
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🤝 Contributing
|
||||||
|
|
||||||
|
1. Fork repository
|
||||||
|
2. Buat branch baru (`git checkout -b feature/AmazingFeature`)
|
||||||
|
3. Commit changes (`git commit -m 'Add some AmazingFeature'`)
|
||||||
|
4. Push ke branch (`git push origin feature/AmazingFeature`)
|
||||||
|
5. Buat Pull Request
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📄 License
|
||||||
|
|
||||||
|
Distributed under the MIT License. See `LICENSE` for more information.
|
||||||
|
gemini chatgpt claude
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 👨💻 Developer
|
||||||
|
|
||||||
|
**Universitas Bhayangkara Jakarta Raya**
|
||||||
|
- Website: https://ubharajaya.ac.id
|
||||||
|
- Email: admin@ubharajaya.ac.id
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🙏 Acknowledgments
|
||||||
|
|
||||||
|
- [Jetpack Compose](https://developer.android.com/jetpack/compose)
|
||||||
|
- [Material Design 3](https://m3.material.io/)
|
||||||
|
- [Google Play Services](https://developers.google.com/android/guides/overview)
|
||||||
|
- [n8n Workflow Automation](https://n8n.io/)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Made with ❤️ for Academic Attendance System**
|
||||||
Loading…
x
Reference in New Issue
Block a user