Langsung ke konten

Contoh Aplikasi ​

Sekitar 3 menit baca

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 ​

AplikasiYang bisa dipelajariSource dan cara menjalankan
Portal pesanan pelangganHalaman dan form dengan query server serta Server Actions bawaan Next.js.Next.js native
Dashboard pengirimanAntrean polling dengan React Query, Eden Fetch, dan backend Elysia terpisah dalam workspace Turborepo.React Query + HTTP
Pemesanan B2BOperasi 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.ts ke create-order.use-case.ts. Server mengambil harga produk lalu menyimpan pesanan.
  • Dashboard pengiriman: mulai dari apps/web/src/features/fulfillment/fulfillment.api.ts, lalu buka apps/api/src/features/fulfillment. Sebelum mengubah pengiriman, backend memeriksa gudang yang boleh diakses operator.
  • Pemesanan B2B: ikuti order.rpc.ts ke decide-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.

Kode: MIT · Tulisan, diagram, dan aset visual: CC BY 4.0