Lb1/docs/DEPLOYMENT.md

🚀 Luxe Platform - Production Deployment Guide

This guide covers deployment procedures for local Docker Compose development, production Kubernetes environments, and database migrations.

---

1. Quick Local Setup with Docker Compose

Prerequisites

• Node.js >= 22.0.0 LTS
• Docker & Docker Compose

Step 1: Clone & Configure Environment

cp .env.example .env

Step 2: Spin Up Infrastructure Containers

npm run docker:up

This launches:

• PostgreSQL 16: localhost:5432
• Redis 7: localhost:6379
• MinIO S3: http://localhost:9000 (Console: http://localhost:9001)
• Mailpit SMTP: http://localhost:8025
• Prometheus: http://localhost:9090
• Grafana: http://localhost:3001

Step 3: Run Database Migrations & Seeding

npm run db:push
npm run db:seed

Step 4: Launch Gateway & Workers in Dev Mode

npm run dev

Open http://localhost:3000/documentation to view the live OpenAPI Swagger UI.

---

2. Production Deployment on Kubernetes

Step 1: Apply Kubernetes Manifests

kubectl apply -f k8s/deployment.yaml

Step 2: Verify Autoscaling (HPA)

kubectl get hpa luxe-gateway-hpa

The Gateway will automatically scale up to 20 replicas when CPU utilization exceeds 75%.