Filosofi & Nilai Jual
Kayooh adalah aplikasi pelacak gowes mandiri (Self-Hosted) yang memberikan kedaulatan penuh atas data pribadi Anda. Di dunia di mana data adalah komoditas, Kayooh memastikan jejak rute dan statistik Anda tetap menjadi rahasia Anda, tersimpan aman di server pribadi Anda dengan akurasi sekelas perangkat profesional.
Fitur Unggulan
✅ Kelebihan Utama
- Privasi Mutlak: Data tersimpan di server Anda sendiri tanpa pihak ketiga.
- Map Matching OSRM: Garis rute secara cerdas "menempel" rapi di jalan raya.
- Black Box Auto-Save: Memori aman! Data gowes tidak hilang walau browser ter-reload.
- Stopwatch & Auto-Pause: Timer presisi tinggi berbasis stempel waktu (Timestamp).
- Bebas Biaya Langganan: Semua fitur analitik tersedia gratis 100% selamanya tanpa paywall.
- Strava Sync: Impor otomatis seluruh riwayat gowes historis Anda dari Strava.
- Ekspor GPX Universal: Unduh rute Anda kapan saja untuk dipindah ke platform lain.
- Telemetri Suhu Udara: Analisis cuaca otomatis via Open-Meteo API.
- Anti Brute-Force: Gerbang login dilengkapi Database IP Blocker.
- Night Ride Mode: Tema gelap otomatis yang nyaman dan peta anti-silau.
- Progressive Web App (PWA): Install ke HP & Offline Mode untuk hemat sinyal.
- Template Flexing: Ekspor gambar statistik transparan untuk sosial media.
⚠️ Karakteristik & Catatan Penggunaan
- Konsumsi Baterai: Menggunakan fitur Wake Lock API agar GPS tidak tertidur, layar HP akan terus menyala sehingga memakan daya lebih besar dibanding aplikasi native.
- Ketergantungan Internet: Meski bisa merekam offline, fitur tingkat lanjut (Suhu, Elevasi, dan Map Matching) mewajibkan koneksi internet aktif saat akan menyimpan aktivitas.
- Akurasi Hardware: Kualitas pelacakan murni bergantung pada kualitas sensor GPS HP Anda dan kondisi rintangan lingkungan (pepohonan/gedung tinggi).
- Tanggung Jawab Data: Karena ini sistem self-hosted tanpa cloud sentral, pencadangan (backup) file database SQLite adalah tanggung jawab Anda sepenuhnya.
- Wajib HTTPS: Keamanan sensor lokasi browser modern mewajibkan sertifikat SSL aktif di domain Anda.
- Setup Teknis: Membutuhkan pengetahuan dasar tentang manajemen web server atau hosting.
Transparansi & API Eksternal
Demi menjaga performa kelas atas tanpa mengorbankan privasi, Kayooh v2.0 mengandalkan beberapa layanan publik yang bersifat terbuka (Open Source) dan anonim. Sistem tidak pernah mengirimkan data identitas pribadi Anda (seperti email atau kata sandi) ke pihak-pihak ini:
- Open-Meteo API: Digunakan murni untuk menghitung total elevasi bukit dan mengambil sampel suhu udara setiap 15 menit berjalan.
- OSRM (Open Source Routing Machine) API: Berperan sebagai "tukang setrika" yang menempelkan titik-titik koordinat GPS Anda agar rapi mengikuti alur aspal di peta.
- OpenStreetMap (OSM): Dimuat melalui library Leaflet.js sebagai kanvas visual untuk menampilkan peta gowes Anda secara estetik.
- Strava API: Digunakan hanya jika Anda memilih untuk melakukan "Sync Strava" secara sukarela guna menyedot riwayat gowes lama Anda.
Panduan Instalasi Server
- Unggah kode sumber ke direktori web server (misal:
/var/www/html/kayooh).
- Pastikan direktori dapat ditulisi oleh PHP agar database SQLite bisa dibuat:
sudo chown -R www-data:www-data /folder-kayooh
sudo chmod -R 755 /folder-kayooh
- Akses domain Anda untuk memulai Setup Akun Admin via
install.php.
Panduan Lengkap API Strava
Agar Kayooh bisa menarik data lama Anda dari Strava, Anda perlu mendaftarkan aplikasi di portal pengembang Strava:
Langkah 1: Membuat Aplikasi API
- Login ke akun Strava Anda di PC/Laptop.
- Buka halaman My API Application: strava.com/settings/api.
- Isi formulir pembuatan aplikasi sebagai berikut:
- Application Name: Contoh: "Kayooh"
- Category: Pilih "Visualizer" atau "Other"
- Website: Isi dengan URL domain Kayooh Anda (misal:
https://jomokerto.web.id)
- Application Description: Contoh: "Self-hosted cycling tracker for personal use"
- Authorization Callback Domain: PENTING! Isi dengan nama domain saja tanpa https dan tanpa folder (misal:
jomokerto.web.id)
- Klik Create. Jika diminta mengunggah ikon, unggah gambar apa saja berukuran persegi.
Langkah 2: Mendapatkan Kredensial
- Setelah aplikasi dibuat, Anda akan melihat halaman ringkasan aplikasi.
- Catat Client ID dan Client Secret yang muncul. Jangan berikan kode ini kepada siapapun!
Langkah 3: Menghubungkan ke Kayooh
- Buka Dashboard Kayooh Anda, lalu klik tombol SYNC STRAVA.
- Masukkan Client ID dan Client Secret tadi ke form, lalu klik Simpan Pengaturan.
- Klik tombol 🔑 Dapatkan Token Sakti. Berikan izin akses pada halaman Strava yang muncul.
- Setelah kembali ke Kayooh, klik SINKRONISASI SEKARANG untuk mulai mengimpor data.