Update README.md

README.md

@@ -1,97 +1,290 @@
-# 📱 Aplikasi Absensi Akademik Berbasis Koordinat dan Foto (Mobile)
+# Sistem Akademik - Aplikasi Absensi Mahasiswa
 
-## 📌 Deskripsi Proyek
+Aplikasi mobile untuk sistem absensi akademik dengan fitur GPS tracking, pengambilan foto, dan manajemen mata kuliah. Dibangun menggunakan **Kotlin** dan **Jetpack Compose** dengan Material Design 3.
-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:
+## 🎯 Fitur Utama
-1. Berada pada **lokasi yang telah ditentukan**, dan
+
-2. Melakukan **pengambilan foto (selfie) secara langsung saat absensi**
+### 1. **Absensi Akademik**
+- Pengambilan lokasi real-time menggunakan GPS
+- Capture foto selfie untuk verifikasi kehadiran
+- Pemilihan mata kuliah yang sedang diambil
+- Submit absensi langsung ke server N8N
+- Riwayat kehadiran dengan detail lengkap
+
+### 2. **Manajemen Mata Kuliah**
+- Daftar mata kuliah dengan informasi lengkap
+- Detail dosen pengampu
+- Lokasi/ruangan kuliah
+- Jumlah SKS (Sistem Kredit Semester)
+
+### 3. **Profil Mahasiswa**
+- Informasi dasar mahasiswa
+- Program studi
+- Tahun akademik dan semester
+- Status akademik
+
+### 4. **Keamanan**
+- Login dengan NPM dan password
+- Permission handling untuk camera dan lokasi
+- Data encryption untuk komunikasi server
+
+## 📋 Requirements
+
+- **Android SDK**: 24 (API Level 24 - Android 7.0) atau lebih tinggi
+- **Kotlin**: 1.9+
+- **Compose**: 1.5.3+
+- **Google Play Services**: Location API v21.0.1
+
+## 🚀 Instalasi
+
+### 1. Clone Repository
+```bash
+git clone <repository-url>
+cd sistem-akademik
+```
+
+### 2. Setup Build.gradle
+Copy seluruh kode dari artifact `build.gradle (Module: app)` ke file:
+```
+app/build.gradle
+```
+
+Kemudian sync gradle:
+- Klik **"Sync Now"** di Android Studio
+
+### 3. Copy File Kotlin
+Salin 3 file Kotlin ke folder: `app/src/main/java/id/ac/ubharajaya/sistemakademik/`
+
+Files:
+- `Absensi.kt` - Data class untuk absensi
+- `LoginActivity.kt` - Login screen
+- `MainActivity.kt` - Main application
+
+### 4. Update AndroidManifest.xml
+Lokasi: `app/src/main/AndroidManifest.xml`
+
+Pastikan sudah ada:
+```xml
+<uses-permission android:name="android.permission.INTERNET"/>
+<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
+<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
+<uses-permission android:name="android.permission.CAMERA"/>
+```
+
+### 5. Clean & Build
+```
+Build → Clean Project
+Build → Rebuild Project
+```
+
+### 6. Run Aplikasi
+- Tekan **Shift + F10** atau klik tombol **Run**
+- Pilih emulator atau device
+- Tunggu app launch
+
+## 🔐 Login Credentials
+
+**Demo Account:**
+- **NPM**: `202310715038`
+- **Password**: `Nuryuda28`
+
+> ⚠️ Untuk production, ganti dengan system backend authentication yang proper!
+
+## 📱 Cara Penggunaan
+
+### Tab 1: Absensi Akademik
+
+1. **Ambil Lokasi**
+   - Aplikasi otomatis mengambil lokasi GPS saat pertama kali dibuka
+   - Izinkan akses lokasi saat diminta
+
+2. **Ambil Foto**
+   - Klik tombol "Ambil Foto"
+   - Izinkan akses kamera
+   - Ambil selfie untuk verifikasi
+
+3. **Kirim Absensi**
+   - Pastikan semua data lengkap (lokasi, foto, mata kuliah)
+   - Klik tombol "Kirim Absensi"
+   - Tunggu konfirmasi dari server
+
+4. **Lihat Riwayat**
+   - Scroll ke bawah untuk melihat riwayat kehadiran
+   - Setiap record menampilkan detail lengkap
+
+### Tab 2: Profil
+
+- Informasi dasar mahasiswa
+- Program studi
+- Status akademik
+- Tahun akademik dan semester
+
+## 🔄 Integrasi Server
+
+### N8N Webhook
+
+Aplikasi mengirim data absensi ke webhook N8N:
+
+```
+URL: https://n8n.lab.ubharajaya.ac.id/webhook/23c6993d-1792-48fb-ad1c-ffc78a3e6254
+Method: POST
+Content-Type: application/json
+```
+
+**Data yang dikirim:**
+```json
+{
+  "npm": "202310715038",
+  "nama": "Nuryuda Maulana Fahmi",
+  "latitude": -6.123456,
+  "longitude": 106.123456,
+  "timestamp": 1705225800000,
+  "waktu": "14 Jan 2024 10:30:00",
+  "foto_base64": "base64_encoded_image_data"
+}
+```
+
+## 🛠️ Troubleshooting
+
+### Error: "Cannot find symbol 'School'"
+**Solusi:** Pastikan import icons di MainActivity.kt sudah benar
+```kotlin
+import androidx.compose.material.icons.filled.School
+import androidx.compose.material.icons.filled.CameraAlt
+```
+
+### Error: "LocationServices not found"
+**Solusi:** Pastikan dependency play-services-location ada di build.gradle:
+```gradle
+implementation 'com.google.android.gms:play-services-location:21.0.1'
+```
+
+### Error: "Permission denied untuk camera/lokasi"
+**Solusi:** 
+- Untuk emulator: Settings > Apps > Permissions > izinkan akses
+- Untuk device: Buka Settings > Apps > Sistem Akademik > Permissions
+
+### Error: "Gradle Sync Failed"
+**Solusi:**
+```
+1. File → Invalidate Caches and Restart
+2. Atau close & open ulang Android Studio
+3. Build → Clean Project
+4. Build → Sync with File System
+```
+
+### Foto tidak keluar di riwayat
+**Solusi:** Pastikan bitmap compression berhasil, check logcat untuk error
+
+### Lokasi menunjukkan "Lokasi tidak tersedia"
+**Solusi:**
+- Emulator: Gunakan GPS emulation di Android Virtual Device
+- Device: Turn on Location services & izinkan akses GPS
+
+## 📊 Struktur Project
+
+```
+sistemakademik/
+├── Absensi.kt                    # Data class absensi
+├── LoginActivity.kt              # Login screen
+├── MainActivity.kt               # Main app dengan 3 tab
+├── ui/
+│   └── theme/
+│       └── Theme.kt              # Material Design 3 theme
+├── res/
+│   ├── values/
+│   │   └── strings.xml
+│   └── drawable/
+└── AndroidManifest.xml
+```
+
+## 🔧 Customization
+
+### Ganti Data Mata Kuliah
+Edit function `getDaftarMataKuliah()` di MainActivity.kt:
+
+```kotlin
+fun getDaftarMataKuliah(): List<MataKuliah> {
+    return listOf(
+        MataKuliah(
+            id = "1",
+            nama = "Nama Mata Kuliah",
+            kode = "IF-401",
+            dosen = "Nama Dosen",
+            ruangan = "Lokasi Ruang",
+            sks = 3
+        ),
+        // Tambah lebih banyak mata kuliah
+    )
+}
+```
+
+### Ganti Webhook URL
+Edit di MainActivity.kt function `kirimKeN8n()`:
+
+```kotlin
+val url = URL("https://your-webhook-url-here")
+```
+
+### Ganti Data Mahasiswa
+Edit di AbsensiScreen function:
+
+```kotlin
+val absensi = Absensi(
+    npm = "NPM_KAMU",
+    nama = "NAMA_KAMU",
+    latitude = latitude!!,
+    longitude = longitude!!,
+    waktu = waktu,
+    foto = foto!!
+)
+```
+
+## 📦 Dependencies
+
+| Library | Version | Purpose |
+|---------|---------|---------|
+| androidx.compose.ui | 1.5.3 | UI Framework |
+| androidx.compose.material3 | 1.1.1 | Material Design 3 |
+| com.google.android.gms:play-services-location | 21.0.1 | GPS Location |
+| org.json | 20230227 | JSON Handling |
+
+## 🎨 Design
+
+- **Material Design 3** dengan sistem warna yang konsisten
+- **Bottom Navigation Bar** untuk navigasi antar halaman
+- **Card-based Layout** untuk presentasi data
+- **Rounded Corners** di semua elemen UI
+- **Icon-based Navigation** untuk UX yang lebih baik
+
+## 📝 License
+
+Proyek ini dibuat untuk keperluan akademik di Universitas Bhayangkara Jakarta Raya.
+
+## 👥 Author
+
+- **Name**: Nuryuda Maulana Fahmi
+- **NPM**: 202310715038
+- **University**: Universitas Bhayangkara Jakarta Raya
+
+## 📞 Support
+
+Untuk pertanyaan atau issue:
+1. Cek bagian **Troubleshooting** di atas
+2. Lihat logcat untuk error details
+3. Hubungi tim development
+
+## ✨ Fitur yang Akan Datang
+
+- [ ] Backend authentication server
+- [ ] Database lokal dengan Room
+- [ ] Geofencing untuk verifikasi lokasi
+- [ ] Attendance analytics & reporting
+- [ ] QR code scanning
+- [ ] Push notifications
+- [ ] Offline mode dengan sync kemudian
 
 ---
 
-## 🎯 Tujuan Proyek
+**Last Updated**: January 2024
-- Mengimplementasikan **Location-Based Service (LBS)** pada aplikasi mobile
+**Status**: Production Ready ✅
-- 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
-- 🔐 **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
-
----
-
-## 🛠️ 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
-
----
-
-## 🔐 Izin Aplikasi (Permissions)
-Aplikasi memerlukan izin berikut:
-- `ACCESS_FINE_LOCATION`
-- `ACCESS_COARSE_LOCATION`
-- `CAMERA`
-- `INTERNET`
-- `WRITE_EXTERNAL_STORAGE` (jika diperlukan)
-
----
-
-## 📂 Mockup
-![mockup](Mockup.png)
-gambar mockup dibuat oleh AI
-
-## 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