90 lines
4.0 KiB
Markdown
90 lines
4.0 KiB
Markdown
# 🚀 Smart-Attendance: Sistem Absensi Mahasiswa Terintegrasi Cloud
|
|
|
|
[](https://developer.android.com/)
|
|
[](https://kotlinlang.org/)
|
|
[](https://developer.android.com/jetpack/compose)
|
|
[](https://www.sqlite.org/)
|
|
|
|
**Smart-Attendance** adalah platform absensi mahasiswa berbasis mobile yang menggabungkan keamanan database lokal dengan validasi geografis dan biometrik visual secara *real-time*. Aplikasi ini dikembangkan menggunakan **Jetpack Compose** untuk memberikan pengalaman pengguna yang modern dan responsif.
|
|
|
|
---
|
|
|
|
## 📸 Antarmuka Aplikasi (Mockup)
|
|
|
|
| Layar Registrasi | Layar Login | Dashboard Absensi |
|
|
| :---: | :---: | :---: |
|
|
|  |  |  |
|
|
| *Pendaftaran Akun (Nama, NPM, Password)* | *Masuk Sistem menggunakan NPM* | *Validasi Lokasi & Foto Wajah* |
|
|
|
|
> **Catatan:** Pastikan Anda menyimpan file gambar di folder root project dengan nama `register.png`, `login.png`, dan `dashboard.png` agar muncul di GitHub.
|
|
|
|
---
|
|
|
|
## 🌟 Fitur Utama
|
|
|
|
- **Otentikasi SQLite**: Pendaftaran Akun (Nama, NPM, Password) dan Login aman yang tersimpan secara lokal di perangkat.
|
|
- **Geo-Precision Tracking**: Mendeteksi lokasi presisi (Latitude & Longitude) menggunakan *Fused Location Provider API* dengan akurasi tinggi.
|
|
- **Visual Proof Recognition**: Pengambilan foto wajah langsung melalui kamera aplikasi sebagai bukti kehadiran fisik yang valid.
|
|
- **Sinkronisasi Cloud**: Data absensi (NPM, Nama, Koordinat, Mata Kuliah, dan Foto) otomatis terkirim ke **Google Sheets** via **n8n Webhook**.
|
|
- **UI/UX Modern**: Desain antarmuka bersih dengan tema gradasi Hijau-Kuning yang segar sesuai standar Material Design 3.
|
|
- **Refresh Lokasi**: Tombol manual untuk memperbarui koordinat GPS jika posisi dirasa kurang akurat.
|
|
|
|
---
|
|
|
|
## 🛠️ Stack Teknologi
|
|
|
|
- **UI Framework**: Jetpack Compose (Declarative UI)
|
|
- **Bahasa**: Kotlin
|
|
- **Local Database**: SQLite (Manajemen profil pengguna)
|
|
- **Location**: Google Play Services Location API
|
|
- **Networking**: HttpURLConnection (JSON Data Transmission)
|
|
- **Automation**: n8n.io (Integrasi Webhook ke Google Sheets)
|
|
|
|
---
|
|
|
|
## 🏗️ Struktur Data JSON (Payload)
|
|
|
|
Data yang dikirimkan ke server memiliki struktur berikut:
|
|
```json
|
|
{
|
|
"npm": "202310715066",
|
|
"nama": "Nabila Suwandira",
|
|
"latitude": 37.421998,
|
|
"longitude": -122.084000,
|
|
"mata_kuliah": "Pemrograman Perangkat Bergerak",
|
|
"timestamp": 1739456789000,
|
|
"foto_base64": "/9j/4AAQSkZJRg..."
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 📱 Panduan Penggunaan
|
|
|
|
1. **Registrasi**: Buka aplikasi, pilih "Daftar Sekarang". Isi Nama Lengkap, NPM, dan Password.
|
|
2. **Login**: Masuk menggunakan NPM dan Password yang telah dibuat.
|
|
3. **Absensi**:
|
|
- Pastikan GPS aktif.
|
|
- Isi atau verifikasi **Mata Kuliah**.
|
|
- Ambil foto wajah dengan menekan tombol **AMBIL FOTO**.
|
|
- Tekan **KIRIM ABSENSI** untuk mengirim data ke server.
|
|
4. **Logout**: Tekan ikon profil di pojok kanan atas untuk keluar.
|
|
|
|
---
|
|
|
|
## 📡 Monitoring Data
|
|
|
|
Verifikasi pengiriman data absensi secara langsung melalui:
|
|
* **Log Real-time**: [ntfy.ubharajaya.ac.id/EAS](https://ntfy.ubharajaya.ac.id/EAS)
|
|
* **Database Cloud**: [Spreadsheet Absensi Mahasiswa](https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0)
|
|
|
|
---
|
|
|
|
## 🎓 Informasi Project
|
|
|
|
**Nama**: Nabila Suwandira
|
|
**NPM**: 202310715066
|
|
**Instansi**: Universitas Bhayangkara Jakarta Raya
|
|
**Mata Kuliah**: Pemrograman Perangkat Bergerak
|
|
**Tujuan**: Proyek Evaluasi Akhir Semester (EAS) 2025-2026
|