Local Development · dazo/docs

Setelah setup environment selesai, menjalankan project butuh dua proses berjalan bersamaan.

Menjalankan aplikasi

bash

php artisan serve      # terminal 1 — backend Laravel di :8000
npm run dev            # terminal 2 — Vite dev server + HMR

Buka http://127.0.0.1:8000. Aplikasi siap dipakai.

Script npm

Script	Perintah	Fungsi
`npm run dev`	`vite`	Dev server + HMR
`npm run build`	`vite build`	Build produksi (wajib sebelum deploy)
`npm run release`	`standard-version`	Generate CHANGELOG

Verifikasi setelah mengubah kode

Tidak ada CI yang menjalankan test. Setelah mengubah kode, jalankan:

bash

npm run build          # wajib untuk perubahan frontend
php artisan test       # wajib untuk perubahan backend

Service eksternal — batasan lokal

dazoapp bergantung pada 3 service terpisah yang berada di luar repo:

Service	Variabel	Fungsi
Backend Go	`url_api`	API service (`/v1/`) — chat, escalate, order
Engine WhatsApp	`url_engine`	Pairing QR, kirim/terima pesan
Engine Bot	`url_ai_agent`	Prompt, QnA, follow-up otomatis

Apa yang bisa dites tanpa service ini

Fitur	Bisa?	Catatan
Login, register, auth flow	Ya	—
CRUD produk, varian, stok	Ya	—
Order management	Sebagian	Pembuatan order jalan, tapi pengiriman pesan WA ke customer gagal
Wallet, withdraw	Ya	Butuh DOKU sandbox
Digital store storefront	Ya	—
Invoice PDF, export Excel	Ya	—
Biolink, shortlink	Ya	—

Apa yang TIDAK bisa dites tanpa service ini

Fitur	Service yang dibutuhkan
Device pairing, QR code	Engine WhatsApp
Live chat inbound	Engine WhatsApp
AI agent response, QnA	Engine Bot
Broadcast kirim pesan	Engine WhatsApp
Follow-up otomatis	Engine Bot

Queue dan job

.env saat ini QUEUE_CONNECTION=sync — artinya job berjalan sinkron dalam request, tidak masuk queue.

Dampaknya:

PaymentTimer (di-dispatch dari DuitkuController:231 dan SubscriptionController:243) blocking request
6 Mailable ShouldQueue (OTP, notifikasi) juga blocking

Jika ada worker eksternal yang seharusnya memproses job, konfigurasi ini perlu diperiksa — lihat Deployment.

Debug

Untuk debug backend, pakai dd() dan logger(). Untuk frontend, console.log — tapi ingat untuk menghapusnya.

Struktur direktori utama

text

app/
├── Http/Controllers/    61 file — mayoritas business logic ada di sini
├── Models/              79 model (77 MongoDB, 2 MySQL)
├── Services/            9 service — tempat menulis logic baru
└── Helpers/             autoload via composer.json "files"

resources/js/
├── Pages/               234 .vue — 28 area fitur
├── Components/          430 .vue (313 di antaranya ikon SVG)
├── Layouts/             10 .vue
├── composables/         7 composable
├── services/            axiosInstance.js (JWT + refresh otomatis)
└── global.js            gitignored — lihat [Environment](./environment)

Langkah berikutnya

Siap deploy? Baca Deployment — branch produksi adalah v3.
Akan kerja fitur? Wajib baca Multi-tenant sebelum menulis query.