Compare commits
2 Commits
d3bb31488c
...
3b76befdd2
| Author | SHA1 | Date | |
|---|---|---|---|
| 3b76befdd2 | |||
| d92cff5fcb |
13
.idea/deviceManager.xml
generated
Normal file
13
.idea/deviceManager.xml
generated
Normal file
@ -0,0 +1,13 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<project version="4">
|
||||||
|
<component name="DeviceTable">
|
||||||
|
<option name="columnSorters">
|
||||||
|
<list>
|
||||||
|
<ColumnSorterState>
|
||||||
|
<option name="column" value="Name" />
|
||||||
|
<option name="order" value="ASCENDING" />
|
||||||
|
</ColumnSorterState>
|
||||||
|
</list>
|
||||||
|
</option>
|
||||||
|
</component>
|
||||||
|
</project>
|
||||||
50
.idea/inspectionProfiles/Project_Default.xml
generated
Normal file
50
.idea/inspectionProfiles/Project_Default.xml
generated
Normal file
@ -0,0 +1,50 @@
|
|||||||
|
<component name="InspectionProjectProfileManager">
|
||||||
|
<profile version="1.0">
|
||||||
|
<option name="myName" value="Project Default" />
|
||||||
|
<inspection_tool class="ComposePreviewDimensionRespectsLimit" enabled="true" level="WARNING" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="ComposePreviewMustBeTopLevelFunction" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="ComposePreviewNeedsComposableAnnotation" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="ComposePreviewNotSupportedInUnitTestFiles" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="GlancePreviewDimensionRespectsLimit" enabled="true" level="WARNING" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="GlancePreviewMustBeTopLevelFunction" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="GlancePreviewNeedsComposableAnnotation" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="GlancePreviewNotSupportedInUnitTestFiles" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="PreviewAnnotationInFunctionWithParameters" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="PreviewApiLevelMustBeValid" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="PreviewDeviceShouldUseNewSpec" enabled="true" level="WEAK WARNING" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="PreviewFontScaleMustBeGreaterThanZero" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="PreviewMultipleParameterProviders" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="PreviewParameterProviderOnFirstParameter" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
<inspection_tool class="PreviewPickerAnnotation" enabled="true" level="ERROR" enabled_by_default="true">
|
||||||
|
<option name="composableFile" value="true" />
|
||||||
|
</inspection_tool>
|
||||||
|
</profile>
|
||||||
|
</component>
|
||||||
150
README.md
150
README.md
@ -1,106 +1,102 @@
|
|||||||
<div align="center">
|
|
||||||
|
|
||||||
# 📱 Aplikasi Absensi Akademik UBHARA Jaya
|
# 📱 Aplikasi Absensi Akademik UBHARA Jaya
|
||||||
### Mobile (Kotlin) & Backend (Python Flask)
|
|
||||||
|
|
||||||
|
[📋 Changelog](./CHANGELOG.md)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
[📋 Lihat Changelog](./CHANGELOG.md)
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📌 Deskripsi Proyek
|
## 📌 Deskripsi Proyek
|
||||||
Proyek ini merupakan **Tugas Project Akhir Mata Kuliah Pemrograman Mobile** yang mengimplementasikan sistem absensi akademik berbasis **Client-Server**.
|
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**.
|
||||||
|
|
||||||
Sistem ini dirancang untuk validitas tinggi dengan mengintegrasikan:
|
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.
|
||||||
* ✅ **Geofencing (GPS)** untuk validasi lokasi kampus.
|
|
||||||
* ✅ **Face Detection (CameraX)** untuk validasi biometrik kehadiran.
|
|
||||||
* ✅ **Anti-Fraud** untuk mendeteksi penggunaan *Fake GPS*.
|
|
||||||
* ✅ **Otomatisasi** pelaporan real-time ke **N8N Webhook**.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📸 Tampilan Aplikasi (Mockup)
|
## 🎯 Tujuan Proyek
|
||||||
<div align="center">
|
- Mengimplementasikan arsitektur **REST API** antara Android dan Python Flask.
|
||||||
<img src="Mockup.png" alt="Mockup Aplikasi Absensi" width="800">
|
- Menerapkan **Face Detection** menggunakan CameraX untuk memvalidasi kehadiran fisik mahasiswa.
|
||||||
</div>
|
- Mencegah kecurangan absensi dengan fitur deteksi **Fake GPS**.
|
||||||
|
- Mengelola status kehadiran otomatis (**Auto-Alfa**) pada server jika mahasiswa lupa absen.
|
||||||
---
|
- Melatih kemampuan Fullstack Mobile Development (Backend, Database, & Mobile UI).
|
||||||
|
|
||||||
## 🎯 Tujuan & Capaian
|
|
||||||
Proyek ini bertujuan untuk melatih kemampuan **Fullstack Mobile Development** dengan fokus pada:
|
|
||||||
1. **REST API Architecture**: Komunikasi aman antara Android dan Python Flask.
|
|
||||||
2. **Biometric Validation**: Implementasi ML Kit untuk deteksi wajah.
|
|
||||||
3. **Security Awareness**: Pencegahan kecurangan lokasi (*Mock Location*).
|
|
||||||
4. **Database Logic**: Penanganan status otomatis (*Auto-Alfa*) di sisi server.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🚀 Fitur Utama
|
## 🚀 Fitur Utama
|
||||||
|
|
||||||
| Fitur | Deskripsi |
|
### 📱 Sisi Mobile (Android - Jetpack Compose)
|
||||||
| :--- | :--- |
|
- **Modern UI**: Antarmuka modern menggunakan **Material3** & **Jetpack Compose**.
|
||||||
| **📱 Sisi Mobile** | • **Smart Attendance:** Validasi radius & wajah real-time.<br>• **Anti-Fraud:** Deteksi & blokir Fake GPS.<br>• **Mode Izin/Sakit:** Upload bukti dokumen tanpa validasi radius.<br>• **Riwayat:** Log kehadiran lengkap dengan foto bukti. |
|
- **Smart Attendance**:
|
||||||
| **💻 Sisi Backend** | • **JWT Auth:** Keamanan token pada setiap request.<br>• **Auto-Alfa:** Menandai "TIDAK HADIR" otomatis jika telat.<br>• **N8N Integration:** Kirim data valid ke webhook untuk notifikasi.<br>• **Image Compression:** Optimasi penyimpanan foto (Base64). |
|
- **Hadir**: Wajib berada di radius kampus & Wajib deteksi wajah (Real-time).
|
||||||
|
- **Sakit/Izin**: Wajib upload foto surat dokter/bukti (Tanpa validasi radius).
|
||||||
|
- **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 Alur Absensi
|
## 🗺️ Mekanisme Absensi
|
||||||
|
|
||||||
### 🟢 1. Status "HADIR"
|
### 1. Absensi Status "HADIR"
|
||||||
1. Mahasiswa memilih Jadwal Kelas aktif.
|
1. Mahasiswa memilih Jadwal Kelas yang aktif.
|
||||||
2. **Validasi Sistem:**
|
2. Sistem mengecek **GPS**:
|
||||||
* 📍 Lokasi dalam radius **500m**?
|
- Apakah di dalam radius **500m** dari kampus?
|
||||||
* 🚫 Tidak ada aplikasi **Fake GPS** aktif?
|
- Apakah terdeteksi aplikasi **Fake GPS**?
|
||||||
3. **Validasi Wajah:** Kamera terbuka, shutter hanya aktif jika wajah terdeteksi.
|
3. Sistem membuka **Kamera Deteksi Wajah**:
|
||||||
|
- Tombol shutter hanya aktif jika wajah terdeteksi.
|
||||||
4. Data (Lokasi + Foto Wajah) dikirim ke server.
|
4. Data (Lokasi + Foto Wajah) dikirim ke server.
|
||||||
|
|
||||||
### 🟡 2. Status "SAKIT / IZIN"
|
### 2. Absensi Status "SAKIT / IZIN"
|
||||||
1. Mahasiswa memilih status Sakit/Izin.
|
1. Mahasiswa memilih status Sakit atau Izin.
|
||||||
2. **Bypass Lokasi:** Validasi radius dilewati.
|
2. Validasi lokasi dilewati (bisa absen dari rumah/RS).
|
||||||
3. **Dokumentasi:** Kamera dokumen terbuka (Tanpa deteksi wajah).
|
3. Sistem membuka **Kamera Dokumen** (Tanpa deteksi wajah).
|
||||||
4. Foto surat/bukti dikirim ke server.
|
4. Mahasiswa memfoto surat keterangan.
|
||||||
|
5. Data dikirim ke server.
|
||||||
|
|
||||||
### 🔴 3. Logika Auto-Alfa (Server Side)
|
### 3. Logika Auto-Alfa (Server)
|
||||||
> *Background Process*
|
- Setiap kali jadwal dimuat, server mengecek jadwal yang `jam_selesai < jam_sekarang`.
|
||||||
* Server memantau jadwal kuliah.
|
- Jika mahasiswa belum ada record absensi pada jam tersebut, server otomatis menginput status **"TIDAK HADIR"**.
|
||||||
* Jika `jam_selesai < jam_sekarang` dan tidak ada data masuk ➔ Input otomatis **"TIDAK HADIR"**.
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🛠️ Tech Stack
|
## 🛠️ Teknologi yang Digunakan
|
||||||
|
- **Mobile Platform**: Android (Kotlin)
|
||||||
| Komponen | Teknologi |
|
- **UI Framework**: Jetpack Compose
|
||||||
| :--- | :--- |
|
- **Camera Engine**: CameraX + ML Kit (Face Analysis)
|
||||||
| **Mobile Platform** | Android (Kotlin) |
|
- **Backend Framework**: Python Flask
|
||||||
| **UI Framework** | Jetpack Compose (Material3) |
|
- **Database**: MySQL
|
||||||
| **Camera & AI** | CameraX + ML Kit (Face Analysis) |
|
- **Integrasi**: N8N Webhook
|
||||||
| **Backend** | Python Flask |
|
- **Protocol**: HTTP/REST (JSON)
|
||||||
| **Database** | MySQL |
|
- **AI**: Gemini & Claude (Sebagai Tools dalam Membantu Pengembangan)
|
||||||
| **Integrasi** | N8N Webhook |
|
|
||||||
| **AI Assistant** | Gemini & Claude (Development Tools) |
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ⚙️ Konfigurasi & Instalasi
|
## 🔐 Izin Aplikasi (Permissions)
|
||||||
|
Aplikasi memerlukan izin berikut:
|
||||||
|
- `INTERNET`: Koneksi ke Server API.
|
||||||
|
- `ACCESS_FINE_LOCATION`: Validasi koordinat presisi tinggi.
|
||||||
|
- `ACCESS_COARSE_LOCATION`: Validasi koordinat jaringan.
|
||||||
|
- `CAMERA`: Pengambilan foto bukti kehadiran & deteksi wajah.
|
||||||
|
|
||||||
### Prasyarat
|
---
|
||||||
* Python 3.x
|
|
||||||
* Android Studio (Ladybug/Latest)
|
|
||||||
* Koneksi jaringan yang sama (Laptop & HP)
|
|
||||||
|
|
||||||
### 1. Setup Backend
|
## 📂 Mockup
|
||||||
Pastikan server berjalan pada jaringan lokal:
|
|
||||||
```bash
|
|
||||||
# Install dependencies
|
|
||||||
pip install -r requirements.txt
|
|
||||||
|
|
||||||
# Jalankan server
|
## Catatan Konfigurasi:
|
||||||
python app.py
|
- **Server**: Pastikan `app.py` berjalan (`python app.py`) pada jaringan yang sama dengan HP.
|
||||||
|
- **Endpoint**: Sesuaikan `BASE_URL` pada file `MainActivity.kt` (Object `AppConstants`) dengan IP Laptop Anda.
|
||||||
|
```kotlin
|
||||||
|
const val BASE_URL = "[http://192.168.](http://192.168.)x.x:5000"
|
||||||
|
```
|
||||||
|
- **Fake GPS**: Pastikan mematikan aplikasi Mock Location saat pengujian fitur Hadir.
|
||||||
|
|
||||||
|
## Pengecekan & Monitoring:
|
||||||
|
- **Monitoring**: https://ntfy.ubharajaya.ac.id/EAS
|
||||||
|
- **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
|
||||||
@ -88,7 +88,7 @@ import androidx.compose.ui.unit.sp
|
|||||||
object AppConstants {
|
object AppConstants {
|
||||||
// Backend API URL - GANTI SESUAI SERVER ANDA
|
// Backend API URL - GANTI SESUAI SERVER ANDA
|
||||||
// const val BASE_URL = "http://10.0.2.2:5000" // Untuk emulator Android
|
// const val BASE_URL = "http://10.0.2.2:5000" // Untuk emulator Android
|
||||||
const val BASE_URL = "http://192.168.xxx.xxx:5000" // Untuk device fisik
|
const val BASE_URL = "http://192.168.100.99:5000" // Untuk device fisik
|
||||||
|
|
||||||
// Koordinat Kampus (UBHARA Jaya)
|
// Koordinat Kampus (UBHARA Jaya)
|
||||||
const val KAMPUS_LATITUDE = -6.223325
|
const val KAMPUS_LATITUDE = -6.223325
|
||||||
|
|||||||
20
backend/Dockerfile
Normal file
20
backend/Dockerfile
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
# Gunakan image Python yang ringan sebagai dasar
|
||||||
|
FROM python:3.9-slim
|
||||||
|
|
||||||
|
# Set working directory di dalam kontainer
|
||||||
|
WORKDIR /app
|
||||||
|
|
||||||
|
# Salin file requirements.txt terlebih dahulu (untuk efisiensi cache Docker)
|
||||||
|
COPY requirements.txt .
|
||||||
|
|
||||||
|
# Install semua library yang dibutuhkan
|
||||||
|
RUN pip install --no-cache-dir -r requirements.txt
|
||||||
|
|
||||||
|
# Salin seluruh file backend ke dalam kontainer
|
||||||
|
COPY . .
|
||||||
|
|
||||||
|
# Ekspos port 5000 agar bisa diakses dari luar kontainer
|
||||||
|
EXPOSE 5000
|
||||||
|
|
||||||
|
# Perintah untuk menjalankan server Flask
|
||||||
|
CMD ["python", "app.py"]
|
||||||
@ -24,7 +24,7 @@ CORS(app)
|
|||||||
DB_CONFIG = {
|
DB_CONFIG = {
|
||||||
'host': 'localhost',
|
'host': 'localhost',
|
||||||
'user': 'root',
|
'user': 'root',
|
||||||
'password': '@Rique03',
|
'password': '',
|
||||||
'database': 'db_absensi_akademik'
|
'database': 'db_absensi_akademik'
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@ -11,6 +11,9 @@ pluginManagement {
|
|||||||
gradlePluginPortal()
|
gradlePluginPortal()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
plugins {
|
||||||
|
id("org.gradle.toolchains.foojay-resolver-convention") version "0.10.0"
|
||||||
|
}
|
||||||
dependencyResolutionManagement {
|
dependencyResolutionManagement {
|
||||||
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
|
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
|
||||||
repositories {
|
repositories {
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user