feat: Projektgerüst, gehärteten Betriebsstand und Prozess aufsetzen

Legt die Grundlage, auf der alle weiteren Meilensteine nur noch Fachlichkeit
ergänzen: Next 16 mit App Router und TypeScript strict, Tailwind 4, Prisma 7,
Vitest 5, Playwright, ESLint, Prettier und die Hooks für Lint und Commits.

Zwei Dinge sind bewusst so gebaut und durch Tests festgehalten:

Die Datenbank ist im Betriebsstand von außen nicht erreichbar. Sie hat kein
ports:-Mapping und hängt allein im Netz "intern", das ohne Gateway läuft; nur
"web" kommt zusätzlich nach draußen. tests/betriebsstand.test.ts schlägt an,
falls ein Port-Mapping zurückkehrt. Geprüft, nicht behauptet: docker compose up
startet den Stack, 5432 ist vom Host aus zu, aus "web" offen.

pnpm pruefe:doku hält Dokumentation und Code zusammen — Version im Changelog,
Issue-Dateien gegen ihre Übersicht, keine Verweise auf fehlende Dateien, keine
fehlenden Bilder. Das Skript wurde gegen vier eingebaute Fehler gegengeprüft.

Drei Versions-Obergrenzen sind nötig und in CLAUDE.md begründet: eslint bleibt
auf 9.x, weil eslint-plugin-react keinen Nachfolger für eslint 10 hat und das
Regelwerk sonst beim Laden abbricht; typescript bleibt auf 6.0.x, weil
typescript-eslint TypeScript 7 noch nicht unterstützt; prisma ist exakt auf
7.10.0 gepinnt, weil sein latest-Tag auf einen 8.0-RC zeigt, der von
@prisma/client aber nicht.

Auth.js entfällt entgegen der ursprünglichen Vorgabe: v5 steht dauerhaft auf
Beta, das Projekt ist im Wartungsmodus und sein Prisma-Adapter deckt Prisma 7
nicht ab. Stattdessen openid-client und jose, wie in ProxLedger.

Dieser erste Commit geht direkt auf main, weil es noch keinen Branch gibt, von
dem abzuzweigen wäre. Ab #006 läuft jedes Issue über einen eigenen Branch.

Closes #5

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

docker-compose.yml

@@ -0,0 +1,97 @@
+# Laufzettel – Betriebsstand.
+#
+# Die Datenbank ist bewusst von aussen NICHT erreichbar: kein ports:-Mapping und
+# ein Netz ohne Gateway (internal: true). Nur web und migrate kommen ueber den
+# Dienstnamen daran. Fuer die Entwicklung gibt es docker-compose.dev.yml.
+#
+# Sicherung trotz geschlossenem Port:
+#   docker compose exec -T postgres pg_dump -U laufzettel laufzettel > sicherung.sql
+
+name: laufzettel
+
+services:
+  postgres:
+    image: postgres:17-alpine
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-laufzettel}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?POSTGRES_PASSWORD fehlt in der .env}
+      POSTGRES_DB: ${POSTGRES_DB:-laufzettel}
+    # Absichtlich expose statt ports: im LAN und auf dem Host nicht erreichbar.
+    expose:
+      - "5432"
+    networks:
+      - intern
+    volumes:
+      - datenbank:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-laufzettel}"]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+
+  # Laeuft einmal beim Start und spielt nur die Migrationen ein.
+  # Der Seed wird bewusst nicht automatisch ausgefuehrt, siehe README.
+  migrate:
+    build:
+      context: .
+      target: bauen
+    restart: "no"
+    environment:
+      DATABASE_URL: ${DATABASE_URL:-postgresql://${POSTGRES_USER:-laufzettel}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB:-laufzettel}?schema=public}
+    depends_on:
+      postgres:
+        condition: service_healthy
+    networks:
+      - intern
+    command: ["pnpm", "exec", "prisma", "migrate", "deploy"]
+
+  web:
+    build:
+      context: .
+      target: laufzeit
+      args:
+        APP_VERSION: ${APP_VERSION:-0.1.0}
+        GIT_SHA: ${GIT_SHA:-}
+    restart: unless-stopped
+    environment:
+      DATABASE_URL: ${DATABASE_URL:-postgresql://${POSTGRES_USER:-laufzettel}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB:-laufzettel}?schema=public}
+      APP_SECRET: ${APP_SECRET:?APP_SECRET fehlt in der .env}
+      APP_URL: ${APP_URL:?APP_URL fehlt in der .env}
+      AUTH_LOCAL_ENABLED: ${AUTH_LOCAL_ENABLED:-false}
+      OIDC_ISSUER: ${OIDC_ISSUER:-}
+      OIDC_CLIENT_ID: ${OIDC_CLIENT_ID:-}
+      OIDC_CLIENT_SECRET: ${OIDC_CLIENT_SECRET:-}
+      OIDC_NAME: ${OIDC_NAME:-authentik}
+      OIDC_GROUP_ADMIN: ${OIDC_GROUP_ADMIN:-}
+      OIDC_GROUP_EDITOR: ${OIDC_GROUP_EDITOR:-}
+      OIDC_GROUP_TECHNICIAN: ${OIDC_GROUP_TECHNICIAN:-}
+      OIDC_GROUP_VIEWER: ${OIDC_GROUP_VIEWER:-}
+      OIDC_CUSTOMER_GROUP_PREFIX: ${OIDC_CUSTOMER_GROUP_PREFIX:-}
+    # Standardmaessig nur auf localhost; davor gehoert ein Reverse Proxy.
+    ports:
+      - "${BIND_ADDR:-127.0.0.1}:${APP_PORT:-3000}:3000"
+    depends_on:
+      postgres:
+        condition: service_healthy
+      migrate:
+        condition: service_completed_successfully
+    networks:
+      - intern
+      - extern
+    healthcheck:
+      test: ["CMD", "wget", "-qO-", "http://localhost:3000/api/gesundheit"]
+      interval: 30s
+      timeout: 5s
+      retries: 5
+      start_period: 20s
+
+networks:
+  # Kein Gateway: die Datenbank kann weder heraus noch ist sie von aussen erreichbar.
+  intern:
+    internal: true
+  # Nur fuer web: Reverse Proxy, OIDC zu authentik, LDAP zum AD.
+  extern:
+
+volumes:
+  datenbank: