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
statusberisi 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 simpancategory_name. - 3NF: tidak ada kolom yang bergantung pada kolom bukan kunci. Jangan simpan
customer_emaildiorderskarena sudah bisa diambil lewatcustomer_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()+ traitHasUlids). - 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
EXPLAINsetelah ada data contoh dalam jumlah realistis. - Pilih tipe sekecil yang masih aman:
string(20)untuk status, bukantext. - Hindari kolom
jsonuntuk 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
- Memahami Eloquent Relationships: One-to-One, One-to-Many, dan Many-to-Many dengan Studi Kasus
- Panduan Database Migration dan Seeder untuk Development, Testing, dan Production
- Mengatasi Masalah N+1 Query di Laravel Menggunakan Eager Loading
- Soft Delete, Audit Trail, dan Activity Log: Cara Melacak Perubahan Data Aplikasi
- Membuat Dokumentasi API dan Panduan Instalasi Source Code Laravel untuk Pelanggan
Last Tested
| Komponen | Versi |
|---|---|
| Laravel | 13.x |
| PHP | 8.4 |
| MySQL | 8.4 LTS |
| Composer | 2.8 |
| Tanggal | 19 Oktober 2026 |