README.md

2026-01-14 15:58:07 +07:00 · 2026-01-14 15:58:07 +07:00 · 7b0928e451
commit 7b0928e451
parent 2e51c31af8
1 changed files with 76 additions and 73 deletions
--- a/README.md
+++ b/README.md
@ -1,97 +1,100 @@
-# 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile)
+# 🚀 Smart-Attendance: Sistem Absensi Mahasiswa Terintegrasi Cloud

-## 📌 Deskripsi Proyek
-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**
+**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**.

 ---

-## 🎯 Tujuan Proyek
- Mengimplementasikan **Location-Based Service (LBS)** pada aplikasi mobile
- Mengintegrasikan **kamera perangkat** untuk dokumentasi absensi
- Mencegah kecurangan absensi (titip absen)
- Mengembangkan aplikasi mobile akademik berbasis Android
- Melatih kemampuan perancangan dan implementasi aplikasi mobile
+## 🌟 Fitur Utama
+
+-   **Otentikasi Ganda**: Sistem login dan registrasi berbasis database **SQLite** lokal untuk memastikan akun unik per mahasiswa (berdasarkan NPM).
+-   **Geo-Fencing Validation**: Mendeteksi lokasi presisi hingga 6 digit desimal menggunakan *High Accuracy Priority* dari Google Play Services.
+-   **Visual Identity Verification**: Pengambilan foto wajah langsung (*Real-time Camera*) yang dienkripsi ke format **Base64** untuk bukti kehadiran autentik.
+-   **Dashboard Akademik**: Mahasiswa dapat memilih atau memasukkan Mata Kuliah yang sedang berlangsung.
+-   **Sinkronisasi Instan**: Data dikirim dalam milidetik ke server cloud menggunakan protokol `HttpURLConnection` yang ringan.
+-   **UI Modern & Adaptif**: Antarmuka responsif dengan desain kartu modern dan tema gradasi Hijau-Kuning-Putih yang segar.

 ---

-## 🚀 Fitur Utama
- 🔐 **Login Pengguna (Mahasiswa)**
- 📍 **Pengambilan Koordinat Lokasi (Latitude & Longitude)**
- 🏫 **Validasi Lokasi Absensi (Radius Area)**
- 📸 **Pengambilan Foto Mahasiswa Saat Absensi**
- 🕒 **Pencatatan Waktu Absensi**
- 📄 **Riwayat Kehadiran Mahasiswa**
- ⚠️ **Notifikasi Absensi Ditolak jika Tidak Valid**
+## 🛠️ Stack Teknologi
+
+| Komponen | Teknologi |
+| :--- | :--- |
+| **Framework UI** | Jetpack Compose (Modern Toolkit) |
+| **Bahasa** | Kotlin (100%) |
+| **Lokasi** | Google Fused Location Provider API |
+| **Database** | SQLite (Manajemen User Lokal) |
+| **Networking** | Java URLConnection (JSON Payload) |
+| **Integrasi** | n8n Webhook & Google Sheets API |
+| **Image Handling** | Android Graphics Bitmap & Base64 Encoding |

 ---

-## 🗺️ Mekanisme Absensi Berbasis Lokasi dan Foto
-1. Mahasiswa melakukan **login**
-2. Memilih menu **Absensi**
-3. Sistem meminta:
-    - Izin **akses lokasi**
-    - Izin **akses kamera**
-4. Aplikasi mengambil:
-    - 📍 **Koordinat lokasi mahasiswa**
-    - 📸 **Foto mahasiswa secara real-time**
-5. Sistem melakukan validasi:
-    - Lokasi berada dalam **radius absensi**
-    - Foto berhasil diambil
-6. Jika valid → **Absensi berhasil**
-7. Jika tidak valid → **Absensi ditolak**
+## 🏗️ Arsitektur Data
+
+### 1. Database Schema (SQLite)
+Tabel `users` menyimpan kredensial aman di dalam memori internal perangkat:
+- `nama` (TEXT): Nama Lengkap Mahasiswa.
+- `npm` (TEXT - UNIQUE): Nomor Pokok Mahasiswa sebagai identitas unik.
+- `password` (TEXT): Kata sandi terenkripsi.
+
+### 2. JSON Payload Integration
+Data dikirim ke Webhook dengan struktur berikut:
+```json
+{
+  "npm": "2021xxxxxx",
+  "nama": "Nabila Suwandira",
+  "latitude": -6.229728,
+  "longitude": 106.989250,
+  "mata_kuliah": "Pemrograman Perangkat Bergerak",
+  "timestamp": 1739456789000,
+  "foto_base64": "/9j/4AAQSkZJRg..."
+}
+```

 ---

-## 📸 Pengambilan Foto Saat Absensi
- Foto diambil menggunakan **kamera depan (selfie)**
- Foto hanya dapat diambil **saat proses absensi**
- Foto disimpan sebagai **bukti kehadiran**
- Foto dapat digunakan untuk:
-    - Verifikasi manual oleh dosen
-    - Dokumentasi akademik
+## 📱 Panduan Penggunaan
+
+1.  **Registrasi**: Pengguna baru harus mendaftarkan Nama, NPM, dan Password pada layar "Daftar Akun".
+2.  **Login**: Masuk menggunakan NPM dan Password yang telah terdaftar.
+3.  **Izin Akses**: Aplikasi akan meminta izin **Kamera** dan **Lokasi Presisi** (Wajib diberikan untuk melakukan absensi).
+4.  **Cek Lokasi**: Pastikan koordinat muncul. Jika koordinat belum muncul atau ingin diperbarui, klik tombol **Refresh Lokasi**.
+5.  **Ambil Foto**: Klik "AMBIL FOTO" untuk membuka kamera. Ambil foto wajah dengan jelas.
+6.  **Kirim**: Klik "KIRIM ABSENSI". Notifikasi akan muncul jika data berhasil diterima oleh server cloud.

 ---

-## 🛠️ Teknologi yang Digunakan
- **Platform** : Android
- **Bahasa Pemrograman** : Kotlin / Java
- **Location Service** :
-    - Google Maps API
-    - Fused Location Provider
- **Camera API** : CameraX / Camera2
- **Database** : Firebase / SQLite / MySQL
- **Storage** : Firebase Storage / Local Storage
- **IDE** : Android Studio
+## 🔧 Persyaratan Sistem
+
+-   **Min SDK**: API 28 (Android 9.0 Pie)
+-   **Target SDK**: API 34 (Android 14)
+-   **Hardware**: Perangkat harus memiliki sensor GPS dan Kamera belakang/depan.
+-   **Internet**: Diperlukan koneksi aktif untuk mengirim data absensi.

 ---

-## 🔐 Izin Aplikasi (Permissions)
-Aplikasi memerlukan izin berikut:
- `ACCESS_FINE_LOCATION`
- `ACCESS_COARSE_LOCATION`
- `CAMERA`
- `INTERNET`
- `WRITE_EXTERNAL_STORAGE` (jika diperlukan)
+## 🔐 Keamanan & Izin (Permissions)
+
+Aplikasi mengimplementasikan standar keamanan Android:
+- `ACCESS_FINE_LOCATION`: Untuk mendapatkan akurasi GPS terbaik.
+- `CAMERA`: Digunakan hanya saat proses pengambilan foto bukti hadir.
+- `INTERNET`: Untuk sinkronisasi data ke database cloud Universitas.

 ---

-## 📂 Mockup
-![mockup](Mockup.png)
-gambar mockup dibuat oleh AI
+## 📊 Monitoring Real-Time

-## Catatan:
- Starter project ini dibuat berbantukan AI
- 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. 
+Admin dan Mahasiswa dapat memverifikasi status pengiriman secara langsung:
+-   **NTFY Channel**: [Live Notification EAS](https://ntfy.ubharajaya.ac.id/EAS)
+-   **Google Sheets Database**: [Sheet Kehadiran Mahasiswa](https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0)

-## Pengecekan:
- https://ntfy.ubharajaya.ac.id/EAS
- https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/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 Mahasiswa
+
+**Nabila Suwandira**  
+**NPM**: [Input NPM Anda Disini]  
+**Prodi**: Teknik Informatika  
+**Instansi**: Universitas Bhayangkara Jakarta Raya  
+**Mata Kuliah**: Pemrograman Perangkat Bergerak  
+**Project**: Evaluasi Akhir Semester (EAS) 2025-2026