From f91fb981babf22a28924990dce0eac90499573e1 Mon Sep 17 00:00:00 2001 From: 202310715280-FADLAN-RIVALDI <202310715280@mhs.ubharajaya.ac.id> Date: Wed, 14 Jan 2026 17:48:46 +0700 Subject: [PATCH] first commit --- README.md | 136 ++++++++---------- .../Repository/AbsensiRepository.kt | 2 + .../sistemakademik/models/Models.kt | 38 +++++ .../sistemakademik/navigation/Navigation.kt | 8 ++ .../sistemakademik/network/ApiService.kt | 2 + .../ui/theme/screen/Loginscreen.kt | 2 + .../ui/theme/screen/MataKuliahScreen.kt | 4 + .../ui/theme/screen/PreviewScreen.kt | 2 + .../ui/theme/screen/ProfileScreen.kt | 2 + .../viewmodel/AbsensiViewModel.kt | 2 + app/src/main/res/xml/file_paths.xml | 4 + 11 files changed, 127 insertions(+), 75 deletions(-) create mode 100644 app/src/main/java/id/ac/ubharajaya/sistemakademik/Repository/AbsensiRepository.kt create mode 100644 app/src/main/java/id/ac/ubharajaya/sistemakademik/models/Models.kt create mode 100644 app/src/main/java/id/ac/ubharajaya/sistemakademik/navigation/Navigation.kt create mode 100644 app/src/main/java/id/ac/ubharajaya/sistemakademik/network/ApiService.kt create mode 100644 app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/Loginscreen.kt create mode 100644 app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/MataKuliahScreen.kt create mode 100644 app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/PreviewScreen.kt create mode 100644 app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/ProfileScreen.kt create mode 100644 app/src/main/java/id/ac/ubharajaya/sistemakademik/viewmodel/AbsensiViewModel.kt create mode 100644 app/src/main/res/xml/file_paths.xml diff --git a/README.md b/README.md index 9871f13..49712e8 100644 --- a/README.md +++ b/README.md @@ -1,97 +1,83 @@ # πŸ“± Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile) -## πŸ“Œ 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** +## πŸ‘€ Identitas Mahasiswa +- **Nama:** Fadlan Rivaldi +- **NPM:** 202310715280 --- -## 🎯 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 +## πŸ“Œ Deskripsi Proyek +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)**. + +Aplikasi memastikan kehadiran mahasiswa valid apabila: +1. Mahasiswa berada dalam radius lokasi kampus yang telah ditentukan. +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)** -- πŸ“ **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** - ---- - -## πŸ—ΊοΈ 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 +- πŸ” **Login Mahasiswa**: Autentikasi dummy yang langsung mengarahkan ke profil mahasiswa. +- πŸŽ“ **Pemilihan Mata Kuliah**: Daftar mata kuliah dinamis (Pemrograman Mobile, Basis Data, dll). +- πŸ“ **LBS (Location Based Service)**: Deteksi otomatis lokasi mahasiswa. +- πŸ“Έ **Selfie Verification**: Integrasi kamera depan untuk pengambilan foto bukti kehadiran. +- πŸ“„ **History Absensi**: Menampilkan riwayat absensi (Mata kuliah, Tanggal, Waktu, dan Status). +- πŸ•’ **Auto Timestamp**: Pencatatan waktu otomatis saat tombol "Submit" ditekan. --- ## πŸ› οΈ 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 +- **Bahasa**: Kotlin +- **UI Framework**: Jetpack Compose (Modern UI) & XML Layout (Interoperability). +- **Architecture**: MVVM (Model-View-ViewModel). +- **State Management**: StateFlow & LiveData. +- **Kamera**: CameraX API. +- **Lokasi**: Fused Location Provider. +- **Dependency Management**: Gradle Version Catalog (libs.versions.toml). + +--- + +## πŸ—ΊοΈ 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: -- `ACCESS_FINE_LOCATION` -- `ACCESS_COARSE_LOCATION` -- `CAMERA` -- `INTERNET` -- `WRITE_EXTERNAL_STORAGE` (jika diperlukan) +Aplikasi memerlukan akses: +- `CAMERA`: Untuk mengambil foto selfie. +- `ACCESS_FINE_LOCATION`: Untuk validasi lokasi kampus. +- `INTERNET`: Untuk mengirim data absensi ke server. --- -## πŸ“‚ Mockup -![mockup](Mockup.png) -gambar mockup dibuat oleh AI +## ⚠️ Disclaimer & Catatan +- **PENGGUNAAN AI**: Proyek ini dikembangkan dengan bantuan **Kecerdasan Buatan (AI)** (ChatGPT/Claude) dalam proses debugging Gradle, perbaikan error XML, dan penyusunan struktur dokumentasi ini. +- **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: -- 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 \ No newline at end of file +## πŸ”— Link Monitoring & Data +- **Monitoring (ntfy)**: [ntfy.ubharajaya.ac.id/EAS](https://ntfy.ubharajaya.ac.id/EAS) +- **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` + +--- +*Dibuat untuk memenuhi Tugas Project Akhir EAS 2025/2026.* \ No newline at end of file diff --git a/app/src/main/java/id/ac/ubharajaya/sistemakademik/Repository/AbsensiRepository.kt b/app/src/main/java/id/ac/ubharajaya/sistemakademik/Repository/AbsensiRepository.kt new file mode 100644 index 0000000..129987e --- /dev/null +++ b/app/src/main/java/id/ac/ubharajaya/sistemakademik/Repository/AbsensiRepository.kt @@ -0,0 +1,2 @@ +package id.ac.ubharajaya.sistemakademik.Repository + diff --git a/app/src/main/java/id/ac/ubharajaya/sistemakademik/models/Models.kt b/app/src/main/java/id/ac/ubharajaya/sistemakademik/models/Models.kt new file mode 100644 index 0000000..add5282 --- /dev/null +++ b/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 +) \ No newline at end of file diff --git a/app/src/main/java/id/ac/ubharajaya/sistemakademik/navigation/Navigation.kt b/app/src/main/java/id/ac/ubharajaya/sistemakademik/navigation/Navigation.kt new file mode 100644 index 0000000..6840c53 --- /dev/null +++ b/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" + } \ No newline at end of file diff --git a/app/src/main/java/id/ac/ubharajaya/sistemakademik/network/ApiService.kt b/app/src/main/java/id/ac/ubharajaya/sistemakademik/network/ApiService.kt new file mode 100644 index 0000000..a40c5f6 --- /dev/null +++ b/app/src/main/java/id/ac/ubharajaya/sistemakademik/network/ApiService.kt @@ -0,0 +1,2 @@ +package id.ac.ubharajaya.sistemakademik.network + diff --git a/app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/Loginscreen.kt b/app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/Loginscreen.kt new file mode 100644 index 0000000..85e80c1 --- /dev/null +++ b/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 + diff --git a/app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/MataKuliahScreen.kt b/app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/MataKuliahScreen.kt new file mode 100644 index 0000000..74a5ba0 --- /dev/null +++ b/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 { +} \ No newline at end of file diff --git a/app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/PreviewScreen.kt b/app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/PreviewScreen.kt new file mode 100644 index 0000000..85e80c1 --- /dev/null +++ b/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 + diff --git a/app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/ProfileScreen.kt b/app/src/main/java/id/ac/ubharajaya/sistemakademik/ui/theme/screen/ProfileScreen.kt new file mode 100644 index 0000000..85e80c1 --- /dev/null +++ b/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 + diff --git a/app/src/main/java/id/ac/ubharajaya/sistemakademik/viewmodel/AbsensiViewModel.kt b/app/src/main/java/id/ac/ubharajaya/sistemakademik/viewmodel/AbsensiViewModel.kt new file mode 100644 index 0000000..494debf --- /dev/null +++ b/app/src/main/java/id/ac/ubharajaya/sistemakademik/viewmodel/AbsensiViewModel.kt @@ -0,0 +1,2 @@ +package id.ac.ubharajaya.sistemakademik.viewmodel + diff --git a/app/src/main/res/xml/file_paths.xml b/app/src/main/res/xml/file_paths.xml new file mode 100644 index 0000000..a39aafb --- /dev/null +++ b/app/src/main/res/xml/file_paths.xml @@ -0,0 +1,4 @@ + + + + \ No newline at end of file