Deployment

VPS Deployment Readiness

Checklist kesiapan sebelum aplikasi dipindah ke VPS. Status saat ini siap untuk persiapan VPS/staging, belum production sampai DB dan smoke test selesai.

Export Markdown Project Checkpoint DB Handover

Verdict: READY_FOR_VPS_PREPARATION_NOT_PRODUCTION

Aman untuk Boss mulai siapkan VPS. Belum boleh dianggap production-ready sampai DATABASE_URL production diverifikasi, migration SQL direview, migrate/seed disetujui, dan smoke test berhasil.

Total Checks

Ready

Pending VPS

Needs Approval

Blocked

Readiness Checklist

Ikuti urutan ini sebelum app dipakai user real di VPS.

Phase	Status	Owner	Check	Evidence
Application Build	READY	Fara	npm run typecheck dan npm run build sudah pass pada checkpoint terakhir.	Latest checkpoint: typecheck ✅, build ✅, 38 routes.
Project Checkpoint	READY	Fara	Final project checkpoint dan export Markdown sudah tersedia.	/project-checkpoint dan /api/project-checkpoint/export.
Source Transfer	PENDING_VPS	Boss/VPS	Project perlu dicopy/push ke VPS setelah server tersedia.	Target VPS belum disiapkan.
Runtime	PENDING_VPS	Boss/VPS	Install Node.js LTS, npm, dan process manager seperti PM2/systemd.	Belum diverifikasi di VPS.
PostgreSQL	PENDING_VPS	Boss/VPS	Install PostgreSQL, buat database/user, dan siapkan DATABASE_URL.	DATABASE_URL production belum diverifikasi.
Environment	PENDING_VPS	Boss/VPS	Buat .env.production dengan DATABASE_URL dan secret/config production.	Env production belum dibuat di VPS.
Migration SQL	NEEDS_APPROVAL	Boss + Fara	Jalankan npm run db:generate hanya setelah Boss approve; ini generate SQL saja.	work_order_drafts sudah ada di schema source, migration SQL belum dibuat.
DB Migration	BLOCKED	Boss + Fara	Jangan menjalankan npm run db:migrate sebelum SQL direview, DATABASE_URL benar, dan Boss approve.	Belum ada migration SQL yang direview.
Seed Data	BLOCKED	Boss + Fara	Seed harus dry-run dulu, lalu execute hanya setelah hasilnya aman dan Boss approve.	db:seed:cache -- --execute belum dijalankan.
Web Server	PENDING_VPS	Boss/VPS	Siapkan nginx reverse proxy, domain, firewall, dan SSL.	Domain/SSL/VPS belum diverifikasi.
Production Smoke Test	PENDING_VPS	Fara	Setelah deploy, test route utama, DB readiness, counts, draft flow, dan export.	Belum bisa dilakukan sebelum VPS tersedia.

Minimum VPS Spec

Ubuntu 22.04/24.04 LTS atau Debian 12.
RAM minimal 2 GB untuk staging kecil; lebih nyaman 4 GB jika PostgreSQL satu server.
Storage minimal 20 GB SSD.
Node.js LTS.
PostgreSQL 15+.
nginx + Certbot/SSL.
Firewall hanya buka SSH, HTTP, HTTPS; database jangan public internet.

Hard Stop Rules

Jangan expose PostgreSQL ke public internet.
Jangan commit/upload .env production ke repository publik.
Jangan menjalankan db:migrate sebelum DATABASE_URL menunjuk database yang benar.
Jangan menjalankan seed execute sebelum dry-run dan count comparison aman.
Jangan aktifkan production untuk user real sebelum smoke test selesai.

Command Reference

npm install

Install dependencies di VPS setelah source code masuk.

npm run typecheck

Validasi TypeScript di VPS.

npm run build

Build production di VPS.

npm run db:generate

Generate SQL migration saja; perlu approval Boss dulu.

npm run db:migrate

Operasi tulis DB; hanya setelah SQL direview dan Boss approve.

npm run db:seed:cache

Dry-run seed/import cache ke PostgreSQL.

npm run db:seed:cache -- --execute

Operasi tulis seed; hanya setelah dry-run aman dan Boss approve.

npm run start

Start Next.js production; untuk VPS lebih baik via PM2/systemd.