Langsung ke konten

REACT FULLSTACK ARCHITECTURE / NEXT.JS

RFAStack

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

Paham API Next.js belum tentu tahu harus menaruh kode di mana

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

Perubahan kecil seharusnya tidak perlu membongkar seluruh repositori

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

Perjelas tanggung jawab fitur dan alasan di balik alur datanya

Struktur folder, kode server, dan alur data harus mengikuti aturan yang sama. Mulai dari cara yang langsung, lalu tambahkan struktur ketika kebutuhannya muncul.

  1. 01

    Mulai dari kebutuhan operasi

    Tentukan dulu apa yang harus dilakukan kode dan siapa yang memakainya. Setelah itu, pilih Server Action, Route Handler, atau library klien.

  2. 02

    Simpan aturan bisnis di fitur terkait

    Tulis aturannya di satu tempat. Halaman, action, dan handler cukup memanggil operasi yang sama.

  3. 03

    Alur query dan mutasi harus jelas

    Dari kode yang memanggil operasi, kamu harus bisa mengikuti alurnya sampai ke fitur, database, atau layanan luar.

  4. 04

    Tambah struktur saat dibutuhkan

    Mulai dari panggilan langsung. Tambahkan batas baru ketika browser, aplikasi lain, atau kebutuhan akses data mengharuskannya.

TEMPAT KODE DAN TANGGUNG JAWABNYA

Dari struktur folder, harus jelas kode ini mengurus apa

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.

Peta arsitektur RFAStackRequest masuk lewat src/app dan diteruskan ke fitur di src/features. Fitur bisa memakai integrasi dari src/platform dan kode umum dari src/shared.ALUR PANGGILAN · ATURAN BISNIS TETAP DI FITURTANPA SKALAA / BATAS NEXT.JSsrc/apppage · layout · handlerF / FITUR BISNISsrc/featuresorders / billing / identity / reportingUI · model · queries · mutations · serverMENGURUS ATURAN BISNISP / INTEGRASIsrc/platformdatabase · email · telemetriS / KODE UMUMsrc/sharedUI · tipe · utilitas
Penjelasan diagram: request masuk lewat 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

Dari penempatan kode ke alur data

Mulai dari pembagian tanggung jawab fitur, lalu ikuti cara data bergerak melalui kode server, browser, dan sumber datanya.

  1. 01Latar Belakang & MotivasiMengapa fitur yang sama-sama berjalan baik bisa membuat aplikasi Next.js makin sulit diubah.
  2. 02Dasar ArsitekturTentukan tanggung jawab fitur, operasi yang boleh dipanggil dari luar, dan arah dependensinya.
  3. 03Pengambilan Data & MutasiPilih cara mengambil dan mengubah data sesuai kebutuhan server, browser, dan aplikasi lain.
  4. 04Perlindungan ResourcePeriksa sesi dan izin akses sebelum membaca atau mengubah data. Kembalikan hanya field yang boleh dilihat pengguna.
  5. 05CachingPahami cache yang dipakai aplikasi dan apa yang harus diperbarui setelah data berubah.
  6. 06Contoh AplikasiJalankan portal pelanggan, dashboard pengiriman, atau aplikasi pemesanan B2B. Lalu ikuti alur request di kodenya.

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