Aplikasi Pelacak Lari
Terakhir diperbarui: 9 Juli 2026
Aplikasi pelacak lari adalah aplikasi seluler yang mencatat jarak, waktu, pace, dan rute setiap sesi lari langsung dari ponsel, dan hanya menampilkan catatan milik masing-masing orang yang telah masuk. Saat satu sesi lari selesai, catatan hari itu bertambah ke dalam daftar, dan catatan orang lain tidak saling terlihat.
Contoh ini menunjukkan satu hal. Sebuah aplikasi seluler memakai backend yang persis sama dengan yang Anda pakai untuk layanan web. Menyimpan catatan, menerima anggota, dan menampilkan hanya catatan milik masing-masing orang tidak berbeda antara web dan aplikasi. Karena itu contoh ini juga menelusuri seluruh proses menyiapkan backend tersebut (data yang menyimpan catatan, login anggota, dan izin untuk melihat hanya catatan sendiri) dari awal sampai akhir, lalu secara terpisah menandai dua hal yang berbeda karena ini seluler: penerapan, dan koneksi yang membawa hasil login kembali ke dalam aplikasi.
Apa yang kita buat
Alih-alih toko pakaian atau blog, contoh kali ini adalah aplikasi pelacak lari pribadi. Ada tiga layar.
- Layar login: Anda masuk dengan Google.
- Daftar catatan: orang yang telah masuk melihat catatan lari yang sudah dia buat sejauh ini, dari yang terbaru.
- Tambah catatan: Anda mencatat jarak, waktu, pace, rute, dan tanggal satu sesi lari.
Intinya adalah "setiap orang hanya melihat catatannya sendiri." Orang yang telah masuk hanya menerima catatan yang dia buat, dan catatan orang lain tidak terlihat. Kondisi inilah yang nantinya membuat login anggota dan izin sama-sama diperlukan.
Buat layar dulu, baru hubungkan
Membuat aplikasi ini sendiri berlangsung dalam dua langkah. Buat layar aplikasi lebih dulu, lalu serahkan bagian di balik layar tersebut ke WEEGLOO.
1. Buat desain layar. Layar-layar di atas dihasilkan dengan memberi LLM prompt seperti di bawah ini. Anda cukup memberi satu baris tentang aplikasi apa yang sedang dibuat, daftar layar dan isi tiap layar, serta arah desainnya.
Desainkan layar untuk aplikasi pelacak lari. Ini adalah aplikasi seluler dengan orientasi vertikal.
Layar:
- Login: satu baris perkenalan aplikasi dan tombol "Continue with Google".
- Daftar catatan (beranda): ringkasan total jarak dan jumlah lari, daftar kartu catatan lari (tanggal, jarak, waktu, pace, thumbnail rute), dan tombol tambah catatan.
- Tambah catatan: input untuk tanggal, jarak, waktu, pace, catatan, dan foto rute, beserta simpan.
Buat tampilannya bersih dan aktif, agar angka seperti jarak dan pace terbaca sekilas. Ikuti konvensi UI seluler.
Ketiga layar di "Apa yang kita buat" di atas adalah hasil dari prompt ini. Pada tahap ini belum ada data dan belum ada login: baru layarnya saja.
2. Hubungkan ke WEEGLOO. Hubungkan agen ke WEEGLOO (Menghubungkan) lalu katakan ini.
Integrasikan ini dengan WEEGLOO.
Tanpa menjelaskan panjang lebar apa yang sedang dibuat, agen memeriksa layar-layar ini dan menyiapkan apa yang dibutuhkan di baliknya. Alur menyerahkan semuanya sekaligus ini sama dengan Integrasikan dalam satu kalimat.
Apa yang WEEGLOO siapkan di balik layar
Dengan satu instruksi "integrasikan ini," agen memeriksa layar dan menyiapkan empat hal ini. Inilah backend yang ditangani WEEGLOO di balik layar.
- Struktur data untuk menampung catatan lari (Content Type). Struktur ini menampung item seperti jarak, waktu, pace, rute, dan tanggal.
- Login Google (ServiceLogin). Memungkinkan pengguna aplikasi mendaftar dan masuk sendiri.
- Izin "hanya catatan sendiri". Memungkinkan orang yang telah masuk membaca, menulis, dan menghapus hanya catatan yang dia buat.
- Pengiriman catatan sendiri. Mengirim ke setiap orang yang telah masuk hanya catatan miliknya sebagai daftar.
Keempat hal ini persis sama dengan yang Anda butuhkan saat membangun layanan yang sama untuk web. Cara menangani tiap bagian secara tersendiri dibahas satu per satu di Menambahkan pendaftaran dan login, Membagi izin, dan Menyimpan dan mengambil data. Jika Anda ingin melampirkan gambar peta rute atau foto juga, Anda bisa menambahkan file (Media).
Sumber daya yang benar-benar dibuat
Di bawah ini adalah sumber daya yang benar-benar dibuat di Space Stride pada contoh ini. Ini bukan panduan menyiapkan tiap sumber daya satu per satu, melainkan tinjauan atas apa yang muncul di aplikasi ini sebagai hasil dari "integrasikan ini."
Struktur yang menampung catatan lari
Yang pertama adalah struktur yang menampung catatan lari (Content Type) "Run". Nilai-nilai yang masuk ke dalam satu sesi lari terbagi ke dalam kolom per item.
| Item | Jenis kolom | Wajib | Nilai yang ditampung |
|---|---|---|---|
Date | Date | Wajib | Tanggal lari. Juga dipakai sebagai judul yang menandai catatan di daftar. |
Distance (km) | Number | Wajib | Jarak yang ditempuh (dalam kilometer). Bisa memuat desimal. |
Duration (seconds) | Integer | Wajib | Waktu yang ditempuh (dalam satuan detik). Di layar ditampilkan dalam menit dan detik, seperti 41:05. |
Notes | Long Text | Opsional | Catatan untuk lari hari itu. |
Route photo | Media | Opsional | Satu berkas peta rute atau foto. |
Tidak ada kolom terpisah yang menyimpan pace rata-rata. Nilai itu bisa didapat hanya dari jarak dan waktu, jadi aplikasi menghitung dan menampilkannya secara langsung (bagian "auto-calculated" di layar tambah catatan).
Login Google
Yang kedua adalah jalur yang dipakai anggota untuk masuk dengan Google (ServiceLogin). Pada contoh ini namanya diatur menjadi "Stride", dan hanya Google satu-satunya metode login yang diaktifkan. Orang yang baru masuk secara bawaan menerima izin "Runner" di bawah ini. Setelah login selesai, hasilnya kembali ke aplikasi melalui halaman jembatan perantara yang dijelaskan di Membawa hasil login kembali ke aplikasi.
Izin "hanya catatan sendiri"
Yang ketiga adalah izin yang diterima anggota (ServiceUserRole) "Runner". Aturannya sebagai berikut.
| Yang bisa dilakukan | Cakupan yang berlaku |
|---|---|
| Membuat catatan | Anggota mana pun yang telah masuk |
| Membaca catatan | Hanya yang dia buat sendiri |
| Menyunting catatan | Hanya yang dia buat sendiri |
| Menghapus catatan | Hanya yang dia buat sendiri |
Karena "membaca" terikat pada "hanya yang dia buat sendiri," daftar hanya menampilkan catatan milik masing-masing orang. Dari empat hal yang disebutkan sebelumnya, nomor 3 (izin) dan nomor 4 (pengiriman) sebenarnya keluar bersama dari satu aturan ini. Karena catatan yang bisa dibaca setiap anggota hanyalah catatannya sendiri, itulah tepatnya daftar yang dikirim kepada orang tersebut.
Catatan dan foto
Yang keempat adalah tiap catatan lari (Content) dan foto rute (Media). Keduanya tidak dibuat sebelumnya, melainkan masing-masing dibuat atas nama anggota ketika dia mencatat satu sesi lari di aplikasi. Di bawah ini adalah satu catatan yang benar-benar dibuat. Struktur "Run" di atas terisi nilai, dan foto rute terlampir bersamanya.
Jarak 42.195 adalah maraton penuh. Waktu ditampung dalam satuan detik (di sini, catatan sepanjang 3 jam 53 menit) dan ditampilkan di aplikasi sebagai 3:53:00. Foto rute disimpan terpisah sebagai berkas (Media), dan catatan hanya menyimpan tautan yang menunjuk ke berkas tersebut. Daftar dan kartu di "Apa yang kita buat" adalah wujud catatan-catatan seperti ini setelah beberapa terkumpul.
Dua hal yang berbeda dari web
Sampai di sini semuanya sama dengan web. Aplikasi seluler memakai backend yang sama apa adanya. Hanya dua hal yang berbeda karena ini seluler.
Penerapan: pasar aplikasi ada di luar WEEGLOO
Layanan web bisa menaruh produk jadinya di internet dengan Web Hosting (Menaruh situs di internet), tetapi menyampaikan aplikasi seluler yang sudah jadi ke tangan orang (mendaftarkannya di pasar aplikasi) terjadi di luar WEEGLOO. Yang ditangani WEEGLOO adalah data, anggota, dan izin di balik layar aplikasi.
Membawa hasil login kembali ke aplikasi
Fitur login itu sendiri dipasang dengan cara yang sama seperti pada web. Yang berbeda dari web adalah koneksi yang membawa hasilnya kembali ke aplikasi setelah login selesai. Hasil login hanya bisa kembali ke alamat web, jadi diperlukan satu langkah tambahan: sebuah halaman yang berperan sebagai jembatan perantara dan meneruskan hasil itu ke aplikasi. Langkah teknis ini dibahas di Auth API.
Melihat bahwa benar-benar hanya catatan sendiri
Kondisi inti aplikasi ini, "setiap orang hanya melihat catatannya sendiri," benar-benar terpenuhi. Di bawah ini adalah layar beranda dari aplikasi yang sama yang dibuka dengan dua akun berbeda. Aplikasinya sama, tetapi total jarak, jumlah lari, dan catatan yang tampil di daftar semuanya berbeda.
Satu akun hanya menampilkan satu lari 5km, dan yang lain hanya menampilkan dua lari, yaitu maraton dan 3km. Catatan keduanya tidak saling terlihat. Stride menampung ketiga catatan ini (lihat Sumber daya yang benar-benar dibuat), tetapi setiap anggota hanya menerima catatan yang dia buat. Ini adalah hasil dari mengikat "membaca" pada "hanya yang dia buat sendiri" di Izin "hanya catatan sendiri" di atas.
Apa yang harus dilakukan berikutnya
- Menambahkan pendaftaran dan login: membahas cara menambahkan login yang menerima anggota Anda sendiri secara terpisah.
- Auth API: membahas langkah teknis membawa hasil login kembali ke aplikasi.
- Membagi izin: membahas cara mengatur izin agar anggota hanya menangani miliknya sendiri.
- Menyimpan dan mengambil data: membahas cara membuat struktur data dan mengisinya dengan konten.