Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Database / Cara Merancang Database Larave...
Database

Cara Merancang Database Laravel dari Requirement hingga ERD dan Migration

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
13 min read
13 views

Dari catatan kebutuhan klien menjadi skema database yang rapi: identifikasi entitas, normalisasi, ERD, pemilihan tipe data dan indeks, lalu migration Laravel yang siap production.

Overview

Banyak proyek Laravel bermasalah bukan karena kodenya, melainkan karena skema database-nya. Tabel dibuat sambil jalan, kolom ditambah setiap ada fitur baru, relasi tidak jelas, dan enam bulan kemudian tim takut mengubah apa pun. Gejalanya mudah dikenali:

  • kolom status berisi teks bebas dengan belasan variasi ejaan,
  • harga produk disimpan di tabel pesanan tanpa histori, sehingga laporan lama ikut berubah,
  • tidak ada foreign key, sehingga ada pesanan milik pelanggan yang sudah tidak ada,
  • query lambat karena kolom yang sering difilter tidak punya indeks.

Artikel ini membahas proses yang berulang dan bisa diikuti untuk setiap proyek: requirement → entitas → atribut → relasi → normalisasi → ERD → migration. Studi kasus yang dipakai adalah sistem pemesanan toko online sederhana, yang juga dipakai di artikel lain dalam seri ini.

Hasil akhir:

  • daftar entitas dan atribut yang diturunkan langsung dari requirement,
  • ERD dalam format teks (Mermaid dan DBML) yang bisa disimpan di repository,
  • migration Laravel lengkap dengan foreign key, indeks, dan tipe data yang tepat,
  • cara memverifikasi skema dengan perintah Artisan.

Prerequisites

Komponen Versi
PHP 8.3 atau lebih baru (disarankan 8.4)
Laravel 13.x (konsep berlaku juga untuk Laravel 11 dan 12)
Database MySQL 8.0+ / MariaDB 10.11+ / PostgreSQL 15+
Composer 2.x
Alat ERD (opsional) Mermaid (didukung GitHub/GitLab), dbdiagram.io, atau DBeaver

Pengetahuan yang diasumsikan: dasar SQL (SELECT, JOIN), dan sudah pernah membuat proyek Laravel.

Step-by-step Tutorial

Langkah 1: Tulis Requirement dalam Bentuk Kalimat

Mulailah dari kebutuhan bisnis, bukan dari tabel. Minta klien (atau tulis sendiri dari hasil diskusi) daftar kebutuhan dalam kalimat sederhana. Contoh untuk toko online:

R1. Pelanggan mendaftar dengan nama, email, dan nomor HP.
R2. Pelanggan dapat menyimpan lebih dari satu alamat pengiriman, salah satunya alamat utama.
R3. Produk memiliki nama, SKU unik, harga, stok, dan dapat masuk ke beberapa kategori.
R4. Pelanggan membuat pesanan berisi satu atau lebih produk dengan jumlah tertentu.
R5. Harga di pesanan tidak boleh berubah walaupun harga produk diubah kemudian.
R6. Pesanan memiliki status: menunggu pembayaran, dibayar, dikirim, selesai, dibatalkan.
R7. Satu pesanan dapat dibayar lebih dari sekali (misalnya pembayaran gagal lalu diulang).
R8. Admin perlu laporan penjualan per hari dan per kategori.

Beri nomor pada setiap requirement. Nomor ini nanti dipakai untuk menelusuri alasan sebuah tabel atau kolom ada.

Langkah 2: Identifikasi Entitas (Kata Benda)

Garis bawahi kata benda yang punya identitas sendiri dan perlu disimpan:

Kata benda Entitas? Alasan
Pelanggan Ya Punya identitas, login, data sendiri
Alamat Ya Satu pelanggan bisa banyak alamat (R2)
Produk Ya Inti katalog
Kategori Ya Produk bisa banyak kategori (R3)
Pesanan Ya Transaksi utama
Item pesanan Ya Menyimpan jumlah dan harga saat transaksi (R4, R5)
Pembayaran Ya Satu pesanan bisa banyak pembayaran (R7)
Status Bukan tabel Nilai tetap dan sedikit; cukup kolom dengan enum PHP (R6)
Laporan Bukan tabel Hasil query dari data yang sudah ada (R8)

Aturan praktis: jika sesuatu hanya punya satu nilai dan tidak punya atribut lain, ia biasanya atribut, bukan entitas.

Langkah 3: Tentukan Atribut dan Tipe Datanya

Untuk setiap entitas, tulis atributnya lalu tentukan tipe data. Beberapa keputusan penting:

Data Pilihan tipe Alasan
Uang (Rupiah) unsignedBigInteger (dalam rupiah) atau decimal(15,2) Jangan pakai float, karena pembulatannya tidak presisi
Status string(20) + PHP enum Lebih fleksibel daripada enum MySQL yang butuh ALTER TABLE untuk menambah nilai
Nomor HP string(20) Bukan angka; bisa diawali 0 atau +62
Kode pesanan publik string unik, misalnya INV-20261019-0001 Jangan tampilkan ID auto increment ke publik
Waktu timestamp / dateTime Simpan dalam UTC, konversi saat ditampilkan
Data fleksibel json Hanya untuk data yang tidak perlu difilter atau di-join

Hasilnya:

customers   : id, name, email (unik), phone, password, timestamps
addresses   : id, customer_id, label, recipient_name, phone, street, city, postal_code, is_primary, timestamps
categories  : id, parent_id (nullable), name, slug (unik), timestamps
products    : id, sku (unik), name, slug (unik), description, price, stock, is_active, timestamps
orders      : id, code (unik), customer_id, address_snapshot (json), status, subtotal, shipping_cost, total, placed_at, timestamps
order_items : id, order_id, product_id, product_name, unit_price, quantity, line_total
payments    : id, order_id, method, amount, status, reference, paid_at, timestamps

Perhatikan product_name, unit_price, dan address_snapshot. Kolom ini sengaja menduplikasi data (denormalisasi terkontrol) untuk memenuhi R5: pesanan adalah dokumen historis yang tidak boleh berubah saat data master berubah.

Langkah 4: Tentukan Relasi dan Kardinalitas

Tanyakan dua arah untuk setiap pasangan entitas: "Satu A punya berapa B?" dan "Satu B milik berapa A?"

Relasi Kardinalitas Implementasi
Customer → Address 1 : N addresses.customer_id
Customer → Order 1 : N orders.customer_id
Order → OrderItem 1 : N order_items.order_id
Product → OrderItem 1 : N order_items.product_id
Order → Payment 1 : N payments.order_id
Product ↔ Category N : M tabel pivot category_product
Category → Category 1 : N (hierarki) categories.parent_id

Relasi N:M selalu membutuhkan tabel penghubung. Jika tabel penghubung punya data sendiri (seperti quantity dan unit_price pada item pesanan), jadikan ia entitas penuh, seperti order_items.

Langkah 5: Normalisasi Secukupnya

Periksa skema terhadap tiga bentuk normal pertama:

  • 1NF: tidak ada kolom berisi daftar. Kolom category_ids = "1,4,7" dilarang, sehingga diganti tabel pivot.
  • 2NF: kolom bergantung pada seluruh kunci. Di tabel pivot category_product, jangan simpan category_name.
  • 3NF: tidak ada kolom yang bergantung pada kolom bukan kunci. Jangan simpan customer_email di orders karena sudah bisa diambil lewat customer_id.

Lalu putuskan dengan sadar di mana denormalisasi dibenarkan:

  • snapshot data transaksi (harga, nama produk, alamat),
  • kolom agregat yang sangat sering dibaca (misalnya orders.total), selama ada satu tempat di kode yang menghitungnya.

Tulis keputusan ini di dokumentasi. Developer berikutnya perlu tahu bahwa duplikasi itu disengaja.

Langkah 6: Gambar ERD sebagai Kode

Simpan ERD sebagai teks di repository agar ikut di-review dan di-versioning. Mermaid dirender otomatis oleh GitHub dan GitLab:

erDiagram
    CUSTOMERS ||--o{ ADDRESSES : memiliki
    CUSTOMERS ||--o{ ORDERS : membuat
    ORDERS ||--|{ ORDER_ITEMS : berisi
    PRODUCTS ||--o{ ORDER_ITEMS : dipesan_di
    ORDERS ||--o{ PAYMENTS : dibayar_lewat
    PRODUCTS }o--o{ CATEGORIES : dikelompokkan
    CATEGORIES ||--o{ CATEGORIES : induk_dari

    CUSTOMERS {
        bigint id PK
        string email UK
        string name
        string phone
    }
    ORDERS {
        bigint id PK
        string code UK
        bigint customer_id FK
        string status
        bigint total
        timestamp placed_at
    }
    ORDER_ITEMS {
        bigint id PK
        bigint order_id FK
        bigint product_id FK
        string product_name
        bigint unit_price
        int quantity
    }
    PRODUCTS {
        bigint id PK
        string sku UK
        string name
        bigint price
        int stock
    }

Alternatif dengan DBML (bisa ditempel ke dbdiagram.io untuk tampilan visual):

Table orders {
  id bigint [pk, increment]
  code varchar(30) [unique, not null]
  customer_id bigint [ref: > customers.id, not null]
  status varchar(20) [not null, default: 'pending']
  total bigint [not null]
  placed_at timestamp
  indexes {
    (status, placed_at)
  }
}

Simpan di docs/database/erd.md. Setiap pull request yang mengubah migration sebaiknya juga memperbarui file ini.

Langkah 7: Rancang Indeks dari Pola Query

Indeks dibuat berdasarkan query yang akan dijalankan, bukan ditebak. Turunkan dari requirement:

Query (sumber) Indeks
Login berdasarkan email (R1) unique(customers.email)
Cari produk berdasarkan SKU (R3) unique(products.sku)
Daftar pesanan pelanggan, terbaru dulu index(orders.customer_id, placed_at)
Laporan harian berdasarkan status (R8) index(orders.status, placed_at)
Item per pesanan foreign key order_items.order_id (otomatis berindeks di MySQL)

Urutan kolom pada indeks komposit penting: kolom dengan kondisi kesamaan (=) di depan, kolom rentang atau pengurutan (BETWEEN, ORDER BY) di belakang.

Langkah 8: Buat Enum untuk Status

php artisan make:enum Enums/OrderStatus --string
// app/Enums/OrderStatus.php
namespace App\Enums;

enum OrderStatus: string
{
    case Pending   = 'pending';
    case Paid      = 'paid';
    case Shipped   = 'shipped';
    case Completed = 'completed';
    case Cancelled = 'cancelled';

    public function label(): string
    {
        return match ($this) {
            self::Pending   => 'Menunggu Pembayaran',
            self::Paid      => 'Dibayar',
            self::Shipped   => 'Dikirim',
            self::Completed => 'Selesai',
            self::Cancelled => 'Dibatalkan',
        };
    }
}

Langkah 9: Tulis Migration

Buat migration berurutan sesuai dependensi: tabel induk dulu, baru tabel anak.

php artisan make:migration create_customers_table
php artisan make:migration create_addresses_table
php artisan make:migration create_categories_table
php artisan make:migration create_products_table
php artisan make:migration create_category_product_table
php artisan make:migration create_orders_table
php artisan make:migration create_order_items_table
php artisan make:migration create_payments_table

Customers dan addresses:

// database/migrations/2026_10_19_000001_create_customers_table.php
public function up(): void
{
    Schema::create('customers', function (Blueprint $table) {
        $table->id();
        $table->string('name', 100);
        $table->string('email')->unique();
        $table->string('phone', 20)->nullable();
        $table->string('password');
        $table->rememberToken();
        $table->timestamps();
    });
}

public function down(): void
{
    Schema::dropIfExists('customers');
}
// database/migrations/2026_10_19_000002_create_addresses_table.php
public function up(): void
{
    Schema::create('addresses', function (Blueprint $table) {
        $table->id();
        $table->foreignId('customer_id')->constrained()->cascadeOnDelete();
        $table->string('label', 50);                 // Rumah, Kantor
        $table->string('recipient_name', 100);
        $table->string('phone', 20);
        $table->text('street');
        $table->string('city', 100);
        $table->string('postal_code', 10);
        $table->boolean('is_primary')->default(false);
        $table->timestamps();
    });
}

Kategori (dengan hierarki) dan produk:

// database/migrations/2026_10_19_000003_create_categories_table.php
public function up(): void
{
    Schema::create('categories', function (Blueprint $table) {
        $table->id();
        $table->foreignId('parent_id')->nullable()
              ->constrained('categories')->nullOnDelete();
        $table->string('name', 100);
        $table->string('slug', 120)->unique();
        $table->timestamps();
    });
}
// database/migrations/2026_10_19_000004_create_products_table.php
public function up(): void
{
    Schema::create('products', function (Blueprint $table) {
        $table->id();
        $table->string('sku', 50)->unique();
        $table->string('name', 150);
        $table->string('slug', 170)->unique();
        $table->text('description')->nullable();
        $table->unsignedBigInteger('price');          // dalam rupiah
        $table->unsignedInteger('stock')->default(0);
        $table->boolean('is_active')->default(true)->index();
        $table->timestamps();
    });
}

Tabel pivot. Nama tabel pivot mengikuti konvensi Laravel: dua nama model dalam bentuk tunggal, urut abjad, dipisah garis bawah.

// database/migrations/2026_10_19_000005_create_category_product_table.php
public function up(): void
{
    Schema::create('category_product', function (Blueprint $table) {
        $table->foreignId('category_id')->constrained()->cascadeOnDelete();
        $table->foreignId('product_id')->constrained()->cascadeOnDelete();
        $table->primary(['category_id', 'product_id']);
    });
}

Pesanan, item, dan pembayaran. Perhatikan pilihan restrictOnDelete(): pelanggan dan produk yang sudah punya transaksi tidak boleh terhapus begitu saja.

// database/migrations/2026_10_19_000006_create_orders_table.php
public function up(): void
{
    Schema::create('orders', function (Blueprint $table) {
        $table->id();
        $table->string('code', 30)->unique();
        $table->foreignId('customer_id')->constrained()->restrictOnDelete();
        $table->json('address_snapshot');
        $table->string('status', 20)->default('pending');
        $table->unsignedBigInteger('subtotal');
        $table->unsignedBigInteger('shipping_cost')->default(0);
        $table->unsignedBigInteger('total');
        $table->timestamp('placed_at')->nullable();
        $table->timestamps();

        $table->index(['customer_id', 'placed_at']);
        $table->index(['status', 'placed_at']);
    });
}
// database/migrations/2026_10_19_000007_create_order_items_table.php
public function up(): void
{
    Schema::create('order_items', function (Blueprint $table) {
        $table->id();
        $table->foreignId('order_id')->constrained()->cascadeOnDelete();
        $table->foreignId('product_id')->constrained()->restrictOnDelete();
        $table->string('product_name', 150);           // snapshot
        $table->unsignedBigInteger('unit_price');      // snapshot
        $table->unsignedInteger('quantity');
        $table->unsignedBigInteger('line_total');

        $table->unique(['order_id', 'product_id']);
    });
}
// database/migrations/2026_10_19_000008_create_payments_table.php
public function up(): void
{
    Schema::create('payments', function (Blueprint $table) {
        $table->id();
        $table->foreignId('order_id')->constrained()->cascadeOnDelete();
        $table->string('method', 30);                 // transfer, qris, va_bca
        $table->unsignedBigInteger('amount');
        $table->string('status', 20)->default('pending');
        $table->string('reference', 100)->nullable()->unique();
        $table->timestamp('paid_at')->nullable();
        $table->timestamps();
    });
}

Ringkasan aturan onDelete yang dipakai:

Aturan Kapan dipakai
cascadeOnDelete() Anak tidak bermakna tanpa induk (alamat, item pesanan, baris pivot)
restrictOnDelete() Induk tidak boleh dihapus selama punya data historis (pelanggan, produk)
nullOnDelete() Relasi opsional (kategori induk)

Langkah 10: Hubungkan ke Model

// app/Models/Order.php
namespace App\Models;

use App\Enums\OrderStatus;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\{BelongsTo, HasMany};

class Order extends Model
{
    protected $fillable = [
        'code', 'customer_id', 'address_snapshot', 'status',
        'subtotal', 'shipping_cost', 'total', 'placed_at',
    ];

    protected function casts(): array
    {
        return [
            'address_snapshot' => 'array',
            'status'           => OrderStatus::class,
            'placed_at'        => 'datetime',
        ];
    }

    public function customer(): BelongsTo
    {
        return $this->belongsTo(Customer::class);
    }

    public function items(): HasMany
    {
        return $this->hasMany(OrderItem::class);
    }

    public function payments(): HasMany
    {
        return $this->hasMany(Payment::class);
    }
}

Pembahasan lengkap relasi ada di artikel Memahami Eloquent Relationships.

Langkah 11: Jalankan dan Verifikasi Skema

php artisan migrate
   INFO  Running migrations.

  2026_10_19_000001_create_customers_table ............ 21.40ms DONE
  2026_10_19_000002_create_addresses_table ............ 35.12ms DONE
  ...
  2026_10_19_000008_create_payments_table ............. 30.87ms DONE

Laravel menyediakan perintah inspeksi yang berguna untuk review:

php artisan db:show                 # ringkasan database, ukuran, jumlah tabel
php artisan db:table orders         # kolom, indeks, dan foreign key tabel orders
php artisan model:show Order        # atribut, cast, dan relasi model
$ php artisan db:table orders
  orders ............................................................
  Columns ............................................. 11
  Size ................................................ 0.05MiB

  Column ............................................. Type
  id autoincrement, unsigned ........................ bigint
  code .......................................... varchar(30)
  customer_id unsigned .............................. bigint
  ...
  Index ............................................................
  orders_code_unique code ........................... unique
  orders_status_placed_at_index status, placed_at .......

Terakhir, uji bahwa rollback juga berjalan:

php artisan migrate:refresh --step=8

Troubleshooting

Error Penyebab Solusi
SQLSTATE[HY000]: General error: 1824 Failed to open the referenced table 'customers' Migration tabel anak berjalan sebelum tabel induk Atur ulang urutan timestamp pada nama file migration
errno: 150 "Foreign key constraint is incorrectly formed" Tipe kolom FK berbeda dengan PK (misalnya integer vs bigint unsigned) Gunakan foreignId() yang otomatis unsignedBigInteger, atau samakan tipe secara manual
1071 Specified key was too long; max key length is 767 bytes MySQL lama atau charset utf8mb4 dengan string(255) pada indeks Gunakan MySQL 8+, atau set Schema::defaultStringLength(191) di AppServiceProvider
Integrity constraint violation: 1451 Cannot delete or update a parent row Menghapus data induk yang punya anak dengan restrictOnDelete Ini perilaku yang disengaja; arsipkan (soft delete) data induk, bukan menghapusnya
1062 Duplicate entry ... for key 'category_product.PRIMARY' Melampirkan relasi yang sama dua kali Gunakan syncWithoutDetaching() alih-alih attach()
Total di laporan selisih beberapa rupiah Uang disimpan sebagai float Migrasikan ke unsignedBigInteger (rupiah) atau decimal(15,2)
migrate:rollback gagal Method down() kosong atau tidak membalik up() dengan benar Selalu tulis down() dan uji dengan migrate:refresh di lokal

Best Practices

Keamanan

  • Jangan tampilkan ID auto increment di URL publik untuk data sensitif. Gunakan kode unik (orders.code) atau ULID ($table->ulid() + trait HasUlids).
  • Pasang foreign key di level database, bukan hanya validasi di aplikasi. Database adalah penjaga terakhir integritas data.
  • Kolom yang menyimpan data pribadi (NIK, nomor rekening) pertimbangkan dienkripsi dengan cast encrypted, dengan konsekuensi kolom tersebut tidak bisa difilter.

Performa

  • Turunkan indeks dari query nyata. Periksa dengan EXPLAIN setelah ada data contoh dalam jumlah realistis.
  • Pilih tipe sekecil yang masih aman: string(20) untuk status, bukan text.
  • Hindari kolom json untuk data yang sering difilter atau di-join.

Maintainability

  • Simpan requirement, ERD, dan catatan keputusan desain di docs/database/, dan perbarui bersamaan dengan migration.
  • Satu migration untuk satu perubahan logis. Jangan pernah mengedit migration yang sudah dijalankan di production; buat migration baru.
  • Gunakan PHP enum untuk nilai status, bukan string yang tersebar di kode.
  • Beri nama konsisten: tabel jamak (orders), FK {model}_id, pivot tunggal urut abjad (category_product).
  • Dokumentasikan setiap denormalisasi yang disengaja beserta alasannya.

Related Articles

Last Tested

Komponen Versi
Laravel 13.x
PHP 8.4
MySQL 8.4 LTS
Composer 2.8
Tanggal 19 Oktober 2026

Bagikan artikel:

Artikel lainnya