02. Instalasi & Memulai Cepat

Ringkasan

Panduan ini berisi petunjuk langkah-demi-langkah untuk menginstal, menginisialisasi, membuat seed data, dan menjalankan T3 Stack Single-App Boilerplate di lingkungan pengembangan lokal maupun server produksi.

Prasyarat

Sebelum memulai, pastikan sistem Anda memenuhi prasyarat perangkat lunak berikut:

Cara Kerja

Proses instalasi menginisialisasi dependensi Node.js, menggenerasi tipe data Prisma Client, menyinkronkan skema database ke server MySQL Anda, dan memasukkan kredensial awal Super Admin serta matriks hak akses RBAC.

sequenceDiagram
    autonumber
    actor Dev as Developer
    participant Terminal as Command Line
    participant DB as MySQL Database
    
    Dev->>Terminal: pnpm install
    Terminal->>Terminal: Unduh node_modules & generasi Prisma Client
    Dev->>Terminal: cp .env.example .env
    Dev->>Terminal: pnpm prisma db push
    Terminal->>DB: Terapkan migrasi skema & tabel
    Dev->>Terminal: pnpm prisma db seed
    Terminal->>DB: Masukkan Super Admin, Peran & Izin
    Dev->>Terminal: pnpm dev
    Terminal->>Dev: Server berjalan di http://localhost:3000

Konfigurasi

Pastikan file .env berisi koneksi MySQL yang valid sebelum menjalankan perintah skema:

DATABASE_URL="mysql://username:password@localhost:3306/turah_singleapps"
NEXTAUTH_SECRET="secret-min-32-karakter"
NEXTAUTH_URL="http://localhost:3000"

Langkah Instalasi

Langkah 1: Clone Repositori & Install Dependensi

Buka terminal di direktori proyek dan jalankan:

pnpm install

Langkah 2: Konfigurasi Environment Variables

Salin file contoh konfigurasi environment:

cp .env.example .env

Edit file .env dan atur URL koneksi database MySQL pada DATABASE_URL.

Langkah 3: Push Skema Database

Jalankan sinkronisasi skema Prisma untuk membuat tabel di database MySQL Anda:

pnpm prisma db push

Langkah 4: Masukkan Seed Data Awal

Jalankan seeding untuk memasukkan peran default, hak akses, app settings, dan akun Super Admin:

pnpm prisma db seed

Langkah 5: Jalankan Server Pengembangan

Jalankan server lokal dengan fitur hot-reload:

pnpm dev

Buka http://localhost:3000/ di browser Anda.

Berkas Terkait

Tabel Database Terkait