From 1dbc0def1dc83949e0c3b13e7325a435c5ecfb76 Mon Sep 17 00:00:00 2001
From: jouel88 <muhammadjulianromadhoni@gmail.com>
Date: Thu, 19 Mar 2026 21:59:08 +0700
Subject: [PATCH] documentation

---
 README.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bb5a115
--- /dev/null
+++ b/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.