diff --git a/README.md b/README.md index 9871f13..f3d4497 100644 --- 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. - -## Pengecekan: -- https://ntfy.ubharajaya.ac.id/EAS -- https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0 +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) -## 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 \ No newline at end of file +--- + +## πŸŽ“ 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