202310715066-NABILA-SUWANDIRA/EAS-NabilaSuwandira-202310715066
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

README.md

Browse Source
This commit is contained in:
202310715066 NABILA SUWANDIRA 2026-01-14 17:56:11 +07:00
parent 7b0928e451
commit e586e69732
1 changed files with 55 additions and 50 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

105
README.md
View File

@ -1,47 +1,62 @@
# 🚀 Smart-Attendance: Sistem Absensi Mahasiswa Terintegrasi Cloud # 🚀 Smart-Attendance: Sistem Absensi Digital Terintegrasi Cloud
**Smart-Attendance** adalah aplikasi Android berbasis **Jetpack Compose** yang dirancang untuk revolusi absensi perkuliahan. Aplikasi ini menjamin integritas data kehadiran dengan menggabungkan verifikasi **Geografis (GPS)**, **Biometrik Visual (Kamera)**, dan **Identitas Digital (SQLite)** dalam satu alur kerja otomatis yang terhubung ke **Google Sheets** via **n8n Automation**. [![Android](https://img.shields.io/badge/Platform-Android-brightgreen.svg)](https://developer.android.com/)
[![Kotlin](https://img.shields.io/badge/Language-Kotlin-blue.svg)](https://kotlinlang.org/)
[![Jetpack Compose](https://img.shields.io/badge/UI-Jetpack%20Compose-orange.svg)](https://developer.android.com/jetpack/compose)
[![SQLite](https://img.shields.io/badge/Database-SQLite-lightgrey.svg)](https://www.sqlite.org/)
**Smart-Attendance** adalah platform absensi mahasiswa berbasis mobile yang menggabungkan keamanan database lokal dengan validasi biometrik visual dan geografis secara *real-time*. Proyek ini dirancang untuk memastikan validitas kehadiran mahasiswa dengan alur kerja yang sepenuhnya otomatis dari perangkat Android hingga ke sistem manajemen data cloud.
---
## 📸 Mockup Aplikasi
Berikut adalah pratinjau desain antarmuka pengguna (UI) dari aplikasi Smart-Attendance:
![Mockup Aplikasi](Mockup.png)
*Gambar di atas merupakan representasi visual dari layar Login, Registrasi, dan Dashboard Absensi.*
--- ---
## 🌟 Fitur Utama ## 🌟 Fitur Utama
- **Otentikasi Ganda**: Sistem login dan registrasi berbasis database **SQLite** lokal untuk memastikan akun unik per mahasiswa (berdasarkan NPM). - **Otentikasi SQLite**: Pendaftaran dan masuk akun yang aman dengan validasi NPM unik langsung dari database lokal perangkat.
- **Geo-Fencing Validation**: Mendeteksi lokasi presisi hingga 6 digit desimal menggunakan *High Accuracy Priority* dari Google Play Services. - **Geo-Precision Tracking**: Mendeteksi lokasi presisi (Latitude & Longitude) menggunakan *Fused Location Provider API* dengan prioritas akurasi tinggi.
- **Visual Identity Verification**: Pengambilan foto wajah langsung (*Real-time Camera*) yang dienkripsi ke format **Base64** untuk bukti kehadiran autentik. - **Visual Proof Recognition**: Integrasi kamera untuk pengambilan foto wajah (selfie) secara *real-time* sebagai bukti fisik kehadiran.
- **Dashboard Akademik**: Mahasiswa dapat memilih atau memasukkan Mata Kuliah yang sedang berlangsung. - **Auto-Sync Integration**: Sinkronisasi data otomatis ke **Google Sheets** melalui jembatan **n8n Automation Webhook**.
- **Sinkronisasi Instan**: Data dikirim dalam milidetik ke server cloud menggunakan protokol `HttpURLConnection` yang ringan. - **Manajemen Mata Kuliah**: Fitur pemilihan atau penginputan mata kuliah yang fleksibel saat melakukan absensi.
- **UI Modern & Adaptif**: Antarmuka responsif dengan desain kartu modern dan tema gradasi Hijau-Kuning-Putih yang segar. - **Material Design 3**: UI modern dengan gradasi warna profesional (Hijau Tua, Kuning, Putih) dan komponen kartu yang intuitif.
--- ---
## 🛠️ Stack Teknologi ## 🛠️ Stack Teknologi
| Komponen | Teknologi | | Komponen | Teknologi yang Digunakan |
| :--- | :--- | | :--- | :--- |
| **Framework UI** | Jetpack Compose (Modern Toolkit) | | **Framework UI** | Jetpack Compose (Modern Toolkit) |
| **Bahasa** | Kotlin (100%) | | **Bahasa Pemrograman** | Kotlin (100%) |
| **Lokasi** | Google Fused Location Provider API | | **Location Services** | Google Play Services (Fused Location) |
| **Database** | SQLite (Manajemen User Lokal) | | **Database Lokal** | SQLite (Manajemen User & Kredensial) |
| **Networking** | Java URLConnection (JSON Payload) | | **Networking** | Java HttpURLConnection (JSON Payload) |
| **Integrasi** | n8n Webhook & Google Sheets API | | **Automation Tool** | n8n.io (Webhook Workflow) |
| **Image Handling** | Android Graphics Bitmap & Base64 Encoding | | **Cloud Storage** | Google Sheets (Database Akhir) |
--- ---
## 🏗️ Arsitektur Data ## 🏗️ Arsitektur Data
### 1. Database Schema (SQLite) ### 1. Database Schema (SQLite)
Tabel `users` menyimpan kredensial aman di dalam memori internal perangkat: Tabel `users` menyimpan data profil mahasiswa di memori internal:
- `nama` (TEXT): Nama Lengkap Mahasiswa. - `nama` (TEXT): Nama lengkap mahasiswa.
- `npm` (TEXT - UNIQUE): Nomor Pokok Mahasiswa sebagai identitas unik. - `npm` (TEXT - UNIQUE): Identitas utama mahasiswa.
- `password` (TEXT): Kata sandi terenkripsi. - `password` (TEXT): Kata sandi akses akun.
### 2. JSON Payload Integration ### 2. Payload Data (JSON)
Data dikirim ke Webhook dengan struktur berikut: Setiap paket absensi yang dikirim memiliki struktur data berikut:
```json ```json
{ {
"npm": "2021xxxxxx", "npm": "20210710001",
"nama": "Nabila Suwandira", "nama": "Nabila Suwandira",
"latitude": -6.229728, "latitude": -6.229728,
"longitude": 106.989250, "longitude": 106.989250,
@ -55,46 +70,36 @@ Data dikirim ke Webhook dengan struktur berikut:
## 📱 Panduan Penggunaan ## 📱 Panduan Penggunaan
1. **Registrasi**: Pengguna baru harus mendaftarkan Nama, NPM, dan Password pada layar "Daftar Akun". 1. **Daftar Akun**: Masuk ke menu "Daftar Sekarang", isi Nama, NPM, dan Password.
2. **Login**: Masuk menggunakan NPM dan Password yang telah terdaftar. 2. **Login**: Masuk menggunakan NPM dan Password yang telah didaftarkan.
3. **Izin Akses**: Aplikasi akan meminta izin **Kamera** dan **Lokasi Presisi** (Wajib diberikan untuk melakukan absensi). 3. **Berikan Izin**: Berikan izin akses **Lokasi** dan **Kamera** saat diminta oleh sistem.
4. **Cek Lokasi**: Pastikan koordinat muncul. Jika koordinat belum muncul atau ingin diperbarui, klik tombol **Refresh Lokasi**. 4. **Verifikasi Lokasi**: Pastikan koordinat GPS muncul dengan benar. Gunakan tombol **Refresh** jika posisi kurang akurat.
5. **Ambil Foto**: Klik "AMBIL FOTO" untuk membuka kamera. Ambil foto wajah dengan jelas. 5. **Ambil Selfie**: Klik "AMBIL FOTO" untuk membuka kamera dan ambil foto wajah dengan jelas.
6. **Kirim**: Klik "KIRIM ABSENSI". Notifikasi akan muncul jika data berhasil diterima oleh server cloud. 6. **Submit Absensi**: Klik "KIRIM ABSENSI". Sistem akan memberikan notifikasi jika data telah diterima oleh server.
--- ---
## 🔧 Persyaratan Sistem ## 🔧 Instalasi & Persiapan
- **Min SDK**: API 28 (Android 9.0 Pie) 1. Clone repositori ini.
- **Target SDK**: API 34 (Android 14) 2. Buka project di **Android Studio (Ladybug 2024.2.1)** atau versi terbaru.
- **Hardware**: Perangkat harus memiliki sensor GPS dan Kamera belakang/depan. 3. Pastikan dependensi di `build.gradle.kts` sudah tersinkronisasi.
- **Internet**: Diperlukan koneksi aktif untuk mengirim data absensi. 4. Lakukan *Build & Run* ke perangkat fisik Android (Min API 28 / Android 9.0).
--- ---
## 🔐 Keamanan & Izin (Permissions) ## 📡 Monitoring Real-Time
Aplikasi mengimplementasikan standar keamanan Android: Admin dapat memantau status absensi secara langsung melalui:
- `ACCESS_FINE_LOCATION`: Untuk mendapatkan akurasi GPS terbaik. * **Live Notification**: [ntfy.ubharajaya.ac.id/EAS](https://ntfy.ubharajaya.ac.id/EAS)
- `CAMERA`: Digunakan hanya saat proses pengambilan foto bukti hadir. * **Database Sheets**: [Sheet Kehadiran Mahasiswa](https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0)
- `INTERNET`: Untuk sinkronisasi data ke database cloud Universitas.
--- ---
## 📊 Monitoring Real-Time ## 🎓 Informasi Project
Admin dan Mahasiswa dapat memverifikasi status pengiriman secara langsung: **Nama**: Nabila Suwandira
- **NTFY Channel**: [Live Notification EAS](https://ntfy.ubharajaya.ac.id/EAS) **Program Studi**: Teknik Informatika
- **Google Sheets Database**: [Sheet Kehadiran Mahasiswa](https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0)
---
## 🎓 Identitas Mahasiswa
**Nabila Suwandira**
**NPM**: [Input NPM Anda Disini]
**Prodi**: Teknik Informatika
**Instansi**: Universitas Bhayangkara Jakarta Raya **Instansi**: Universitas Bhayangkara Jakarta Raya
**Mata Kuliah**: Pemrograman Perangkat Bergerak **Mata Kuliah**: Pemrograman Perangkat Bergerak
**Project**: Evaluasi Akhir Semester (EAS) 2025-2026 **Project**: Evaluasi Akhir Semester (EAS) 2025-2026