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

   cp .env.example .env
   # Masukkan BASE_URL API di .env
   

3. Instal Dependensi

   flutter pub get
   

4. Jalankan Aplikasi

   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)

---

Developed by MPG Team.