crossword-app/Dockerfile

# Multi-stage build to optimize performance and security
# Stage 1: Builder - Install dependencies and build as root
FROM python:3.11-slim as builder

# Set working directory
WORKDIR /app

# Install system dependencies for sentence-transformers and FAISS
RUN apt-get update && apt-get install -y \
    gcc \
    g++ \
    wget \
    curl \
    git \
    && rm -rf /var/lib/apt/lists/*

# Install Node.js for frontend build
RUN curl -fsSL https://deb.nodesource.com/setup_18.x | bash - && \
    apt-get install -y nodejs

# Copy frontend package files and install dependencies first (for better caching)
COPY frontend/package*.json ./frontend/
RUN cd frontend && npm ci

# Copy Python backend requirements and install dependencies
COPY backend-py/requirements.txt ./backend-py/
RUN pip install --no-cache-dir --upgrade pip && \
    pip install --no-cache-dir -r backend-py/requirements.txt

# Copy all source code
COPY frontend/ ./frontend/
COPY backend/ ./backend/
COPY backend-py/ ./backend-py/

# Build the React frontend
RUN cd frontend && npm run build

# Copy built frontend files to Python backend public directory
RUN mkdir -p backend-py/public && cp -r frontend/dist/* backend-py/public/

# Create symlink for shared data (word lists)
RUN cd backend-py && ln -sf ../backend/data data

# Stage 2: Runtime - Copy only necessary files as non-root user
FROM python:3.11-slim as runtime

# Copy Python packages from builder stage
COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
COPY --from=builder /usr/local/bin /usr/local/bin

# Install minimal runtime dependencies
RUN apt-get update && apt-get install -y \
    curl \
    && rm -rf /var/lib/apt/lists/*

# Create non-root user
RUN useradd -m -u 1000 appuser

# Set working directory
WORKDIR /app/backend-py

# Copy built application files with correct ownership
COPY --from=builder --chown=appuser:appuser /app/backend-py ./
COPY --from=builder --chown=appuser:appuser /app/backend/data ./data

# Switch to non-root user
USER appuser

# Expose port 7860 (Hugging Face Spaces standard)
EXPOSE 7860

# Set environment variables for production
ENV NODE_ENV=production
ENV PORT=7860
ENV PYTHONPATH=/app/backend-py
ENV PYTHONUNBUFFERED=1
ENV PIP_NO_CACHE_DIR=1

# Health check
HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
    CMD curl -f http://localhost:7860/health || exit 1

# Start the Python backend server with uvicorn for better production performance
CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860", "--workers", "1"]