vip-coordinator/APP_PLATFORM_DEPLOYMENT.md

# VIP Coordinator - Digital Ocean App Platform Deployment

## Overview

Deploy VIP Coordinator using Digital Ocean App Platform for a **fully managed, cheaper** deployment ($17/month total vs $24+ for droplets).

## What You Get

- ✅ **Automatic SSL/HTTPS** (Let's Encrypt)
- ✅ **Auto-scaling** (if needed)
- ✅ **Managed PostgreSQL database**
- ✅ **No server management**
- ✅ **Automatic deployments** from Docker Hub
- ✅ **Built-in monitoring**

## Cost Breakdown

| Service | Size | Cost/Month |
|---------|------|------------|
| Backend | basic-xxs | $5 |
| Frontend | basic-xxs | $5 |
| PostgreSQL | Dev tier | $7 |
| **Total** | | **$17/month** |

## Prerequisites

✅ Docker images pushed to Docker Hub:
- `t72chevy/vip-coordinator-backend:latest`
- `t72chevy/vip-coordinator-frontend:latest`

## Deployment Steps

### Step 1: Make Docker Hub Repos Private (Optional but Recommended)

1. Go to [Docker Hub](https://hub.docker.com/repositories/t72chevy)
2. Click `vip-coordinator-backend` → Settings → **Make Private**
3. Click `vip-coordinator-frontend` → Settings → **Make Private**

### Step 2: Create App on Digital Ocean

1. Go to [Digital Ocean App Platform](https://cloud.digitalocean.com/apps)
2. Click **Create App**
3. Choose **Docker Hub** as source

### Step 3: Configure Docker Hub Authentication

1. **Registry:** Docker Hub
2. **Username:** `t72chevy`
3. **Access Token:** `dckr_pat_CPwzonJV_nCTIa05Ib_w8NFRrpQ`
4. Click **Next**

### Step 4: Add Backend Service

1. Click **+ Add Resource** → **Service**
2. **Source:**
   - Registry: Docker Hub
   - Repository: `t72chevy/vip-coordinator-backend`
   - Tag: `latest`
3. **HTTP Port:** `3000`
4. **HTTP Request Routes:** `/api`
5. **Health Check:**
   - Path: `/api/v1/health`
   - Initial delay: 40 seconds
6. **Instance Size:** Basic (XXS) - $5/month
7. **Environment Variables:** (Add these)
   ```
   NODE_ENV=production
   AUTH0_DOMAIN=dev-s855cy3bvjjbkljt.us.auth0.com
   AUTH0_AUDIENCE=https://vip-coordinator-api
   AUTH0_ISSUER=https://dev-s855cy3bvjjbkljt.us.auth0.com/
   ```
8. Click **Save**

### Step 5: Add Frontend Service

1. Click **+ Add Resource** → **Service**
2. **Source:**
   - Registry: Docker Hub
   - Repository: `t72chevy/vip-coordinator-frontend`
   - Tag: `latest`
3. **HTTP Port:** `80`
4. **HTTP Request Routes:** `/`
5. **Instance Size:** Basic (XXS) - $5/month
6. Click **Save**

### Step 6: Add PostgreSQL Database

1. Click **+ Add Resource** → **Database**
2. **Engine:** PostgreSQL 16
3. **Name:** `vip-db`
4. **Plan:** Dev ($7/month) or Production ($15/month)
5. This automatically creates `${vip-db.DATABASE_URL}` variable
6. Click **Save**

### Step 7: Add Redis (Optional - for sessions)

**Option A: Use App Platform Redis (Recommended)**
1. Wait - App Platform doesn't have managed Redis yet
2. Skip for now, or use Upstash Redis (free tier)

**Option B: Skip Redis**
- Backend will work without Redis
- Remove Redis-dependent features temporarily

### Step 8: Configure Environment Variables

Go back to **backend** service and add:

```env
# Database (automatically set by App Platform)
DATABASE_URL=${vip-db.DATABASE_URL}

# Auth0
AUTH0_DOMAIN=dev-s855cy3bvjjbkljt.us.auth0.com
AUTH0_AUDIENCE=https://vip-coordinator-api
AUTH0_ISSUER=https://dev-s855cy3bvjjbkljt.us.auth0.com/

# Application
NODE_ENV=production
PORT=3000

# Redis (if using Upstash or external)
REDIS_URL=redis://your-redis-url:6379
```

### Step 9: Configure Custom Domain

1. In App settings, go to **Settings** → **Domains**
2. Click **Add Domain**
3. Enter: `vip.madeamess.online`
4. You'll get DNS instructions:
   ```
   Type: CNAME
   Name: vip
   Value: <app-name>.ondigitalocean.app
   ```

### Step 10: Update Namecheap DNS

1. Go to [Namecheap Dashboard](https://ap.www.namecheap.com/domains/list/)
2. Select `madeamess.online` → **Advanced DNS**
3. Add CNAME record:
   ```
   Type: CNAME Record
   Host: vip
   Value: <your-app>.ondigitalocean.app
   TTL: Automatic
   ```
4. Save

### Step 11: Update Auth0 Callbacks

1. Go to [Auth0 Dashboard](https://manage.auth0.com/)
2. Select your VIP Coordinator application
3. Update URLs:
   ```
   Allowed Callback URLs:
   https://vip.madeamess.online

   Allowed Web Origins:
   https://vip.madeamess.online

   Allowed Logout URLs:
   https://vip.madeamess.online
   ```
4. Click **Save Changes**

### Step 12: Deploy!

1. Review all settings
2. Click **Create Resources**
3. Wait 5-10 minutes for deployment
4. App Platform will:
   - Pull Docker images
   - Create database
   - Run migrations (via entrypoint script)
   - Configure SSL
   - Deploy to production

## Verification

### Check Deployment Status

1. Go to App Platform dashboard
2. Check all services are **Deployed** (green)
3. Click on app URL to test

### Test Endpoints

```bash
# Health check
curl https://vip.madeamess.online/api/v1/health

# Frontend
curl https://vip.madeamess.online/
```

### Test Login

1. Go to `https://vip.madeamess.online`
2. Click login
3. Authenticate with Auth0
4. First user should be auto-approved as admin

## Updating Application

When you push new images to Docker Hub:

1. Go to App Platform dashboard
2. Click your app → **Settings** → **Component** (backend or frontend)
3. Click **Force Rebuild and Redeploy**

Or set up **Auto-Deploy**:
1. Go to component settings
2. Enable **Autodeploy**
3. New pushes to Docker Hub will auto-deploy

## Monitoring & Logs

### View Logs

1. App Platform dashboard → Your app
2. Click **Runtime Logs**
3. Select service (backend/frontend)
4. View real-time logs

### View Metrics

1. Click **Insights**
2. See CPU, memory, requests
3. Set up alerts

## Database Management

### Connect to Database

```bash
# Get connection string from App Platform dashboard
# Environment → DATABASE_URL

# Connect via psql
psql "postgresql://doadmin:<password>@<host>:25060/defaultdb?sslmode=require"
```

### Backups

- **Dev tier**: Daily backups (7 days retention)
- **Production tier**: Daily backups (14 days retention)
- Manual backups available

### Run Migrations

Migrations run automatically on container startup via `docker-entrypoint.sh`.

To manually trigger:
1. Go to backend component
2. Click **Console**
3. Run: `npx prisma migrate deploy`

## Troubleshooting

### App Won't Start

1. Check **Runtime Logs** for errors
2. Verify environment variables are set
3. Check database connection string
4. Ensure images are accessible (public or authenticated)

### Database Connection Failed

1. Verify `DATABASE_URL` is set correctly
2. Check database is running (green status)
3. Ensure migrations completed successfully

### Frontend Shows 502

1. Check backend is healthy (`/api/v1/health`)
2. Verify backend routes are configured correctly
3. Check nginx logs in frontend component

### Auth0 Login Fails

1. Verify callback URLs match exactly
2. Check `vip.madeamess.online` is set correctly
3. Ensure HTTPS (not HTTP)
4. Clear browser cache/cookies

## Cost Optimization

### Downsize if Needed

**Basic XXS ($5/month):**
- 512MB RAM, 0.5 vCPU
- Good for low traffic

**Basic XS ($12/month):**
- 1GB RAM, 1 vCPU
- Better for production

### Use Dev Database

**Dev Database ($7/month):**
- 1GB RAM, 10GB storage
- 7 daily backups
- Good for testing

**Production Database ($15/month):**
- 2GB RAM, 25GB storage
- 14 daily backups
- Better performance

### Optimize Images

Current sizes:
- Backend: 446MB → Can optimize to ~200MB
- Frontend: 75MB → Already optimized

## Alternative: Deploy via CLI

```bash
# Install doctl
brew install doctl  # Mac
# or download from https://docs.digitalocean.com/reference/doctl/

# Authenticate
doctl auth init

# Create app from spec
doctl apps create --spec .do/app.yaml

# Update app
doctl apps update <app-id> --spec .do/app.yaml
```

## Redis Alternative (Free)

Since App Platform doesn't have managed Redis, use **Upstash** (free tier):

1. Go to [Upstash](https://console.upstash.com/)
2. Create free Redis database
3. Copy connection URL
4. Add to backend environment:
   ```
   REDIS_URL=rediss://default:<password>@<host>:6379
   ```

Or skip Redis entirely:
- Comment out Redis code in backend
- Remove session storage dependency

## Support Resources

- [App Platform Docs](https://docs.digitalocean.com/products/app-platform/)
- [Docker Hub Integration](https://docs.digitalocean.com/products/app-platform/how-to/deploy-from-container-images/)
- [Managed Databases](https://docs.digitalocean.com/products/databases/)

---

**Deployment Complete!** 🚀

Your VIP Coordinator will be live at: `https://vip.madeamess.online`

Total cost: **~$17/month** (much cheaper than droplets!)