Database Design

Preferred DB: PostgreSQL

Default untuk semua project backend (Go, Laravel, NestJS, Bun/Hono).

Schema Design

Use snake_case untuk nama tabel dan kolom.
Tabel plural: users, posts, orders.
Foreign key naming: user_id, post_id.
Timestamps: created_at, updated_at, deleted_at (soft delete jika perlu).
Primary Key: Default gunakan format Prefixed NanoID/ULID sebagai VARCHAR (contoh: usr_2v6d8x1) yang diekspos sebagai string di API. Jika internal menggunakan SERIAL/BIGINT, jangan diekspos ke public API (gunakan kolom UUID eksternal).

Panduan Tipe Data

Data	PostgreSQL Type	Kapan Digunakan
ID / PK	`VARCHAR(32)`	Untuk NanoID/ULID/Prefixed ID (cth: `usr_xyz`)
String	`VARCHAR(255)`	Email, Nama, Title, dll
Teks	`TEXT`	Deskripsi, Artikel, JSON string fallback
Uang / Saldo	`DECIMAL(15,2)`	Harga, saldo (hindari tipe `FLOAT` untuk uang)
Waktu	`TIMESTAMPTZ`	Selalu gunakan timezone-aware (contoh: `created_at`)
Dinamis	`JSONB`	Metadata, seting user, array data tanpa struktur pasti
Enum	`VARCHAR`	Hindari native `ENUM` PostgreSQL (sulit di-alter). Gunakan `VARCHAR` dengan `CHECK` constraint atau tabel referensi.

Contoh Skema SQL Terstruktur

CREATE TABLE users (
    id VARCHAR(32) PRIMARY KEY,
    email VARCHAR(255) UNIQUE NOT NULL,
    status VARCHAR(50) DEFAULT 'active' CHECK (status IN ('active', 'inactive', 'banned')),
    metadata JSONB DEFAULT '{}'::jsonb,
    created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP,
    deleted_at TIMESTAMPTZ NULL
);

CREATE TABLE orders (
    id VARCHAR(32) PRIMARY KEY,
    user_id VARCHAR(32) NOT NULL REFERENCES users(id) ON DELETE CASCADE,
    total_amount DECIMAL(15,2) NOT NULL,
    created_at TIMESTAMPTZ DEFAULT CURRENT_TIMESTAMP
);

Migration Strategy

Gunakan migration tool sesuai stack:

Stack	Tool
Go	Atlas / goose
Laravel	Eloquent migrations
NestJS	TypeORM / Prisma
Bun	Drizzle ORM

Contoh Penamaan File Migrasi

Gunakan format prefix timestamp untuk menghindari conflict:

20260710123000_create_users_table.sql (Raw SQL / goose)
2026_07_10_123000_create_users_table.php (Laravel)

Contoh Isi File Migrasi (Goose/SQL)

-- +goose Up
CREATE TABLE posts (
    id VARCHAR(32) PRIMARY KEY,
    title VARCHAR(255) NOT NULL,
    body TEXT
);

-- +goose Down
DROP TABLE posts;

Indexing

B-Tree (Default): Untuk pencarian exact match, inequality (>, <), dan sorting. Selalu index kolom Foreign Key dan kolom yang sering di-ORDER BY.
- Contoh: CREATE INDEX idx_orders_user_id ON orders(user_id);
GIN Index: Wajib untuk pencarian full-text search atau mencari key di dalam kolom JSONB.
- Contoh: CREATE INDEX idx_users_metadata ON users USING GIN (metadata);
Partial Index: Sangat disarankan untuk memfilter data aktif guna menghemat memori.
- Contoh: CREATE INDEX idx_users_active_email ON users(email) WHERE deleted_at IS NULL;
Composite Index: Jika sering filter berdasarkan 2 kolom bersamaan (WHERE category_id = 1 AND status = 'active'). Urutan kolom di index itu penting (Left-most prefix rule).
Hindari Over-indexing: Setiap index memperlambat proses INSERT dan UPDATE.
Selalu cek dengan EXPLAIN ANALYZE sebelum deploy index ke production.

Soft Delete

Pakai deleted_at timestamp NULL DEFAULT NULL. Query default pakai WHERE deleted_at IS NULL.

Connection Pool

Go: SetMaxOpenConns(25), SetMaxIdleConns(10).
NestJS/Prisma: Default pool cukup, adjust berdasarkan load.

MySQL (Alternatif Relasional)

Meskipun PostgreSQL adalah default, jika project mengharuskan penggunaan MySQL, ikuti panduan berikut:

Storage Engine: Selalu gunakan InnoDB.
Collation & Charset: Gunakan utf8mb4 dan utf8mb4_unicode_ci (atau utf8mb4_0900_ai_ci di MySQL 8+) agar mendukung emoji.
Tipe Data Ekuivalen:
- Waktu: Gunakan DATETIME (simpan semua waktu dalam zona UTC secara default).
- Boolean: Gunakan TINYINT(1).
- Dinamis: Gunakan tipe data JSON.
- ID/PK: Gunakan VARCHAR(32) untuk NanoID/ULID, atau VARCHAR(36) untuk UUID standar.

Redis (Caching & Key-Value)

Gunakan Redis untuk Caching, Session Storage, Rate Limiting, dan Pub/Sub.

Key Naming Convention: Gunakan format colon-separated (titik dua) untuk membuat namespace yang rapi.
- Contoh Data Profile: cache:user:usr_123:profile
- Contoh Session: session:usr_123
- Contoh Rate Limit: ratelimit:ip:192.168.1.1
Time To Live (TTL): Wajib set TTL (EX / PX) untuk setiap data cache dan session agar RAM tidak penuh secara permanen.
Eviction Policy: Pastikan konfigurasi Redis memiliki maxmemory-policy seperti allkeys-lru (menghapus data lama secara otomatis jika memori penuh) atau volatile-lru.
Data Types: Jangan hanya menggunakan string (SET/GET). Manfaatkan struktur lain:
- Hash (HSET / HGETALL): Menyimpan object user.
- Set (SADD / SISMEMBER): Menyimpan daftar unik (contoh: tags).
- Sorted Set (ZADD / ZRANGE): Leaderboard atau antrean berdasarkan skor/waktu.