Webgis-Poverty/README.md

WebGIS Poverty Mapping System

Sistem Informasi Geografis berbasis web untuk visualisasi data kemiskinan dan penyaluran bantuan sosial.

🚀 Fitur Utama

• Arsitektur Berbasis Peran (RBAC): Login terpisah antara Admin (akses penuh) dan Rumah Ibadah (hanya akses data penduduk dalam radiusnya).
• Dashboard Statistik: Ringkasan data (KPI), grafik analisis kedekatan penduduk, grafik jenis penyaluran bantuan, dan log terbaru penyaluran bantuan.
• Peta Interaktif (WebGIS):
  • Visualisasi radius layanan rumah ibadah (buffer).
  • Pemetaan rumah ibadah dan penduduk miskin.
  • Pencarian spasial (search).
• Manajemen Bantuan (Penyaluran): Setiap akun rumah ibadah dapat mencatat secara real-time bantuan yang diberikan kepada penduduk miskin.
• Manajemen Akun Rumah Ibadah: Fitur lengkap bagi Admin untuk membuat dan mereset password akun petugas rumah ibadah.

🛠️ Teknologi yang Digunakan

• Backend: PHP Native (Multi-page views & REST API terstruktur) & MySQL.
• Frontend:
  • Vanilla HTML/CSS/JS (Arsitektur komponen modular dan routing index.php).
  • Leaflet.js (Pemetaan Interaktif).
  • Chart.js (Visualisasi Grafik Dashboard).

📋 Persyaratan Sistem

• PHP (versi 7.4 atau lebih baru direkomendasikan)
• Apache Web Server (XAMPP / Laragon)
• MySQL / MariaDB

⚙️ Cara Setup (Instalasi Lokal)

1. Tempatkan folder proyek webgis_poverty di dalam direktori htdocs (XAMPP) atau direktori publik server lokal Anda.
2. Mulai modul Apache dan MySQL (di XAMPP Control Panel).
3. Buat database baru bernama webgis_poverty di phpMyAdmin, kemudian import struktur database menggunakan file SQL yang disediakan (database.sql).
4. Salin atau buat file konfigurasi database di api/config/database.php (Gunakan database.php.example sebagai referensi jika ada) lalu sesuaikan username dan password database.
5. Akses sistem melalui browser: http://localhost/webgis/webgis_poverty/

🔐 Akun Akses Default

Jika setup awal berhasil, Anda dapat login menggunakan akun berikut:

• Admin: username admin / password password
• Akun Rumah Ibadah: Didaftarkan dan dibuat langsung oleh Admin melalui halaman Daftar Rumah Ibadah.

📁 Struktur Proyek Utama

• index.php — Router utama yang mengatur layout dan halaman aplikasi.
• pages/ — Kumpulan file View PHP (Dashboard, Peta, Daftar PM, Manajemen Akun).
• components/ — File PHP re-usable (Sidebar, Head, Global Scripts).
• api/ — Endpoint REST API (Login, Fetch Data, CRUD, dll).
• js/pages/ dan js/features/ — Modular JavaScript untuk fungsionalitas tiap halaman dan fitur (Peta, Log Bantuan, dll).
• css/ — Stylesheet yang dipecah per-halaman dan komponen untuk performa lebih baik.