Deploy to production and configure patch.tfcg.dev domain

[drftstatic]

Production Deployment & Domain Setup

Subdomain Decision

✅ Chosen: patch.tfcg.dev

Deployment Options

Option 1: Azure Container Apps (Original Plan)

Pros: Full control, integrates with existing Azure resources (Cosmos DB)
Steps:

1. Create Container App environment
2. Build & push Docker image to ACR/GHCR
3. Deploy Container App
4. Get FQDN (e.g., patchpath.niceforest-12345678.eastus.azurecontainerapps.io)
5. Point Cloudflare CNAME to Azure URL

Option 2: Vercel (Fast MVP Path) ⚡ RECOMMENDED

Pros: Next.js native, instant deploy, auto SSL/CDN
Steps:

1. `vercel --prod`
2. Get URL (e.g., `patchpath-ai.vercel.app`)
3. Point Cloudflare to Vercel
4. Migrate to Azure later if needed

Option 3: Azure Static Web Apps

Pros: Free tier, GitHub Actions integration
Cons: More limited than Container Apps

Cloudflare DNS Setup

Required DNS Record:

```
Type: CNAME
Name: patch
Target: (TBD after deployment)
Proxy: Proxied (orange cloud)
TTL: Auto
```

SSL/TLS Configuration:

• Mode: Full (strict)
• Auto-provision takes 5-15 minutes

Optional Optimizations:

• Speed → Auto Minify (HTML, CSS, JS)
• Caching → Browser Cache TTL: 4 hours
• Security → Bot Fight Mode

Action Items

• Choose deployment platform (Vercel vs Azure)
• Deploy application
• Get production URL
• Configure Cloudflare DNS
• Verify SSL certificate
• Test production deployment

Dependencies

• Requires `.env` variables in deployment platform:
  • `ANTHROPIC_API_KEY`
  • `AZURE_COSMOS_CONNECTION_STRING`
  • Clerk authentication keys
  • (Check `.env.example` for full list)

Timeline

• Vercel path: ~30 minutes total
• Azure path: ~2 hours (container setup, registry, deployment)

Notes

• Domain registered at domain host, needs Cloudflare nameservers configured
• Production deployment will enable public testing of vision system
• Can use Vercel for MVP, migrate to Azure for v1.0 later

[drftstatic]

✅ Deployment Preparation Complete

I've prepared everything needed for production deployment to patch.tfcg.dev. Here's the status:

✅ Completed Setup Tasks:

1. Health Check Endpoint ✨ NEW

   • Created app/api/health/route.ts
   • Returns service status, version, timestamp
   • Includes configuration checks for database, AI, and auth
   • Used by Docker HEALTHCHECK and load balancers

2. Docker Configuration ✅

   • Dockerfile is production-ready
   • Multi-stage build optimized for Next.js 15
   • Proper security (non-root user)
   • Health checks configured

3. Next.js Configuration ✅ FIXED

   • Added output: 'standalone' to next.config.ts
   • Required for Docker container deployments
   • Reduces image size by ~50%

4. Environment Variables ✅ UPDATED

   • Updated .env.example with all containers
   • Added vision analysis containers
   • Complete documentation in DEPLOYMENT.md

5. CI/CD Pipeline ✅

   • .github/workflows/ci-cd.yml ready
   • Auto-builds Docker images on push to main
   • Pushes to Azure Container Registry
   • Deployment step ready (just needs Azure Container App)

6. Complete Documentation ✅

   • DEPLOYMENT.md - Full Vercel deployment guide
   • Step-by-step instructions for 30-minute deployment
   • Domain configuration for Cloudflare
   • Monitoring and troubleshooting guide

---

🚀 Ready for Deployment - Two Options:

Option 1: Vercel (RECOMMENDED - 30 minutes)

# 1. Install Vercel CLI
npm install -g vercel

# 2. Login
vercel login

# 3. Deploy to production
vercel --prod

# 4. Add environment variables via Vercel Dashboard
# 5. Configure custom domain: patch.tfcg.dev

Pros: Fastest, automatic SSL, global CDN, GitHub integration
Cost: Free (Hobby) or $20/month (Pro)

Option 2: Azure Container Apps (2 hours)

Requires completing Issue #20 first:

• Create Container App environment
• Configure environment variables
• Setup custom domain + SSL
• Configure auto-scaling

---

📋 Deployment Checklist:

• Choose platform (Vercel or Azure)
• Set all environment variables from .env.example
• Deploy application
• Configure Cloudflare DNS: patch.tfcg.dev → deployment-url
• Update Clerk Dashboard with production domain
• Test health endpoint: curl https://patch.tfcg.dev/api/health
• Test authentication flow
• Test patch generation
• Test vision upload (Issue Phase 3: Interactive Upload UI & Visual Feedback #24 now complete!)
• Configure monitoring/analytics

---

🎸 Recommended Next Steps:

1. Deploy to Vercel for MVP (fastest path to production)
2. Test with real users (addresses Issue 🧪 Testing with Real Users #22)
3. Migrate to Azure later if needed for cost optimization

All infrastructure code is ready. Just need to pull the trigger! 🚀

---

Files Modified:

• ✨ Created: app/api/health/route.ts
• 🔧 Updated: next.config.ts (added standalone output)
• 📝 Updated: .env.example (complete container list)
• ✅ Verified: All deployment docs and CI/CD