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>

src/lib/db.ts

@@ -0,0 +1,39 @@
+import { PrismaPg } from "@prisma/adapter-pg";
+import { PrismaClient } from "@/generated/prisma/client";
+
+/**
+ * Zugriff auf die Datenbank.
+ *
+ * Der Client wird erst beim ersten Zugriff gebaut. Dadurch laeuft `next build`
+ * ohne gesetzte DATABASE_URL durch, obwohl Module den Import auf oberster Ebene
+ * haben. In der Entwicklung liegt die Instanz an globalThis, damit Hot Reload
+ * nicht bei jedem Speichern eine neue Verbindung aufbaut.
+ */
+function clientBauen(): PrismaClient {
+  const url = process.env["DATABASE_URL"];
+  if (!url) {
+    throw new Error("DATABASE_URL ist nicht gesetzt. Siehe .env.example.");
+  }
+  return new PrismaClient({ adapter: new PrismaPg({ connectionString: url }) });
+}
+
+const globalerZwischenspeicher = globalThis as typeof globalThis & {
+  laufzettelPrisma?: PrismaClient;
+};
+
+let instanz: PrismaClient | undefined;
+
+function instanzHolen(): PrismaClient {
+  if (process.env["NODE_ENV"] !== "production") {
+    globalerZwischenspeicher.laufzettelPrisma ??= clientBauen();
+    return globalerZwischenspeicher.laufzettelPrisma;
+  }
+  instanz ??= clientBauen();
+  return instanz;
+}
+
+export const prisma = new Proxy({} as PrismaClient, {
+  get(_ziel, eigenschaft, empfaenger) {
+    return Reflect.get(instanzHolen(), eigenschaft, empfaenger);
+  },
+});

src/lib/navigation.ts

@@ -0,0 +1,53 @@
+/**
+ * Die Seitenleiste an einer Stelle beschrieben.
+ *
+ * `verfuegbar` wird umgestellt, sobald der Meilenstein die Seite liefert. So zeigt
+ * die Huelle von Anfang an die echte Struktur, ohne auf Seiten zu verlinken, die
+ * es noch nicht gibt. Die Beschriftungen haengen am Betriebsmodus (#008).
+ */
+export type Betriebsmodus = "INTERN" | "DIENSTLEISTUNG";
+
+export type NavEintrag = {
+  readonly pfad: string;
+  readonly beschriftung: string;
+  /** Beschriftung im Modus Dienstleistung, falls sie abweicht. */
+  readonly beschriftungDienstleistung?: string;
+  /** Nur in diesem Modus zeigen. Fehlt der Wert, gilt der Eintrag in beiden. */
+  readonly nurModus?: Betriebsmodus;
+  readonly symbol: string;
+  readonly verfuegbar: boolean;
+  /** Issue, das die Seite liefert – nur fuer den Hinweis, solange sie fehlt. */
+  readonly ausIssue?: number;
+};
+
+export const NAVIGATION: readonly NavEintrag[] = [
+  { pfad: "/", beschriftung: "Übersicht", symbol: "LayoutDashboard", verfuegbar: true },
+  { pfad: "/laeufe", beschriftung: "Läufe", symbol: "ListChecks", verfuegbar: false, ausIssue: 13 },
+  { pfad: "/vorlagen", beschriftung: "Vorlagen", symbol: "FileText", verfuegbar: false, ausIssue: 10 },
+  {
+    pfad: "/mitarbeiter",
+    beschriftung: "Mitarbeiter & Geräte",
+    nurModus: "INTERN",
+    symbol: "Users",
+    verfuegbar: false,
+    ausIssue: 11,
+  },
+  {
+    pfad: "/kunden",
+    beschriftung: "Kunden",
+    nurModus: "DIENSTLEISTUNG",
+    symbol: "Building2",
+    verfuegbar: false,
+    ausIssue: 8,
+  },
+  { pfad: "/archiv", beschriftung: "Archiv", symbol: "Archive", verfuegbar: false, ausIssue: 15 },
+  { pfad: "/admin", beschriftung: "Admin", symbol: "Settings", verfuegbar: false, ausIssue: 8 },
+];
+
+export function navigationFuer(modus: Betriebsmodus): readonly NavEintrag[] {
+  return NAVIGATION.filter((e) => e.nurModus === undefined || e.nurModus === modus).map((e) =>
+    modus === "DIENSTLEISTUNG" && e.beschriftungDienstleistung
+      ? { ...e, beschriftung: e.beschriftungDienstleistung }
+      : e,
+  );
+}

src/lib/utils.ts

@@ -0,0 +1,7 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+/** Klassen zusammenfuehren, spaetere Tailwind-Klassen gewinnen. Von shadcn/ui erwartet. */
+export function cn(...eingaben: ClassValue[]): string {
+  return twMerge(clsx(eingaben));
+}

src/lib/version.ts

@@ -0,0 +1,10 @@
+/**
+ * Version und Git-Stand fuer die Anzeige unten links.
+ * Beide Werte werden beim Bauen gesetzt (Docker-Build-Arg bzw. deploy/install.sh).
+ */
+export const VERSION = process.env["NEXT_PUBLIC_APP_VERSION"] ?? "0.0.0-dev";
+export const GIT_SHA = (process.env["NEXT_PUBLIC_GIT_SHA"] ?? "").slice(0, 7);
+
+export function versionText(): string {
+  return GIT_SHA ? `v${VERSION} · ${GIT_SHA}` : `v${VERSION}`;
+}