Kayooh

Kedaulatan Data di Tangan Anda

Gowes tenang, data aman. Tracker cerdas mandiri yang ringan di memori, namun sangat mematikan di jalanan aspal.

#KayoohTerus

Filosofi & Nilai Jual

Kayooh adalah aplikasi pelacak gowes mandiri (Self-Hosted) kelas Enterprise yang memberikan kedaulatan penuh atas data pribadi Anda. Dengan arsitektur hybrid terbaru yang memisahkan beban database lokal dan satelit Object Storage, Kayooh menjamin kinerja secepat kilat meski menyimpan puluhan ribu rekor gowes Anda seumur hidup.

Fitur Unggulan

โœ… Kelebihan & Fitur Super

  • ๐ŸŽ™๏ธ Radio Peleton (Walkie Talkie): Komunikasi suara antar peserta murni via browser dengan Native Web API. Terdapat Auto-Sweeper pembersih cache memori.
  • ๐Ÿ—ฃ๏ธ Smart Voice Coach: Asisten suara pintar berbahasa Indonesia pembaca jarak dan kecepatan setiap 5 KM.
  • ๐Ÿ’ง Hydration Coach & Night Mode: Asisten pengingat minum tiap 20 menit, dan peta adaptif yang otomatis berubah gelap di malam hari.
  • ๐ŸŒ‘ Stealth Mode (Pocket Lock): Fitur UI hitam pekat penyelamat baterai AMOLED dan anti-kepencet di dalam tas (Double Tap to Wake).
  • ๐ŸŽต Local Jukebox Engine: Pemutar musik MP3 offline mandiri terintegrasi di layar perekaman. Dilengkapi algoritma Smart Shuffle anti-ulang, Panic Skip Button, dan efek redup otomatis (Audio Ducking) saat Voice Coach berbicara.
  • Cloudflare R2 Integration: Database SQLite dijamin bebas bengkak. Kordinat masif dititipkan aman ke satelit Cloudflare R2 secara instan.
  • IndexedDB Black Box: Penyimpanan darurat offline tahan banting dari resiko browser crash.
  • Peleton Radar Sync: Mesin pengawas terpusat pemantau titik seluruh peserta Peleton secara real-time di satu peta.
  • Strava Mass-Sync: Mesin penyedot data dengan Pagination aman untuk menarik ratusan sejarah gowes lawas.
  • Live Tracking Telegram: Siaran posisi dan notifikasi Start/Finish langsung ke grup Telegram keluarga secara otomatis.
  • Telemetri Suhu Udara: Sensor cuaca otomatis via Open-Meteo API setiap 15 menit berjalan.
  • Offline GPX Extractor: Kemerdekaan mutlak mengekstrak rute jadi .gpx murni tanpa pihak ketiga.
  • ๐Ÿ“ธ Social Flexing (Share Map/Stats): Ekspor jalur rute dan statistik gowes Anda menjadi gambar premium yang siap dipamerkan ke Instagram atau grup WhatsApp hanya dengan satu klik!

โš ๏ธ Catatan Penggunaan

  • Konfigurasi Cloudflare R2 (Opsional/Disarankan): Tidak wajib, namun sangat direkomendasikan untuk menautkan bucket R2 agar memori/hardisk VPS atau hosting Anda tidak bengkak oleh tumpukan file JSON rute.
  • Konsumsi Baterai Ekstra: Menggunakan Wake Lock API agar layar HP terus menyala. Pastikan baterai Anda penuh atau gunakan Stealth Mode.
  • Ketergantungan Internet: Meski Black Box bekerja offline, fitur Radar Peleton, Live Telegram, dan R2 mewajibkan koneksi internet aktif.
  • Sertifikat SSL (HTTPS) Mutlak: Fitur keamanan sensor Geolocation browser (Chrome/Safari) mewajibkan akses via HTTPS.
  • Akurasi Perangkat: Kayooh meminta akurasi tinggi. Jika cuaca buruk atau HP di dalam tas tebal, rute garis (polyline) mungkin sedikit melompat.

Transparansi API Eksternal

Kayooh hanya mengandalkan beberapa layanan publik kelas kakap untuk memaksimalkan fitur tanpa mengorbankan privasi Anda:

Panduan Instalasi Server (First-Time Setup)

Kayooh dirancang agar sangat ringan dan gampang di-deploy di VPS atau Shared Hosting (cPanel).

  1. Persyaratan Sistem: Pastikan server menjalankan PHP (versi 7.4/8.0+) dan ekstensi SQLite3 aktif.
  2. Unggah File: Upload source code Kayooh ke direktori web Anda (misal: public_html/).
  3. Hak Akses (Permissions): Pastikan folder instalasi memiliki izin tulis (misal: chmod 755) untuk menciptakan kayooh.sqlite dan menulis log.
  4. Jalankan Installer: Buka URL instalasi: https://domain-anda.com/install.php
  5. Buat Akun Kapten: Masukkan email dan sandi kuat. Sistem otomatis mengunci file instalasi setelah selesai.

Panduan Live Tracking Telegram

Siarkan posisi gowes Anda langsung ke keluarga tanpa mereka harus menginstal aplikasi Kayooh!

Langkah 1: Membuat Bot

  1. Cari @BotFather di Telegram. Ketik /newbot dan ikuti instruksi.
  2. Simpan Bot Token API yang diberikan.

Langkah 2: Grup Komando & Chat ID

  1. Buat grup keluarga dan masukkan Bot Anda ke dalamnya (jadikan Admin).
  2. Undang sementara bot @RawDataBot ke grup untuk melihat struktur datanya.
  3. Catat angka ID pada bagian "chat": { "id": -100XXXXXXXXX } (jangan lupakan tanda minusnya).

Langkah 3: Tautkan & Gowes

  1. Buka menu โš™๏ธ Pengaturan di Dashboard Kayooh.
  2. Masukkan Bot Token dan Chat ID, lalu Simpan.
  3. Klik ๐Ÿš€ SOLO atau ๐Ÿ‘ฅ PELETON untuk mulai mengirim notifikasi otomatis!

Panduan Mode Peleton & Radio

Langkah 1: Inisiasi Kapten

  1. Klik ๐Ÿ‘ฅ PELETON dari Dashboard. Sistem akan men-generate 6 digit Room ID.
  2. Klik ๐Ÿ”— COPY LINK dan bagikan tautannya ke grup WhatsApp teman gowes.

Langkah 2: Peserta Bergabung (Guest)

  1. Peserta mengklik link tadi, masukkan nama, dan klik MULAI TRACKING.
  2. Browser Guest akan merekam kordinat mandiri dan memancarkannya ke Radar Kapten.

Langkah 3: Radio Peleton ๐ŸŽ™๏ธ

  1. Perhatikan panel radio di pojok kanan bawah.
  2. Tekan dan tahan tombol ๐ŸŽค TAHAN UNTUK BICARA, lalu lepaskan untuk mengirim pesan suara ke seluruh grup seketika!

Panduan Sinkronisasi API Strava

  1. Buka halaman Strava API Settings di PC Anda.
  2. Buat aplikasi. Pada kolom Authorization Callback Domain, isi hanya domain Anda (misal: jomokerto.web.id).
  3. Catat Client ID dan Client Secret yang muncul.
  4. Masukkan ke dalam menu ๐Ÿงก SYNC di Dashboard Kayooh, dapatkan token sakti, dan klik Sinkronisasi!

Panduan Cloudflare R2 (Satelit Media)

Integrasi R2 (Gratis 10GB/bulan) mencegah hosting Anda penuh akibat penumpukan file JSON rute panjang.

Langkah 1: Buat Bucket

  1. Login ke Cloudflare, masuk menu R2, dan buat bucket (misal: kayooh-media).

Langkah 2: Atur CORS Policy โš ๏ธ

  1. Masuk tab Settings bucket Anda, cari CORS Policy, lalu paste JSON murni ini:
[
  {
    "AllowedOrigins": [
      "http://localhost*",
      "https://domain-kayooh-anda.com"
    ],
    "AllowedMethods": [
      "GET", "PUT", "POST", "DELETE", "HEAD"
    ],
    "AllowedHeaders": [ "*" ]
  }
]

*Ganti domain dengan URL web Kayooh Anda (tanpa garis miring di belakang).

Langkah 3: Pasang Kredensial

  1. Klik Manage R2 API Tokens, buat token dengan akses Object Read & Write.
  2. Masukkan Access Key ID, Secret Access Key, dan Endpoint S3 ke Pengaturan Dashboard Kayooh.