Aplikasi utama Tugas Besar SIG untuk pemetaan warga miskin, rumah ibadah, kebutuhan bantuan, status bantuan, dan blank spot layanan berbasis Leaflet, PHP, dan MySQL/MariaDB.

Status audit terakhir: 2026-06-03. Kode aktif sudah memakai validasi koordinat bersama, CSRF untuk mutasi terautentikasi, session cookie hardening, scope operator, masking data publik, verifikasi warga sebelum workflow bantuan/kebutuhan, dan kebijakan import admin langsung Terverifikasi.

Catatan submit: project final ini sekarang dijalankan lewat Docker Compose dari root repository webgis/. Runtime utama memakai PHP 8.2 Apache dan MariaDB 11.4; database db_webgis otomatis dibuat dari setup_database.sql saat volume MariaDB masih kosong. SQL setup menggunakan syntax MariaDB-friendly seperti ADD COLUMN IF NOT EXISTS.

Stack

PHP procedural dengan MySQLi
MySQL/MariaDB
Leaflet untuk peta interaktif
Chart.js untuk statistik
Vanilla JavaScript modules
Docker Compose sebagai runtime utama
XAMPP/Laragon/WAMP hanya sebagai opsi legacy lokal

Struktur Utama

WebgisPovertyMapping/
├── index.php              # Shell peta utama
├── dashboard.php          # Dashboard administrator
├── config.php             # Konfigurasi app, session, dan database
├── koneksi.php            # Koneksi DB + Haversine/proximity helper
├── setup_database.sql     # Schema database dan seed admin
├── auth/                  # Login, change password, session/RBAC helper
├── api/                   # Endpoint JSON/CSV/HTML per domain
├── pages/                 # Halaman admin/operator
├── modules/               # JavaScript map modules
├── css/                   # CSS admin
├── tests/                 # Test PHP ad-hoc
└── docs/                  # Dokumentasi audit, deployment, dan superpowers plans/specs

Setup Lokal Dengan Docker

Jalankan dari root repository webgis/, bukan dari folder WebgisPovertyMapping/:

cp .env.example .env
docker compose -f docker-compose.yml -f docker-compose.local.yml up --build -d

Akses aplikasi:

http://localhost:8080/WebgisPovertyMapping/

Tambahkan APP_PORT=8081 di file .env root jika port 8080 sudah dipakai. Database akan otomatis diinisialisasi oleh container MariaDB dari WebgisPovertyMapping/setup_database.sql.

Untuk reset database Docker dari awal:

docker compose -f docker-compose.yml -f docker-compose.local.yml down -v
docker compose -f docker-compose.yml -f docker-compose.local.yml up --build -d

XAMPP tidak lagi menjadi jalur utama. Dokumentasi XAMPP tetap ada sebagai referensi legacy di docs/deployment-xampp.md.

Akun Default

Default akun demo untuk penilaian:

Administrator: admin / password
Operator     : operator / password
Viewer       : viewer / password

Untuk demo penilaian, akun tersebut tidak dipaksa mengganti password saat login pertama.

Role

viewer: akses publik/read-only, data sensitif penduduk dimasking.
operator: tambah/mengelola warga dan kebutuhan dalam rumah ibadah yang ditugaskan.
administrator: kelola semua data, rumah ibadah, pengguna, import/export, verifikasi, dan recalculation.

Publik tanpa login tetap bisa membuka peta sebagai viewer read-only. Dashboard admin tidak menawarkan pembuatan akun viewer baru karena akses publik tidak membutuhkan akun; role tersebut dipertahankan sebagai fallback RBAC dan kompatibilitas akun lama.

Operator harus dikaitkan ke satu rumah_ibadah melalui halaman manajemen user.

Model ownership warga saat ini adalah proximity-only: penduduk_miskin.ibadah_id dihitung dari radius rumah ibadah terdekat dan menjadi dasar scope operator. Jika posisi/radius rumah ibadah berubah, admin dapat menjalankan hitung ulang proximity dan assignment warga bisa berubah mengikuti hasil spasial terbaru.

Fitur Utama

Peta interaktif Pontianak berbasis Leaflet.
Layer rumah ibadah dengan radius layanan.
Layer penduduk miskin dengan proximity dan blank spot.
Status bantuan dan riwayat perubahan.
Kebutuhan bantuan per warga dan papan kebutuhan publik.
Dashboard statistik dan heatmap untuk operator/admin.
Import CSV dan export laporan.
RBAC berbasis session.
Proteksi data publik: hanya warga Terverifikasi yang tampil, PII dimasking, dan koordinat rumah warga tidak dikirim untuk pengunjung publik.
Workflow bantuan/kebutuhan hanya aktif untuk warga Terverifikasi.

Dokumentasi Teknis

docs/codebase-navigation.md: navigasi struktur repo, schema, endpoint, modul frontend, proximity, dan RBAC.
docs/codebase-audit-report.md: laporan proses bisnis, wiring backend/frontend, data lifecycle, catatan logika, prioritas fix, dan saran pengembangan.
docs/business-process-sop.md: SOP proses bisnis aktif untuk admin, operator, publik, dan donatur.
docs/deployment-docker.md: panduan deployment Docker/Coolify, reverse proxy, database container, dan troubleshooting.
docs/deployment-xampp.md: referensi legacy jika harus menjalankan aplikasi tanpa Docker.
docs/audit-fix-task-plan.md: task plan audit/hardening lintas fase.
docs/superpowers/README.md: indeks dokumen superpowers aktif.
docs/superpowers/plans/2026-06-03-codebase-audit-refresh.md: ringkasan audit implementasi terbaru.
Tugas/ dan DESIGN.md adalah artifact lama/pendukung; gunakan dokumen di atas sebagai referensi implementasi aktif.

Catatan Audit 2026-06-03

Yang sudah terlihat terpasang di kode:

Validasi koordinat terpusat di includes/validation.php dan bounds wilayah studi di config.php.
Import CSV admin menyimpan warga sebagai Terverifikasi beserta verified_by dan verified_at.
Duplikasi NIK dicek terhadap semua record, termasuk arsip/inactive, agar validasi PHP sejalan dengan unique index database.
Endpoint kebutuhan dan status bantuan menolak warga yang belum Terverifikasi.
Statistik operator sudah scoped ke rumah ibadah operator.
Heatmap publik disembunyikan; heatmap menggunakan dataset internal untuk operator/admin.
User management mencegah self-demotion administrator dan operator ke rumah ibadah yang sudah dihapus.

Sisa pekerjaan yang masih disarankan:

Rate limit session sederhana sudah aktif untuk form kontak donatur publik; pertimbangkan CAPTCHA atau rate limit IP untuk deploy publik serius.
Pertimbangkan model ownership hybrid jika tanggung jawab operasional operator harus dipisah dari hasil proximity spasial.
Perluas tests/run_all.php jika ingin mencakup semua test DB smoke test dalam satu runner.
Siapkan mirror lokal untuk CDN/tile provider bila deployment berada di jaringan tertutup.

Test dan Verifikasi Dengan Docker

Lint semua file PHP:

docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app sh -lc 'find /var/www/html/WebgisPovertyMapping -name "*.php" -print0 | xargs -0 -n1 php -l'

Test ad-hoc statis yang aman dijalankan dari root project:

docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/run_all.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_verifikasi_binding.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_update_posisi_scope.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_operator_scope_endpoints.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_public_verification_filters.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_frontend_module_loader.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_frontend_reliability_guards.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_no_legacy_poi.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_viewer_public_filters.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_operator_scope_strict.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_penduduk_binding_types.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_csrf_enforcement.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_session_cookie_security.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_operator_ibadah_highlight.php
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app php /var/www/html/WebgisPovertyMapping/tests/test_viewer_account_ui_hidden.php

Test yang memuat ../config.php atau ../koneksi.php perlu dijalankan dari folder tests:

docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app sh -lc 'cd /var/www/html/WebgisPovertyMapping/tests && php test_auth_helper.php'
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app sh -lc 'cd /var/www/html/WebgisPovertyMapping/tests && php test_db.php'
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app sh -lc 'cd /var/www/html/WebgisPovertyMapping/tests && php test_ibadah.php'
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app sh -lc 'cd /var/www/html/WebgisPovertyMapping/tests && php test_kebutuhan.php'
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app sh -lc 'cd /var/www/html/WebgisPovertyMapping/tests && php test_penduduk.php'
docker compose -f ../docker-compose.yml -f ../docker-compose.local.yml exec app sh -lc 'cd /var/www/html/WebgisPovertyMapping/tests && php test_proximity.php'

Beberapa test membutuhkan container database yang sudah sehat. Jika menjalankan mode XAMPP legacy, sesuaikan command PHP dan port database mengikuti docs/deployment-xampp.md.