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.
- Demo
- Tampilan Aplikasi
- Latar Belakang
- Fitur Utama
- Teknologi yang Digunakan
- Arsitektur
- Struktur Proyek
- Cara Penggunaan
- Peran Developer
- Pembelajaran dari Proyek
- Ucapan Terima Kasih
Coming Soon
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 | 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 |
| 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 |
| Level | Kondisi |
|---|---|
| ๐ข Rendah | Curah hujan < 10 mm/jam |
| ๐ก Sedang | Curah hujan 10โ30 mm/jam |
| ๐ด Tinggi | Curah hujan > 30 mm/jam |
- 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
- 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
- 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 | 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 |
| 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 |
| 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 |
| 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 |
SafeRoute menggunakan arsitektur Single Page Application (SPA) berbasis Vue.js 3 dengan Composition API. Semua logika berjalan di sisi klien tanpa backend server.
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
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.
- 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
- 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
- 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
- Pantau grafik curah hujan 24 jam terakhir di lokasi Anda
- Lihat distribusi tingkat risiko dari data historis yang tersimpan
- 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
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) |
// 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 }
}// Watch antar store untuk alur data otomatis
watch(() => weatherStore.currentWeather, (weather) => {
if (weather) riskStore.setRisk(computeRisk(weather))
})// leaflet-routing-machine butuh L sebagai global
import L from 'leaflet'
if (typeof window !== 'undefined') window.L = L
import 'leaflet-routing-machine'// 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 }
)
})// Peta terpotong jika container belum punya dimensi final
nextTick(() => { mapInstance.invalidateSize() })
setTimeout(() => { mapInstance.invalidateSize() }, 300)// Simpan dan baca data historis tanpa backend
function saveRecord(record) {
history.value.push(record)
localStorage.setItem(STORAGE_KEY, JSON.stringify(history.value))
}- 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
- 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
- MDN Web Docs โ Referensi Web API (Geolocation, Notifications, localStorage)
- WMO Weather Codes โ Standar kode cuaca internasional
โญ Jika proyek ini bermanfaat, jangan lupa beri bintang! โญ
"Kesiapsiagaan bukan soal takut pada bencana, tapi soal siap menghadapinya."





