67 lines
2.2 KiB
Markdown
67 lines
2.2 KiB
Markdown
# MPG HRIS - Mobile Client
|
|
|
|
Aplikasi mobile untuk pegawai sebagai bagian dari ekosistem MPG HRIS. Dirancang dengan antarmuka modern (Bento Grid) dan fitur keamanan tingkat tinggi berbasis biometrik.
|
|
|
|
## 🚀 Tech Stack
|
|
|
|
- **Framework**: Flutter (Dart)
|
|
- **State Management**: Provider
|
|
- **Networking**: Dio
|
|
- **Maps**: Google Maps Flutter / Flutter Map
|
|
- **Biometric**: Google ML Kit (Face Detection)
|
|
- **Local Storage**: Hive & Shared Preferences
|
|
- **Themes**: Google Fonts (Inter/Outfit), Bento Grid UI, Glassmorphism.
|
|
|
|
## 🛠 Panduan Jalankan Proyek
|
|
|
|
1. **Prasyarat**
|
|
- Flutter SDK installed.
|
|
- Android Studio / VS Code dengan ekstensi Dart & Flutter.
|
|
|
|
2. **Setup Environment**
|
|
```bash
|
|
cp .env.example .env
|
|
# Masukkan BASE_URL API di .env
|
|
```
|
|
|
|
3. **Instal Dependensi**
|
|
```bash
|
|
flutter pub get
|
|
```
|
|
|
|
4. **Jalankan Aplikasi**
|
|
```bash
|
|
flutter run
|
|
```
|
|
|
|
## 📂 Struktur Proyek
|
|
|
|
Proyek mengikuti pola clean architecture sederhana di Flutter:
|
|
- `lib/screens`: UI Layer (Antarmuka pengguna).
|
|
- `lib/providers`: State Management (Logika aplikasi).
|
|
- `lib/repositories`: Data Layer (Interaksi dengan API).
|
|
- `lib/models`: Struktur data.
|
|
- `lib/widgets`: Komponen UI reusable.
|
|
|
|
## ✨ Fitur Utama (Highlight)
|
|
|
|
1. **Presensi Real-time**: Check-in/out berbasis lokasi (Geofencing) dan deteksi wajah (Face Recognition).
|
|
2. **Dashboard Bento**: Tampilan modern yang merangkum statistik kerja, poin lembur, dan jadwal.
|
|
3. **Pengajuan Izin/Cuti**: Form pengajuan digital dengan lampiran bukti file/foto.
|
|
4. **Signature Capture**: Fitur tanda tangan digital untuk verifikasi dokumen/izin.
|
|
5. **Notifikasi**: Integrasi notifikasi untuk pengumuman dan status pengajuan.
|
|
|
|
## 🎨 Design Guidelines
|
|
|
|
- **Primary Colors**: Navy (`#1E293B`), Orange (`#F59E0B`), White (`#FFFFFF`).
|
|
- **Style**: Soft shadows, rounded corners (Bento Grid), dan micro-animations.
|
|
- **Theme**: Konfigurasi tema utama tersedia di `lib/theme.dart`.
|
|
|
|
## 🛡️ Quality Assurance (QA) & Testing
|
|
|
|
Sistem mobile ini terintegrasi dengan modul backend. Untuk skenario pengujian lengkap (termasuk Matriks Role & Isolasi Data), silakan merujuk ke panduan utama di:
|
|
👉 **[PANDUAN QA (Web Project)](file:///c:/xampp/htdocs/mpg-hris/QA_GUIDE.md)**
|
|
|
|
---
|
|
Developed by MPG Team.
|