feat: add Docker containerization with Ollama integration

- Add multi-stage Dockerfile with security best practices
- Add docker-compose.yml for full stack deployment
- Add docker-compose.dev.yml for development with hot reload
- Add nginx.conf for production reverse proxy with rate limiting
- Add .dockerignore for optimized builds
- Add setup-ollama.sh script for model management
- Add run-tests.sh script for Docker-based testing
- Update README with comprehensive Docker deployment guide

Dockerfile

@@ -0,0 +1,43 @@
+# Use Python 3.7 slim image for compatibility
+FROM python:3.7-slim
+
+# Set environment variables
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PYTHONPATH=/app
+
+# Set work directory
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        curl \
+        ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first for better caching
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir --upgrade pip \
+    && pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY app/ ./app/
+COPY pytest.ini .
+
+# Create non-root user for security
+RUN groupadd -r appuser && useradd -r -g appuser appuser \
+    && chown -R appuser:appuser /app
+USER appuser
+
+# Expose port
+EXPOSE 8000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:8000/health || exit 1
+
+# Run the application
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

README.md

@@ -202,12 +202,15 @@ client.newCall(request).execute().use { response ->
 ### Running Tests
 
 ```bash
-# Run all tests
+# Run all tests locally
 pytest
 
 # Run with coverage
 pytest --cov=app --cov-report=html --cov-report=term
 
+# Run tests in Docker
+./scripts/run-tests.sh
+
 # Run specific test file
 pytest tests/test_api.py -v
 
@@ -255,15 +258,46 @@ tests/
 
 ## Docker Deployment
 
-### Local Development with Docker
+### Quick Start with Docker
+
+```bash
+# 1. Start Ollama service
+docker-compose up ollama -d
+
+# 2. Download a model (first time only)
+./scripts/setup-ollama.sh llama3.1:8b
+
+# 3. Start the API
+docker-compose up api -d
+
+# 4. Test the setup
+curl http://localhost:8000/health
+```
+
+### Development with Hot Reload
 
 ```bash
-# Build and run with docker-compose
-docker-compose up --build
+# Use development compose file
+docker-compose -f docker-compose.dev.yml up --build
+```
+
+### Production with Nginx
+
+```bash
+# Start with Nginx reverse proxy
+docker-compose --profile production up --build
+```
+
+### Manual Build
 
-# Or build manually
+```bash
+# Build the image
 docker build -t summarizer-backend .
-docker run -p 8000:8000 summarizer-backend
+
+# Run with Ollama
+docker run -p 8000:8000 \
+  -e OLLAMA_HOST=http://host.docker.internal:11434 \
+  summarizer-backend
 ```
 
 ### Production Deployment

docker-compose.dev.yml

@@ -0,0 +1,38 @@
+version: '3.8'
+
+services:
+  # Development version with hot reload
+  api-dev:
+    build: .
+    container_name: summarizer-api-dev
+    ports:
+      - "8000:8000"
+    environment:
+      - OLLAMA_HOST=http://ollama:11434
+      - OLLAMA_MODEL=llama3.1:8b
+      - OLLAMA_TIMEOUT=30
+      - SERVER_HOST=0.0.0.0
+      - SERVER_PORT=8000
+      - LOG_LEVEL=DEBUG
+    volumes:
+      - ./app:/app/app:ro
+    command: ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]
+    depends_on:
+      - ollama
+    restart: unless-stopped
+
+  # Ollama service (same as production)
+  ollama:
+    image: ollama/ollama:latest
+    container_name: summarizer-ollama-dev
+    ports:
+      - "11434:11434"
+    volumes:
+      - ollama_data_dev:/root/.ollama
+    environment:
+      - OLLAMA_HOST=0.0.0.0
+    restart: unless-stopped
+
+volumes:
+  ollama_data_dev:
+    driver: local

docker-compose.yml

@@ -0,0 +1,67 @@
+version: '3.8'
+
+services:
+  # Ollama service for local LLM inference
+  ollama:
+    image: ollama/ollama:latest
+    container_name: summarizer-ollama
+    ports:
+      - "11434:11434"
+    volumes:
+      - ollama_data:/root/.ollama
+    environment:
+      - OLLAMA_HOST=0.0.0.0
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:11434/api/tags"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+  # FastAPI backend service
+  api:
+    build: .
+    container_name: summarizer-api
+    ports:
+      - "8000:8000"
+    environment:
+      - OLLAMA_HOST=http://ollama:11434
+      - OLLAMA_MODEL=llama3.1:8b
+      - OLLAMA_TIMEOUT=30
+      - SERVER_HOST=0.0.0.0
+      - SERVER_PORT=8000
+      - LOG_LEVEL=INFO
+    depends_on:
+      ollama:
+        condition: service_healthy
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s
+
+  # Optional: Nginx reverse proxy for production
+  nginx:
+    image: nginx:alpine
+    container_name: summarizer-nginx
+    ports:
+      - "80:80"
+      - "443:443"
+    volumes:
+      - ./nginx.conf:/etc/nginx/nginx.conf:ro
+    depends_on:
+      - api
+    restart: unless-stopped
+    profiles:
+      - production
+
+volumes:
+  ollama_data:
+    driver: local
+
+networks:
+  default:
+    name: summarizer-network

nginx.conf

@@ -0,0 +1,47 @@
+events {
+    worker_connections 1024;
+}
+
+http {
+    upstream api {
+        server api:8000;
+    }
+
+    # Rate limiting
+    limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s;
+
+    server {
+        listen 80;
+        server_name localhost;
+
+        # Security headers
+        add_header X-Frame-Options DENY;
+        add_header X-Content-Type-Options nosniff;
+        add_header X-XSS-Protection "1; mode=block";
+
+        # API routes
+        location / {
+            limit_req zone=api burst=20 nodelay;
+            
+            proxy_pass http://api;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            
+            # Timeouts
+            proxy_connect_timeout 30s;
+            proxy_send_timeout 30s;
+            proxy_read_timeout 30s;
+        }
+
+        # Health check endpoint (no rate limiting)
+        location /health {
+            proxy_pass http://api;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+        }
+    }
+}

scripts/run-tests.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+
+# Test runner script for Docker environment
+set -e
+
+echo "🧪 Running tests in Docker environment..."
+
+# Build test image
+echo "📦 Building test image..."
+docker build -t summarizer-backend-test .
+
+# Run tests
+echo "🚀 Running tests..."
+docker run --rm \
+  -v "$(pwd)/tests:/app/tests:ro" \
+  -v "$(pwd)/app:/app/app:ro" \
+  -v "$(pwd)/pytest.ini:/app/pytest.ini:ro" \
+  summarizer-backend-test \
+  pytest tests/ -v --cov=app --cov-report=term-missing
+
+echo "✅ Tests completed!"

scripts/setup-ollama.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+
+# Setup script for Ollama model download
+set -e
+
+echo "🚀 Setting up Ollama for Text Summarizer Backend..."
+
+# Check if Ollama is running
+if ! curl -s http://localhost:11434/api/tags > /dev/null; then
+    echo "❌ Ollama is not running. Please start Ollama first:"
+    echo "   docker-compose up ollama -d"
+    echo "   or"
+    echo "   ollama serve"
+    exit 1
+fi
+
+# Default model
+MODEL=${1:-"llama3.1:8b"}
+
+echo "📥 Downloading model: $MODEL"
+echo "This may take several minutes depending on your internet connection..."
+
+# Pull the model
+ollama pull "$MODEL"
+
+echo "✅ Model $MODEL downloaded successfully!"
+
+# Test the model
+echo "🧪 Testing model..."
+TEST_RESPONSE=$(curl -s -X POST http://localhost:11434/api/generate \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "'"$MODEL"'",
+    "prompt": "Summarize this: Hello world",
+    "stream": false
+  }')
+
+if echo "$TEST_RESPONSE" | grep -q "response"; then
+    echo "✅ Model test successful!"
+else
+    echo "❌ Model test failed. Response:"
+    echo "$TEST_RESPONSE"
+    exit 1
+fi
+
+echo ""
+echo "🎉 Setup complete! Your text summarizer backend is ready to use."
+echo ""
+echo "Next steps:"
+echo "1. Start the API: docker-compose up api -d"
+echo "2. Test the API: curl http://localhost:8000/health"
+echo "3. Try summarization: curl -X POST http://localhost:8000/api/v1/summarize/ \\"
+echo "   -H 'Content-Type: application/json' \\"
+echo "   -d '{\"text\": \"Your text to summarize here...\"}'"