01 / FITUR PERTAMA
Halaman langsung membaca database. Mutasi ditaruh di Server Action. Helper masuk ke utils. Semuanya cukup untuk membuat fitur pertama berjalan.
REACT FULLSTACK ARCHITECTURE / NEXT.JS
An Opinionated React Fullstack Architecture for Next.js Applications
Aplikasi Next.js biasanya makin sulit dirawat karena keputusan kecil yang menumpuk. Awalnya masuk akal: taruh logika di sini dulu, salin sedikit kode di sana. Lama-lama, kita tidak yakin lagi logika bisnis harus ditaruh di mana atau perubahan kecil akan berdampak ke bagian mana. RFAStack menawarkan pola arsitektur yang bisa diikuti sebelum codebase sampai ke titik itu.
KEPUTUSAN DI LUAR FRAMEWORK
Dokumentasi menjelaskan cara kerja Server Component, Server Action, dan Route Handler. Tapi kamu tetap perlu menentukan kapan memakainya, di mana logika bisnis ditulis, dan kode mana yang dipakai bersama.
01 / FITUR PERTAMA
Halaman langsung membaca database. Mutasi ditaruh di Server Action. Helper masuk ke utils. Semuanya cukup untuk membuat fitur pertama berjalan.
02 / POLA MULAI BERBEDA
Halaman berikutnya mengambil data serupa lewat endpoint internal. Mutasi lain punya pemeriksaan di tempat berbeda. Semuanya jalan, tapi developer berikutnya tidak tahu pola mana yang harus diikuti.
03 / ATURAN BERSAMA
Simpan aturan bisnis di fitur yang mengurusnya. Halaman, Server Action, dan Route Handler tinggal memanggil operasi itu lewat jalur yang sesuai.
WAKTU HABIS UNTUK MENELUSURI
Kamu seharusnya bisa membuka fitur, menemukan aturannya, lalu mengikuti query atau mutasi sampai ke datanya. Kalau dua jalur melakukan pekerjaan yang sama tanpa alasan yang jelas, setiap perubahan harus dimulai dengan mencari tahu ulang. Review jadi lebih lama dan kesalahan yang sama mudah terulang.
ATURAN DASAR DAN BATASNYA
Struktur folder, kode server, dan alur data harus mengikuti aturan yang sama. Mulai dari cara yang langsung, lalu tambahkan struktur ketika kebutuhannya muncul.
Tentukan dulu apa yang harus dilakukan kode dan siapa yang memakainya. Setelah itu, pilih Server Action, Route Handler, atau library klien.
Tulis aturannya di satu tempat. Halaman, action, dan handler cukup memanggil operasi yang sama.
Dari kode yang memanggil operasi, kamu harus bisa mengikuti alurnya sampai ke fitur, database, atau layanan luar.
Mulai dari panggilan langsung. Tambahkan batas baru ketika browser, aplikasi lain, atau kebutuhan akses data mengharuskannya.
TEMPAT KODE DAN TANGGUNG JAWABNYA
Pohon folder yang rapi mudah disalin, tapi nama folder saja belum cukup. src/app berisi entry point Next.js. src/features mengurus perilaku bisnis aplikasi. src/platform menangani koneksi database dan layanan luar. src/shared berisi kode umum yang tidak terikat aturan bisnis. Tanpa pembagian tanggung jawab, keempat folder itu tetap bisa menjadi tempat menumpuk kode.
src/app lalu diteruskan ke fitur yang mengurusnya di src/features. Fitur bisa memakai integrasi dari src/platform dan kode umum dari src/shared.URUTAN BACA / RFASTACK
Mulai dari pembagian tanggung jawab fitur, lalu ikuti cara data bergerak melalui kode server, browser, dan sumber datanya.