# PANDUAN PENGGUNA (USER MANUAL)

Sistem Informasi Geospasial (WebGIS) Pengentasan Kemiskinan

## 1. Pendahuluan

Aplikasi WebGIS ini dirancang sebagai platform pemetaan cerdas untuk analisis spasial persebaran infrastruktur dan demografi kemiskinan. Sistem ini mengadopsi arsitektur Monorepo yang terbagi menjadi dua modul utama:

- Modul Publik (/publik): Portal terbuka untuk masyarakat umum guna melihat persebaran titik fasilitas, jaringan jalan, dan pemetaan poligon lahan.
- Modul Kemiskinan (/kemiskinan): Sistem tertutup (memerlukan autentikasi) untuk admin dan verifikator lapangan dalam mendata penduduk miskin, menganalisis radius jangkauan bantuan, dan mengelola fasilitas publik.

## 2. Cara Mengakses Aplikasi

1. Buka web browser (disarankan menggunakan Google Chrome atau Mozilla Firefox).
2. Masukkan alamat URL (link) aplikasi yang telah di-deploy (misalnya: `https://webgis-kemiskinan.ifuntanhub.dev`).
3. Untuk masuk ke sistem pengelola, gunakan akun yang telah disetujui (Admin/Petugas).

## 3. Panduan Modul Publik (Tanpa Login)

Modul ini dapat diakses oleh siapa saja. Pengguna dapat:

- Melihat Peta: Melakukan zoom in/out dan menggeser peta (panning).
- Melihat Informasi Titik (Marker): Klik pada marker (ikon) di peta untuk memunculkan kotak informasi (pop-up) mengenai fasilitas atau lokasi tersebut.
- Melihat Garis dan Area: Klik pada rute jalan (garis) atau area tanah (poligon) untuk melihat luas dan detail spesifiknya.

## 4. Panduan Modul Kemiskinan (Khusus Admin/Petugas)

### 4.1. Registrasi dan Login

- Login: Masukkan Username/Email dan Password pada halaman Login. Jika berhasil, Anda akan diarahkan ke Dashboard.
- Registrasi: Jika belum memiliki akun, klik "Daftar sekarang". Pilih peran sebagai `Petugas`. Akun petugas memerlukan persetujuan dari Admin Utama sebelum bisa digunakan.

### 4.2. Navigasi Sidebar dan Alat Peta (Toolbar)

Di halaman Dashboard, seluruh menu navigasi dan alat-alat digitasi terletak pada Sidebar di sebelah kiri layar.

💡 INFO PENTING:
Sidebar ini dapat di-scroll (digulir) ke bawah! Jika Anda membuka dari laptop berlayar kecil, silakan scroll sidebar ke bawah untuk menemukan menu-menu tambahan yang tersembunyi seperti Modul Bantuan, Pencarian, dan Manajemen Pengguna.

Berikut adalah alat-alat pemetaan yang tersedia di Sidebar:

- 📍 Mode Tambah Titik: Klik alat ini, lalu klik di sembarang tempat pada peta untuk menambahkan titik lokasi baru (Fasilitas Publik atau SPBU).
- 🛣️ Mode Gambar Jalan: Klik alat ini, lalu klik titik awal pada peta. Lanjutkan mengklik untuk membentuk rute jalan. Klik ganda (double-click) untuk mengakhiri rute.
- ⬠ Mode Gambar Area: Klik alat ini, klik titik-titik sudut area yang ingin dibentuk, lalu klik kembali titik pertama untuk menutup area (Poligon).

### 4.3. Modul Bantuan & Penduduk Miskin

Fitur utama dari aplikasi ini adalah memetakan rumah penduduk miskin dan menganalisis radius bantuan secara otomatis.

1. Pilih Modul Bantuan dari Sidebar.
2. Aktifkan Mode Tambah Titik.
3. Klik pada lokasi rumah penduduk miskin di peta.
4. Pada form isian, masukkan Nama Kepala Keluarga & NIK, Foto Rumah, Foto KK, dan pilih Fasilitas Publik Terdekat.
5. Sistem akan otomatis menghitung apakah rumah tersebut masuk dalam Radius Jangkauan bantuan fasilitas publik tersebut atau tidak.

### 4.4. Analisis Spasial Radius

- Saat melihat data fasilitas publik (seperti Kantor Desa atau Posko Bantuan), sistem akan memunculkan Lingkaran Radius (berwarna merah/biru transparan) di peta.
- Rumah penduduk miskin yang berada di dalam lingkaran tersebut otomatis berstatus "Dalam Jangkauan", sedangkan yang di luar otomatis "Luar Jangkauan".

### 4.5. Mengelola Akun (Khusus Admin)

1. Buka menu Manajemen Pengguna di bagian bawah Sidebar.
2. Anda dapat melihat daftar semua pengguna yang terdaftar.
3. Untuk akun Petugas yang berstatus Pending, Admin dapat menekan tombol Setujui (Approve) atau Tolak.

## 5. Penyelesaian Masalah (Troubleshooting)

- Peta tidak muncul / Blank Putih: Pastikan koneksi internet Anda stabil karena aplikasi memerlukan koneksi ke server Leaflet/OpenStreetMap.
- Gagal Upload Foto: Pastikan ukuran foto Rumah/KK tidak melebihi 2 Megabyte (MB) dan berformat `.jpg` atau `.png`.