From e35bc5166f9c7e001298bc01a31bcac32965177b Mon Sep 17 00:00:00 2001 From: NelsonDavey17 Date: Wed, 3 Jun 2026 02:15:51 +0700 Subject: [PATCH] 2nd commit: - --- README.md | 107 +++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 102 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 9a3cb42..28430e5 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,102 @@ -πŸ—ΊοΈ WebGIS Pemetaan Kemiskinan dan Distribusi Bantuan (Kota Pontianak)Sebuah Sistem Informasi Geografis (GIS) berbasis web yang dirancang dengan arsitektur Single Page Application (SPA) untuk memetakan demografi kemiskinan, mengkalkulasi kelayakan bantuan secara otomatis, mengelola respons darurat musibah, dan memfasilitasi pendataan talenta untuk program pemberdayaan warga.Sistem ini dibangun dengan kontrol otorisasi tingkat lanjut (RBAC & Geofencing) serta menggunakan algoritma Sistem Pendukung Keputusan (SPK) terintegrasi.✨ Fitur Utama (Core Features)Gatekeeper Authentication: Sistem layar kunci persisten dengan enkripsi kata sandi menggunakan standar BCRYPT dan validasi sesi via API (Anti Client-Side Amnesia).Pemetaan Spasial & Geofencing: Visualisasi interaktif titik infrastruktur dan batas wewenang radius operasional rumah ibadah menggunakan Leaflet.js dan Reverse Geocoding via Nominatim API.SPK Kemiskinan Otomatis: Menghitung Tingkat Kemiskinan (Sangat Miskin, Miskin, Rentan) secara dinamis menggunakan parameter Garis Kemiskinan Regional dan observasi aset fisik (Proxy Means Testing / PMT).Distribusi Bantuan Cerdas (Smart Autofill): Memberikan rekomendasi takaran logistik pro-rata berdasarkan status keparahan kemiskinan.Manajemen Krisis (Visual Alert): Peringatan dini berbasis geospasial menggunakan rendering animasi kelap-kelip merah pada titik lokasi keluarga yang mengalami musibah darurat.Resolusi Musibah Otomatis (Auto-Resolve): Menerapkan Database Transactions di mana penyaluran logistik akan secara otomatis memadamkan status darurat warga.Filter Pelatihan Algoritmik: Guard clause otomatis untuk menyeleksi kandidat pelatihan berdasarkan batas usia produktif, tingkat pendidikan, dan status pengangguran dari tabel Anggota Keluarga.πŸ› οΈ Stack Teknologi (Tech Stack)Frontend:HTML5 & CSS3 (Native)JavaScript (ES6+ / Vanilla JS)Leaflet.js (Pustaka Pemetaan Klien)Fetch API (Asynchronous HTTP Requests)Backend:PHP 8.x (API Endpoints & Sesi)PDO (PHP Data Objects) untuk interaksi basis dataMySQL / MariaDB (Database Relasional)βš™οΈ Persyaratan Sistem (Prerequisites)Untuk menjalankan proyek ini di mesin lokal, Anda membutuhkan:Web Server lokal seperti XAMPP, MAMP, atau Laragon.PHP Engine (Minimal versi 7.4, direkomendasikan versi 8.x).MySQL Database.Koneksi internet stabil (diperlukan untuk memuat aset basemap OpenStreetMap dan fitur Reverse Geocoding).πŸš€ Panduan Instalasi (Installation Guide)Ikuti langkah-langkah berikut untuk menjalankan sistem di lingkungan pengembangan lokal (localhost):Clone RepositoriBuka terminal/CMD dan jalankan perintah berikut di dalam direktori publik web server Anda (misal: C:\xampp\htdocs\):git clone [https://github.com/username-anda/nama-repositori-anda.git](https://github.com/username-anda/nama-repositori-anda.git) -Konfigurasi DatabaseBuka phpMyAdmin (biasanya di http://localhost/phpmyadmin).Buat sebuah database baru dengan nama webgis_kemiskinan (atau sesuai nama database Anda).Import file SQL yang telah disediakan di repositori ini (misal: database_auth.sql atau file dump lengkap sistem Anda) ke dalam database yang baru dibuat.Konfigurasi Koneksi PHPBuka file koneksi.php di dalam root direktori proyek, dan pastikan kredensial basis data sesuai dengan konfigurasi lokal Anda:$host = "localhost"; +πŸ—ΊοΈ WebGIS Pemetaan Kemiskinan dan Distribusi Bantuan (Kota Pontianak) + +Sebuah Sistem Informasi Geografis (GIS) berbasis web yang dirancang dengan arsitektur Single Page Application (SPA) untuk memetakan demografi kemiskinan, mengkalkulasi kelayakan bantuan secara otomatis, mengelola respons darurat musibah, dan memfasilitasi pendataan talenta untuk program pemberdayaan warga. + +Sistem ini dibangun dengan kontrol otorisasi tingkat lanjut (Single-Tier Gatekeeper) serta menggunakan algoritma Sistem Pendukung Keputusan (SPK) terintegrasi untuk distribusi bantuan yang tepat sasaran. + +✨ Fitur Utama (Core Features) + +Gatekeeper Authentication: Sistem layar kunci persisten dengan enkripsi kata sandi menggunakan standar BCRYPT dan validasi sesi via API (Anti Client-Side Amnesia). + +Pemetaan Spasial & Geofencing: Visualisasi interaktif titik infrastruktur dan batas wewenang radius operasional rumah ibadah menggunakan Leaflet.js dan Reverse Geocoding via Nominatim API. + +SPK Kemiskinan Otomatis: Menghitung Tingkat Kemiskinan (Sangat Miskin, Miskin, Rentan) secara dinamis menggunakan parameter Garis Kemiskinan Regional dan observasi aset fisik (Proxy Means Testing / PMT). + +Distribusi Bantuan Cerdas (Smart Autofill): Memberikan rekomendasi takaran logistik pro-rata berdasarkan status keparahan kemiskinan. + +Manajemen Krisis (Visual Alert): Peringatan dini berbasis geospasial menggunakan rendering animasi kelap-kelip merah (GPU Accelerated) pada titik lokasi keluarga yang mengalami musibah darurat. + +Resolusi Musibah Otomatis (Auto-Resolve): Menerapkan Database Transactions di mana penyaluran logistik akan secara otomatis memadamkan status darurat warga. + +Filter Pelatihan Algoritmik: Guard clause otomatis untuk menyeleksi kandidat pelatihan berdasarkan batas usia produktif, tingkat pendidikan, dan status pengangguran dari tabel Anggota Keluarga. + +πŸ› οΈ Stack Teknologi (Tech Stack) + +Frontend: + +HTML5 & CSS3 (Native) + +JavaScript (ES6+ / Vanilla JS) + +Leaflet.js (Pustaka Pemetaan Klien) + +Fetch API (Asynchronous HTTP Requests) + +Backend: + +PHP 8.x (API Endpoints & Sesi) + +PDO (PHP Data Objects) untuk interaksi basis data + +MySQL / MariaDB (Database Relasional) + +βš™οΈ Persyaratan Sistem (Prerequisites) + +Untuk menjalankan proyek ini di mesin lokal, Anda membutuhkan: + +Web Server lokal seperti XAMPP, MAMP, atau Laragon. + +PHP Engine (Minimal versi 7.4, direkomendasikan versi 8.x). + +MySQL Database. + +Koneksi internet stabil (diperlukan untuk memuat aset basemap OpenStreetMap dan fitur Reverse Geocoding). + +πŸš€ Panduan Instalasi (Installation Guide) + +Ikuti langkah-langkah berikut untuk menjalankan sistem di lingkungan pengembangan lokal (localhost): + +Clone Repositori +Buka terminal/CMD dan jalankan perintah berikut di dalam direktori publik web server Anda (misal: C:\xampp\htdocs\): + +git clone [https://github.com/username-anda/nama-repositori-anda.git](https://github.com/username-anda/nama-repositori-anda.git) + + +Konfigurasi Database + +Buka phpMyAdmin (biasanya di http://localhost/phpmyadmin). + +Buat sebuah database baru dengan nama webgis_kemiskinan (atau sesuai nama database Anda). + +Import file SQL database_lengkap.sql yang telah disediakan di repositori ini ke dalam database yang baru dibuat. + +Konfigurasi Koneksi PHP +Buka file koneksi.php di dalam root direktori proyek, dan pastikan kredensial basis data sesuai dengan konfigurasi lokal Anda: + +$host = "localhost"; $user = "root"; // Username default XAMPP $pass = ""; // Kosongkan jika XAMPP default $dbname = "webgis_kemiskinan"; // Sesuaikan dengan nama database Anda -Jalankan AplikasiBuka web browser dan akses direktori proyek Anda:http://localhost/nama-folder-proyek/ -πŸ”’ Akses Pengujian (Dummy Credentials)Gunakan kredensial berikut untuk melewati layar kunci (Gatekeeper) pada saat pengujian sistem:Username: admin (contoh)Password: 123456 (contoh)(Catatan: Anda dapat membuat akun baru melalui tab "Daftar" di layar awal sistem).πŸ“‚ Struktur Direktori (Directory Structure)πŸ“¦ root-directory + + +Jalankan Aplikasi +Buka web browser dan akses direktori proyek Anda: + +http://localhost/nama-folder-proyek/ + + +πŸ”’ Akses Pengujian (Dummy Credentials) + +Gunakan kredensial berikut untuk melewati layar kunci (Gatekeeper) pada saat pengujian sistem: + +Username: admin (contoh, ubah sesuai isi database Anda) + +Password: 123456 (contoh) +(Catatan: Anda dapat membuat akun baru melalui tab "Daftar" di layar awal sistem jika tabel users masih kosong). + +πŸ“‚ Struktur Direktori (Directory Structure) + +πŸ“¦ root-directory ┣ πŸ“‚ components # Komponen UI modular (Sidebar, Modals) ┣ πŸ“‚ otak_auth # API Backend untuk Login, Register, Sesi & Logout ┣ πŸ“‚ otak_kemiskinan # API Backend untuk logika CRUD & SPK warga, anggota, pelatihan @@ -14,5 +106,10 @@ Jalankan AplikasiBuka web browser dan akses direktori proyek Anda:http://localho ┣ πŸ“œ app.js # Otak Utama Sistem (Logika Spasial & State Management) ┣ πŸ“œ style.css # Desain Kosmetik UI dan Animasi GPU ┣ πŸ“œ koneksi.php # Jembatan penghubung ke Database MySQL + ┣ πŸ“œ database_lengkap.sql # File dump database mutlak untuk instalasi β”— πŸ“œ index.php # Entry point aplikasi -πŸ“ LisensiProyek ini dikembangkan sebagai bagian dari penelitian akademik/tugas perkuliahan Universitas Tanjungpura (2026). Segala bentuk distribusi dan modifikasi mengacu pada kebijakan hak cipta yang berlaku.Dibangun dengan presisi logika dan ketajaman rasional. \ No newline at end of file + + +πŸ“ Lisensi + +Proyek ini dikembangkan sebagai bagian dari penelitian akademik/tugas perkuliahan Universitas Tanjungpura (2026). Segala bentuk distribusi dan modifikasi mengacu pada kebijakan hak cipta yang berlaku. \ No newline at end of file