2026-01-14 18:16:56 +07:00

80 lines
3.9 KiB
Markdown

# 🚀 Smart-Attendance: Sistem Absensi Digital Terintegrasi Cloud
**Smart-Attendance** adalah aplikasi Android inovatif yang dirancang untuk mengotomatisasi proses absensi mahasiswa. Aplikasi ini memastikan validitas data kehadiran dengan menggabungkan tiga pilar verifikasi: **Identitas Digital (SQLite)**, **Geografis (GPS)**, dan **Biometrik Visual (Kamera)**. Seluruh data disinkronkan secara *real-time* ke **Google Sheets** melalui sistem automasi **n8n**.
---
## 📸 Pratinjau Antarmuka (Mockup)
| Layar Registrasi | Layar Login | Dashboard Absensi |
| :---: | :---: | :---: |
| ![Register](./register.png) | ![Login](./login.png) | ![Dashboard](./dashboard.png) |
| *Registrasi Akun Baru (Nama, NPM, Password)* | *Autentikasi Aman Berbasis NPM* | *Validasi Lokasi, Foto & Mata Kuliah* |
---
## 🌟 Fitur Utama
- **Otentikasi SQLite Lokal**: Sistem pendaftaran dan masuk yang mandiri, menyimpan data kredensial secara aman di memori internal perangkat.
- **Presisi Lokasi GPS**: Mengintegrasikan *Google Fused Location Provider* untuk mendapatkan koordinat Latitude & Longitude dengan akurasi tinggi (6 digit desimal).
- **Verifikasi Visual (Selfie)**: Mengambil foto wajah secara langsung sebagai bukti kehadiran fisik yang tidak dapat dimanipulasi dari galeri.
- **Sinkronisasi Cloud Otomatis**: Pengiriman data menggunakan protokol JSON melalui Webhook n8n yang langsung terhubung ke database Google Sheets.
- **Antarmuka Modern (Material 3)**: Desain UI responsif menggunakan Jetpack Compose dengan tema gradasi warna profesional (Hijau, Kuning, Putih).
- **Fitur Refresh Lokasi**: Memungkinkan pengguna memperbarui koordinat GPS secara manual untuk akurasi maksimal sebelum melakukan absensi.
---
## 🛠️ Stack Teknologi
| Sektor | Teknologi |
| :--- | :--- |
| **Bahasa Pemrograman** | [Kotlin](https://kotlinlang.org/) |
| **Framework UI** | [Jetpack Compose](https://developer.android.com/jetpack/compose) |
| **Database Lokal** | SQLite (Room/OpenHelper) |
| **Layanan Lokasi** | Google Play Services Location (Fused Location) |
| **Networking** | Java HttpURLConnection & JSONObject |
| **Backend/Automation** | n8n.io Webhook Workflow |
| **Database Cloud** | Google Sheets |
---
## 🏗️ Arsitektur Aliran Data
1. **Input**: Mahasiswa memasukkan Nama, NPM, Mata Kuliah, serta mengambil foto wajah dan titik lokasi.
2. **Processing**: Aplikasi mengonversi foto ke format **Base64** dan mengemas seluruh data ke dalam objek **JSON**.
3. **Transmission**: Data dikirim via jaringan Internet ke URL Webhook n8n.
4. **Storage**: Server n8n mengolah data dan memasukkannya secara rapi ke baris kolom di Google Sheets.
---
## 📱 Panduan Penggunaan
1. **Pendaftaran**: Buka aplikasi, pilih "Daftar Sekarang", masukkan Nama Lengkap, NPM, dan Password Anda.
2. **Masuk**: Gunakan NPM dan Password yang telah dibuat untuk masuk ke Dashboard.
3. **Izin Perangkat**: Berikan izin **Akses Lokasi** dan **Kamera** agar aplikasi berfungsi dengan benar.
4. **Proses Absen**:
- Pastikan koordinat lokasi muncul (Gunakan tombol **Refresh** jika perlu).
- Verifikasi nama **Mata Kuliah** yang muncul.
- Tekan **AMBIL FOTO** dan lakukan selfie.
- Tekan **KIRIM ABSENSI**.
5. **Konfirmasi**: Tunggu pesan "Absensi diterima server" muncul di layar.
---
## 📊 Monitoring & Validasi
Data kehadiran dapat dipantau langsung oleh Admin/Dosen melalui:
* **Live Log**: [ntfy.ubharajaya.ac.id/EAS](https://ntfy.ubharajaya.ac.id/EAS)
* **Database Kehadiran**: [Link Spreadsheet Google Sheets](https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0)
---
## 🎓 Informasi Akademik
* **Nama Mahasiswa**: Nabila Suwandira
* **NPM**: 202310715066
* **Program Studi**: Teknik Informatika
* **Instansi**: Universitas Bhayangkara Jakarta Raya
* **Mata Kuliah**: Pemrograman Perangkat Bergerak
* **Tujuan**: Proyek Evaluasi Akhir Semester (EAS) TA 2025-2026