# Multi-Stage Build: Zwei separate Phasen in einem Dockerfile.
# Vorteil: Der finale Container enthält nur das Minimum — kein Node.js, kein Source-Code, keine node_modules.
# Kleineres und sichereres Image als wenn alles in einem Stage wäre.

# Stage 1: Builder — zuständig für das Bauen der React-App.
# "AS builder" gibt diesem Stage einen Namen damit Stage 2 darauf zugreifen kann.
FROM node:20-alpine AS builder

# Arbeitsverzeichnis setzen — alle folgenden Befehle laufen hier.
WORKDIR /app

# Zuerst nur package.json kopieren für optimales Layer Caching.
# npm ci läuft nur neu wenn sich die Dependencies ändern, nicht bei jedem Code-Change.
COPY package*.json ./
RUN npm ci

# Code kopieren — nach npm ci damit der Cache optimal genutzt wird.
COPY . .

# VITE_API_URL als Build-Argument — wird von docker-compose.yml übergeben.
# ARG ist nur während des Builds verfügbar, ENV macht sie für Vite lesbar.
# Warum beide: Vite läuft als Node.js-Prozess und liest ENV-Variablen — nicht ARG direkt.
# Leerer Default "" bedeutet relative URLs werden verwendet — Nginx leitet intern weiter.
ARG VITE_API_URL=""
ENV VITE_API_URL=$VITE_API_URL

# Vite baut die React-App in den /app/dist Ordner — optimiertes, minifiziertes Bundle.
RUN npm run build

# Stage 2: Nginx — zuständig für das Ausliefern der gebauten Dateien.
# Node.js aus Stage 1 wird komplett weggeworfen — nur der dist-Ordner wird übernommen.
FROM nginx:alpine

# Nur den fertigen dist-Ordner aus Stage 1 kopieren — kein Source-Code, kein Node.js.
# --from=builder verweist auf Stage 1 per Name.
COPY --from=builder /app/dist /usr/share/nginx/html

# Eigene Nginx-Konfiguration kopieren — überschreibt die Standard-Konfiguration.
# Enthält Reverse Proxy Regeln für /rooms und /socket.io sowie SPA-Fallback.
COPY nginx.conf /etc/nginx/conf.d/default.conf

# Port 80 dokumentieren — Standard HTTP-Port.
EXPOSE 80

# Nginx im Vordergrund starten — ohne "daemon off" würde Nginx in den Hintergrund gehen
# und Docker würde denken der Container ist fertig und ihn stoppen.
CMD ["nginx", "-g", "daemon off;"]