Version 1.1

DOCKER_README.md

@@ -1,54 +1,56 @@
 # Lottery Investment Calculator - Docker Setup
 
-## 🐋 Docker Deployment Guide
-
-### Prerequisites
+## Prerequisites
 - Docker Desktop installed (https://www.docker.com/products/docker-desktop)
 - Docker Compose (included with Docker Desktop)
 
 ---
 
-## 🚀 Quick Start
+## Quick Start
 
-### 1. Build and Run Everything
+### 1. Configure Environment
 ```bash
-docker-compose up -d
+cp .env.example .env
+# Edit .env with your preferred settings
 ```
 
-This will start:
+### 2. Build and Run
+```bash
+docker compose up -d
+```
+
+This starts:
 - **Backend API** on http://localhost:5000
 - **Frontend Web App** on http://localhost:3000
 
-### 2. Check Status
+### 3. Check Status
 ```bash
-docker-compose ps
+docker compose ps
 ```
 
-### 3. View Logs
+### 4. View Logs
 ```bash
 # All services
-docker-compose logs -f
+docker compose logs -f
 
-# Just backend
-docker-compose logs -f backend
-
-# Just frontend
-docker-compose logs -f frontend
+# Specific service
+docker compose logs -f backend
+docker compose logs -f frontend
 ```
 
-### 4. Stop Everything
+### 5. Stop
 ```bash
-docker-compose down
+docker compose down
 ```
 
 ---
 
-## 📦 Individual Services
+## Individual Services
 
 ### Backend Only
 ```bash
 docker build -f Dockerfile.backend -t lottery-backend .
-docker run -p 5000:5000 lottery-backend
+docker run -p 5000:5000 --env-file .env lottery-backend
 ```
 
 ### Frontend Only
@@ -57,291 +59,139 @@ docker build -f Dockerfile.frontend -t lottery-frontend .
 docker run -p 3000:3000 lottery-frontend
 ```
 
-### Email Scheduler (Optional)
-```bash
-docker-compose --profile email up -d
-```
+---
+
+## Configuration
+
+All configuration is done via environment variables. See `.env.example` for available options.
+
+Key variables:
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `FLASK_DEBUG` | `false` | Enable Flask debug mode |
+| `FLASK_CORS_ORIGINS` | `*` | Allowed CORS origins |
+| `FEDERAL_TAX_RATE` | `0.37` | US federal tax rate |
+| `DEFAULT_STATE_TAX_RATE` | `0.055` | Default state tax rate |
+| `USD_TO_CAD` | `1.44` | USD→CAD exchange rate |
+| `CACHE_TTL_HOURS` | `6` | Jackpot cache duration |
 
 ---
 
-## 🔧 Configuration
+## Network
 
-### Update Next.js to use standalone output
-
-Add to `frontend/next.config.ts`:
-```typescript
-const nextConfig = {
-  output: 'standalone',
-};
-```
-
-### Environment Variables
-
-Create `.env` file:
-```bash
-# Backend
-FLASK_ENV=production
-
-# Frontend
-NEXT_PUBLIC_API_URL=http://localhost:5000
-
-# Email (optional)
-EMAIL_SENDER=mblanke@gmail.com
-EMAIL_RECIPIENT=mblanke@gmail.com
-EMAIL_PASSWORD=vyapvyjjfrqpqnax
-```
-
-Then update `docker-compose.yml` to use env_file:
-```yaml
-services:
-  backend:
-    env_file: .env
-```
-
----
-
-## 🏗️ Build Process
-
-### First Time Setup
-```bash
-# Build all images
-docker-compose build
-
-# Or build individually
-docker-compose build backend
-docker-compose build frontend
-docker-compose build email-scheduler
-```
-
-### Rebuild After Code Changes
-```bash
-# Rebuild and restart
-docker-compose up -d --build
-
-# Rebuild specific service
-docker-compose up -d --build backend
-```
-
----
-
-## 🌐 Network Configuration
-
-All services communicate via the `lottery-network` bridge network.
-
-### Internal URLs (container to container):
+### Internal URLs (container to container)
 - Backend: `http://backend:5000`
 - Frontend: `http://frontend:3000`
 
-### External URLs (host to container):
+### External URLs (host machine)
 - Backend: `http://localhost:5000`
 - Frontend: `http://localhost:3000`
 
 ---
 
-## 📊 Health Checks
+## Health Checks
 
-The backend includes a health check endpoint:
 ```bash
 curl http://localhost:5000/api/health
 ```
 
-Check in Docker:
-```bash
-docker inspect lottery-backend | grep -A 10 Health
-```
-
 ---
 
-## 🔄 Production Deployment
+## Production Deployment
 
-### Docker Hub
+### Using Production Compose
 ```bash
-# Tag images
+docker compose -f docker-compose.prod.yml up -d
+```
+
+This adds nginx reverse proxy with:
+- Rate limiting (10 req/s)
+- Static asset caching
+- HTTPS support (configure certs in `ssl/`)
+- Resource limits per container
+
+See `ssl/README.md` for certificate setup.
+
+### Deploy to Server
+```bash
+git clone <your-repo>
+cd Lottery-Tracker
+cp .env.example .env
+# Edit .env for production
+docker compose -f docker-compose.prod.yml up -d
+```
+
+### Push to Docker Hub
+```bash
+docker login
 docker tag lottery-backend yourusername/lottery-backend:latest
 docker tag lottery-frontend yourusername/lottery-frontend:latest
-
-# Push to Docker Hub
 docker push yourusername/lottery-backend:latest
 docker push yourusername/lottery-frontend:latest
 ```
 
-### Deploy to Server
-```bash
-# Pull images on server
-docker pull yourusername/lottery-backend:latest
-docker pull yourusername/lottery-frontend:latest
-
-# Run with compose
-docker-compose -f docker-compose.prod.yml up -d
-```
-
 ---
 
-## 🐛 Troubleshooting
+## Troubleshooting
 
-### Backend won't start
+### Port Already in Use
 ```bash
-# Check logs
-docker logs lottery-backend
+# Windows
+netstat -ano | findstr :5000
+taskkill /PID <PID> /F
 
-# Common issues:
-# - Port 5000 already in use
-# - Playwright installation failed
-# - Missing dependencies
+# Or change ports in docker-compose.yml
 ```
 
-### Frontend can't connect to backend
+### Backend Won't Start
 ```bash
-# Check if backend is running
-docker-compose ps
+docker logs lottery-backend
+docker compose build --no-cache backend
+```
 
-# Test backend directly
+### Frontend Can't Connect to Backend
+```bash
+docker compose ps
 curl http://localhost:5000/api/health
-
-# Check frontend environment
 docker exec lottery-frontend env | grep API_URL
 ```
 
-### Playwright browser issues
+### Playwright Browser Issues
 ```bash
-# Rebuild with no cache
-docker-compose build --no-cache backend
-
-# Check Playwright installation
+docker compose build --no-cache backend
 docker exec lottery-backend playwright --version
 ```
 
-### Container keeps restarting
+### Access Container Shell
 ```bash
-# View logs
-docker logs lottery-backend --tail 100
+docker exec -it lottery-backend /bin/bash
+docker exec -it lottery-frontend /bin/sh
+```
 
-# Check health status
-docker inspect lottery-backend | grep -A 5 Health
+### Clean Everything
+```bash
+docker compose down -v --rmi all
+docker system prune -a
 ```
 
 ---
 
-## 📝 Useful Commands
+## Resource Usage
 
-### Access Container Shell
-```bash
-# Backend
-docker exec -it lottery-backend /bin/bash
+Production limits (set in `docker-compose.prod.yml`):
+- Backend: 2 GB RAM, 1 CPU
+- Frontend: 512 MB RAM, 0.5 CPU
+- Nginx: 256 MB RAM, 0.25 CPU
 
-# Frontend
-docker exec -it lottery-frontend /bin/sh
-```
-
-### Remove Everything
-```bash
-# Stop and remove containers, networks
-docker-compose down
-
-# Also remove volumes
-docker-compose down -v
-
-# Remove images
-docker-compose down --rmi all
-```
-
-### Prune Unused Resources
-```bash
-docker system prune -a
-```
-
-### View Resource Usage
+### Monitor
 ```bash
 docker stats
 ```
 
 ---
 
-## 🚢 Alternative: Docker without Compose
+## Image Sizes (Approximate)
 
-### Create Network
-```bash
-docker network create lottery-network
-```
-
-### Run Backend
-```bash
-docker run -d \
-  --name lottery-backend \
-  --network lottery-network \
-  -p 5000:5000 \
-  lottery-backend
-```
-
-### Run Frontend
-```bash
-docker run -d \
-  --name lottery-frontend \
-  --network lottery-network \
-  -p 3000:3000 \
-  -e NEXT_PUBLIC_API_URL=http://localhost:5000 \
-  lottery-frontend
-```
-
----
-
-## 🎯 Email Scheduler with Docker
-
-To include the email scheduler:
-
-1. **Start with email service:**
-```bash
-docker-compose --profile email up -d
-```
-
-2. **Or add to default profile** (edit docker-compose.yml):
-Remove `profiles: - email` from email-scheduler service
-
-3. **Check email logs:**
-```bash
-docker logs lottery-email -f
-```
-
----
-
-## 🔐 Security Notes
-
-⚠️ **Important:**
-- Never commit `.env` files with real credentials
-- Use Docker secrets in production
-- Set proper firewall rules
-- Use HTTPS in production
-- Regularly update base images
-
----
-
-## 📈 Scaling
-
-### Run multiple backend instances
-```bash
-docker-compose up -d --scale backend=3
-```
-
-### Add load balancer (nginx)
-See `docker-compose.prod.yml` for nginx configuration
-
----
-
-## 🆘 Support
-
-If containers won't start:
-1. Check Docker Desktop is running
-2. Ensure ports 3000 and 5000 are available
-3. Check logs: `docker-compose logs`
-4. Rebuild: `docker-compose up -d --build`
-5. Reset: `docker-compose down && docker-compose up -d`
-
----
-
-## 📦 Image Sizes (Approximate)
-
-- Backend: ~1.5 GB (includes Chromium browser)
-- Frontend: ~200 MB
-- Email Scheduler: ~1.5 GB (includes Chromium browser)
-
-To reduce size, consider multi-stage builds or Alpine Linux variants.
+- Backend: ~1.5 GB (includes Chromium for Playwright)
+- Frontend: ~200 MB (Next.js standalone)
+- Nginx: ~30 MB