Skip to content
ChrisimanaPublic

About

Website kesiapsiagaan bencana untuk masyarakat Indonesia dengan peta zona risiko, jalur evakuasi, pemantauan cuaca real-time, analitik risiko, notifikasi darurat, dan panduan keselamatan untuk membantu pengguna menghadapi berbagai situasi bencana

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›ก๏ธ SafeRoute

Vue.js Vite Pinia Leaflet Chart.js Vitest fast-check Version Status

Platform web kesiapsiagaan bencana real-time untuk masyarakat Indonesia


๐Ÿ“‹ Deskripsi Proyek

SafeRoute adalah platform web interaktif berbasis Vue.js 3 yang membantu masyarakat umum menghadapi situasi bencana alam. Sistem ini menyediakan visualisasi zona aman dan rawan bencana, panduan jalur evakuasi tercepat, pemantauan cuaca dan risiko lokal secara real-time, serta notifikasi darurat otomatis melalui browser.

Proyek ini hadir untuk menjawab kebutuhan nyata masyarakat Indonesia yang tinggal di wilayah rawan bencana dengan memberikan informasi risiko yang mudah dipahami, jalur evakuasi yang jelas, dan panduan keselamatan yang komprehensif, semuanya langsung di browser tanpa instalasi tambahan dan 100% gratis.


๐Ÿ“‘ Daftar Isi


๐ŸŽฎ Demo

Coming Soon


๐Ÿ“ธ Tampilan Aplikasi

Halaman Beranda

Screenshot Beranda

Halaman Peta Interaktif

Screenshot Peta

Halaman Prakiraan Cuaca

Screenshot Cuaca

Halaman Analitik Risiko

Screenshot Analitik

Halaman Panduan Keselamatan

Screenshot Keselamatan

Halaman Tentang Aplikasi

Screenshot Tentang


๐ŸŽฏ Latar Belakang

Indonesia adalah salah satu negara paling rawan bencana di dunia. Berada di Cincin Api Pasifik, memiliki lebih dari 127 gunung berapi aktif, dan menghadapi ancaman banjir, tsunami, gempa bumi, serta cuaca ekstrem setiap tahunnya.

Kebutuhan yang melatarbelakangi proyek ini:

  • Kurangnya akses informasi risiko yang mudah dipahami karena banyak sistem peringatan dini yang terlalu teknis dan sulit diakses masyarakat umum
  • Minimnya panduan evakuasi berbasis lokasi untuk masyarakat sering tidak tahu harus ke mana saat bencana terjadi
  • Kebutuhan akan sistem real-time saat kondisi cuaca berubah cepat, dibutuhkan analisis risiko yang selalu diperbarui
  • Pentingnya edukasi kebencanaan terpusat untuk informasi prosedur evakuasi tersebar di berbagai sumber yang tidak terstruktur
  • Aksesibilitas tanpa instalasi dari aplikasi berbasis browser memungkinkan siapa saja mengakses tanpa mengunduh aplikasi

๐ŸŒŸ Fitur Utama

๐Ÿ—บ๏ธ Peta Interaktif Zona Risiko

Fitur Deskripsi
Visualisasi zona Polygon GeoJSON berwarna sesuai tingkat risiko (hijau/kuning/merah)
Popup informatif Klik zona untuk melihat nama, tingkat risiko, dan deskripsi bahaya
Marker evakuasi Titik pengungsian yang dapat diklik untuk info lokasi
Routing evakuasi Kalkulasi rute dari lokasi pengguna ke titik evakuasi terdekat
Lokasi pengguna Marker "you are here" otomatis mengikuti GPS pengguna

๐ŸŒค๏ธ Pemantauan Cuaca Real-time

Fitur Deskripsi
Cuaca terkini Suhu, kelembapan, curah hujan, kecepatan angin
Prakiraan mingguan 7 hari ke depan dengan ikon cuaca dan prediksi risiko
Feels-like Estimasi suhu yang dirasakan berdasarkan kelembapan
Tips dinamis Saran aktivitas berdasarkan kondisi cuaca aktual
Auto-retry Percobaan ulang otomatis setelah 60 detik jika API gagal

โš ๏ธ Deteksi Risiko Lokal

Level Kondisi
๐ŸŸข Rendah Curah hujan < 10 mm/jam
๐ŸŸก Sedang Curah hujan 10โ€“30 mm/jam
๐Ÿ”ด Tinggi Curah hujan > 30 mm/jam

๐Ÿ”” Notifikasi Darurat

  • Push notification browser otomatis saat risiko berubah ke Tinggi
  • Banner peringatan in-app terlepas dari status izin notifikasi
  • Pencegahan notifikasi duplikat dalam rentang < 10 menit
  • Polling pembaruan cuaca setiap 5 menit saat risiko tinggi

๐Ÿ“Š Analitik Risiko

  • Line chart curah hujan 24 jam terakhir
  • Bar chart distribusi tingkat risiko historis
  • Statistik: rata-rata risiko, kejadian risiko tinggi, waktu terakhir diperbarui
  • Data tersimpan di localStorage tanpa memerlukan backend

๐Ÿ›Ÿ Panduan Keselamatan

  • Prosedur evakuasi untuk 8 jenis bencana (Banjir, Gempa, Tsunami, Kebakaran, Gunung Berapi, Longsor, Puting Beliung, Kekeringan)
  • 80+ lokasi pengungsian resmi di seluruh 38 provinsi Indonesia
  • Filter lokasi pengungsian per provinsi
  • Tips keselamatan: tas darurat, nomor darurat, komunikasi keluarga

๐Ÿ› ๏ธ Teknologi yang Digunakan

Core Technologies

Teknologi Versi Fungsi
Vue.js 3 3.5 Framework UI dengan Composition API
Vite 8.0 Build tool dan dev server modern
Pinia 3.0 State management ringan untuk Vue
Vue Router 5.0 Client-side routing antar halaman

UI & Visualisasi

Library Versi Fungsi
Leaflet.js 1.9 Peta interaktif berbasis OpenStreetMap
Leaflet Routing Machine 3.2 Kalkulasi rute evakuasi
Chart.js 4.5 Grafik analitik risiko dan curah hujan

External APIs

API Fungsi
Open-Meteo Data cuaca real-time gratis tanpa API key
OpenStreetMap Tile peta dunia open-source
OSRM (via LRM) Kalkulasi rute evakuasi gratis
Browser Geolocation API Deteksi lokasi pengguna
Browser Notification API Push notification darurat

Testing

Library Versi Fungsi
Vitest 4.1 Test runner berbasis Vite
@vue/test-utils 2.4 Testing komponen Vue
fast-check 4.6 Property-based testing
jsdom 29.0 Simulasi DOM untuk testing

๐Ÿ—๏ธ Arsitektur

SafeRoute menggunakan arsitektur Single Page Application (SPA) berbasis Vue.js 3 dengan Composition API. Semua logika berjalan di sisi klien tanpa backend server.


๐Ÿ“ Struktur Proyek

saferoute/
โ”‚
โ”œโ”€โ”€ index.html                    # Entry point HTML
โ”œโ”€โ”€ package.json                  # Dependensi dan skrip npm
โ”œโ”€โ”€ vite.config.js                # Konfigurasi Vite + Vitest
โ”‚
โ”œโ”€โ”€ Screenshot/                   # Tampilan aplikasi
โ”‚
โ””โ”€โ”€ src/
    โ”œโ”€โ”€ main.js                   # Entry point Vue
    โ”œโ”€โ”€ App.vue                   # Root komponen + bootstrap data
    โ”œโ”€โ”€ style.css                 # CSS global
    โ”‚
    โ”œโ”€โ”€ router/
    โ”‚   โ””โ”€โ”€ index.js              # Konfigurasi Vue Router (9 rute)
    โ”‚
    โ”œโ”€โ”€ stores/
    โ”‚   โ”œโ”€โ”€ locationStore.js      # State koordinat & izin lokasi
    โ”‚   โ”œโ”€โ”€ weatherStore.js       # State cuaca & prakiraan
    โ”‚   โ”œโ”€โ”€ riskStore.js          # State risiko, histori, polling
    โ”‚   โ””โ”€โ”€ routeStore.js         # State rute evakuasi aktif
    โ”‚
    โ”œโ”€โ”€ composables/
    โ”‚   โ”œโ”€โ”€ useGeolocation.js     # Geolocation API wrapper
    โ”‚   โ”œโ”€โ”€ useWeather.js         # Fetch Open-Meteo + retry logic
    โ”‚   โ””โ”€โ”€ useRiskCalculator.js  # Rule-based risk engine
    โ”‚
    โ”œโ”€โ”€ utils/
    โ”‚   โ”œโ”€โ”€ mapUtils.js           # Style zona & popup GeoJSON
    โ”‚   โ”œโ”€โ”€ weatherUtils.js       # Proses prakiraan & ikon cuaca
    โ”‚   โ”œโ”€โ”€ analyticsUtils.js     # Kalkulasi statistik risiko
    โ”‚   โ”œโ”€โ”€ accessibilityUtils.js # Kalkulasi kontras warna WCAG
    โ”‚   โ”œโ”€โ”€ NotificationHandler.js# Browser Notification API
    โ”‚   โ””โ”€โ”€ __tests__/            # Unit & property tests
    โ”‚
    โ”œโ”€โ”€ views/
    โ”‚   โ”œโ”€โ”€ Home.vue              # Beranda dengan status & quick links
    โ”‚   โ”œโ”€โ”€ MapView.vue           # Peta interaktif Leaflet
    โ”‚   โ”œโ”€โ”€ WeatherForecast.vue   # Prakiraan cuaca mingguan
    โ”‚   โ”œโ”€โ”€ Analytics.vue         # Grafik analitik risiko
    โ”‚   โ”œโ”€โ”€ EvacuationRoute.vue   # Detail rute evakuasi
    โ”‚   โ”œโ”€โ”€ RiskStatus.vue        # Status risiko terkini
    โ”‚   โ”œโ”€โ”€ Safety.vue            # Panduan keselamatan (tab)
    โ”‚   โ”œโ”€โ”€ About.vue             # Tentang aplikasi
    โ”‚   โ””โ”€โ”€ NotFound.vue          # Halaman 404
    โ”‚
    โ”œโ”€โ”€ components/
    โ”‚   โ”œโ”€โ”€ NavBar.vue            # Navigasi utama + mobile menu
    โ”‚   โ”œโ”€โ”€ AppFooter.vue         # Footer hak cipta
    โ”‚   โ”œโ”€โ”€ RiskBadge.vue         # Badge level risiko berwarna
    โ”‚   โ”œโ”€โ”€ WeatherPanel.vue      # Panel cuaca terkini
    โ”‚   โ”œโ”€โ”€ EmergencyBanner.vue   # Banner darurat saat risiko tinggi
    โ”‚   โ””โ”€โ”€ EvacuationMarker.vue  # Marker titik evakuasi di peta
    โ”‚
    โ””โ”€โ”€ data/
        โ”œโ”€โ”€ zonaRisiko.json       # GeoJSON zona risiko 24 kota
        โ”œโ”€โ”€ evacuationPoints.js   # 80+ titik evakuasi 38 provinsi
        โ””โ”€โ”€ evacuationProcedures.js # Prosedur 8 jenis bencana

๐ŸŽฎ Cara Penggunaan

1. Pertama Kali Membuka Aplikasi

Saat pertama kali membuka, browser akan meminta izin akses lokasi. Klik Izinkan untuk deteksi GPS otomatis. Aplikasi akan langsung mengambil data cuaca dan menghitung tingkat risiko di lokasi Anda.

2. Beranda

  • Lihat status risiko lokal dan data cuaca terkini di hero section
  • Pantau status sistem (lokasi aktif, data cuaca tersedia)
  • Akses cepat ke semua fitur melalui kartu Fitur Utama
  • Lihat nomor darurat yang bisa langsung ditekan untuk menelepon

3. Peta Interaktif

  • Peta otomatis berpindah ke lokasi Anda saat GPS tersedia
  • Klik polygon zona risiko untuk melihat detail bahaya di area tersebut
  • Klik marker biru (titik evakuasi) untuk melihat info dan menghitung rute
  • Jika lokasi tidak tersedia, klik peta untuk menentukan titik awal manual

4. Prakiraan Cuaca

  • Lihat cuaca terkini dengan suhu, kelembapan, curah hujan, dan angin
  • Pantau prakiraan cuaca mingguan beserta prediksi risiko tiap hari
  • Baca tips hari ini yang disesuaikan dengan kondisi cuaca aktual

5. Analitik Risiko

  • Pantau grafik curah hujan 24 jam terakhir di lokasi Anda
  • Lihat distribusi tingkat risiko dari data historis yang tersimpan

6. Panduan Keselamatan

  • Pilih tab Prosedur Evakuasi untuk panduan langkah demi langkah per jenis bencana
  • Gunakan tab Lokasi Pengungsian dan filter per provinsi untuk menemukan shelter terdekat
  • Pelajari Tips Keselamatan dan Komunikasi Keluarga untuk persiapan darurat

๐Ÿ‘จโ€๐Ÿ’ป Peran Developer

Proyek ini dikembangkan secara mandiri sebagai proyek portofolio untuk mendemonstrasikan kemampuan pengembangan aplikasi web modern dengan Vue.js 3.

Area Kontribusi
Arsitektur Merancang alur data dari lokasi โ†’ cuaca โ†’ risiko โ†’ notifikasi โ†’ persistensi
UI/UX Desain antarmuka responsif dengan tema biru konsisten dan aksesibilitas WCAG
Peta Interaktif Integrasi Leaflet dengan GeoJSON, marker dinamis, routing, dan "you are here"
Mesin Risiko Rule-based risk engine berdasarkan threshold curah hujan
State Management Implementasi Pinia stores dengan reactive watchers dan localStorage
Notifikasi Browser Notification API dengan pencegahan duplikat dan polling otomatis
Analitik Chart.js line chart dan bar chart dengan data dari localStorage
Panduan Keselamatan Data 80+ titik evakuasi 38 provinsi dan 8 prosedur bencana
Testing 34 unit test dan property-based test dengan fast-check (18 properties)

๐Ÿ“š Pembelajaran dari Proyek (Lessons Learned)

1. Vue.js 3 Composition API

// Composable yang reusable dan testable
export function useRiskCalculator() {
  const riskLevel = ref(null)
  const riskColor = ref(null)

  function calculateRisk(weatherData) {
    const { precipitation } = weatherData
    if (precipitation < 10) return 'Rendah'
    if (precipitation <= 30) return 'Sedang'
    return 'Tinggi'
  }

  return { riskLevel, riskColor, calculateRisk }
}

2. Pinia untuk State Management Reaktif

// Watch antar store untuk alur data otomatis
watch(() => weatherStore.currentWeather, (weather) => {
  if (weather) riskStore.setRisk(computeRisk(weather))
})

3. Leaflet dengan ES Module (UMD workaround)

// leaflet-routing-machine butuh L sebagai global
import L from 'leaflet'
if (typeof window !== 'undefined') window.L = L
import 'leaflet-routing-machine'

4. Property-Based Testing dengan fast-check

// Menguji properti yang harus berlaku untuk semua input valid
test('kalkulasi risiko sesuai threshold', () => {
  fc.assert(
    fc.property(fc.float({ min: 0, max: 200 }), (precipitation) => {
      const result = calculateRisk({ precipitation })
      if (precipitation < 10) return result === 'Rendah'
      if (precipitation <= 30) return result === 'Sedang'
      return result === 'Tinggi'
    }),
    { numRuns: 100 }
  )
})

5. Leaflet invalidateSize untuk Rendering yang Benar

// Peta terpotong jika container belum punya dimensi final
nextTick(() => { mapInstance.invalidateSize() })
setTimeout(() => { mapInstance.invalidateSize() }, 300)

6. localStorage Round-trip untuk Persistensi

// Simpan dan baca data historis tanpa backend
function saveRecord(record) {
  history.value.push(record)
  localStorage.setItem(STORAGE_KEY, JSON.stringify(history.value))
}

๐Ÿ™ Ucapan Terima Kasih

API & Data

  • Open-Meteo โ€” API cuaca real-time gratis dan open-source tanpa API key
  • OpenStreetMap โ€” Tile peta dunia berbasis komunitas
  • OSRM โ€” Kalkulasi rute evakuasi gratis via Leaflet Routing Machine
  • BMKG โ€” Referensi standar peringatan cuaca Indonesia
  • BNPB โ€” Referensi informasi dan prosedur kebencanaan Indonesia

Library & Tools

  • Vue.js โ€” Framework UI yang powerful dengan ekosistem lengkap
  • Pinia โ€” State management yang simpel dan efisien
  • Leaflet.js โ€” Library peta open-source yang ringan
  • Chart.js โ€” Visualisasi grafik yang fleksibel
  • Vite โ€” Build tool modern yang sangat cepat
  • Vitest โ€” Test runner yang terintegrasi sempurna dengan Vite
  • fast-check โ€” Property-based testing yang powerful
  • Shields.io โ€” Badge untuk README

Dokumentasi Referensi


โญ Jika proyek ini bermanfaat, jangan lupa beri bintang! โญ

"Kesiapsiagaan bukan soal takut pada bencana, tapi soal siap menghadapinya."

About

Website kesiapsiagaan bencana untuk masyarakat Indonesia dengan peta zona risiko, jalur evakuasi, pemantauan cuaca real-time, analitik risiko, notifikasi darurat, dan panduan keselamatan untuk membantu pengguna menghadapi berbagai situasi bencana

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages