documentation

README.md

@@ -0,0 +1,61 @@
+# 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`.
+
+---
+Developed by MPG Team.