Update-Skript fuer Linux/macOS und Windows

update.sh bzw. update.ps1 holen den neuen Stand und bauen den Stack neu:

- Bricht ab, wenn git, docker compose oder die .env fehlen.
- Bricht ab, wenn es lokale Aenderungen gibt — ein "git pull" wuerde dort
  im Konflikt enden.
- Holt den Stand mit "git merge --ff-only" und zeigt die neuen Commits.
- Baut nur neu, wenn es tatsaechlich Aenderungen gab (--force erzwingt es).
- Wartet, bis die Anwendung auf APP_PORT antwortet, und gibt bei Zeitablauf
  das Container-Protokoll aus, statt stillschweigend Erfolg zu melden.
- Zeigt zum Schluss die Migrationszeilen aus dem Start und den Status.
- --prune raeumt auf Wunsch verwaiste Images auf, die bei jedem Neubau
  zurueckbleiben.

README um einen Abschnitt "Aktualisieren" ergaenzt.

README.md

@@ -12,6 +12,7 @@ vorbereitet.
 ## Inhalt
 
 - [Schnellstart](#schnellstart)
+- [Aktualisieren](#aktualisieren)
 - [Konfiguration](#konfiguration)
 - [Bedienung](#bedienung)
 - [Technischer Aufbau](#technischer-aufbau)
@@ -45,6 +46,53 @@ docker compose down -v         # Stack stoppen und Datenbank löschen
 
 ---
 
+## Aktualisieren
+
+Für neue Versionen liegt ein Update-Skript bei — einmal für Linux/macOS und
+einmal für Windows. Es holt den aktuellen Stand aus Git, baut den Stack neu
+und wartet, bis die Anwendung wieder antwortet.
+
+```bash
+./update.sh            # Linux / macOS
+```
+
+```powershell
+.\update.ps1           # Windows
+```
+
+Beim ersten Aufruf unter Linux muss das Skript einmal ausführbar gemacht
+werden: `chmod +x update.sh`.
+
+Was das Skript tut:
+
+1. prüft, ob `git`, `docker compose` und die `.env` vorhanden sind,
+2. bricht ab, wenn es **lokale Änderungen** gibt — sonst würde `git pull` im
+   Konflikt enden,
+3. holt den neuen Stand mit `git merge --ff-only` und zeigt die neuen Commits,
+4. baut den Stack nur neu, wenn es tatsächlich Änderungen gab,
+5. wartet, bis die Anwendung auf `APP_PORT` antwortet, und zeigt sonst das
+   Protokoll,
+6. gibt die Migrationszeilen aus dem Start-Protokoll und den Containerstatus
+   aus.
+
+Optionen:
+
+| Option              | Wirkung                                                        |
+| ------------------- | -------------------------------------------------------------- |
+| `--force` / `-Force` | Auch ohne neue Commits neu bauen                                |
+| `--prune` / `-Prune` | Danach verwaiste Docker-Images entfernen (`docker image prune`) |
+| `--help`             | Hilfe anzeigen                                                  |
+
+Die Datenbank bleibt beim Update erhalten — neue Migrationen wendet der
+App-Container beim Start automatisch an. Wer lieber von Hand aktualisiert:
+
+```bash
+git pull
+docker compose up -d --build
+```
+
+---
+
 ## Konfiguration
 
 Alle Einstellungen stehen in der `.env` im Projektverzeichnis (Vorlage:
@@ -171,6 +219,7 @@ prisma/
   migrations/              Versionierte Migrationen
 docker/
   entrypoint.sh            Migration + Serverstart im Container
+update.sh / update.ps1     Update-Skript (git pull + Neubau + Prüfung)
 src/
   app/
     page.tsx               Startseite mit dem Kachel-Grid

update.ps1

@@ -0,0 +1,149 @@
+<#
+.SYNOPSIS
+  QR-Code-Generator aktualisieren: neuen Stand holen, Stack neu bauen, starten.
+
+.DESCRIPTION
+  Windows-Gegenstück zu update.sh. Holt den aktuellen Stand aus dem Git-Remote
+  und baut den Docker-Stack neu, wenn es Änderungen gab.
+
+.PARAMETER Force
+  Auch dann neu bauen, wenn es keine neuen Commits gibt.
+
+.PARAMETER Prune
+  Nach dem Bauen verwaiste Docker-Images entfernen.
+
+.EXAMPLE
+  .\update.ps1
+  .\update.ps1 -Force -Prune
+#>
+[CmdletBinding()]
+param(
+  [switch]$Force,
+  [switch]$Prune
+)
+
+$ErrorActionPreference = 'Stop'
+
+function Write-Info { param([string]$Text) Write-Host "→ $Text" }
+function Write-Ok   { param([string]$Text) Write-Host "✓ $Text" -ForegroundColor Green }
+function Stop-WithError {
+  param([string]$Text)
+  Write-Host "✗ $Text" -ForegroundColor Red
+  exit 1
+}
+
+# Immer im Projektverzeichnis arbeiten, egal von wo das Skript gestartet wird.
+Set-Location -Path $PSScriptRoot
+
+# --- Voraussetzungen --------------------------------------------------------
+
+foreach ($tool in @('git', 'docker')) {
+  if (-not (Get-Command $tool -ErrorAction SilentlyContinue)) {
+    Stop-WithError "$tool ist nicht installiert."
+  }
+}
+
+docker compose version *> $null
+if (-not $?) {
+  Stop-WithError 'docker compose ist nicht verfügbar (Docker Compose v2 wird benötigt).'
+}
+
+if (-not (Test-Path .env)) {
+  Stop-WithError '.env fehlt. Anlegen mit: Copy-Item .env.example .env'
+}
+
+# Ein "git pull" auf einem veränderten Arbeitsverzeichnis endet im Konflikt.
+$dirty = git status --porcelain
+if ($dirty) {
+  Write-Host '✗ Es gibt lokale Änderungen im Arbeitsverzeichnis:' -ForegroundColor Red
+  git status --short
+  Write-Host ''
+  Stop-WithError "Bitte zuerst committen oder mit 'git stash' beiseitelegen."
+}
+
+# --- Neuen Stand holen ------------------------------------------------------
+
+$before = git rev-parse HEAD
+$branch = git rev-parse --abbrev-ref HEAD
+
+Write-Info "Hole neuen Stand von origin/$branch …"
+git fetch --quiet origin
+if (-not $?) { Stop-WithError 'Der Remote ist nicht erreichbar.' }
+
+# --ff-only: lieber abbrechen als eine Merge-Situation erzeugen.
+git merge --ff-only "origin/$branch"
+if (-not $?) {
+  Stop-WithError 'Der lokale Stand lässt sich nicht ohne Merge aktualisieren. Bitte von Hand prüfen.'
+}
+
+$after = git rev-parse HEAD
+
+if ($before -eq $after) {
+  Write-Ok "Bereits auf dem neuesten Stand ($(git rev-parse --short HEAD))."
+} else {
+  Write-Ok "Aktualisiert: $(git rev-parse --short $before) → $(git rev-parse --short $after)"
+  Write-Host ''
+  git --no-pager log --oneline "$before..$after"
+  Write-Host ''
+}
+
+# --- Stack neu bauen --------------------------------------------------------
+
+$running = @(docker compose ps --status running --quiet).Count
+
+if (($before -eq $after) -and (-not $Force) -and ($running -gt 0)) {
+  Write-Ok 'Der Stack läuft und es gibt nichts Neues — kein Neubau nötig.'
+  Write-Host '  (Mit .\update.ps1 -Force lässt sich ein Neubau erzwingen.)'
+  exit 0
+}
+
+Write-Info 'Baue und starte den Stack neu — das dauert einige Minuten …'
+docker compose up -d --build
+if (-not $?) { Stop-WithError 'Der Neubau ist fehlgeschlagen.' }
+
+# --- Warten, bis die Anwendung antwortet ------------------------------------
+
+# Nur die Ziffern behalten — so stören weder Anführungszeichen noch Leerzeichen.
+$portLine = Select-String -Path .env -Pattern '^APP_PORT=' | Select-Object -First 1
+$appPort = if ($portLine) { ($portLine.Line -replace '\D', '') } else { '' }
+if (-not $appPort) { $appPort = '3000' }
+
+Write-Info 'Warte darauf, dass die Anwendung antwortet …'
+$ready = $false
+for ($attempt = 0; $attempt -lt 60; $attempt++) {
+  try {
+    Invoke-WebRequest -Uri "http://localhost:$appPort/" -UseBasicParsing -TimeoutSec 5 | Out-Null
+    $ready = $true
+    break
+  } catch {
+    Start-Sleep -Seconds 2
+  }
+}
+
+if (-not $ready) {
+  docker compose logs --tail 40 app
+  Stop-WithError 'Die Anwendung antwortet nach 2 Minuten nicht. Protokoll siehe oben.'
+}
+
+Write-Ok "Die Anwendung antwortet auf http://localhost:$appPort"
+
+# --- Ergebnis ---------------------------------------------------------------
+
+Write-Host ''
+Write-Info 'Datenbankmigrationen beim Start:'
+docker compose logs app |
+  Select-String -Pattern 'migration', 'Migration', 'pending' |
+  Select-Object -Last 5 |
+  ForEach-Object { "  $($_.Line)" }
+
+Write-Host ''
+docker compose ps
+
+if ($Prune) {
+  Write-Host ''
+  Write-Info 'Räume verwaiste Docker-Images auf …'
+  docker image prune --force
+}
+
+Write-Host ''
+Write-Ok "Fertig — Version $(git rev-parse --short HEAD)"

update.sh

@@ -0,0 +1,152 @@
+#!/bin/sh
+# =============================================================================
+# QR-Code-Generator aktualisieren
+#
+#   ./update.sh              neuen Stand holen und, falls es Änderungen gibt,
+#                            den Stack neu bauen und starten
+#   ./update.sh --force      auch ohne neue Commits neu bauen
+#   ./update.sh --prune      danach verwaiste Docker-Images aufräumen
+#   ./update.sh --help       diese Hilfe
+# =============================================================================
+set -eu
+
+FORCE=0
+PRUNE=0
+
+usage() {
+  cat <<'HILFE'
+QR-Code-Generator aktualisieren.
+
+  ./update.sh            neuen Stand holen und, falls es Änderungen gibt,
+                         den Stack neu bauen und starten
+  ./update.sh --force    auch ohne neue Commits neu bauen
+  ./update.sh --prune    danach verwaiste Docker-Images aufräumen
+  ./update.sh --help     diese Hilfe
+HILFE
+}
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --force) FORCE=1 ;;
+    --prune) PRUNE=1 ;;
+    -h|--help) usage; exit 0 ;;
+    *)
+      echo "Unbekannte Option: $1" >&2
+      echo "Aufruf: ./update.sh [--force] [--prune]" >&2
+      exit 2
+      ;;
+  esac
+  shift
+done
+
+# Immer im Projektverzeichnis arbeiten, egal von wo das Skript gestartet wird.
+cd "$(dirname "$0")"
+
+info()  { echo "→ $*"; }
+ok()    { echo "✓ $*"; }
+fail()  { echo "✗ $*" >&2; exit 1; }
+
+# --- Voraussetzungen --------------------------------------------------------
+
+command -v git >/dev/null 2>&1 || fail "git ist nicht installiert."
+command -v docker >/dev/null 2>&1 || fail "docker ist nicht installiert."
+docker compose version >/dev/null 2>&1 ||
+  fail "docker compose ist nicht verfügbar (Docker Compose v2 wird benötigt)."
+
+[ -f .env ] || fail ".env fehlt. Anlegen mit: cp .env.example .env"
+
+# Ein "git pull" auf einem verändertem Arbeitsverzeichnis endet im Konflikt.
+if [ -n "$(git status --porcelain)" ]; then
+  echo "✗ Es gibt lokale Änderungen im Arbeitsverzeichnis:" >&2
+  git status --short >&2
+  echo "" >&2
+  fail "Bitte zuerst committen oder mit 'git stash' beiseitelegen."
+fi
+
+# --- Neuen Stand holen ------------------------------------------------------
+
+BEFORE="$(git rev-parse HEAD)"
+BRANCH="$(git rev-parse --abbrev-ref HEAD)"
+
+info "Hole neuen Stand von origin/$BRANCH …"
+git fetch --quiet origin
+# --ff-only: lieber abbrechen als eine Merge-Situation erzeugen, die auf einem
+# Server niemand auflösen will.
+git merge --ff-only "origin/$BRANCH" ||
+  fail "Der lokale Stand lässt sich nicht ohne Merge aktualisieren. Bitte von Hand prüfen."
+
+AFTER="$(git rev-parse HEAD)"
+
+if [ "$BEFORE" = "$AFTER" ]; then
+  ok "Bereits auf dem neuesten Stand ($(git rev-parse --short HEAD))."
+else
+  ok "Aktualisiert: $(git rev-parse --short "$BEFORE") → $(git rev-parse --short "$AFTER")"
+  echo ""
+  git --no-pager log --oneline "$BEFORE..$AFTER"
+  echo ""
+fi
+
+# --- Stack neu bauen --------------------------------------------------------
+
+RUNNING="$(docker compose ps --status running --quiet 2>/dev/null | wc -l | tr -d ' ')"
+
+if [ "$BEFORE" = "$AFTER" ] && [ "$FORCE" -eq 0 ] && [ "$RUNNING" -gt 0 ]; then
+  ok "Der Stack läuft und es gibt nichts Neues — kein Neubau nötig."
+  echo "  (Mit ./update.sh --force lässt sich ein Neubau erzwingen.)"
+  exit 0
+fi
+
+info "Baue und starte den Stack neu — das dauert einige Minuten …"
+docker compose up -d --build
+
+# --- Warten, bis die Anwendung antwortet ------------------------------------
+
+# Nur die Ziffern behalten — so stören weder Anführungszeichen noch ein
+# Wagenrücklauf aus einer unter Windows bearbeiteten .env.
+APP_PORT="$(grep -m1 '^APP_PORT=' .env | cut -d= -f2 | tr -cd '0-9')"
+[ -n "$APP_PORT" ] || APP_PORT=3000
+
+probe() {
+  if command -v curl >/dev/null 2>&1; then
+    curl --silent --fail --max-time 5 --output /dev/null "http://localhost:$APP_PORT/"
+  elif command -v wget >/dev/null 2>&1; then
+    wget --quiet --timeout=5 --tries=1 --spider "http://localhost:$APP_PORT/"
+  else
+    return 0 # Kein Prüfwerkzeug vorhanden — dann eben ohne Prüfung.
+  fi
+}
+
+info "Warte darauf, dass die Anwendung antwortet …"
+ATTEMPT=0
+until probe; do
+  ATTEMPT=$((ATTEMPT + 1))
+  if [ "$ATTEMPT" -ge 60 ]; then
+    echo ""
+    docker compose logs --tail 40 app >&2
+    fail "Die Anwendung antwortet nach 2 Minuten nicht. Protokoll siehe oben."
+  fi
+  sleep 2
+done
+
+ok "Die Anwendung antwortet auf http://localhost:$APP_PORT"
+
+# --- Ergebnis ---------------------------------------------------------------
+
+echo ""
+info "Datenbankmigrationen beim Start:"
+docker compose logs app 2>/dev/null |
+  grep -E "migration|Migration|pending" |
+  tail -n 5 |
+  sed 's/^/  /'
+
+echo ""
+docker compose ps
+
+if [ "$PRUNE" -eq 1 ]; then
+  echo ""
+  info "Räume verwaiste Docker-Images auf …"
+  docker image prune --force
+fi
+
+echo ""
+ok "Fertig — Version $(git rev-parse --short HEAD)"