Initial commit

frontend/Dockerfile

@@ -1,23 +1,47 @@
+# 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;"]