diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8bfd69c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,46 @@
+# 🗺️ Panduan Penggunaan Sistem Dashboard GIS - Pengentasan Kemiskinan Berbasis Masjid
+
+Selamat datang di Panduan Pengguna aplikasi **Sistem Informasi Geografis (SIG) Pengentasan Kemiskinan**. Aplikasi ini mengintegrasikan peran masjid dalam mendistribusikan bantuan kepada kaum dhuafa/warga berkebutuhan berdasarkan jangkauan wilayah (radius) terdekat secara otomatis.
+
+## 🔗 Link Akses Website
+Aplikasi dapat diakses langsung melalui tautan berikut:
+👉 [Demo Live Website UAS Pengentasan Kemiskinan](https://sigwebsite.free.je/Pengentasan_Kemiskinan/)
+
+---
+
+## 👥 Hak Akses (Role) & Point of View (POV) Saat Login
+
+Sistem ini memiliki 3 level pengguna dengan tampilan kontrol dan batasan akses yang berbeda demi keamanan data:
+
+### 1. POV Admin (Super User)
+Admin memegang kendali penuh atas manajemen seluruh data master di dalam sistem.
+* **Manajemen Masjid:** Hanya Admin yang bisa menambah, mengedit, atau menghapus data titik koordinat Masjid beserta jangkauan operasionalnya (Radius).
+* **Manajemen Akun & Verifikasi Data:** Sesuai kebijakan sistem, **Pengurus Masjid atau Warga tidak dapat mendaftar sendiri secara bebas**. Mereka harus menghubungi Admin (via Telepon/WhatsApp). Admin kemudian akan memvalidasi data lapangan, membuatkan akun login, sekaligus memetakan marker lokasi mereka ke dalam database sistem.
+
+### 2. POV Pengurus Masjid
+Akses ini dirancang khusus untuk perwakilan pengurus masing-masing masjid yang telah didaftarkan oleh Admin.
+* **Melihat Data Warga di Radius Masjid:** Pengurus hanya dapat melihat daftar dan detail warga dhuafa yang masuk ke dalam wilayah/radius jangkauan masjid mereka (**Status Hijau**).
+* **Manajemen Bantuan (CRUD Warga Dhuafa):** Pengurus masjid memiliki hak untuk mengelola data warga dhuafa di bawah naungannya, memperbarui profil ekonomi mereka, dan mengatur distribusi bantuan pangan/zakat secara langsung.
+* **Proteksi Akses:** Pengurus masjid diblokir (tidak bisa) melihat data internal warga dhuafa yang berada di bawah naungan pengampu masjid lain.
+
+### 3. POV Warga Berkebutuhan (Dhuafa)
+Akses paling terbatas yang diberikan kepada warga penerima manfaat bantuan.
+* **Melihat Status Bantuan:** Warga yang login hanya dapat melihat profil dirinya sendiri, melihat jarak rumah mereka ke masjid terdekat, serta memantau status validasi bantuan yang dikirimkan oleh pihak pengurus masjid.
+* **Proteksi Akses:** Warga dhuafa dilarang keras mengakses form input/edit data apa pun, tidak bisa melihat data warga lain, dan tidak bisa mengubah koordinat marker rumah mereka sendiri yang sudah dikunci oleh Admin.
+
+---
+
+## 🛠️ Alur Tambah Data Akun & Marker (Kebijakan Kontak Admin)
+
+Untuk menjaga akurasi koordinat pemetaan dan menghindari akun fiktif, sistem ini menerapkan alur pendaftaran terpusat:
+1. **Pengajuan Lapangan:** Pengurus Masjid baru atau Warga Dhuafa yang membutuhkan bantuan harus **menghubungi Admin** secara langsung.
+2. **Pengisian Koordinat oleh Admin:** Admin membuka peta dashboard, melacak posisi lintang/bujur rumah warga atau lokasi masjid menggunakan koordinat GPS yang valid.
+3. **Pembuatan Kredensial:** Admin mendaftarkan *username* dan *password* melalui sistem registrasi aman, lalu menautkan akun tersebut ke ID Marker geografis yang baru dibuat.
+4. **Sistem Siap Digunakan:** Akun diserahkan kepada pengguna terkait untuk digunakan login sesuai hak akses masing-masing.
+
+---
+
+## 📊 Fitur Spasial Cerdas (Geofencing Otomatis)
+* **Sistem Radius:** Saat Admin memasukkan data koordinat warga baru, sistem backend PHP akan otomatis menghitung jarak spasial (*Haversine Formula*) rumah warga ke seluruh masjid terdaftar.
+* **🟢 Status Hijau:** Jika rumah warga berada di dalam area radius salah satu masjid, warga tersebut otomatis ditugaskan ke masjid terdekat tersebut sebagai pengampunya.
+* **🔴 Status Merah:** Jika rumah warga terlalu jauh dan berada di luar radius seluruh masjid, sistem akan menandainya dengan status merah agar mendapat perhatian khusus dari Admin utama.
\ No newline at end of file