webgis-poverty-pontianak/README.md

WebGIS Pemetaan Kemiskinan Kota Pontianak

Aplikasi WebGIS sederhana berbasis Leaflet.js untuk memetakan data kemiskinan, sebaran penduduk miskin, log bantuan, dan rumah ibadah di Kota Pontianak.

Warning

DISCLAIMER — DATA DUMMY / BUKAN DATA NYATA

Seluruh data yang ditampilkan dalam aplikasi ini, termasuk namun tidak terbatas pada:

• Data nama, lokasi, dan kategori penduduk miskin
• Foto rumah dan Foto Kartu Keluarga (KK) yang diunggah
• Data rumah ibadah beserta radius jangkauannya
• Log bantuan yang tercatat di sistem

adalah data fiktif / dummy yang dibuat semata-mata untuk keperluan demonstrasi, pengembangan, dan pengujian sistem ini. Data tersebut tidak mewakili kondisi, identitas, atau situasi nyata dari individu maupun lokasi mana pun di Kota Pontianak.

Fitur Utama

• Pemetaan Interaktif: Visualisasi peta dengan Leaflet.js yang berpusat di Kota Pontianak.
• Manajemen Data Spasial:
  • Rumah Ibadah: Lokasi titik rumah ibadah (Masjid, Gereja, Vihara, dll) beserta jangkauan radius jemaah/bantuan.
  • Penduduk Miskin: Pemetaan warga kurang mampu dan integrasi log/riwayat bantuan sosial yang disalurkan melalui rumah ibadah terdekat.
• Pencarian Cepat: Cari data rumah ibadah langsung dari bilah pencarian.
• Impor GeoJSON Eksternal: Pengguna dapat menambahkan file GeoJSON dari perangkat lokal ke dalam peta.

Persyaratan Sistem

• Server Web: Apache (misal menggunakan XAMPP atau Laragon).
• Bahasa Pemrograman: PHP 7.4 ke atas.
• Database: MySQL versi 5.7+ atau MariaDB versi 10.2+ (Wajib mendukung fitur fungsi spasial seperti ST_GeomFromGeoJSON dan ST_AsGeoJSON).

Cara Instalasi & Penggunaan

1. Unduh/Clone Repositori: Tempatkan folder webgis-poverty-pontianak di dalam direktori root server web Anda (misalnya C:/xampp/htdocs/webgis/webgis-poverty-pontianak).

2. Setup Database:

   • Buka phpMyAdmin atau MySQL client pilihan Anda.
   • Buat database baru bernama webgis:

     CREATE DATABASE webgis;
     

   • Import file database.sql ke dalam database webgis tersebut.

3. Konfigurasi Koneksi:

   • Buka file api/db_connect.php.
   • Sesuaikan konfigurasi host, user, password, dan database sesuai dengan setup database MySQL lokal Anda:

     $host = "localhost";
     $user = "root";
     $pass = "";
     $db   = "webgis";
     

4. Jalankan Aplikasi:

   • Aktifkan modul Apache dan MySQL di Control Panel XAMPP Anda.
   • Buka browser dan navigasikan ke alamat: http://localhost/webgis/webgis-poverty-pontianak/index.php

Akun Akses Default (Login)

Anda dapat masuk ke dalam sistem menggunakan akun simulasi berikut:

• Akun Administrator (Admin):

  • Username: admin
  • Password: password
  • Hak Akses: Mengelola data spasial rumah ibadah, penduduk miskin, mengelola akun pengelola rumah ibadah, dan manajemen pengguna secara penuh.

• Akun Pengelola Rumah Ibadah:

  • Username: pengelola_mujahidin
  • Password: password
  • Hak Akses: Mengelola (tambah, edit, hapus, impor, geser lokasi) data penduduk miskin, serta menginput log bantuan sosial yang disalurkan melalui masjid kelolaannya (Masjid Raya Mujahidin).

Struktur Folder

• api/ — Kumpulan REST API endpoint untuk operasi CRUD masing-masing fitur.
  • rumah_ibadah/, penduduk_miskin/, log_bantuan/
• assets/ — File aset frontend.
  • css/ — Gaya UI (custom style.css).
  • js/ — Logika frontend peta dan pengelolaan interaksi panel data.
    • features/ — Modul fitur Leaflet (manajemen layer, geolokasi, dll).
• index.php — Halaman utama interface WebGIS.
• database.sql — Skema database beserta data dummy Pontianak untuk pengetesan awal. Seluruh data di dalamnya bersifat fiktif dan tidak merepresentasikan data nyata.
• uploads/ — Folder penyimpanan foto yang diunggah. File yang sudah ada merupakan contoh dummy semata.