Contoh Aplikasi
Pilih contoh yang kebutuhannya paling dekat dengan aplikasimu. Setelah berjalan di lokal, ikuti satu request dari UI sampai datanya tersimpan. Dari situ, kamu bisa melihat hubungan antara route, kode fitur, dan database.
Pilih contoh
| Aplikasi | Yang bisa dipelajari | Source dan cara menjalankan |
|---|---|---|
| Portal pesanan pelanggan | Halaman dan form dengan query server serta Server Actions bawaan Next.js. | Next.js native |
| Dashboard pengiriman | Antrean polling dengan React Query, Eden Fetch, dan backend Elysia terpisah dalam workspace Turborepo. | React Query + HTTP |
| Pemesanan B2B | Operasi API dengan tipe input dan hasil yang dipakai bersama oleh browser dan klien command-line. | React Query + oRPC |
Mulai dari portal pelanggan kalau kebutuhan utamanya halaman dan form. Pilih dashboard kalau browser perlu terus mengambil pembaruan dari layanan HTTP. Contoh B2B cocok untuk mempelajari API bertipe yang dipakai beberapa klien. Alasannya dijelaskan dalam panduan pengambilan data.
Dashboard menempatkan Next.js di apps/web, Elysia di apps/api, dan schema bersama di packages/contracts. Eden Fetch memeriksa tipe request berdasarkan route Elysia, sementara React Query mengelola polling dan cache hasilnya. Turborepo mengatur task antar-package. Mutasi dari browser melewati Next.js agar cache server bisa diinvalidasi sebelum respons dikirim.
Jalankan di lokal
README tiap contoh berisi perintah setup dan akun demo. Siapkan Bun 1.4.0, Docker Compose, serta Node.js 22 atau lebih baru untuk menjalankan alat pengujian. Instal dependensi dari folder contoh yang dipilih. Instalasi di root repositori hanya untuk situs dokumentasi.
Masing-masing aplikasi punya database PostgreSQL, port, dan test sendiri. Proses pengiriman barang disimulasikan, jadi tidak perlu kredensial layanan luar atau setup pembayaran. Contoh ini belum mencakup registrasi publik, pengiriman email, dan hosting produksi.
Ikuti satu request
Ketiga aplikasi memakai pembagian yang sama: route di app, aturan bisnis di features, setup integrasi di platform, dan kode umum di shared. Aturan dependensinya ada di panduan struktur folder.
Pilih salah satu alur berikut:
- Portal pelanggan: ikuti
checkout.actions.tskecreate-order.use-case.ts. Server mengambil harga produk lalu menyimpan pesanan. - Dashboard pengiriman: mulai dari
apps/web/src/features/fulfillment/fulfillment.api.ts, lalu bukaapps/api/src/features/fulfillment. Sebelum mengubah pengiriman, backend memeriksa gudang yang boleh diakses operator. - Pemesanan B2B: ikuti
order.rpc.tskedecide-order.use-case.ts. Use case memeriksa keanggotaan perusahaan, izin approver, dan status pesanan.
Untuk melihat pemeriksaan akses yang dipakai bersama, buka query pesanan di portal pelanggan. Query daftar, detail, dan pengiriman berada dalam satu file. Semuanya memakai withMembership dari modul query membership, sehingga pemeriksaan keanggotaan tetap dijalankan pada setiap operasi. Contoh wrapper membership membahas polanya.
Coba ubah aturan bisnis di fitur terkait, lalu jalankan test contoh itu. README-nya juga menjelaskan cara mengamati cache setelah data berubah. Untuk memahami apa yang perlu diperiksa, lanjutkan ke perlindungan resource dan caching.