# Tugas Besar SIG - WebGIS Poverty Mapping

Repository ini berisi aplikasi utama Tugas Besar SIG dan artifact tugas kelas WebGIS dasar.

## Prioritas Penilaian

Jalankan dan nilai aplikasi utama pada folder:

```text
WebgisPovertyMapping/
```

Folder `01/` disertakan sebagai bukti tugas kelas/prototype pengembangan sebelum aplikasi final.

## Daftar Project

| Folder | Peran | Ringkasan |
| --- | --- | --- |
| `01/` | Tugas kelas WebGIS dasar | CRUD POI/lokasi usaha, digitasi jalan polyline, digitasi parsil polygon |
| `WebgisPovertyMapping/` | Aplikasi final tugas besar | Auth, role admin/operator/viewer, dashboard, kebutuhan bantuan, import/export, keamanan, laporan |

## Mapping Database

Setiap project memakai database terpisah agar schema tidak saling bertabrakan saat di-import.

```text
01                   -> db_webgis_01
WebgisPovertyMapping -> db_webgis
```

## URL Lokal Dengan Docker

Jalankan dari root repository dengan Docker Compose lokal:

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

Buka:

```text
http://localhost:8080/
http://localhost:8080/01/
http://localhost:8080/WebgisPovertyMapping/
```

Tambahkan `APP_PORT=8081` di `.env` jika port `8080` sudah dipakai.

## Quick Start Aplikasi Final

Setelah Docker berjalan, buka aplikasi final:

```text
http://localhost:8080/WebgisPovertyMapping/
```

Database `db_webgis` otomatis dibuat dan diisi dari `WebgisPovertyMapping/setup_database.sql` saat volume MariaDB Docker masih kosong.

XAMPP tidak lagi menjadi jalur utama. Jika perlu menjalankan mode legacy tanpa Docker, lihat `WebgisPovertyMapping/docs/deployment-xampp.md`.

## Quick Start Docker

Docker setup menjalankan dua service:

- `app`: PHP 8.2 + Apache untuk root repo, `01/`, dan `WebgisPovertyMapping/`.
- `db`: MariaDB 11.4 yang otomatis import `01/setup_database.sql` dan `WebgisPovertyMapping/setup_database.sql` saat volume database masih kosong.

Jalankan dari root repository:

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

Buka:

```text
http://localhost:8080/
http://localhost:8080/01/
http://localhost:8080/WebgisPovertyMapping/
```

Tambahkan `APP_PORT=8081` di `.env` jika port `8080` sudah dipakai. Untuk reset database Docker dari awal:

```bash
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
```

## Deployment Coolify

Gunakan repo ini sebagai source project Coolify dengan Docker Compose deployment. File `docker-compose.yml` adalah konfigurasi production: service `app` hanya memakai `expose: 80`, sehingga tidak membuka host port publik. Domain publik diarahkan oleh reverse proxy Coolify ke container port `80`; service `db` tetap private di network internal compose.

1. Push root repository ini ke Git provider yang bisa diakses Coolify.
2. Di Coolify, buat resource baru dari Git repository tersebut.
3. Pilih build pack/deployment type `Docker Compose`.
4. Pastikan compose file yang dipakai adalah `docker-compose.yml` di root repository.
5. Assign domain pada service `app`, misalnya:

```text
https://ifuntanhub.dev
```

Karena container Apache listen di port `80`, domain tidak perlu diberi suffix port.

6. Set environment variable berikut di Coolify:

```env
MARIADB_ROOT_PASSWORD=isi-password-kuat
```

7. Deploy. Saat database volume masih kosong, MariaDB otomatis menjalankan:

```text
01/setup_database.sql
WebgisPovertyMapping/setup_database.sql
```

8. Setelah deploy, buka URL publik Coolify root. Landing page akan menampilkan link ke project kelas `01/` dan aplikasi final `WebgisPovertyMapping/`.

Catatan penting:

- Jangan tambahkan `ports:` di `docker-compose.yml` production. Jika port host dipublish, service dapat terbuka di luar kontrol reverse proxy.
- `docker-compose.local.yml` hanya untuk development lokal dan tidak perlu dipilih di Coolify.
- Jika ingin langsung membuka aplikasi final sebagai halaman utama domain, atur domain/path di reverse proxy ke `/WebgisPovertyMapping/` atau ubah landing page root sesuai kebutuhan.
- Jika database Docker perlu direset di Coolify, hapus persistent volume database terlebih dahulu. Tanpa reset volume, file SQL init tidak dijalankan ulang oleh MariaDB.

## Environment

- Runtime utama: Docker Compose dengan PHP 8.2 Apache dan MariaDB 11.4.
- Di Docker, aplikasi memakai `DB_HOST=db` dan `DB_PORT=3306`.
- Default port `3307` hanya relevan untuk mode XAMPP legacy.
- Leaflet, Chart.js, font, tile peta, dan geocoding memakai CDN/layanan eksternal sehingga demo membutuhkan koneksi internet.
- File root `DESIGN.md` adalah catatan desain lokal yang tidak terkait pengumpulan dan diabaikan oleh `.gitignore`.

## Urutan Demo Yang Disarankan

1. Buka `WebgisPovertyMapping/` sebagai aplikasi final.
2. Login dengan akun demo:

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

3. Untuk akses publik tanpa login, buka langsung halaman peta aplikasi final.
4. Tunjukkan peta, dashboard, rumah ibadah, penduduk miskin, proximity/blank spot, kebutuhan bantuan, dan laporan.
5. Jika diminta bukti tugas kelas, buka `01/`.