feat(mandant): Betriebsmodus, Kundenverwaltung und Einstellungen

Laufzettel läuft jetzt in zwei Betriebsmodi, aber nicht in zwei Codepfaden. Jede
kundenbezogene Zeile trägt ohnehin schon eine Kunden-Zuordnung; im Modus INTERN
ist das die eine Organisation, die in der Oberfläche nirgends erscheint. Der
Wechsel ist deshalb eine Datenänderung und keine Migration — dieselbe Zeile
bleibt, nichts hängt um.

src/server/mandant.ts ist die eine Stelle, an der die Mandantenregel steht:
kundeErmitteln verwirft im Modus INTERN eine mitgeschickte kundeId, verlangt im
Modus DIENSTLEISTUNG eine Wahl und prüft, ob der Benutzer den Kunden überhaupt
sehen darf. Die Sichtbarkeit steckte zunächst in einer zweiten Funktion daneben,
an die jeder künftige Aufrufer selbst hätte denken müssen; da #009 diese Signatur
übernimmt, ist sie jetzt eingebaut.

Der unabhängige Review fand drei Blocker, alle behoben.

Die Lesemodelle wandten die Mandantensicht nicht an. kundenListe gab jedem alle
Kunden zurück, und sichtbareKundenIds hatte in der Produktion keinen einzigen
Aufrufer — ein gebundener Techniker hätte Namen, Notizen und Bestandszahlen
fremder Kunden gesehen. Die Funktionen verlangen jetzt den Benutzer und filtern
selbst, wie CLAUDE.md es verlangt.

Mein Kommentar "Alles in einer Transaktion" war falsch: der Protokolleintrag
stand dahinter. Schlug er fehl, war der Modus gewechselt und der Vorgang stand
nirgends. Und Prüfung und Vollzug lagen auseinander, sodass zwei gleichzeitige
Wechsel beide durchliefen und ein zwischendurch angelegter Kunde zu Modus INTERN
bei zwei Kunden führte. Beides reproduziert, beides geschlossen: alles in einer
Transaktion, mit pg_advisory_xact_lock als erster Anweisung.

Dazu sechs kleinere Befunde: ASCII-Faltung in Texten, die Menschen lesen (die
Regel gilt für Bezeichner, nicht für Fließtext — steht jetzt so in CLAUDE.md);
eine Erfolgsmeldung, die nach dem Wechsel unsichtbar blieb; eine Zusage im
Dialog, die der Code nicht durchsetzt; fehlende Fehlerbehandlung beim
Archivieren; ein Handy-Screenshot, der das Navigationsmenü statt des Dialogs
zeigte.

Der Wechsel wurde nicht nur im Service geprüft, sondern per Playwright durch die
Oberfläche gefahren: anmelden, Dialog aufklappen, bestätigen, und danach steht
die Navigation auf Kunden.

336 Tests.

Closes #8

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

scripts/screenshots.ts

@@ -15,7 +15,7 @@
  */
 import { mkdir } from "node:fs/promises";
 import { join } from "node:path";
-import { chromium, type Browser, type Cookie } from "@playwright/test";
+import { chromium, type Browser, type Cookie, type Page } from "@playwright/test";
 
 const APP_URL = process.env["E2E_APP_URL"] ?? "http://127.0.0.1:3000";
 
@@ -29,13 +29,41 @@ type Seite = {
   readonly pfad: string;
   /** Oeffentliche Seiten werden ohne Anmeldung aufgenommen. */
   readonly ohneAnmeldung?: boolean;
+  /**
+   * Nur aufnehmen, wenn der Betriebsmodus passt. Der Modus steht in der
+   * Datenbank; wer beide Seiten braucht, laesst das Skript zweimal laufen und
+   * stellt dazwischen um.
+   */
+  readonly nurModus?: "INTERN" | "DIENSTLEISTUNG";
+  /** Vor der Aufnahme ausfuehren, etwa ein Aufklappen. */
+  readonly vorbereiten?: (tab: Page) => Promise<void>;
 };
 
 /** Seiten, die abgebildet werden. Waechst mit jedem Meilenstein. */
 const SEITEN: readonly Seite[] = [
   { name: "anmelden", pfad: "/anmelden", ohneAnmeldung: true },
   { name: "uebersicht", pfad: "/" },
+  { name: "admin-einstellungen", pfad: "/admin" },
+  {
+    name: "admin-moduswechsel",
+    pfad: "/admin",
+    nurModus: "INTERN",
+    vorbereiten: async (tab) => {
+      // Gezielt den Wechsel-Dialog aufklappen. `getByRole("group").first()`
+      // traf bei 390 px das Navigationsmenue, weil das dort das erste details ist.
+      await tab.locator("summary", { hasText: "wechseln" }).click();
+      await tab.waitForTimeout(150);
+    },
+  },
+  {
+    // Mit mehr als einem nicht archivierten Kunden ist der Rueckweg gesperrt.
+    // Genau das soll die Anleitung zeigen.
+    name: "admin-moduswechsel-abgelehnt",
+    pfad: "/admin",
+    nurModus: "DIENSTLEISTUNG",
+  },
   { name: "admin-benutzer", pfad: "/admin/benutzer" },
+  { name: "kunden", pfad: "/kunden", nurModus: "DIENSTLEISTUNG" },
 ];
 
 function argument(name: string): string | undefined {
@@ -101,6 +129,8 @@ async function kachelnErzeugen(browser: Browser): Promise<void> {
 
 const zielMeilenstein = argument("ziel");
 const nur = argument("nur");
+/** Welcher Betriebsmodus gerade eingestellt ist – steuert, welche Seiten passen. */
+const modus = (argument("modus") ?? "INTERN") as "INTERN" | "DIENSTLEISTUNG";
 const ziel = zielMeilenstein
   ? join("docs", "screenshots", zielMeilenstein)
   : join("docs", "anleitung", "bilder");
@@ -112,7 +142,9 @@ const browser = await chromium.launch();
 try {
   await kachelnErzeugen(browser);
 
-  const auswahl = SEITEN.filter((s) => !nur || s.name === nur);
+  const auswahl = SEITEN.filter(
+    (s) => (!nur || s.name === nur) && (s.nurModus === undefined || s.nurModus === modus),
+  );
   const kekse = auswahl.some((s) => !s.ohneAnmeldung) ? await anmelden(browser) : [];
 
   for (const seite of auswahl) {
@@ -127,6 +159,7 @@ try {
       if (!seite.ohneAnmeldung) await kontext.addCookies(kekse);
       const tab = await kontext.newPage();
       await tab.goto(`${APP_URL}${seite.pfad}`, { waitUntil: "load" });
+      if (seite.vorbereiten) await seite.vorbereiten(tab);
       // Schriften muessen geladen sein, sonst wackelt das Bild zwischen Laeufen.
       await tab.evaluate(() => document.fonts.ready);
       await tab.waitForLoadState("domcontentloaded");