UAS-SIG-WebGIS-Poverty-Mapping/PANDUAN.md

WebGIS - Panduan Perbaikan & Penggunaan

✓ Masalah Sudah Diperbaiki

Kesalahan "Gagal menyimpan data: Failed to fetch" telah diperbaiki dengan:

• ✓ Database dan tabel dibuat dengan lengkap
• ✓ Semua kolom untuk Rumah Ibadah, Rumah Miskin, dan Data Umum tersedia
• ✓ Error handling pada API diperbaiki
• ✓ Trigger database sudah diperiksa dan diperbaiki

PENTING: Cara Mengakses Aplikasi

JANGAN buka file langsung dari Windows Explorer!

Langkah 1: Mulai Server

1. Buka XAMPP Control Panel
2. Klik tombol "Start" untuk Apache (warna hijau = running)
3. Klik tombol "Start" untuk MySQL (warna hijau = running)

Langkah 2: Akses Aplikasi

Buka browser dan kunjungi:

http://localhost/webgis/

Jangan gunakan: file:///C:/xampp_new/htdocs/webgis/index.html (Ini akan memblokir semua fetch request!)

Langkah 3: Cek Status (Opsional)

Kunjungi halaman status untuk memverifikasi:

http://localhost/webgis/status.html

Akun Pengguna & Role

Aplikasi ini dirancang untuk mendukung beberapa role pengguna. Untuk saat ini, autentikasi dapat dilakukan dengan menggunakan data dummy pada tabel users atau konfigurasi lokal dalam aplikasi.

Role	Username	Password	Hak Akses
Admin	admin	admin123	Tambah/Edit/Hapus semua data, kelola sistem
Operator	operator	operator123	Input data, edit data, lihat laporan
Viewer	viewer	viewer123	Lihat peta dan data saja

Catatan: Jika fitur login belum tersedia, akun di atas dapat dimasukkan sebagai referensi nilai awal di tabel users pada database.

URL Akses & Link Repo

Akses aplikasi produksi lokal:

http://localhost/webgis/

Akses halaman status:

http://localhost/webgis/status.html

Link repository Gitea (isi dengan alamat repo Anda):

https://gitea.example.com/username/webgis-poverty-mapping

Link project kelas (isi dengan URL project di kelas jika ada):

https://ifuntanhub.dev/login

Struktur Database yang Telah Dibuat

Tabel: data_unified

Rumah Ibadah (Worship)

• Nama: Nama tempat ibadah
• Jenis: Masjid, Gereja, Kuil, dll
• Alamat: Lokasi alamat
• Kontak: Nomor kontak penting
• Kegiatan: Jenis kegiatan yang ada
• Kapasitas: Daya tampung (dalam orang)
• Radius: Jangkauan layanan (dalam meter)

Rumah Penduduk Miskin (Poor House)

• Nama Kepala Keluarga: Nama orang tua/kepala rumah tangga
• Alamat: Lokasi rumah
• Jumlah Anggota: Berapa orang dalam keluarga
• Kondisi Rumah: Layak/Tidak layak huni
• Sumber Penghasilan: Pekerjaan/penghasilan utama
• Kebutuhan Prioritas: Bantuan apa yang paling dibutuhkan
• Status Bantuan: Sudah/belum menerima bantuan

Data Umum (Point)

• Nama: Nama tempat/fasilitas
• No WA: Nomor WhatsApp kontak
• Buka 24 Jam: Ya/Tidak

Cara Menggunakan Aplikasi

Menambah Data Baru

1. Akses aplikasi → http://localhost/webgis/
2. Pilih tipe marker dari dropdown di panel kontrol:
   • Rumah Ibadah
   • Rumah Penduduk Miskin
   • SPBU / Data Umum
3. Atur radius (untuk Rumah Ibadah) - geser slider jika perlu
4. Klik tombol gambar di toolbar peta
5. Klik lokasi di peta untuk menempatkan marker
6. Isi form yang muncul:
   • Untuk Rumah Ibadah: nama, jenis, alamat, kontak, kegiatan, kapasitas
   • Untuk Rumah Miskin: nama kepala keluarga, alamat, jumlah anggota, kondisi rumah, sumber penghasilan, kebutuhan prioritas, status bantuan
   • Untuk Data Umum: nama, nomor WA, jam buka
7. Klik "Simpan" untuk menyimpan data
8. Jika berhasil → data akan muncul di peta dengan warna sesuai tipenya

Mengedit Data

1. Klik marker yang ingin diubah
2. Geser marker untuk mengubah lokasi
3. Untuk Rumah Ibadah, anda bisa mengubah radius dengan:
   • Mengetik nilai baru di input radius
   • Atau drag handle (titik di ujung lingkaran) untuk mengubah ukuran
4. Klik "Hapus" jika ingin menghapus data

Tombol Penting

• Muat Ulang Data: Refresh data dari database
• Kontrol Layer: Show/hide layer sesuai keperluan (checkbox kanan atas)

Warna Marker Berdasarkan Tipe

• 🔵 Biru = Rumah Ibadah (Worship)
• 🟢 Hijau = Rumah Miskin DI DALAM radius layanan Rumah Ibadah
• 🔴 Merah = Rumah Miskin DI LUAR radius layanan Rumah Ibadah
• 🟣 Ungu = Data Umum (SPBU, fasilitas lainnya)

Jika Ada Error

Error: "Gagal menyimpan data"

1. Periksa XAMPP

   • Apache harus "Running" (warna hijau)
   • MySQL harus "Running" (warna hijau)

2. Periksa Browser

   • Buka Developer Console: Tekan F12
   • Lihat tab "Network" untuk request yang failed
   • Lihat tab "Console" untuk error message

3. Akses URL yang benar

   • Pastikan menggunakan http://localhost/webgis/
   • Jangan gunakan file:// protocol

4. Reset Database (jika diperlukan)

   • Kunjungi http://localhost/webgis/drop_db.php
   • Kemudian http://localhost/webgis/setup_db.php
   • Ini akan membuat database baru

File-file Penting

File	Fungsi
index.html	Aplikasi utama
save_point.php	API untuk menyimpan data baru
update_point.php	API untuk mengubah data
delete_point.php	API untuk menghapus data
get_point.php	API untuk membaca data
db.php	Koneksi database
setup_db.php	Setup database
status.html	Cek status sistem

Bantuan Tambahan

Setup Database Manual (jika diperlukan)

1. Buka http://localhost/phpmyadmin/
2. Klik "New" untuk buat database baru
3. Nama: webgis_unified
4. Collation: utf8mb4_unicode_ci
5. Klik Create

Verifikasi Data di Database

1. Buka http://localhost/phpmyadmin/
2. Pilih database: webgis_unified
3. Lihat tabel: data_unified
4. Tab SQL untuk query data

---

Status: ✓ Semua perbaikan telah selesai
Database: ✓ Terkoneksi dan siap
API: ✓ Error handling ditingkatkan

Silakan mulai menggunakan aplikasi! 🗺️