Initial commit

PANDUAN.md

@@ -0,0 +1,193 @@
+# 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! 🗺️