From ce48dbcddc2862320ea25417615869c2c80ba777 Mon Sep 17 00:00:00 2001
From: ocabacaa <oca.locago@gmail.com>
Date: Thu, 11 Jun 2026 23:40:51 +0700
Subject: [PATCH] first commit

---
 README.md | 518 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 518 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ea38b0a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,518 @@
+# WebGIS Pengentasan Kemiskinan Kalimantan Barat
+
+Sistem Informasi Geografis (WebGIS) untuk Pelaporan, Validasi, dan Monitoring Bantuan Sosial Berbasis Lokasi di Kalimantan Barat.
+
+## Informasi Pengembang
+
+Nama : Clara Oxana Azalia
+
+NIM : D1041231051
+
+Program Studi Informatika
+
+Universitas Tanjungpura
+
+---
+
+# Deskripsi Sistem
+
+WebGIS Pengentasan Kemiskinan Kalimantan Barat merupakan sistem informasi geografis berbasis web yang digunakan untuk membantu proses pelaporan, validasi, penyaluran, dan monitoring bantuan sosial kepada masyarakat kurang mampu.
+
+Sistem menyediakan tiga jenis pengguna, yaitu:
+
+* Administrator
+* Warga
+* Customer Service (CS) Rumah Ibadah
+
+Selain itu sistem dilengkapi dengan peta GIS berbasis Leaflet yang digunakan untuk memvisualisasikan lokasi laporan kemiskinan.
+
+---
+# Fitur Utama
+
+- Login Multi Role (Admin, Warga, CS)
+- Registrasi Warga
+- Registrasi Customer Service (CS)
+- Pelaporan Kemiskinan Berbasis Lokasi
+- Upload Foto Laporan
+- Validasi Laporan
+- Assign Bantuan Sosial
+- Monitoring Bantuan
+- Upload Bukti Penyaluran Bantuan
+- Dashboard Statistik
+- Visualisasi GIS dengan Leaflet
+- Marker Cluster
+- Filter Status Laporan
+- Integrasi Google Maps
+
+
+# Teknologi yang Digunakan
+
+## Backend
+
+* PHP Native
+* MySQL
+
+## Frontend
+
+* HTML
+* CSS
+* JavaScript
+* Tailwind CSS
+
+## GIS
+
+* Leaflet JS
+* OpenStreetMap
+* Leaflet Marker Cluster
+
+## Visualisasi Data
+
+* Chart.js
+
+---
+
+# Cara Menjalankan Sistem di Localhost
+
+## 1. Install XAMPP
+
+Download dan install XAMPP:
+
+https://www.apachefriends.org
+
+Aktifkan:
+
+* Apache
+* MySQL
+
+---
+
+## 2. Salin Project
+
+Letakkan folder project ke dalam:
+
+```text
+xampp/htdocs/
+```
+
+Contoh:
+
+```text
+xampp/htdocs/webgis_poverty
+```
+
+---
+
+## 3. Buat Database
+
+Buka browser:
+
+```text
+http://localhost/phpmyadmin
+```
+
+Buat database baru:
+
+```sql
+webgis_poverty
+```
+
+---
+
+## 4. Import Database
+
+Pilih database:
+
+```text
+webgis_poverty
+```
+
+Klik:
+
+```text
+Import
+```
+
+Lalu pilih file:
+
+```text
+database.sql
+```
+
+Kemudian klik:
+
+```text
+Go
+```
+
+---
+
+## 5. Konfigurasi Koneksi Database
+
+Edit file:
+
+```text
+config/koneksi.php
+```
+
+Contoh konfigurasi:
+
+```php
+<?php
+
+$conn = mysqli_connect(
+    "localhost",
+    "root",
+    "",
+    "webgis_poverty"
+);
+
+?>
+```
+
+---
+
+## 6. Jalankan Aplikasi
+
+Buka browser:
+
+```text
+http://localhost/webgis_poverty
+```
+
+---
+
+# Akun Login
+
+## Administrator
+
+```text
+Username : admin
+Password : admin
+```
+
+---
+
+## Warga 1
+
+```text
+Username : andi
+Password : 123456
+```
+
+---
+
+## Warga 2
+
+```text
+Username : siti
+Password : 123456
+```
+
+---
+
+## Warga 3
+
+```text
+Username : rahmat
+Password : 123456
+```
+
+---
+
+## Customer Service (CS)
+
+```text
+Username : cs01
+Password : cs123
+```
+
+```text
+Username : cs02
+Password : cs123
+```
+
+---
+
+# Cara Penggunaan Sistem
+
+## Sebagai Warga
+
+### 1. Login
+
+Masukkan username dan password warga.
+
+### 2. Membuat Laporan
+
+Pilih menu:
+
+```text
+Buat Laporan
+```
+
+Isi data:
+
+* Nama Warga
+* Alamat
+* Kondisi Warga
+* Lokasi pada peta
+* Foto kondisi warga
+
+Kemudian klik:
+
+```text
+Kirim Laporan
+```
+
+Status awal laporan:
+
+```text
+Pending
+```
+
+---
+
+### 3. Melihat Status Laporan
+
+Pilih menu:
+
+```text
+Status Laporan
+```
+
+Warga dapat melihat:
+
+* Foto laporan
+* Tanggal laporan
+* Status laporan
+
+Status yang tersedia:
+
+```text
+Pending
+Disetujui
+Ditolak
+Diproses
+Selesai
+```
+
+---
+
+# Sebagai Administrator
+
+### 1. Login
+
+Gunakan akun administrator.
+
+### 2. Dashboard
+
+Administrator dapat melihat:
+
+* Total laporan
+* Statistik laporan
+* Grafik laporan
+* Data bantuan
+* Data rumah ibadah
+* Data CS
+
+---
+
+### 3. Validasi Laporan
+
+Pilih menu:
+
+```text
+Validasi Laporan
+```
+
+Administrator dapat:
+
+```text
+Approve
+Reject
+```
+
+Jika laporan disetujui maka status berubah menjadi:
+
+```text
+Disetujui
+```
+
+---
+
+### 4. Assign Bantuan
+
+Pilih tombol:
+
+```text
+Assign Bantuan
+```
+
+Administrator menentukan:
+
+* Rumah Ibadah
+* Customer Service
+* Jenis Bantuan
+
+Status laporan berubah menjadi:
+
+```text
+Diproses
+```
+
+---
+
+### 5. Monitoring Bantuan
+
+Pilih menu:
+
+```text
+Data Bantuan
+```
+
+Administrator dapat memantau:
+
+* Nama warga
+* Rumah ibadah
+* CS penyalur
+* Jenis bantuan
+* Status bantuan
+* Bukti foto bantuan
+
+---
+
+### 6. Kelola Rumah Ibadah
+
+Pilih menu:
+
+```text
+Rumah Ibadah
+```
+
+Administrator dapat:
+
+* Menambah rumah ibadah
+* Menghapus rumah ibadah
+* Menentukan lokasi rumah ibadah melalui peta
+
+---
+
+### 7. Peta GIS
+
+Pilih menu:
+
+```text
+Peta GIS
+```
+
+Fitur yang tersedia:
+
+* Marker lokasi laporan
+* Cluster marker
+* Filter status laporan
+* Popup detail laporan
+* Link Google Maps
+
+Warna marker:
+
+```text
+Orange  = Pending
+Green   = Disetujui
+Red     = Ditolak
+Blue    = Diproses
+Purple  = Selesai
+```
+
+---
+
+# Sebagai Customer Service Rumah Ibadah (CS)
+
+### 1. Login
+
+Masukkan akun CS.
+
+### 2. Lihat Tugas Bantuan
+
+Pilih menu:
+
+```text
+Tugas Bantuan
+```
+
+CS dapat melihat:
+
+* Nama warga
+* Alamat
+* Jenis bantuan
+* Status bantuan
+
+---
+
+### 3. Lihat Lokasi Warga
+
+Klik:
+
+```text
+Lihat Lokasi
+```
+
+Sistem akan membuka Google Maps berdasarkan koordinat laporan.
+
+---
+
+### 4. Upload Bukti Bantuan
+
+Klik:
+
+```text
+Upload Bukti
+```
+
+Kemudian:
+
+* Pilih foto dokumentasi bantuan
+* Upload foto
+
+Status bantuan otomatis menjadi:
+
+```text
+Selesai
+```
+
+Status laporan juga otomatis berubah menjadi:
+
+```text
+Selesai
+```
+
+---
+
+# Struktur Status Sistem
+
+## Status Laporan
+
+```text
+Pending
+Disetujui
+Ditolak
+Diproses
+Selesai
+```
+
+## Status Bantuan
+
+```text
+Proses
+Selesai
+```
+
+---
+
+# Penutup
+
+WebGIS Pengentasan Kemiskinan Kalimantan Barat dikembangkan untuk membantu proses identifikasi, validasi, penyaluran, dan monitoring bantuan sosial berbasis lokasi secara lebih efektif dan terintegrasi.
+
+© 2026
+
+Clara Oxana Azalia
+
+D1041231051