Branch sebelum Redesign

CHANGELOG.md

@@ -0,0 +1,71 @@
+# Changelog
+
+Semua perubahan penting pada proyek Aplikasi Absensi Akademik didokumentasikan dalam file ini.
+
+## [Unreleased] - Versi Terbaru (Redesign & Backend Integration)
+
+Perubahan besar-besaran dilakukan pada arsitektur aplikasi, beralih dari aplikasi *single-screen* sederhana menjadi aplikasi manajemen akademik yang komprehensif dengan autentikasi dan validasi keamanan.
+
+### ✨ Fitur Baru (Added)
+- **Sistem Autentikasi**:
+    - Menambahkan layar **Login** dan **Register**.
+    - Integrasi **JWT Authentication** (penyimpanan token via `SharedPreferences`).
+    - Manajemen sesi pengguna (Auto-login jika token tersimpan).
+- **Manajemen Jadwal & Mata Kuliah**:
+    - Menambahkan fitur pengambilan data **Jadwal Kuliah** hari ini dari database.
+    - Dropdown pemilihan mata kuliah saat melakukan absensi.
+- **Validasi Keamanan Tingkat Lanjut**:
+    - **Geofencing**: Validasi lokasi dalam radius 500m dari koordinat kampus.
+    - **Anti-Fake GPS**: Logika deteksi aplikasi *Mock Location* untuk mencegah kecurangan.
+    - **Face Detection**: Integrasi **CameraX + ML Kit** (tersirat dalam logika kamera baru) untuk mewajibkan deteksi wajah saat status "HADIR".
+- **Fitur Kamera Kustom**:
+    - Mengganti intent kamera bawaan (`MediaStore`) dengan **CameraX** tertanam dalam UI.
+    - Fitur overlay kamera untuk panduan posisi wajah/dokumen.
+    - Dukungan kamera depan (selfie) dan belakang (dokumen).
+- **Riwayat & Profil**:
+    - Menambahkan tab **Riwayat Absensi** untuk melihat log kehadiran dan bukti foto.
+    - Menambahkan tab **Profil** yang menampilkan data mahasiswa dan fitur Logout.
+- **Multi-Status Absensi**:
+    - Dukungan untuk status **HADIR**, **SAKIT**, dan **IZIN**.
+    - Logika validasi berbeda untuk setiap status (Sakit/Izin tidak butuh radius lokasi).
+
+### 🎨 Antarmuka & UX (Changed)
+- **UI Overhaul (Material3)**:
+    - Redesign total menggunakan **Jetpack Compose Material3**.
+    - Penerapan tema identitas kampus (**Gold & Maroon**).
+    - Penggunaan komponen UI modern: `Card`, `NavigationBar` (Bottom Nav), `Gradient Button`.
+- **Navigasi**:
+    - Implementasi **Bottom Navigation Bar** dengan 4 menu utama (Absensi, Kelas, Riwayat, Profil).
+    - Transisi antar layar (Login <-> Main <-> Register).
+- **Feedback User**:
+    - Loading indicator saat proses API berjalan.
+    - Dialog error dan sukses yang lebih informatif dibandingkan `Toast` sederhana.
+
+### ⚙️ Teknis & Backend (Changed)
+- **Migrasi API**:
+    - **Sebelumnya**: Mengirim data hardcoded langsung ke Webhook N8N via `HttpURLConnection`.
+    - **Sekarang**: Berkomunikasi dengan **Backend Python Flask** (`/api/auth`, `/api/absensi`, `/api/jadwal`). Backend yang kemudian meneruskan data ke N8N.
+- **Struktur Kode**:
+    - Refactoring dari *Single Activity Monolith* menjadi struktur modular.
+    - Pemisahan logic ke dalam:
+        - `AppConstants` (Konfigurasi URL & Koordinat).
+        - `UserPreferences` (Manajemen sesi lokal).
+        - `Data Classes` (Mahasiswa, Jadwal, Riwayat).
+        - Helper functions (Bitmap Converter, Distance Calculation).
+
+### 🔥 Dihapus (Removed)
+- Menghapus pengiriman data hardcoded (NPM "12345") pada fungsi `kirimKeN8n`.
+- Menghapus penggunaan `MediaStore.ACTION_IMAGE_CAPTURE` (Intent kamera eksternal).
+- Menghapus tampilan *single-screen* sederhana tanpa navigasi.
+
+---
+
+## [Legacy] - Versi Awal (Sebelum Redesign)
+
+Versi purwarupa (prototype) untuk pengujian fungsionalitas dasar.
+
+### Fitur
+- Pengambilan titik koordinat GPS sederhana (`FusedLocationProvider`).
+- Pengambilan foto menggunakan aplikasi kamera bawaan HP (`Intent`).
+- Pengiriman data dummy langsung ke Webhook N8N.
+- Tampilan UI dasar menggunakan `Column` dan `Button` standar.

README.md

@@ -1,95 +1,101 @@
-# 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile)
+# 📱 Aplikasi Absensi Akademik UBHARA Jaya (Mobile & Backend)
+
+[📋 Changelog](./CHANGELOG.md)
 
 ## 📌 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**.
+Proyek ini merupakan **Tugas Project Akhir Mata Kuliah Pemrograman Mobile** yang mengimplementasikan sistem absensi akademik berbasis **Client-Server**. Aplikasi mobile dibangun menggunakan **Kotlin (Jetpack Compose)**, sedangkan sisi server menggunakan **Python Flask** dengan database **MySQL**.
 
-Aplikasi ini dirancang untuk meningkatkan **validitas kehadiran mahasiswa**, dengan memastikan bahwa absensi hanya dapat dilakukan apabila mahasiswa:
+Sistem ini dirancang dengan validasi ketat menggunakan **Geofencing (GPS)** dan **Deteksi Wajah (Face Detection)** untuk status kehadiran "Hadir", serta mendukung pengiriman bukti dokumen untuk status "Sakit/Izin". Seluruh data terintegrasi secara real-time ke **N8N Webhook** untuk pelaporan otomatis.
-1. Berada pada **lokasi yang telah ditentukan**, dan
-2. Melakukan **pengambilan foto (selfie) secara langsung saat absensi**
 
 ---
 
 ## 🎯 Tujuan Proyek
-- Mengimplementasikan **Location-Based Service (LBS)** pada aplikasi mobile
+- Mengimplementasikan arsitektur **REST API** antara Android dan Python Flask.
-- Mengintegrasikan **kamera perangkat** untuk dokumentasi absensi
+- Menerapkan **Face Detection** menggunakan CameraX untuk memvalidasi kehadiran fisik mahasiswa.
-- Mencegah kecurangan absensi (titip absen)
+- Mencegah kecurangan absensi dengan fitur deteksi **Fake GPS**.
-- Mengembangkan aplikasi mobile akademik berbasis Android
+- Mengelola status kehadiran otomatis (**Auto-Alfa**) pada server jika mahasiswa lupa absen.
-- Melatih kemampuan perancangan dan implementasi aplikasi mobile
+- Melatih kemampuan Fullstack Mobile Development (Backend, Database, & Mobile UI).
 
 ---
 
 ## 🚀 Fitur Utama
-- 🔐 **Login Pengguna (Mahasiswa)**
+
-- 📍 **Pengambilan Koordinat Lokasi (Latitude & Longitude)**
+### 📱 Sisi Mobile (Android - Jetpack Compose)
-- 🏫 **Validasi Lokasi Absensi (Radius Area)**
+- **Modern UI**: Antarmuka modern menggunakan **Material3** & **Jetpack Compose**.
-- 📸 **Pengambilan Foto Mahasiswa Saat Absensi**
+- **Smart Attendance**:
-- 🕒 **Pencatatan Waktu Absensi**
+    - **Hadir**: Wajib berada di radius kampus & Wajib deteksi wajah (Real-time).
-- 📄 **Riwayat Kehadiran Mahasiswa**
+    - **Sakit/Izin**: Wajib upload foto surat dokter/bukti (Tanpa validasi radius).
-- ⚠️ **Notifikasi Absensi Ditolak jika Tidak Valid**
+- **Anti-Fraud**: Sistem mendeteksi dan menolak jika pengguna mengaktifkan **Fake GPS/Mock Location**.
+- **Riwayat & Bukti**: Mahasiswa dapat melihat riwayat kehadiran beserta foto bukti yang tersimpan di server.
+- **Profil Mahasiswa**: Menampilkan data akademik dan fitur logout.
+
+### 💻 Sisi Backend (Python Flask)
+- **JWT Authentication**: Keamanan berbasis token untuk setiap request.
+- **Auto-Alfa Trigger**: Sistem otomatis menandai "TIDAK HADIR" jika jam kuliah berakhir dan mahasiswa belum absen.
+- **N8N Integration**: Data absensi yang valid dikirim otomatis ke webhook N8N untuk notifikasi/reporting.
+- **Image Handling**: Kompresi foto (Base64) otomatis untuk efisiensi penyimpanan database.
 
 ---
 
-## 🗺️ Mekanisme Absensi Berbasis Lokasi dan Foto
+## 🗺️ Mekanisme Absensi
-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**
 
----
+### 1. Absensi Status "HADIR"
+1. Mahasiswa memilih Jadwal Kelas yang aktif.
+2. Sistem mengecek **GPS**:
+    - Apakah di dalam radius **500m** dari kampus?
+    - Apakah terdeteksi aplikasi **Fake GPS**?
+3. Sistem membuka **Kamera Deteksi Wajah**:
+    - Tombol shutter hanya aktif jika wajah terdeteksi.
+4. Data (Lokasi + Foto Wajah) dikirim ke server.
 
-## 📸 Pengambilan Foto Saat Absensi
+### 2. Absensi Status "SAKIT / IZIN"
-- Foto diambil menggunakan **kamera depan (selfie)**
+1. Mahasiswa memilih status Sakit atau Izin.
-- Foto hanya dapat diambil **saat proses absensi**
+2. Validasi lokasi dilewati (bisa absen dari rumah/RS).
-- Foto disimpan sebagai **bukti kehadiran**
+3. Sistem membuka **Kamera Dokumen** (Tanpa deteksi wajah).
-- Foto dapat digunakan untuk:
+4. Mahasiswa memfoto surat keterangan.
-    - Verifikasi manual oleh dosen
+5. Data dikirim ke server.
-    - Dokumentasi akademik
+
+### 3. Logika Auto-Alfa (Server)
+- Setiap kali jadwal dimuat, server mengecek jadwal yang `jam_selesai < jam_sekarang`.
+- Jika mahasiswa belum ada record absensi pada jam tersebut, server otomatis menginput status **"TIDAK HADIR"**.
 
 ---
 
 ## 🛠️ Teknologi yang Digunakan
-- **Platform** : Android
+- **Mobile Platform**: Android (Kotlin)
-- **Bahasa Pemrograman** : Kotlin / Java
+- **UI Framework**: Jetpack Compose
-- **Location Service** :
+- **Camera Engine**: CameraX + ML Kit (Face Analysis)
-    - Google Maps API
+- **Backend Framework**: Python Flask
-    - Fused Location Provider
+- **Database**: MySQL
-- **Camera API** : CameraX / Camera2
+- **Integrasi**: N8N Webhook
-- **Database** : Firebase / SQLite / MySQL
+- **Protocol**: HTTP/REST (JSON)
-- **Storage** : Firebase Storage / Local Storage
-- **IDE** : Android Studio
 
 ---
 
 ## 🔐 Izin Aplikasi (Permissions)
 Aplikasi memerlukan izin berikut:
-- `ACCESS_FINE_LOCATION`
+- `INTERNET`: Koneksi ke Server API.
-- `ACCESS_COARSE_LOCATION`
+- `ACCESS_FINE_LOCATION`: Validasi koordinat presisi tinggi.
-- `CAMERA`
+- `ACCESS_COARSE_LOCATION`: Validasi koordinat jaringan.
-- `INTERNET`
+- `CAMERA`: Pengambilan foto bukti kehadiran & deteksi wajah.
-- `WRITE_EXTERNAL_STORAGE` (jika diperlukan)
 
 ---
 
 ## 📂 Mockup
 ![mockup](Mockup.png)
 
-## Catatan:
+## Catatan Konfigurasi:
-- Kembangkan project dari starter yang sudah disediakan, tidak membuat dari awal.
+- **Server**: Pastikan `app.py` berjalan (`python app.py`) pada jaringan yang sama dengan HP.
-- Untuk koordinat bisa ditambah/kurangi angka tertentu agar tidak memunculkan koordinat rumah masing-masing, data awal tetap dari GPS. 
+- **Endpoint**: Sesuaikan `BASE_URL` pada file `MainActivity.kt` (Object `AppConstants`) dengan IP Laptop Anda.
- 
+  ```kotlin
-## Pengecekan:
+  const val BASE_URL = "[http://192.168.](http://192.168.)x.x:5000"
-- https://ntfy.ubharajaya.ac.id/EAS
+  ```
-- https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0
+- **Fake GPS**: Pastikan mematikan aplikasi Mock Location saat pengujian fitur Hadir.
 
-## Webhook:
+## Pengecekan & Monitoring:
-- test: https://n8n.lab.ubharajaya.ac.id/webhook-test/23c6993d-1792-48fb-ad1c-ffc78a3e6254
+- **Monitoring**: https://ntfy.ubharajaya.ac.id/EAS
-- production: https://n8n.lab.ubharajaya.ac.id/webhook/23c6993d-1792-48fb-ad1c-ffc78a3e6254
+- **Data Spreadsheet**: https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0
+
+## Webhook N8N:
+- **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

app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/ic_launcher_background"/>
+    <foreground android:drawable="@mipmap/ic_launcher_foreground"/>
+</adaptive-icon>

app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/ic_launcher_background"/>
+    <foreground android:drawable="@mipmap/ic_launcher_foreground"/>
+</adaptive-icon>

app/src/main/res/mipmap-anydpi/ic_launcher.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
-    <background android:drawable="@drawable/ic_launcher_background" />
-    <foreground android:drawable="@drawable/ic_launcher_foreground" />
-    <monochrome android:drawable="@drawable/ic_launcher_foreground" />
-</adaptive-icon>

app/src/main/res/mipmap-anydpi/ic_launcher_round.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
-    <background android:drawable="@drawable/ic_launcher_background" />
-    <foreground android:drawable="@drawable/ic_launcher_foreground" />
-    <monochrome android:drawable="@drawable/ic_launcher_foreground" />
-</adaptive-icon>

app/src/main/res/values/ic_launcher_background.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="ic_launcher_background">#FFFFFF</color>
+</resources>