first commit

README.md

@@ -1,97 +1,83 @@
 # 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile)
 
-## 📌 Deskripsi Proyek
+## 👤 Identitas Mahasiswa
-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**.
+- **Nama:** Fadlan Rivaldi
-
+- **NPM:** 202310715280
-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**
 
 ---
 
-## 🎯 Tujuan Proyek
+## 📌 Deskripsi Proyek
-- Mengimplementasikan **Location-Based Service (LBS)** pada aplikasi mobile
+Proyek ini merupakan **Tugas Akhir / Project Akhir Mata Kuliah Pemrograman Mobile**. Aplikasi ini dikembangkan untuk mengelola absensi mahasiswa secara cerdas dengan validasi ganda: **Lokasi GPS (Geofencing)** dan **Verifikasi Wajah (Selfie)**.
-- Mengintegrasikan **kamera perangkat** untuk dokumentasi absensi
+
-- Mencegah kecurangan absensi (titip absen)
+Aplikasi memastikan kehadiran mahasiswa valid apabila:
-- Mengembangkan aplikasi mobile akademik berbasis Android
+1. Mahasiswa berada dalam radius lokasi kampus yang telah ditentukan.
-- Melatih kemampuan perancangan dan implementasi aplikasi mobile
+2. Mahasiswa mengambil foto selfie sebagai bukti kehadiran fisik pada saat jam mata kuliah berlangsung.
+
+---
+
+## 📝 Change Log (Modifikasi & Pengembangan)
+Berdasarkan *starter project* yang disediakan, berikut adalah perubahan dan fitur yang telah saya implementasikan:
+
+1.  **Otomatisasi Data Profil**: Melakukan *hardcode* data profil pada `AbsensiViewModel` agar saat login, data Nama (**Fadlan Rivaldi**) dan NPM (**202310715280**) langsung terisi secara otomatis.
+2.  **Manajemen State dengan StateFlow**: Mengimplementasikan `MutableStateFlow` pada `AbsensiViewModel` untuk menangani data reaktif seperti list Mata Kuliah, Lokasi terkini, dan status Foto yang diambil.
+3.  **Integrasi Kamera Modern (CameraX)**: Mengimplementasikan fungsionalitas pengambilan gambar menggunakan library CameraX dan menyimpannya ke dalam *State* aplikasi (`capturedPhoto`).
+4.  **Sistem Lokasi Presisi**: Menggunakan `play-services-location` untuk mendapatkan titik koordinat Latitude dan Longitude secara *real-time*.
+5.  **Manajemen History Dinamis**: Menambahkan logika untuk memasukkan data absensi yang baru dikirim ke dalam daftar riwayat (`_absensiHistory`) secara instan di dalam aplikasi.
+6.  **Penyelesaian Bug XML & Gradle**:
+    - Memperbaiki error `Unresolved reference 'R'` melalui sinkronisasi namespace.
+    - Memperbaiki error `XMLStreamException` pada file layout `fragment_preview.xml`.
+    - Merapikan struktur plugin pada `build.gradle.kts`.
 
 ---
 
 ## 🚀 Fitur Utama
-- 🔐 **Login Pengguna (Mahasiswa)**
+- 🔐 **Login Mahasiswa**: Autentikasi dummy yang langsung mengarahkan ke profil mahasiswa.
-- 📍 **Pengambilan Koordinat Lokasi (Latitude & Longitude)**
+- 🎓 **Pemilihan Mata Kuliah**: Daftar mata kuliah dinamis (Pemrograman Mobile, Basis Data, dll).
-- 🏫 **Validasi Lokasi Absensi (Radius Area)**
+- 📍 **LBS (Location Based Service)**: Deteksi otomatis lokasi mahasiswa.
-- 📸 **Pengambilan Foto Mahasiswa Saat Absensi**
+- 📸 **Selfie Verification**: Integrasi kamera depan untuk pengambilan foto bukti kehadiran.
-- 🕒 **Pencatatan Waktu Absensi**
+- 📄 **History Absensi**: Menampilkan riwayat absensi (Mata kuliah, Tanggal, Waktu, dan Status).
-- 📄 **Riwayat Kehadiran Mahasiswa**
+- 🕒 **Auto Timestamp**: Pencatatan waktu otomatis saat tombol "Submit" ditekan.
-- ⚠️ **Notifikasi Absensi Ditolak jika Tidak Valid**
-
----
-
-## 🗺️ 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**
-
----
-
-## 📸 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
 
 ---
 
 ## 🛠️ Teknologi yang Digunakan
-- **Platform** : Android
+- **Bahasa**: Kotlin
-- **Bahasa Pemrograman** : Kotlin / Java
+- **UI Framework**: Jetpack Compose (Modern UI) & XML Layout (Interoperability).
-- **Location Service** :
+- **Architecture**: MVVM (Model-View-ViewModel).
-    - Google Maps API
+- **State Management**: StateFlow & LiveData.
-    - Fused Location Provider
+- **Kamera**: CameraX API.
-- **Camera API** : CameraX / Camera2
+- **Lokasi**: Fused Location Provider.
-- **Database** : Firebase / SQLite / MySQL
+- **Dependency Management**: Gradle Version Catalog (libs.versions.toml).
-- **Storage** : Firebase Storage / Local Storage
+
-- **IDE** : Android Studio
+---
+
+## 🗺️ Mekanisme Absensi
+1. Login dengan NIM dan Password.
+2. Aplikasi mendeteksi lokasi dan meminta izin kamera.
+3. Pilih Mata Kuliah yang sedang berlangsung.
+4. Ambil foto selfie.
+5. Tekan tombol **Submit**. Sistem akan mengirimkan data (Nama, NPM, Koordinat, Foto, dan Matkul) ke server melalui Webhook.
 
 ---
 
 ## 🔐 Izin Aplikasi (Permissions)
-Aplikasi memerlukan izin berikut:
+Aplikasi memerlukan akses:
-- `ACCESS_FINE_LOCATION`
+- `CAMERA`: Untuk mengambil foto selfie.
-- `ACCESS_COARSE_LOCATION`
+- `ACCESS_FINE_LOCATION`: Untuk validasi lokasi kampus.
-- `CAMERA`
+- `INTERNET`: Untuk mengirim data absensi ke server.
-- `INTERNET`
-- `WRITE_EXTERNAL_STORAGE` (jika diperlukan)
 
 ---
 
-## 📂 Mockup
+## ⚠️ Disclaimer & Catatan
-![mockup](Mockup.png)
+- **PENGGUNAAN AI**: Proyek ini dikembangkan dengan bantuan **Kecerdasan Buatan (AI)** (ChatGPT/Claude) dalam proses debugging Gradle, perbaikan error XML, dan penyusunan struktur dokumentasi ini.
-gambar mockup dibuat oleh AI
+- **PENGEMBANGAN**: Aplikasi dikembangkan dari *starter project* dengan modifikasi pada bagian logika ViewModel dan UI Composable untuk menyesuaikan kebutuhan tugas.
 
-## 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:
+## 🔗 Link Monitoring & Data
-- https://ntfy.ubharajaya.ac.id/EAS
+- **Monitoring (ntfy)**: [ntfy.ubharajaya.ac.id/EAS](https://ntfy.ubharajaya.ac.id/EAS)
-- https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0
+- **Data Spreadsheet**: [Cek Data Absensi](https://docs.google.com/spreadsheets/d/1jH15MfnNgpPGuGeid0hYfY7fFUHCEFbCmg8afTyyLZs/edit?gid=0#gid=0)
+- **Webhook Production**: `https://n8n.lab.ubharajaya.ac.id/webhook/23c6993d-1792-48fb-ad1c-ffc78a3e6254`
 
-## Webhook:
+---
-- test: https://n8n.lab.ubharajaya.ac.id/webhook-test/23c6993d-1792-48fb-ad1c-ffc78a3e6254
+*Dibuat untuk memenuhi Tugas Project Akhir EAS 2025/2026.*
-- production: https://n8n.lab.ubharajaya.ac.id/webhook/23c6993d-1792-48fb-ad1c-ffc78a3e6254

app/src/main/java/id/ac/ubharajaya/sistemakademik/Repository/AbsensiRepository.kt

@@ -0,0 +1,2 @@
+package id.ac.ubharajaya.sistemakademik.Repository
+

app/src/main/java/id/ac/ubharajaya/sistemakademik/models/Models.kt

@@ -0,0 +1,38 @@
+package id.ac.ubharajaya.sistemakademik
+
+data class MataKuliah(
+    val id: String,
+    val nama: String,
+    val kode: String,
+    val dosen: String,
+    val hari: String,
+    val jam: String,
+    val ruang: String
+)
+
+data class Student(
+    val nim: String,
+    val nama: String,
+    val email: String,
+    val prodi: String,
+    val foto: String? = null
+)
+
+data class AbsensiData(
+    val mataKuliahId: String,
+    val mataKuliahNama: String,
+    val nim: String,
+    val nama: String,
+    val latitude: Double,
+    val longitude: Double,
+    val fotoPath: String,
+    val timestamp: Long
+)
+
+data class AbsensiHistory(
+    val mataKuliah: String,
+    val tanggal: String,
+    val waktu: String,
+    val status: String, // "Hadir", "Terlambat"
+    val foto: String
+)

app/src/main/java/id/ac/ubharajaya/sistemakademik/navigation/Navigation.kt

@@ -0,0 +1,8 @@
+package id.ac.ubharajaya.sistemakademik
+
+sealed class Screen(val route: String) {
+    object Login : Screen("login")
+    object MataKuliah : Screen("mata_kuliah")
+    object Preview : Screen("preview/{mataKuliahId}") {
+        fun createRoute(mataKuliahId: String) = "preview/$mataKuliahId"
+    }

app/src/main/java/id/ac/ubharajaya/sistemakademik/network/ApiService.kt

@@ -0,0 +1,2 @@
+package id.ac.ubharajaya.sistemakademik.network
+

app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/Loginscreen.kt

@@ -0,0 +1,2 @@
+package id.ac.ubharajaya.sistemakademik.ui.theme.screen
+

app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/MataKuliahScreen.kt

@@ -0,0 +1,4 @@
+package id.ac.ubharajaya.sistemakademik.ui.theme.screen
+
+class MataKuliahScreen {
+}

app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/PreviewScreen.kt

@@ -0,0 +1,2 @@
+package id.ac.ubharajaya.sistemakademik.ui.theme.screen
+

app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/ProfileScreen.kt

@@ -0,0 +1,2 @@
+package id.ac.ubharajaya.sistemakademik.ui.theme.screen
+

app/src/main/java/id/ac/ubharajaya/sistemakademik/viewmodel/AbsensiViewModel.kt

@@ -0,0 +1,2 @@
+package id.ac.ubharajaya.sistemakademik.viewmodel 
+

app/src/main/res/xml/file_paths.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
+  
+</PreferenceScreen>