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! 🗺️