Lewati ke konten utama

Panduan Instalasi & Pengoperasian Local

Dokumen ini menjelaskan langkah-langkah untuk menyiapkan environment pengembang (local development), konfigurasi variabel lingkungan (environment variables), dan menjalankan Codeverta ERP Core.

Prasyarat System​

Sebelum memulai, pastikan perangkat Anda telah terpasang software berikut:

  • Node.js: v18.x atau v20.x+
  • pnpm: v8.x atau v9.x+
  • Go: v1.22+
  • PostgreSQL: v14+
  • Redis: v6+
  • Docker & Docker Compose (opsional, untuk pengujian kontainerisasi)

Langkah Instalasi Local​

1. Clone Repository & Install Dependensi Node​

git clone https://github.com/codeverta/enterprise.codeverta.com.git
cd enterprise.codeverta.com

# Install dependensi pnpm workspace
pnpm install

2. Konfigurasi Variabel Lingkungan (.env)​

Salin file contoh konfigurasi pada masing-masing service:

# Backend Environment
cp apps/backend/.env.example apps/backend/.env

# Admin Frontend Environment
cp apps/admin/.env.example apps/admin/.env

Pengaturan Penting pada apps/backend/.env:​

PORT=8080
DATABASE_URL="postgres://user:password@localhost:5432/codeverta_erp?sslmode=disable"
REDIS_URL="redis://localhost:6379/0"

# Secret Key (Wajib diubah dengan minimal 64 karakter acak)
JWT_SECRET="ganti-dengan-string-rahasia-minimal-64-karakter-acak-dan-aman"
REFRESH_SECRET="ganti-dengan-string-refresh-rahasia-minimal-64-karakter"

# Service Integrasi (Tencent SES & Xendit)
TENCENTCLOUD_SECRET_ID="your-tencent-secret-id"
TENCENTCLOUD_SECRET_KEY="your-tencent-secret-key"
XENDIT_SECRET_KEY="xnd_development_..."

Menjalankan Service di Local​

Anda dapat menjalankan backend dan frontend secara bersamaan dari root workspace:

# Menjalankan Backend Go Engine
pnpm dev:backend

# Menjalankan Admin Frontend React (Vite)
pnpm dev:admin

Backend akan berjalan pada http://localhost:8080 dan Admin Dashboard pada http://localhost:5173.

Pengujian & Verifikasi Build​

Untuk memastikan seluruh modul terkompilasi tanpa kesalahan, jalankan perintah verifikasi berikut:

# 1. Verifikasi Build Frontend Admin
pnpm --filter admin-page build

# 2. Verifikasi Unit Testing & Build Backend Go
cd apps/backend
JWT_SECRET="minimal-64-characters-long-secret-key-for-testing-purpose-only" go test ./...
go build ./...

Menjalankan dengan Docker Compose​

Untuk mensimulasikan lingkungan produksi lengkap dengan HAProxy dan PostgreSQL:

docker-compose up --build -d

Layanan akan dapat diakses melalui domain lokal atau IP host sesuai konfigurasi haproxy/haproxy.cfg.