Dockerfile

# TypeCraft - Multi-stage Dockerfile
# Conformidade: Constituição Vértice v3.0
# P1 (Completude): All system dependencies included
# P4 (Rastreabilidade): All versions documented

# ==============================================================================
# Stage 1: Builder - Compile Go binaries
# ==============================================================================
FROM golang:1.24-alpine AS builder

LABEL maintainer="JuanCS-Dev (juan@vertice-maximus.com)"
LABEL description="TypeCraft AI-Powered Book Production Engine - Builder Stage"

# Install build dependencies
RUN apk add --no-cache \
    git \
    make \
    gcc \
    musl-dev

WORKDIR /app

# Copy dependency files first (layer caching optimization)
COPY go.mod go.sum ./
RUN go mod download

# Copy source code
COPY . .

# Build binaries
# P6 (Eficiência): Static linking for smaller binaries
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-w -s" -o bin/api ./cmd/api
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-w -s" -o bin/worker ./cmd/worker

# Verify binaries were created (P2 - Validação Preventiva)
RUN test -f bin/api || (echo "ERROR: API binary not found" && exit 1)
RUN test -f bin/worker || (echo "ERROR: Worker binary not found" && exit 1)

# ==============================================================================
# Stage 2: API Runtime - Production API server
# ==============================================================================
FROM alpine:3.19 AS api

LABEL maintainer="JuanCS-Dev (juan@vertice-maximus.com)"
LABEL description="TypeCraft API Server - Production Runtime"
LABEL version="0.1.0"

# Install runtime dependencies
# P1 (Completude): ALL tools required for book production
RUN apk add --no-cache \
    ca-certificates \
    tzdata \
    curl \
    pandoc \
    texlive \
    texlive-luatex \
    texlive-xetex \
    nodejs \
    npm \
    chromium \
    nss \
    freetype \
    harfbuzz \
    ttf-freefont \
    && rm -rf /var/cache/apk/*

# Puppeteer/PagedJS configuration (solução oficial)
ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium-browser

# Create app user (security best practice)
RUN addgroup -g 1000 typecraft && \
    adduser -D -u 1000 -G typecraft typecraft

# Install Node.js dependencies globally
# pagedjs-cli: HTML to PDF rendering
RUN npm install -g pagedjs-cli@0.4.3 \
    && npm cache clean --force

# Create directories
RUN mkdir -p /app/output /app/templates /tmp/typecraft && \
    chown -R typecraft:typecraft /app /tmp/typecraft

WORKDIR /app

# Copy binary from builder
COPY --from=builder /app/bin/api /usr/local/bin/typecraft-api

# Copy templates (LaTeX, HTML, etc.)
COPY --chown=typecraft:typecraft templates/ /app/templates/

# Set timezone to UTC
ENV TZ=UTC

# Switch to non-root user
USER typecraft

# Expose API port
EXPOSE 8080

# Health check (P2 - Validação Preventiva)
HEALTHCHECK --interval=30s --timeout=5s --start-period=40s --retries=3 \
    CMD curl -f http://localhost:8080/health || exit 1

# Entrypoint
ENTRYPOINT ["/usr/local/bin/typecraft-api"]

# ==============================================================================
# Stage 3: Worker Runtime - Async job processor
# ==============================================================================
FROM alpine:3.19 AS worker

LABEL maintainer="JuanCS-Dev (juan@vertice-maximus.com)"
LABEL description="TypeCraft Worker - Async Job Processor"
LABEL version="0.1.0"

# Install runtime dependencies (same as API)
# P1 (Completude): Worker needs ALL conversion tools
RUN apk add --no-cache \
    ca-certificates \
    tzdata \
    pandoc \
    texlive \
    texlive-luatex \
    texlive-xetex \
    nodejs \
    npm \
    && rm -rf /var/cache/apk/*

# Install Node.js dependencies
RUN npm install -g pagedjs-cli@0.4.3 \
    && npm cache clean --force

# Create app user
RUN addgroup -g 1000 typecraft && \
    adduser -D -u 1000 -G typecraft typecraft

# Create directories
RUN mkdir -p /app/output /app/templates /tmp/typecraft && \
    chown -R typecraft:typecraft /app /tmp/typecraft

WORKDIR /app

# Copy binary from builder
COPY --from=builder /app/bin/worker /usr/local/bin/typecraft-worker

# Copy templates
COPY --chown=typecraft:typecraft templates/ /app/templates/

# Set timezone
ENV TZ=UTC

# Switch to non-root user
USER typecraft

# No exposed ports (worker connects to Redis)

# Entrypoint
ENTRYPOINT ["/usr/local/bin/typecraft-worker"]

# ==============================================================================
# Stage 4: Development - Hot reload for local development
# ==============================================================================
FROM golang:1.24-alpine AS development

LABEL maintainer="JuanCS-Dev (juan@vertice-maximus.com)"
LABEL description="TypeCraft Development Environment"

# Install all dependencies (build + runtime)
RUN apk add --no-cache \
    git \
    make \
    gcc \
    musl-dev \
    pandoc \
    texlive \
    texlive-luatex \
    texlive-xetex \
    nodejs \
    npm \
    && rm -rf /var/cache/apk/*

# Install Node.js dependencies
RUN npm install -g pagedjs-cli@0.4.3

# Install air for hot reload
RUN go install github.com/cosmtrek/air@latest

WORKDIR /app

# Copy everything
COPY . .

# Download Go dependencies
RUN go mod download

# Expose ports
EXPOSE 8080

# Use air for hot reload
CMD ["air", "-c", ".air.toml"]

# ==============================================================================
# Build Instructions:
#
# Build API:
#   docker build --target api -t typecraft-api:latest .
#
# Build Worker:
#   docker build --target worker -t typecraft-worker:latest .
#
# Build Development:
#   docker build --target development -t typecraft-dev:latest .
#
# Run with docker-compose:
#   docker compose up -d
#
# ==============================================================================
# System Requirements Validation:
# - Pandoc: pandoc --version (should be 2.x+)
# - LaTeX: lualatex --version (should be LuaTeX 1.x+)
# - Node: node --version (should be v18+)
# - Paged.js: pagedjs-cli --version (should be 0.4.x)
# ==============================================================================