D
Setup

Local Development

Langkah menjalankan backend Laravel, Vite, dan optional Inertia SSR untuk pengembangan Toko Digital.

Prasyarat

  • PHP 8.1 atau lebih baru dengan extension Laravel dan MongoDB.
  • Composer.
  • Node.js dan npm.
  • Instance MySQL dan MongoDB yang sesuai dengan konfigurasi lokal.
  • Akses ke data atau service bersama yang diperlukan untuk menguji checkout, shipping, dan payment.

Instalasi

bash
composer install
copy .env.example .env
php artisan key:generate
npm install

Pada shell Unix, gunakan cp .env.example .env sebagai pengganti copy.

Isi .env sebelum menjalankan request yang membaca database atau service eksternal.

Menjalankan aplikasi

Jalankan Laravel dan Vite di terminal terpisah:

bash
php artisan serve
bash
npm run dev

Vite menggunakan 127.0.0.1:5173 secara default. Laravel melayani request aplikasi melalui URL yang ditentukan APP_URL.

Mode store lokal

Resolusi store lokal dapat menggunakan query parameter username ketika APP_ENV bernilai local atau development:

text
http://localhost:8000/?username=<store-username>

Path-based URL juga tersedia:

text
http://localhost:8000/<store-username>

Jangan menggunakan username yang termasuk reserved path. Daftarnya dijelaskan di Store Resolution.

Build lokal

bash
npm run build

Perintah tersebut menjalankan dua build Vite:

  1. Bundle client dari resources/js/app.js.
  2. Bundle SSR dari resources/js/ssr.js.

Output berada di public/build dan bootstrap/ssr/ssr.js. Bundle SSR adalah generated output dan tidak boleh diedit manual.

Pengujian dasar

bash
php artisan test
./vendor/bin/phpunit --testsuite=Feature
./vendor/bin/phpunit --testsuite=Unit
git diff --check

Coverage fitur bisnis masih terbatas. Sebelum mengubah checkout atau routing, lakukan smoke test storefront, product detail, cart, preview, dan payment status secara manual.