Konvensi Kode

Codebase dazoapp dikerjakan turun-temurun tanpa standar koding dan tanpa code review. Pola yang ada bukan keputusan desain — jangan ditiru secara otomatis. Tapi yang dominan aman diikuti.

Backend

Response API

// BENAR — pola dominan
return response()->json([
    'status'  => true,
    'data'    => $order,
    'message' => 'Order created',
], 201);

// BENAR — untuk halaman
return Inertia::render('Order/Show', [
    'order' => $order,
]);

Untuk fitur baru — tulis di service

Controller sudah bengkak (OrderController.php 2.987 baris, ContactController.php 2.403, ProductController.php 2.017). Tulis logic baru di app/Services/, bukan di controller.

Ada 9 service yang sudah ada:

Frontend

Untuk kode Vue baru

<script setup>
import { useForm } from '@inertiajs/vue3'
import { Head, Link } from '@inertiajs/vue3'

const form = useForm({
    name: '',
    email: '',
})

const submit = () => form.post('/api/contact', {
    preserveScroll: true,
})
</script>

<template>
    <form @submit.prevent="submit">
        <!-- ... -->
    </form>
</template>

API call di luar Inertia

Pakai services/axiosInstance.js — sudah menangani JWT + refresh otomatis:

import axiosInstance from '@/services/axiosInstance'

const { data } = await axiosInstance.get('/api/orders')

Penamaan

Campur aduk — ini kondisi nyata, bukan standar yang harus ditiru:

Typo yang terlanjur dipakai

Jangan perbaiki tanpa diminta — akan memecah import:

• Toltip.vue (harusnya Tooltip)
• AccordionGrup.vue (harusnya AccordionGroup)
• ContentSyarat&Ketentuan.vue — ada & di nama file

Untuk file baru

• Komponen: PascalCase.vue
• Util: camelCase.js
• Halaman: PascalCase.vue

Bahasa

Komentar, variabel, dan commit bercampur Indonesia/Inggris.

• Balas user dalam Bahasa Indonesia
• Untuk kode, ikuti bahasa file yang sedang diedit
• Jangan mengganti bahasa komentar yang sudah ada

God component — hati-hati

Komponen kembar — cek dulu sebelum buat

Pola duplikasi yang ada:

Duplikasi dari tidak adanya review

Saat menambah library, cek dulu apakah sudah ada yang serupa. Jangan tambah varian ke-5.

Helper tumpang tindih

Ada tiga modul helper dengan duplikasi:

Duplikat: formatDateOnly, getPageCardWidth ada di helpers.js dan global.js. timeAgo (global) vs getTimeAgoString (helpers) melakukan hal yang sama.

Langkah berikutnya

• Butuh auth? Baca Auth & JWT.
• Butuh query? Baca Multi-tenant.
• Butuh panggil service? Baca External Services.