Persyaratan

Persyaratan

Perangkat lunak

Komponen	Versi / catatan
Node.js	≥ 22 (engines di package.json)
pnpm	10+ (repo memakai pnpm-lock.yaml; packageManager menunjuk pnpm 10.x)
Docker + Compose	Untuk PostgreSQL 16 dan Redis 7
Git	Opsional jika Anda hanya mengekstrak ZIP

Cara umum mengaktifkan pnpm:

corepack enable && corepack prepare pnpm@latest --activate
pnpm -v

Port default

Layanan	Port host
App Kartaya	3000
PostgreSQL (Compose)	5434 → container 5432
Redis (Compose)	6380 → container 6379

Pastikan port tidak bentrok dengan layanan lokal lain. Jika mengubah mapping di docker-compose.yml, sesuaikan juga DATABASE_URL / REDIS_URL di .env.local.

Layanan yang dibutuhkan saat jalan

1. PostgreSQL — via Compose di repo (postgres:16-alpine)
2. Redis — via Compose (redis:7-alpine)
3. Proses app — pnpm dev atau pnpm build + pnpm preview
4. Proses worker — pnpm worker (wajib untuk job)

Docker Compose di paket hanya Postgres + Redis. Tidak ada Dockerfile aplikasi Node.

Kunci / akun eksternal (disiapkan pembeli)

Kebutuhan	Keterangan
Provider TEXT	OpenAI-compatible (contoh: DeepSeek, OpenAI, OpenRouter) — API key
Provider IMAGE	Ideogram (disarankan) dan/atau OpenAI-compatible — API key
S3 (opsional)	Endpoint, region, bucket, access key, secret key — lewat Settings
Google Drive (opsional)	OAuth Client ID/Secret + GDRIVE_REDIRECT_URI yang cocok

Biaya pemakaian API AI ditanggung pembeli, langsung ke provider masing-masing.

Hardware (praktis, bukan angka resmi di kode)

• OS: Linux, macOS, atau Windows (Docker Desktop / engine setara)
• RAM: disarankan ≥ 4 GB jika app + worker + Postgres + Redis jalan bersama
• CPU: 2 inti cukup untuk dual process; generate gambar bergantung kuota API
• Disk: image Docker, node_modules, dan folder runtime storage/