Version 1.0.0 — Freigabe für den Echtbetrieb (#17 )

Phase 11: Freigabereife (#16 )
Phase 10: Mandantenfähigkeit (#15 )
2026-09-06 20:08:16 +00:00 · 2026-09-06 20:05:49 +00:00 · 2026-09-05 13:47:46 +00:00 · 2026-09-05 02:30:51 +00:00 · 2026-09-04 13:43:53 +00:00 · 2026-09-04 13:24:48 +02:00
199 changed files with 20830 additions and 674 deletions
@@ -164,6 +164,11 @@ AUTH_LOCAL_ENABLED=true
 # Nach dem ersten Login das Passwort in der Oberfläche ändern.
 SEED_ADMIN_EMAIL=admin@beispielwehr.de
 SEED_ADMIN_PASSWORT=Feuerwehr2026
 # Das Konto der Kreisebene aus dem Beispielbestand (Phase 10): Mitglied in der
 # eigenen Wehr, Aufsicht in der Nachbarwehr. Vorgabe leitet sich aus der
 # Wehrkennung ab, also kbi@ff-musterhausen.de.
 # SEED_KBI_EMAIL=
 # SEED_KBI_PASSWORT=Feuerwehr2026
 # bcrypt-Kostenfaktor. 12 ist ein guter Kompromiss aus Sicherheit und Tempo.
 AUTH_BCRYPT_ROUNDS=12
@@ -421,3 +426,19 @@ PERSON_ANONYMISIERUNG_TAGE=365
 # -----------------------------------------------------------------------------
 NEXT_TELEMETRY_DISABLED=1
 CHECKPOINT_DISABLE=1
 # -----------------------------------------------------------------------------
 # Testwehr fuer die E2E-Tests
 #
 # Die Playwright-Tests laufen gegen eine EIGENE Wehr, nicht gegen die
 # Beispielwehr aus der Anleitung. Sonst wachsen deren Listen bei jedem Lauf,
 # und die Bildschirmfotos aendern sich, ohne dass sich die Oberflaeche
 # geaendert haette.
 #
 # Vor dem Lauf einmal:  npm run db:test-reset
 # -----------------------------------------------------------------------------
 E2E_SLUG=ff-teststelle
 E2E_NAME=Freiwillige Feuerwehr Teststelle
 E2E_KURZNAME=FF Teststelle
 E2E_ADMIN_EMAIL=e2e@teststelle.de
 E2E_ADMIN_PASSWORT=Feuerwehr2026
@@ -0,0 +1,184 @@
 # =============================================================================
 # Die Pruefung bei jedem Push.
 #
 # Bis Phase 10 gab es 581 Unit- und 266 E2E-Tests — und nichts, was sie
 # ausfuehrte ausser einem Menschen, der daran dachte. In der Sitzung, in der
 # die Kassenverwaltung entstand, haben die Tests vier echte Fehler gefunden,
 # zwei davon in Code, der eine Stunde alt war. Genau das soll hier von allein
 # passieren.
 #
 # Zwei Auftraege, bewusst getrennt:
 #
 #   pruefung   typecheck, lint und die Unit-Tests. Braucht eine Datenbank,
 #              weil ein Teil der Tests die Trigger und RLS gegen echtes
 #              Postgres prueft — mit einer Attrappe waeren sie wertlos.
 #
 #   oberflaeche  die E2E-Tests. Dauern eine Dreiviertelstunde und brauchen den
 #                halben Stack, deshalb laufen sie nur auf main und in Pull
 #                Requests, nicht bei jedem Zwischenstand auf einem Zweig.
 # =============================================================================
 name: Pruefung
 on:
  push:
    branches: [main]
  pull_request:
 env:
  # Dieselben Werte wie in .env.example. Es sind Testdaten in einem
  # Wegwerf-Container; echte Geheimnisse haben in einer Pipeline nichts zu
  # suchen und stehen im Betrieb in der .env.
  POSTGRES_USER: florian
  POSTGRES_PASSWORD: pruefung
  POSTGRES_DB: florian
  POSTGRES_APP_PASSWORD: pruefung_app
  DATABASE_URL: postgresql://florian_app:pruefung_app@localhost:5432/florian?schema=public
  DIRECT_DATABASE_URL: postgresql://florian:pruefung@localhost:5432/florian?schema=public
  AUTH_SECRET: nur-fuer-die-pruefung-nicht-fuer-den-betrieb
  AUTH_TRUST_HOST: "true"
  APP_URL: http://localhost:3100
  S3_ENDPOINT: localhost
  S3_PORT: "9000"
  S3_USE_SSL: "false"
  S3_ACCESS_KEY: florian
  S3_SECRET_KEY: pruefung_minio
  S3_BUCKET: florian
  REDIS_URL: redis://localhost:6379
  TZ: Europe/Berlin
 jobs:
  pruefung:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      # Das eigene Postgres-Image statt eines fertigen: FLORIAN braucht
      # PostGIS **und** pgvector, und kein oeffentliches Image bringt beides
      # mit. Ein Dienst-Container mit postgres:17 wuerde die Migrationen
      # durchlassen und erst bei der ersten Umkreissuche scheitern.
      - name: Datenbank bauen und starten
        run: |
          docker build -t florian-postgres:pruefung ./docker/postgres
          docker run -d --name postgres -p 5432:5432 \
            -e POSTGRES_USER=$POSTGRES_USER \
            -e POSTGRES_PASSWORD=$POSTGRES_PASSWORD \
            -e POSTGRES_DB=$POSTGRES_DB \
            -e POSTGRES_APP_PASSWORD=$POSTGRES_APP_PASSWORD \
            -e POSTGRES_INITDB_ARGS="--locale-provider=icu --icu-locale=de-DE --locale=C.UTF-8 --encoding=UTF8" \
            -v "$(pwd)/docker/postgres:/docker-entrypoint-initdb.d:ro" \
            florian-postgres:pruefung
      - name: Redis und MinIO starten
        run: |
          docker run -d --name redis -p 6379:6379 redis:7-alpine
          docker run -d --name minio -p 9000:9000 \
            -e MINIO_ROOT_USER=$S3_ACCESS_KEY \
            -e MINIO_ROOT_PASSWORD=$S3_SECRET_KEY \
            minio/minio:latest server /data
      - run: npm ci
      - name: Auf die Datenbank warten
        run: |
          for i in $(seq 1 60); do
            docker exec postgres pg_isready -U "$POSTGRES_USER" -d "$POSTGRES_DB" && exit 0
            sleep 2
          done
          echo "Postgres kam nicht hoch:"
          docker logs postgres
          exit 1
      - run: npx prisma generate
      - run: npm run typecheck
      - run: npm run lint
      - name: Migrationen einspielen
        run: npm run db:migrate
      # Der Seed gehoert dazu: er ist selbst ein Test. Faellt eine Migration
      # oder ein Standardwert um, merkt man es hier und nicht erst, wenn eine
      # Wehr ihn zum ersten Mal ausfuehrt.
      - name: Beispielbestand anlegen
        run: npm run db:seed
      - run: npm run test
      - name: Aufraeumen
        if: always()
        run: docker rm -f postgres redis minio || true
  oberflaeche:
    runs-on: ubuntu-latest
    # Nur wo es sich lohnt: ein voller Lauf dauert etwa 45 Minuten.
    if: github.event_name == 'pull_request' || github.ref == 'refs/heads/main'
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - name: Dienste starten
        run: |
          docker build -t florian-postgres:pruefung ./docker/postgres
          docker run -d --name postgres -p 5432:5432 \
            -e POSTGRES_USER=$POSTGRES_USER \
            -e POSTGRES_PASSWORD=$POSTGRES_PASSWORD \
            -e POSTGRES_DB=$POSTGRES_DB \
            -e POSTGRES_APP_PASSWORD=$POSTGRES_APP_PASSWORD \
            -e POSTGRES_INITDB_ARGS="--locale-provider=icu --icu-locale=de-DE --locale=C.UTF-8 --encoding=UTF8" \
            -v "$(pwd)/docker/postgres:/docker-entrypoint-initdb.d:ro" \
            florian-postgres:pruefung
          docker run -d --name redis -p 6379:6379 redis:7-alpine
          docker run -d --name minio -p 9000:9000 \
            -e MINIO_ROOT_USER=$S3_ACCESS_KEY \
            -e MINIO_ROOT_PASSWORD=$S3_SECRET_KEY \
            minio/minio:latest server /data
          docker run -d --name gotenberg -p 3001:3000 gotenberg/gotenberg:8
      - run: npm ci
      - run: npx playwright install --with-deps chromium
      - name: Auf die Datenbank warten
        run: |
          for i in $(seq 1 60); do
            docker exec postgres pg_isready -U "$POSTGRES_USER" -d "$POSTGRES_DB" && exit 0
            sleep 2
          done
          docker logs postgres
          exit 1
      - run: npx prisma generate
      - run: npm run db:migrate
      # Die E2E-Tests laufen seit Phase 8 gegen eine eigene Wehr, nicht gegen
      # den Beispielbestand. Das Skript legt beide an.
      - name: Testwehr anlegen
        run: npm run db:test-reset
      - run: npm run build
      - run: npx playwright test
        env:
          GOTENBERG_URL: http://localhost:3001
      - name: Fehlerbilder sichern
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: playwright-bericht
          path: |
            playwright-report/
            test-results/
          retention-days: 7
      - name: Aufraeumen
        if: always()
        run: docker rm -f postgres redis minio gotenberg || true
@@ -40,3 +40,6 @@ debug.log
 # Prisma
 prisma/*.db
 prisma/*.db-journal
 # Sicherungen bleiben lokal — sie enthalten den gesamten Bestand.
 sicherungen/
@@ -6,9 +6,510 @@ Alle nennenswerten Änderungen an FLORIAN. Format nach
 Die Regeln dazu stehen in [docs/VERSIONIERUNG.md](docs/VERSIONIERUNG.md).
-## [Unveröffentlicht]
+## [1.0.0] — 2026-09-06
-Nächster Schritt ist Phase 9 (Kassenverwaltung).
+**Freigabe für den Echtbetrieb.**
 Kein neues Modul. Zwölf Phasen sind fertig, und die Wehr kann ab jetzt echte
 Daten hineingeben, ohne befürchten zu müssen, sie beim nächsten Update zu
 verlieren.
 Was 1.0.0 bedeutet: der Funktionsumfang ist vollständig, die Datenbank ist
 stabil, Migrationen sind aufwärtskompatibel, und ab hier gilt semantische
 Versionierung — ein Update bricht nichts, ohne dass es in der Hauptnummer
 steht.
 Was es nicht bedeutet: dass keine Fehler mehr da sind.
 ### Hinzugefügt
 - **`update.sh`** — Aktualisieren auf einem Linux-Server, in einem Befehl. Der
  Ablauf darf an jeder Stelle abbrechen, ohne eine halb aktualisierte Anlage
  zu hinterlassen: erst nachsehen, ob es überhaupt etwas Neues gibt, dann
  **sichern**, dann holen und bauen (schlägt das fehl, läuft die alte Fassung
  unverändert weiter), dann umschalten, dann nachsehen, ob die Anwendung
  antwortet. Tut sie es nicht, stehen die letzten Protokollzeilen da und die
  Befehle, mit denen der vorherige Stand zurückkommt.
  Vorher prüft es Docker, git, die `.env` und dass keine unverbuchten
  Änderungen im Verzeichnis liegen. `--pruefen` sieht nur nach,
  `--ohne-sicherung` gibt es für Testinstallationen.
 - **`docs/KURZANLEITUNG.md`** — der Einstieg, nach Rollen sortiert und auf ein
  paar Seiten. Die vollständige Anleitung hat 63 Kapitel; die liest niemand,
  bevor er das erste Gerät prüfen will. Diese hier ist aufgabenorientiert
  („ein Gerät prüfen", „einen Kontoauszug einlesen") statt nach Modulen
  geordnet, und sie sagt bei jedem heiklen Punkt dazu, warum es so ist — warum
  ein abgeschlossenes Prüfprotokoll nicht änderbar ist, warum gegengebucht und
  nicht korrigiert wird, warum der Atemschutzhinweis stehen bleibt.
 ### Geändert
 - Version auf **1.0.0**. Ab hier gilt semantische Versionierung nach
  [docs/VERSIONIERUNG.md](docs/VERSIONIERUNG.md).
 - Die Roadmap hält den Stand **jeder** Freigabevoraussetzung fest, auch der
  offenen. Zwei sind organisatorisch und stehen aus: die Abnahme des
  Löschkonzepts durch die Wehr und die Schulung. An der Software hängt nichts
  davon ab; sie stehen dort, damit später nachlesbar ist, was zum Zeitpunkt
  der Freigabe erledigt war und was nicht.
 ### Behoben
 - **Die Testläufe flackerten seit Phase 8 — jetzt ist die Ursache weg.** Zwei
  Datenbanktests schalteten beim Aufräumen ihre Trigger mit
  `ALTER TABLE ... DISABLE TRIGGER` ab. Das ist eine Schemaänderung: sie gilt
  für die ganze Datenbank und für alle. Vitest fährt die Testdateien parallel
  — während die eine Datei abräumte, prüfte die andere gerade, dass genau
  dieser Trigger greift, und sah keinen.
  Das erklärt rückwirkend eine ganze Reihe von Fehlschlägen, die als
  „Flackern" abgetan wurden und keines waren. Statt der Schemaänderung wird
  jetzt `SET LOCAL session_replication_role = 'replica'` benutzt: dieselbe
  Wirkung, aber nur in der eigenen Transaktion. Fünf Läufe hintereinander
  sauber.
 - **Ein Datenbanktest räumte nur am Ende auf.** Brach ein Lauf ab, scheiterte
  der nächste an einer Eindeutigkeit, die mit dem Geprüften nichts zu tun
  hatte. Er räumt jetzt auch am Anfang auf.
 ### Zum Stand der Freigabevoraussetzungen
 | Voraussetzung | Stand |
 |---|---|
 | Datenübernahme | **entfällt** — die Wehr pflegt von Hand ein |
 | Sicherungskonzept, einmal wiederhergestellt | **erledigt** (Phase 11) |
 | Löschkonzept nach DSGVO | **technisch vollständig** (Phase 11), Abnahme steht aus |
 | Schulung | **steht aus**, Grundlage ist die Kurzanleitung |
 | Atemschutzhinweis | **bewusst stehen gelassen** — FLORIAN bleibt ergänzend |
 ---
 ## [0.12.0] — 2026-09-05
 Phase 11: Freigabereife. Die drei Software-Voraussetzungen für 1.0.0 —
 Personenauskunft nach Art. 15 DSGVO, ein geprüftes Sicherungskonzept und eine
 Pipeline, die die Tests von allein ausführt.
 **Das Auskunftsrecht war ein Versprechen ohne Umsetzung.** `person.export`
 stand seit Phase 0 im Berechtigungskatalog und war dem Kommandanten
 zugewiesen; implementiert war nichts. Die Löschseite gab es (Anonymisierung im
 Aufbewahrungslauf), die Auskunftsseite nicht — und ohne Art. 15 ist ein
 Löschkonzept nicht abnehmbar.
 **Eine Sicherung, die nie zurückgespielt wurde, ist eine Vermutung.** Genau
 das hat sich hier bestätigt: der erste Rückspielversuch lief scheinbar
 sauber durch und hatte dabei sämtliche Unveränderlichkeitsgarantien der
 Datenbank entfernt.
 ### Hinzugefügt
 **Auskunft nach Art. 15 DSGVO**
 - `lib/dsgvo/auskunft.ts` sammelt alles, was über eine Person vorliegt:
  Stammdaten, Zugang, Rollen, Qualifikationen, arbeitsmedizinische Vorsorge,
  Belastungsübungen, Einsatz- und Übungsbeteiligung, Anwesenheiten, Fahrten,
  Beiträge, Benachrichtigungswege, Ausweise. Dreizehn Abschnitte.
 - **Über jedem Abschnitt steht, wozu die Daten vorliegen.** Art. 15 Abs. 1
  verlangt nicht nur die Daten, sondern auch Zwecke, Empfänger und den Hinweis
  auf die weiteren Rechte. Eine Liste ohne das sieht aus wie eine Auskunft und
  ist keine.
 - **Gesundheitsdaten sind als besondere Kategorie nach Art. 9 gekennzeichnet** —
  G26 und Belastungsübungen.
 - **Leere Abschnitte bleiben stehen.** „Dazu liegt nichts vor" ist eine
  Auskunft; ein weggelassener Abschnitt wirft die Frage auf, ob da doch etwas
  ist.
 - **Was die Person getan hat, wird gezählt, nicht mitgeliefert.** Prüfprotokolle
  und Mängelmeldungen gehören zum Nachweisbestand der Wehr. Vollständig
  ausgeliefert käme jeder über eine Selbstauskunft an die Geräteakten — die
  Auskunftspflicht wäre eine Hintertür.
 - Ein Durchgang liefert alles: die Anzeige, ein PDF für die Akte und JSON nach
  Art. 20. Bewusst nicht drei Knöpfe, von denen zwei vergessen werden können.
 - Der Vorgang wird protokolliert. Dass eine Auskunft erteilt wurde, gehört
  festgehalten — sie legt alles offen, was über einen Menschen gespeichert ist.
 **Sicherung und Wiederherstellung**
 - `npm run sicherung` — Datenbank über `pg_dump` im Container, dazu alle
  Dateien aus MinIO, dazu ein Manifest. Beides aus demselben Moment: eine
  Datenbank von heute mit Dateien von gestern ergibt Verweise ins Leere.
 - `npm run wiederherstellen` — mit Probelauf als Vorgabe. Ohne `--wirklich`
  wird nur angezeigt, was geschähe.
 - Nach dem Zurückspielen setzt das Skript die Sperren der Anwendungsrolle neu
  und **prüft danach nach**, ob es gewirkt hat.
 - `scripts/sicherung-sperren.ts` ist die eine Liste, aus der Wiederherstellen
  und Prüfen entstehen. Ein Test gleicht sie gegen die migrierte Datenbank ab —
  läuft sie auseinander, wäre der Schaden lautlos.
 **Pipeline**
 - `.gitea/workflows/pruefung.yml` mit zwei Aufträgen: `pruefung` (typecheck,
  lint, Migrationen, Seed, 599 Unit-Tests) bei jedem Push, `oberflaeche`
  (E2E) auf `main` und in Pull Requests.
 - Die Datenbank wird aus `docker/postgres` gebaut statt aus einem fertigen
  Image: FLORIAN braucht PostGIS **und** pgvector. Ein Dienst-Container mit
  `postgres:17` ließe die Migrationen durch und scheiterte erst bei der ersten
  Umkreissuche.
 - Der Seed läuft mit, weil er selbst ein Test ist.
 ### Behoben
 - **Eine Wiederherstellung entfernte alle Unveränderlichkeitsgarantien.** Der
  Dump lief mit `--no-acl`, die Rechte kamen also nicht zurück; und selbst
  ohne dieses Flag greift beim Zurückspielen die Vorgabeprivilegierung aus
  `docker/postgres/10-init-app-role.sh` — jede von `pg_restore` neu angelegte
  Tabelle bekommt automatisch alle Rechte, und `GRANT` kann nur hinzufügen,
  nie wegnehmen. Nach einer Wiederherstellung durfte die Anwendungsrolle das
  Audit-Log ändern, Wiki-Fassungen löschen und Kiosk-Vorgänge umschreiben.
  Nichts hätte darauf hingewiesen.
  Gefunden haben es vier Datenbanktests unmittelbar nach der ersten
  Rückspielprobe — also genau die Probe, wegen der 1.0.0 sie verlangt.
 - **Ein E2E-Test klickte, bevor die Seite lebendig war.** Unter Last dauert das
  Hydrieren länger; das Formular verschickte sich dann selbst, und die
  Fehlerfläche, auf die der Test wartete, entstand nie — obwohl der Server
  richtig ablehnte. Er wartet jetzt auf einen client-seitig erzeugten Knopf.
 ### Nachweise
 - Sicherung und Wiederherstellung einmal vollständig durchgeführt: ein nach
  der Sicherung angelegter Datensatz war danach weg, alle Zahlen stimmten
  wieder, und **599 Tests liefen nach dem Zurückspielen grün** — einschließlich
  derer, die die Sperren prüfen.
 ---
 ## [0.11.0] — 2026-09-05
 Phase 10: Mandantenfähigkeit. Ein Konto, mehrere Wehren, eine Kreisebene, die
 zusieht — und eine Verwaltung für den, der die Installation betreibt.
 **Das Anmeldekonto ist von der Personenakte gelöst.** Bis hierher war die Akte
 zugleich das Konto: Passwort-Hash und OIDC-Subject hingen an `person`, und
 `person` gehört genau einer Wehr. Ein Mensch konnte damit nicht zu zwei Wehren
 gehören, ohne zwei Passwörter zu haben — und die Anmeldung per E-Mail war
 mehrdeutig, sobald dieselbe Adresse in zwei Wehren stand, weil die
 Eindeutigkeit nur je Organisation galt.
 **Das Konto trägt keine Mandantenkennung — und kann keine tragen.** Es ist der
 Angelpunkt, an dem ein Mensch zu mehreren Wehren gehört. Geschützt wird es
 deshalb wie `Berechtigung` aus Phase 0: über Rechte statt über Row Level
 Security. Was ein Konto in einer Wehr darf, entscheidet nicht es selbst,
 sondern seine `Mitgliedschaft` — und die trägt `organisationId` wie jede
 andere Tabelle.
 **Die Kreisebene sieht und ändert nichts.** Ihre Rechte werden nicht
 aufgezählt, sondern gefiltert: alles, was `.lesen` heißt, und sonst nichts.
 Eine Liste von Hand wäre bei der nächsten Phase veraltet, und zwar unbemerkt.
 ### Hinzugefügt
 **Datenmodell**
 - `Benutzer` — das Anmeldekonto. Global eindeutige E-Mail, ein Passwort, ein
  OIDC-Subject. Ohne `organisationId`, mit Begründung im Schema.
 - `Mitgliedschaft` — die Zugehörigkeit eines Kontos zu einer Wehr, als
  `MITGLIED` (mit Personenakte) oder `AUFSICHT` (ohne).
 - `Person` verliert die Anmeldefelder. Der Passwort-Hash kann damit aus einer
  Personenabfrage gar nicht mehr herausfallen — die drei Stellen, die ihn
  bisher vorsichtshalber abgeschnitten haben, sind entfallen.
 **Was die Datenbank durchsetzt** (Migrationen `20260905090000` und
 `20260905091500`)
 - RLS für `mitgliedschaft` wie für jede andere Tabelle. Eine Wehr sieht damit
  auch nicht, in welchen anderen ein Konto noch geführt wird.
 - Trigger `mitgliedschaft_akte_gleiche_wehr` — eine Zuordnung, deren
  Personenakte in einer anderen Wehr liegt, wird abgelehnt. Ein Fremdschlüssel
  prüft nur, *dass* es die Akte gibt, nicht *wo* sie liegt; ohne den Trigger
  ließe sich ein Konto über eine fremde Akte in eine Wehr hängen.
 - Trigger `benutzer_kennung_unveraenderlich` — E-Mail, OIDC-Subject und das
  Verwaltermerkmal lassen sich nicht aus einer Wehr heraus ändern.
 - `REVOKE INSERT, DELETE ON benutzer` für die Anwendungsrolle.
 - CHECKs: `MITGLIED` braucht eine Akte, `AUFSICHT` darf keine haben; ein Konto
  braucht einen Anmeldeweg; eine E-Mail ohne @ ist keine.
 **Die Umstellung ist datenerhaltend.** Jede Person mit Anmeldedaten bekommt
 ein Konto und eine Mitgliedschaft, bevor die alten Spalten fallen. Wer schon
 mit derselben Adresse in zwei Wehren stand, bekommt **ein** Konto mit **zwei**
 Mitgliedschaften — genau das, was vorher nicht möglich war. Eine Prüfung am
 Ende bricht die Migration ab, statt einen halben Zustand zu hinterlassen.
 **Oberfläche**
 - **Wehrwähler** in der Seitenleiste. Er erscheint nur bei mehr als einer Wehr
  — ein Auswahlfeld mit genau einem Eintrag ist eine Frage ohne
  Antwortmöglichkeit.
 - Nach der Anmeldung öffnet die **eigene** Wehr, nicht die betreute.
 - Ein dauerhafter Hinweis, wenn man eine Wehr als Kreisaufsicht sieht — nicht
  als kurz aufblitzende Meldung.
 - **`/wehren`** für den Verwalter: Wehren anlegen (samt Systemrollen), Konten
  führen, Zuordnungen vergeben und beenden. Jede Zuordnung wird in der
  betroffenen Wehr protokolliert, nicht beim Verwalter — sonst hätte der
  Betreiber einen Weg, sich still in fremde Daten zu setzen.
 **Rechte**
 - Neue Rolle `AUFSICHT` — bewusst **nicht** im Prisma-Enum: sie wird nicht
  vergeben, sondern ergibt sich aus der Mitgliedschaftsart.
 - Ausdrücklich ausgenommen, obwohl sie auf `.lesen` enden: `kasse.lesen` (die
  Kasse gehört dem Verein oder der Kommune, nicht der Kreisaufsicht),
  `person.export`, `system.auditlog`, `ki.protokoll`.
 - `istVerwalter` als Merkmal des Kontos, nicht als Recht.
 **Tests**
 - 19 neue Unit-Tests, davon 11 gegen eine echte Datenbank: Doppelmitgliedschaft,
  der Trigger gegen wehrfremde Akten, die CHECKs und die Trennung der
  Zuordnungen über RLS.
 - 13 E2E-Tests: kein Wähler bei einer Wehr, Wechsel in die betreute und
  zurück, die Mitglieder der anderen Wehr, die verschlossene Kasse, und dass
  der Administrator die Umstellung überlebt hat.
 **Seed**
 - Eine zweite, kleine Wehr je Mandant und ein Konto, das in der einen Mitglied
  und in der anderen Kreisaufsicht ist. Ohne sie ließe sich die Phase nicht
  ausprobieren — und eine Mandantentrennung, die nie zwei Mandanten hatte, ist
  keine geprüfte.
 ### Geändert
 - Eine Sitzung ohne Personenakte ist gültig. Bis hierher galt genau das als
  „nicht angemeldet"; für die Kreisaufsicht, die in der betreuten Wehr keine
  Akte hat, hätte jeder Aufruf auf der Anmeldeseite geendet.
 - `Sitzung.personId` ist nullbar. Der Typechecker hat damit die fünf Stellen
  gezeigt, an denen eine Aufsichtssitzung nichts verloren hat — Anmeldemarke,
  Dienstausweis, Prüfungswizard, Dateiupload, Atemschutz.
 - Die Mitgliederansicht zeigt statt eines ungenutzten Zeitstempels, ob jemand
  überhaupt ein Konto hat. Das ist die nützlichere Auskunft: ohne Konto kommt
  er nicht in FLORIAN hinein.
 ### Behoben
 - **Ein Testaufbau war nicht wiederholbar.** `ki-datenbank.test.ts` legte Wehr
  und Person idempotent an, die Wiki-Seite aber nicht — blieb aus einem
  abgebrochenen Lauf etwas stehen, scheiterte der ganze Datei-Lauf an einer
  Eindeutigkeit, die mit dem Geprüften nichts zu tun hat.
 - **`db:test-reset` ließ die Nachbarwehr stehen** und der Seed hielt daraufhin
  alles für erledigt — die Mitgliedschaft in der neu angelegten Testwehr
  entstand nie wieder. Der Reset nimmt sie jetzt mit, und der Seed prüft
  Nachbarwehr und Kreiskonto getrennt statt mit einem gemeinsamen Ausstieg.
 - **Der Fehlversuch-Test sperrte das gemeinsame Testkonto.** Fünf Fehlversuche
  sperren ein Konto für fünf Minuten; bei zwei Projekten und Wiederholungen
  kam das im vollen Lauf zusammen, und fremde Testdateien fielen mit
  „Anmeldung fehlgeschlagen“ aus. Er nimmt jetzt eine Adresse, die es nicht
  gibt — die Meldung muss ohnehin dieselbe sein.
 ---
 ## [0.10.0] — 2026-09-04
 Phase 9: Kassenverwaltung. Kassenbuch, Mitgliedsbeiträge, Rechnungen an
 Dritte, Kassenprüfung und die Auswertungen für die Jahreshauptversammlung.
 **Eine festgeschriebene Buchung ist unveränderbar.** Nicht, weil ein Zweig im
 Router es so vorsieht, sondern weil die Datenbank es ablehnt. Korrigiert wird
 über eine Gegenbuchung mit Verweis; beide Buchungen bleiben stehen, und im
 Kassenbuch ist zu sehen, dass etwas berichtigt wurde. Genau das will ein
 Kassenprüfer sehen — eine verschwundene Buchung dagegen kann er nicht prüfen.
 **Der Kassenabschluss schließt seinen Zeitraum.** Danach wird keine Buchung
 mit einem Datum darin mehr angenommen, auch keine nachträglich hineindatierte.
 Ohne diese zweite Hälfte stimmte der geprüfte Bestand nach einem
 Datumswechsel nicht mehr — und niemand hätte es bemerkt.
 **Gerechnet wird mit `Prisma.Decimal`, nirgends mit Fließkomma.** `0.1 + 0.2`
 ergibt in JavaScript 0.30000000000000004. In einer Kasse ist das kein
 Rundungsfehler, sondern eine Differenz in der Prüfung, die niemand erklären
 kann.
 ### Hinzugefügt
 **Datenmodell**
 - `Kassenkonto` (bar, Bank, Rücklage) mit Anfangsbestand. Der laufende Bestand
  wird **gerechnet und nie gespeichert**: ein gespeicherter Bestand neben
  einer nachgetragenen Buchung wäre falsch, ohne falsch auszusehen.
 - `Buchungskategorie` als zweistufiger Baum, mit Kontonummer für den Export an
  die Kämmerei.
 - `Buchung` mit Datum, Richtung, immer positivem Betrag, Verwendungszweck,
  Belegnummer, Beleg-Datei und dem Verweis auf die Gegenbuchung.
 - `Beitragssatz` und `Beitrag` (offen, bezahlt, erlassen, gemahnt) mit
  Mahnstufe und Erlassbegründung.
 - `Rechnung` und `Rechnungsposition` mit Nummernkreis je Jahr. Die Menge hat
  drei Nachkommastellen — Einsatzstunden werden viertelstündlich abgerechnet.
 - `Kassenabschluss` und `Abschlussposten` mit Bestand laut Buch, gezähltem
  Bestand, Differenz, zwei Prüfern und dem Bericht als PDF.
 **Was die Datenbank durchsetzt** (Migration `20260904140000`)
 - RLS für alle neun Tabellen, wie in jeder Phase zuvor.
 - Trigger `buchung_unveraenderlich` — festgeschriebene Buchungen lassen sich
  weder ändern noch löschen. Änderbar bleibt genau eines: der Verweis auf die
  Gegenbuchung. Eine Stornierung entsteht später; sie einzutragen ist keine
  Änderung des Vorgangs, sondern seine Fortschreibung.
 - Trigger `buchung_zeitraum_offen` — ein geprüfter Zeitraum nimmt weder eine
  neue Buchung an noch das Hineindatieren einer vorhandenen.
 - Trigger `abschluss_unveraenderlich` — ein festgeschriebener Abschluss bleibt,
  wie er ist. Nachtragen lässt sich nur der Prüfbericht, denn das PDF entsteht
  im Hintergrund und damit nach dem Festschreiben.
 - `REVOKE DELETE ON kassenabschluss` für die Anwendung.
 - CHECKs, die verhindern, was sich hinterher nicht mehr erkennen ließe: ein
  Betrag von null oder darunter, eine Buchung an eine Person **und** einen
  Dritten zugleich, ein erlassener Beitrag ohne Begründung, ein Abschluss mit
  einer Differenz, die nicht zu seinen eigenen Zahlen passt, eine Rechnung,
  die fällig wird, bevor sie geschrieben wurde.
 **Kassenbuch**
 - Buchungsmaske mit **Kategorievorschlag**: zuerst aus den eigenen früheren
  Buchungen der Wehr, erst danach aus einer kurzen Stichwortliste. Unter der
  Hälfte gemeinsamer Wörter schweigt der Vorschlag — ein falscher wird
  übernommen, ohne gelesen zu werden.
 - Summen über **alle** Treffer, nicht nur über die angezeigte Seite.
 - Festschreiben als Sammelaktion bis zu einem Stichtag.
 - Gegenbuchen mit Pflichtbegründung; das Buchungsdatum ist immer heute, damit
  ein geprüfter Zeitraum zubleibt.
 - **Aus einem gegengezeichneten Beleg wird eine Buchung.** Die Brücke zu
  Phase 8: fotografiert und ausgefüllt wird am Terminal oder am Handy,
  gebucht wird in der Kasse — mit Konto und Kategorie, die keine Maschine
  entscheiden kann. Das Foto hängt danach an der Buchung, und genau das
  verlangt eine Kassenprüfung: zu jeder Ausgabe ein Beleg, an der Buchung
  und nicht in einem Ordner daneben. Ein Entwurf lässt sich nicht buchen.
 **Kontoauszug einlesen**
 - CAMT.053 und MT940, beides ohne zusätzliche Abhängigkeit. Erkannt wird am
  Inhalt, nicht an der Dateiendung.
 - Es entstehen **Entwürfe, keine fertigen Buchungen**.
 - Jeder Umsatz trägt eine Kennung — die der Bank, sonst eine aus Datum, Betrag
  und Zweck gebildete. Ein zweimal eingelesener Auszug wird dadurch als solcher
  erkannt, statt einen Monat doppelt zu buchen.
 - Was nicht gelesen werden konnte, steht mit Grund daneben, statt still zu
  verschwinden.
 **Beiträge**
 - Sätze je Abteilung, gültig ab einem Jahr und nicht rückwirkend änderbar.
 - Beitragslauf mit **Vorschau**: wie viele Beiträge entstehen, welche Summe —
  und wer keinen passenden Satz hat. Der Lauf ist wiederholbar, ohne dass
  etwas doppelt entsteht.
 - Zahlungseingang erzeugt zugleich die Buchung. Ein Häkchen ohne Geld in der
  Kasse wäre eine Behauptung.
 - Mahnen als Sammelaktion, Erlassen nur mit Begründung.
 - Rückstandsliste über alle Jahre — die Ansicht, in der auffällt, wer seit
  drei Jahren offen steht.
 **Rechnungen**
 - Fortlaufende Nummer je Jahr, lückenlos: eine fehlende Nummer muss in der
  Kassenprüfung erklärt werden.
 - Der Betrag ist die Summe der Positionen, gerechnet und nicht eingegeben.
 - Bis zum Versenden ein Entwurf, danach unveränderbar. Korrigiert wird über
  Storno und eine neue Rechnung — die stornierte bleibt mit Grund stehen.
 - PDF über Gotenberg, im Hintergrund erzeugt.
 **Kassenprüfung und Auswertung**
 - Prüfmaske: links der Bestand laut Buch, rechts der gezählte. In dieser
  Reihenfolge — wer erst das Buch sieht und dann zählt, zählt, bis es passt.
 - Ohne Prüfer und Prüfdatum lässt sich nichts festschreiben; eine Differenz
  ohne Erläuterung ebenso wenig.
 - Kassenprüfbericht als PDF mit vier Unterschriftsfeldern.
 - Jahresauswertung nach Kategorie und Monat, mit Vorjahresvergleich.
 - CSV-Export mit Semikolon und BOM — was Excel in Deutschland ohne Rückfrage
  richtig öffnet.
 **Tests**
 - 67 neue Unit-Tests: Geldrechnen, beide Auszugsformate, Kategorievorschlag,
  und dreizehn gegen eine echte Datenbank, die die Trigger und CHECKs prüfen.
  Sie laufen über den Systemzugang: kommt nicht einmal der Eigentümer der
  Datenbank daran vorbei, kommt niemand vorbei.
 - 13 E2E-Tests über Desktop und Tablet.
 **Seed**
 - Ein vollständiges Kassenjahr: drei Konten, der Standardkontenrahmen,
  24 Buchungen über zwei Jahre, die Mitgliedsbeiträge mit Rückständen, zwei
  Rechnungen und die festgeschriebene Kassenprüfung des Vorjahres. Die Zahlen
  des Abschlusses sind die Summe der Buchungen und nicht erfunden.
 ### Geändert
 - Ein E2E-Test aus Phase 0 sicherte zu, dass die Kasse in der Navigation
  **kein** Verweis ist — sie war ja noch nicht da. Die Zusicherung ist mit
  dieser Phase abgelaufen und prüft jetzt das Gegenteil. Ein künftiges Modul
  zum Ausgrauen gibt es nicht mehr; kommt später eines dazu, gehört sie
  zurück.
 ### Behoben
 - **Die Rechnungsnummer war ein Wettlauf.** Höchste lesen und dann schreiben:
  schreiben zwei Leute gleichzeitig eine Rechnung, lesen beide dieselbe
  höchste Nummer, und die zweite läuft in den Eindeutigkeitsfehler. Gefunden
  hat das der parallele E2E-Lauf. Der seltene Zusammenstoß wird jetzt erkannt
  und die nächste Nummer genommen — lückenlos bleibt sie dabei.
 - **Eine Organisation ließ sich nicht mehr löschen**, sobald sie eine
  festgeschriebene Buchung hatte: der Trigger lehnte auch das Löschen im
  Aufbewahrungslauf ab. Er kennt jetzt denselben Schalter wie das Audit-Log
  und das Prüfprotokoll (`app.audit_bereinigung`). Ohne ihn wäre die
  DSGVO-Löschung einer ausscheidenden Wehr nicht durchführbar gewesen.
 ---
 ## [0.9.1] — 2026-09-04
 Aufräumarbeiten vor Phase 9. Drei Punkte, die sich über mehrere Phasen
 angesammelt hatten und in jeder Phase Zeit gekostet haben.
 ### Hinzugefügt
 - **ESLint** hat endlich eine Konfiguration (`eslint.config.mjs`, Flat Config).
  Bis dahin gab es das Skript `npm run lint`, aber nichts, was es hätte prüfen
  können — ein Werkzeug, das aussieht, als prüfe es etwas, und nichts prüft,
  ist schlechter als gar keines. Bewusst **ohne** Formatierungsregeln: die
  macht Prettier. Dazu `npm run lint:fix`.
 - **Eine eigene Wehr für die E2E-Tests.** `npm run db:test-reset` legt
  `ff-teststelle` neu an — vollständig, mit denselben Beispieldaten, aber unter
  eigener Kennung. Ein Riegel im Skript bricht ab, wenn die Testkennung mit der
  der Beispielwehr übereinstimmt.
 - `tests/e2e/wehr.ts` — Zugangsdaten und Anmeldung an einer Stelle statt
  achtmal wortgleich in acht Dateien. Schlägt die Anmeldung fehl, sagt die
  Meldung, dass die Testwehr fehlt, statt zweihundertmal „Timeout".
 ### Behoben
 - **Die E2E-Tests schrieben in die Beispielwehr.** Nach fünf Phasen standen
  dort 120 Atemschutz-Überwachungen statt einer, 115 Geräte statt 45 und
  39 Einsätze statt 8. Zweimal fielen Tests aus, weil ein gesuchter Eintrag von
  Seite 1 gerutscht war; bei jedem Lauf unterschieden sich alle 72
  Bildschirmfotos. Der Bestand ist einmal zurückgesetzt, die Tests laufen
  jetzt gegen die eigene Wehr.
 - **`<div>` in einem `<p>` auf der Einsatzseite** — die Meldung stand seit
  Phase 3 in der Konsole und ist der klassische Auslöser für einen
  Hydration-Fehler. Die Wurzel war das `Badge`: es rendert jetzt ein `<span>`
  statt eines `<div>`. Ein Abzeichen ist Fließtext-Inhalt, und die Darstellung
  ändert sich dadurch nicht.
 - **Die Fehlerfläche der Karte konnte nie etwas anzeigen** — der Zustand
  dahinter wurde nirgends gesetzt. Eine gescheiterte Abfrage sah damit aus wie
  „keine Hydranten vorhanden". Gefunden hat das der neue Linter.
 - **Die Lagekarte rechnete bei jedem Rendern neu.** Ein `?? []` erzeugte jedes
  Mal ein neues leeres Feld und machte damit zwei `useMemo` wirkungslos — bei
  einer Karte mit dreißig Elementen und einem Ereignisstrom im Zwei-Sekunden-
  Takt kein akademischer Punkt.
 - Deutsche Anführungszeichen in vier Ansichten schlossen mit einem geraden
  Zoll-Zeichen statt mit dem typografischen.
 - Unbenutzte Importe in fünf Dateien.
 ### Geändert
 - `npm run lint` ruft jetzt `eslint .` statt des in Next 15.5 abgekündigten
  `next lint`.
 - **`tests/e2e` ist nicht mehr vom Typecheck ausgenommen.** Die Ausnahme hat
  beim Umbau einen doppelt deklarierten Bezeichner durchgelassen, den erst der
  Testlauf gemeldet hat — `npx tsc --noEmit` hatte geschwiegen.
 ---
@@ -1,8 +1,14 @@
 # FLORIAN — Feuerwehr-Verwaltungsplattform
 **Version 1.0.0** — freigegeben für den Echtbetrieb.
 Selbstgehostete Verwaltungssoftware für Freiwillige Feuerwehren. Läuft im
 Gerätehaus, nicht in der Cloud. Keine Telemetrie, keine externen CDNs.
 > **Wer FLORIAN benutzen und nicht bauen will:**
 > [**Kurzanleitung**](docs/KURZANLEITUNG.md) — alles Wichtige nach Rollen
 > sortiert, auf ein paar Seiten.
 ## Schnellstart
 ```bash
@@ -32,7 +38,9 @@ Anmelden mit `SEED_ADMIN_EMAIL` und `SEED_ADMIN_PASSWORT` aus der `.env`
 | Phase 6 — Kartenmodule | fertig |
 | Phase 7 — Benachrichtigungen und Termine | fertig |
 | Phase 8 — Lokale KI | fertig |
-| Phase 9 — Kassenverwaltung | offen |
+| Phase 9 — Kassenverwaltung | fertig |
 | Phase 10 — Mandantenfähigkeit | fertig |
 | Phase 11 — Freigabereife | fertig |
 Vollständige Planung mit Aufwänden: [docs/ROADMAP.md](docs/ROADMAP.md) und
 [docs/AUFWANDSSCHAETZUNG.md](docs/AUFWANDSSCHAETZUNG.md).
@@ -41,7 +49,8 @@ Vollständige Planung mit Aufwänden: [docs/ROADMAP.md](docs/ROADMAP.md) und
 | Datei | Inhalt |
 |---|---|
-| [docs/ANLEITUNG.md](docs/ANLEITUNG.md) | Bedienung mit Bildschirmfotos |
+| [docs/KURZANLEITUNG.md](docs/KURZANLEITUNG.md) | **Der Einstieg.** Nach Rollen sortiert, ein paar Seiten |
 | [docs/ANLEITUNG.md](docs/ANLEITUNG.md) | Die vollständige Bedienung mit Bildschirmfotos, zum Nachschlagen |
 | [docs/ROADMAP.md](docs/ROADMAP.md) | Phasenplan und was jeweils entsteht |
 | [docs/AUFWANDSSCHAETZUNG.md](docs/AUFWANDSSCHAETZUNG.md) | Aufwand je Phase, Schätzung gegen Ist |
 | [docs/DEVLOG.md](docs/DEVLOG.md) | Entwicklungstagebuch mit Zeiterfassung |
@@ -1155,22 +1164,471 @@ Fehlermeldung der Datenbank durchzureichen, die niemand versteht.
 ---
 ## Phase 9 — Kassenverwaltung
 Kassenbuch, Mitgliedsbeiträge, Rechnungen an Dritte, Kassenprüfung und die
 Zahlen für die Jahreshauptversammlung.
 Eine Feuerwehrkasse wird von einem Ehrenamtlichen geführt und von zwei anderen
 geprüft. Was die Prüfung wert ist, hängt einzig daran, dass sich das Geprüfte
 hinterher nicht mehr ändern lässt. Deshalb ist der zentrale Punkt dieser Phase
 kein Formular, sondern eine Sperre.
 ### Drei Festlegungen
 **Eine festgeschriebene Buchung ist unveränderbar.** Nicht, weil ein Zweig im
 Router es so vorsieht, sondern weil die Datenbank es ablehnt — ein vergessener
 Zustandscheck, ein Skript, ein Import würden sonst reichen. Korrigiert wird
 über eine **Gegenbuchung** mit Verweis: beide Buchungen bleiben stehen, und im
 Kassenbuch ist zu sehen, dass etwas berichtigt wurde. Genau das will ein
 Kassenprüfer sehen; eine verschwundene Buchung kann er nicht prüfen.
 **Der Kassenabschluss schließt seinen Zeitraum.** Danach wird keine Buchung
 mit einem Datum darin mehr angenommen — auch keine nachträglich
 hineindatierte. Ohne diese zweite Hälfte stimmte der geprüfte Bestand nach
 einem Datumswechsel nicht mehr, und niemand hätte es bemerkt. Wer nach der
 Prüfung noch eine Quittung findet, bucht sie mit dem heutigen Datum.
 **Beträge sind `DECIMAL(12,2)`, gerechnet wird mit `Prisma.Decimal`.**
 `0.1 + 0.2` ergibt in JavaScript 0.30000000000000004. In einer Kasse ist das
 kein Rundungsfehler, sondern eine Differenz in der Prüfung, die niemand
 erklären kann.
 ### Das Kassenbuch
 Drei Kontenarten: Barkasse, Bankkonto, Rücklage. Der **Bestand wird gerechnet,
 nie gespeichert** — Anfangsbestand plus die Wirkung aller Buchungen. Ein
 gespeicherter Bestand neben einer nachgetragenen Buchung wäre falsch, ohne
 falsch auszusehen, und genau danach sucht ein Kassenprüfer.
 Der Betrag einer Buchung ist immer positiv; die Richtung steht daneben. Eine
 negative Ausgabe wäre eine Einnahme in Verkleidung und in keiner Auswertung
 als solche zu erkennen — die Datenbank nimmt sie deshalb nicht an.
 Die Buchungsmaske schlägt eine Kategorie vor: zuerst aus den **eigenen
 früheren Buchungen** der Wehr, erst danach aus einer kurzen Stichwortliste.
 Der Nutzen liegt nicht in den gesparten Sekunden, sondern darin, dass dieselbe
 Sache immer unter derselben Kategorie landet — erst das macht die
 Jahresauswertung brauchbar. Unter der Hälfte gemeinsamer Wörter schweigt der
 Vorschlag: ein falscher wird übernommen, ohne gelesen zu werden.
 Ein **gegengezeichneter Beleg** aus Phase 8 wird mit einem Klick zur Buchung:
 Konto und Kategorie wählen, fertig. Betrag, Datum und Händler stehen schon
 fest, und das Foto hängt danach an der Buchung — zu jeder Ausgabe ein Beleg,
 an der Buchung und nicht in einem Ordner daneben. Ein Entwurf lässt sich
 nicht buchen: er ist ein von einem Modell ausgefülltes Formular.
 ### Kontoauszug einlesen
 Das Online-Banking bietet beides zum Herunterladen an, meist unter
 „Umsatzexport“:
 | Format | Datei | Was gelesen wird |
 |---|---|---|
 | CAMT.053 | `.xml`, `.camt` | Datum, Richtung, Betrag, Verwendungszweck, Gegenseite, Bankkennung |
 | MT940 | `.txt`, `.sta` | dasselbe, aus den Feldern `:61:` und `:86:` |
 Erkannt wird am Inhalt, nicht an der Dateiendung. Es entstehen **Entwürfe,
 keine fertigen Buchungen** — durchsehen muss sie der Kassier.
 Jeder Umsatz trägt eine Kennung: die der Bank, sonst eine aus Datum, Betrag
 und Zweck gebildete. Derselbe Auszug zweimal eingelesen wird dadurch als
 solcher erkannt und in der Liste als „steht schon in der Kasse“ ausgewiesen.
 Ohne das wäre es ein doppelt gebuchter Monat, und der fiele erst beim
 Kassenabschluss auf.
 Was nicht gelesen werden konnte, steht mit Grund daneben. Ein Parser, der
 stillschweigend drei Umsätze verschluckt, ist schlimmer als einer, der gar
 nicht erst liest.
 ### Mitgliedsbeiträge
 Sätze gelten ab einem Jahr und je Abteilung; ein Satz ohne Abteilung gilt für
 alle übrigen. Rückwirkend geändert wird nichts — sonst stimmten die Beiträge
 vergangener Jahre nicht mehr, und die sind bereits geprüft.
 Der **Beitragslauf** zeigt vorher, was entstehen wird: wie viele Beiträge,
 welche Summe, und wer keinen passenden Satz hat. Der letzte Teil ist der
 interessante — das sind die Leute, für die niemand entschieden hat, was sie
 zahlen. Der Lauf ist wiederholbar; im Februar noch einmal gestartet legt er
 nur die Neuen an.
 Ein Zahlungseingang erzeugt zugleich die Buchung. Ein Häkchen ohne Geld in der
 Kasse wäre eine Behauptung. Ein Erlass braucht eine Begründung — die Datenbank
 lehnt einen ohne ab, weil er in der Kassenprüfung sonst eine offene Frage ist.
 Die Rückstandsliste geht über alle Jahre. Sie ist die einzige Ansicht, in der
 auffällt, wer seit drei Jahren offen steht.
 ### Rechnungen an Dritte
 Kostenersatz nach Art. 28 BayFwG, Vermietungen, Veranstaltungen. Die Nummer
 vergibt FLORIAN fortlaufend je Jahr und **lückenlos**: eine fehlende Nummer
 muss in der Kassenprüfung erklärt werden.
 Der Betrag ist die Summe der Positionen, gerechnet und nicht eingegeben. Ein
 eingetippter Gesamtbetrag neben Positionen, die etwas anderes ergeben, ist der
 Fehler, den niemand bemerkt, bis der Empfänger anruft. Die Menge hat drei
 Nachkommastellen — Einsatzstunden werden viertelstündlich abgerechnet, und
 0,25 × 47,50 muss auf den Cent stimmen.
 Bis zum Versenden ist eine Rechnung ein Entwurf, danach unveränderbar: was
 beim Empfänger liegt, muss dem entsprechen, was hier steht. Korrigiert wird
 über Storno und eine neue Rechnung; die stornierte bleibt mit Grund stehen.
 ### Kassenprüfung
 In der Prüfmaske steht links der Bestand laut Buch und rechts der gezählte.
 In dieser Reihenfolge, und die gezählten Felder fangen leer an — wer erst das
 Buch sieht und dann zählt, zählt, bis es passt.
 Ohne Prüfer und Prüfdatum lässt sich nichts festschreiben: ohne beides ist es
 kein Abschluss, sondern eine Notiz. Eine Differenz braucht eine Erläuterung,
 sonst steht in fünf Jahren „stimmt nicht“ im Bericht und niemand weiß mehr,
 warum.
 Der Kassenprüfbericht entsteht als PDF mit vier Unterschriftsfeldern und wird
 im Hintergrund erzeugt.
 ### Auswertungen
 Einnahmen und Ausgaben nach Kategorie und Monat, mit dem Vorjahr daneben —
 eine Zahl ohne Vergleich sagt nichts. Der Export ist eine CSV-Datei mit
 Semikolon und BOM: das ist, was Excel in Deutschland ohne Rückfrage richtig
 öffnet. Eine Datei, die beim Doppelklick als eine Spalte voller Semikolons
 erscheint, wird zurückgeschickt.
 ### Wer was sieht
 | Recht | Wer | Was |
 |---|---|---|
 | `kasse.lesen` | Kassier, Kommandant, Vorstand | Buchungen und Auswertungen ansehen |
 | `kasse.bearbeiten` | Kassier | Buchungen, Beiträge, Rechnungen erfassen |
 | `kasse.abschluss` | Kassier, Kassenprüfer | Kassenabschluss anlegen und festschreiben |
 Der Gerätewart sieht keine Buchungen, der Kassier keine Atemschutzdaten. Die
 Trennung liegt in `lib/authz.ts`, nicht in den Komponenten.
 **Keine zusätzlichen Umgebungsvariablen.** Die Kasse braucht nur, was ohnehin
 läuft: Postgres, MinIO für die Belege und Gotenberg für die PDFs.
 ---
 ## Phase 10 — Mandantenfähigkeit
 Ein Server, mehrere Wehren. Ein Konto, mehrere Zugehörigkeiten. Eine
 Kreisebene, die zusieht.
 Datenmodell und Row Level Security tragen seit Phase 0 mehrere Wehren — jede
 Tabelle hat `organisationId`, jede Abfrage läuft im Mandantenkontext. Was
 fehlte, war alles darüber: eine Anmeldung, die zu mehr als einer Wehr gehören
 kann, ein Weg zum Umschalten, und eine Verwaltung für den, der den Server
 betreibt.
 ### Konto und Akte sind nicht dasselbe
 Bis Phase 9 war die Personenakte zugleich das Anmeldekonto: Passwort-Hash und
 OIDC-Subject hingen an `person`, und `person` gehört genau einer Wehr. Daraus
 folgten zwei Dinge, die niemand wollte:
 - Wer in zwei Wehren geführt wurde, brauchte **zwei Passwörter**, die
  auseinanderlaufen können.
 - Die Anmeldung per E-Mail war **mehrdeutig**, sobald dieselbe Adresse in zwei
  Wehren stand — die Eindeutigkeit galt nur je Organisation, und gefunden
  wurde, was die Datenbank zuerst hergab.
 Seit Phase 10:
 | Tabelle | Was sie ist | Mandant |
 |---|---|---|
 | `Benutzer` | das Anmeldekonto — E-Mail, Passwort, OIDC | **keiner** |
 | `Mitgliedschaft` | Zugehörigkeit eines Kontos zu einer Wehr | `organisationId` |
 | `Person` | die Akte in einer Wehr — Dienstgrad, Qualifikationen, Einsätze | `organisationId` |
 **`Benutzer` trägt bewusst keine Mandantenkennung** und kann keine tragen: sie
 ist ja der Angelpunkt, an dem ein Mensch zu mehreren Wehren gehört. RLS greift
 dort deshalb nicht. Geschützt wird sie stattdessen über Rechte — dieselbe
 Lösung wie bei `Berechtigung` aus Phase 0 und aus demselben Grund: eine
 Tabelle, die über allen Mandanten steht, gehört nicht in die Hand der
 Anwendungsrolle. Was ein Konto in einer Wehr darf, entscheidet nicht es
 selbst, sondern seine `Mitgliedschaft`.
 Ein angenehmer Nebeneffekt: der Passwort-Hash kann aus einer Personenabfrage
 gar nicht mehr herausfallen. Die drei Stellen, die ihn bisher vorsichtshalber
 abgeschnitten haben, sind entfallen — eine Sorgfaltsmaßnahme ist durch eine
 Struktur ersetzt.
 ### Die Wehr wechseln
 Der Wähler steht in der Seitenleiste unter dem Namen der Wehr — **aber nur,
 wenn es etwas zu wählen gibt.** Für die allermeisten gibt es das nie, und ein
 Auswahlfeld mit genau einem Eintrag ist keine Hilfe, sondern eine Frage ohne
 Antwortmöglichkeit.
 Nach der Anmeldung öffnet die **eigene** Wehr, nicht die betreute: wer eine
 Wehr führt und acht andere beaufsichtigt, will in seiner landen.
 Technisch: die Wehr steht im Sitzungstoken, also wird beim Wechsel ein neues
 ausgestellt. Was der Browser dabei schickt, ist ein **Wunsch** — geprüft wird
 serverseitig gegen die Mitgliedschaften des Kontos. Eine fremde Kennung zu
 nennen bringt nichts, weil es dazu keine Mitgliedschaft gibt.
 ### Die Kreisebene
 Kreisbrandrat und Kreisbrandinspektion gehören den betreuten Wehren nicht an.
 Sie bekommen deshalb dort **keine Personenakte**, tauchen in keiner
 Mitgliederliste auf und können nichts ändern.
 Ihre Rechte werden nicht aufgezählt, sondern **gefiltert**: alles, was
 `.lesen` heißt, und sonst nichts. Eine von Hand gepflegte Liste wäre bei der
 nächsten Phase veraltet, und zwar unbemerkt — ein neues Modul brächte Rechte
 mit, die niemand nachträgt. So bekommt die Aufsicht neue Leserechte
 automatisch und neue Schreibrechte nie.
 Vier Rechte sind ausdrücklich ausgenommen, obwohl sie auf `.lesen` enden:
 | Recht | Warum nicht |
 |---|---|
 | `kasse.lesen` | Die Kasse gehört dem Verein oder der Kommune, nicht der Kreisaufsicht. |
 | `person.export` | Das Auskunftsrecht nach DSGVO erfüllt die Wehr, die die Daten führt. |
 | `system.auditlog` | Wer wann was getan hat, bleibt innerhalb der Wehr. |
 | `ki.protokoll` | Dasselbe. |
 Der **Atemschutz** steht dagegen bewusst drin: ob ein Träger tauglich ist, ist
 genau die Frage, für die es eine Kreisebene gibt.
 Wer als Aufsicht unterwegs ist, sieht dauerhaft einen Hinweis darauf — nicht
 als kurz aufblitzende Meldung, sondern als Zeile über der Ansicht. Man soll
 nicht erst merken, in welcher Rolle man ist, wenn ein Knopf fehlt.
 ### Doppelmitgliedschaft
 Ein Konto, mehrere Zugehörigkeiten. In Bayern der Regelfall bei allem, was
 über die eigene Wehr hinausgeht: aktiv in A, Ehrenmitglied in B, oder
 Kommandant der einen und Kreisbrandinspektor für sechs weitere.
 Zwei Zusicherungen setzt die Datenbank durch:
 - **Ein Konto gehört einer Wehr höchstens einmal an.**
 - **Eine Personenakte hängt an höchstens einem Konto.** Sonst wäre nicht
  entscheidbar, wer unter ihrem Namen gehandelt hat.
 Und eine dritte, die weniger offensichtlich ist: die Akte muss zu **derselben
 Wehr** gehören wie die Zuordnung. Ein Fremdschlüssel prüft nur, *dass* es die
 Akte gibt, nicht *wo* sie liegt — ohne diese Prüfung ließe sich ein Konto über
 eine Akte aus Wehr A in Wehr B hängen, und die Sitzung stünde dort mit einer
 Personenkennung da, die niemandem gehört. Ein Trigger lehnt das ab.
 ### Wehren und Konten verwalten
 Unter **`/wehren`**, und nur für den, der die Installation betreibt.
 Der Zugang hängt an einem Merkmal des Kontos (`istVerwalter`), **nicht an
 einem Recht**. Rechte gelten je Wehr; wer Wehren anlegt, steht über allen. Ein
 Recht, das in Wehr A vergeben wird und in Wehr B wirkt, wäre genau die
 Hintertür, die diese Phase vermeiden soll.
 Was dort geht:
 - Eine Wehr anlegen — sie bekommt sofort ihre Systemrollen samt Rechten. Ein
  Konto bekommt sie nicht: eine Wehr anzulegen und jemanden hineinzusetzen
  sind zwei Entscheidungen, und die zweite trifft meist jemand anders.
 - Ein Konto anlegen — ohne Wehr. Die kommt über die Zuordnung.
 - Zuordnen: als Mitglied mit Personenakte oder als Kreisaufsicht ohne.
 **Jede Zuordnung wird in der betroffenen Wehr protokolliert**, nicht beim
 Verwalter. Sonst hätte der Betreiber einen Weg, sich still in fremde Daten zu
 setzen.
 **Keine zusätzlichen Umgebungsvariablen.**
 ### Was bewusst fehlt
 **Wehrübergreifende Auswertungen.** Eine Zahl über mehrere Wehren hinweg
 braucht eine abgestimmte Definition — was zählt als Einsatz, was als Übung,
 wie wird eine Doppelmitgliedschaft gezählt. Ohne die ist eine solche Zahl
 schlimmer als keine, weil sie benutzt wird. Die Aufsicht sieht jede Wehr
 einzeln, und das reicht für die Fragen, die tatsächlich gestellt werden.
 **Ein Einladungsverfahren.** Passwörter werden vom Verwalter vergeben und
 weitergegeben. FLORIAN verschickt keine.
 ---
 ## Phase 11 — Freigabereife
 Die drei Dinge, die zwischen dem letzten Modul und dem Echtbetrieb standen:
 das Auskunftsrecht, ein geprüftes Sicherungskonzept und eine Pipeline.
 ### Auskunft nach Art. 15 DSGVO
 Jede Person darf verlangen zu erfahren, welche Daten über sie verarbeitet
 werden. In einer Feuerwehr ist das mehr, als die meisten erwarten — und mit
 den G26-Untersuchungen sind Gesundheitsdaten dabei, also eine besondere
 Kategorie nach Art. 9.
 Auf der Seite eines Mitglieds steht dafür der Knopf **Datenauskunft**
 (Recht `person.export`). Ein Durchgang liefert drei Dinge:
 | | Wofür |
 |---|---|
 | **Anzeige** | Was ausgehändigt wird, vor dem Aushändigen |
 | **PDF** | Das Schreiben an die Person, für die Akte |
 | **JSON** | Datenübertragbarkeit nach Art. 20 |
 Bewusst nicht drei Knöpfe: wer eine Auskunft erteilt, soll sie vollständig
 erteilen und nicht in Schritten, von denen zwei vergessen werden können.
 **Über jedem Abschnitt steht, wozu die Daten vorliegen.** Art. 15 Abs. 1
 verlangt nicht nur die Daten, sondern auch Zwecke, Empfänger, Speicherdauer
 und den Hinweis auf die weiteren Rechte. Eine Liste ohne das sieht aus wie
 eine Auskunft und ist keine.
 Zwei Festlegungen bestimmen den Zuschnitt:
 **Was über die Person gespeichert ist, steht vollständig drin** — auch das
 Unangenehme: eine nicht bestandene G26, ein gemahnter Beitrag. Eine Auskunft,
 die auswählt, was gut aussieht, ist keine.
 **Was die Person getan hat, steht als Zahl drin.** Wer zwölf Prüfprotokolle
 unterschrieben hat, bekommt die Zahl — nicht zwölf Protokolle. Die gehören zum
 Nachweisbestand der Wehr; sie mitzuliefern hieße, dass jeder über eine
 Selbstauskunft an die Geräteakten käme. Die Trennlinie ist nicht „viel oder
 wenig", sondern „über mich" gegen „von mir".
 Leere Abschnitte bleiben stehen. „Dazu liegt nichts vor" ist eine Auskunft;
 ein weggelassener Abschnitt wirft die Frage auf, ob da doch etwas ist.
 Der Vorgang wird protokolliert — dass eine Auskunft erteilt wurde, gehört
 festgehalten.
 ### Sicherung
 ```bash
 npm run sicherung                      # nach ./sicherungen/<Zeitstempel>/
 npm run sicherung -- --ziel D:\backups
 ```
 Gesichert wird beides, aus **demselben Moment**: die Datenbank über `pg_dump`
 im Container und alle Dateien aus MinIO. Eine Datenbank von heute mit Dateien
 von gestern ergibt Datensätze, die auf nichts zeigen.
 Daneben entsteht ein `manifest.json` mit Zeitpunkt, Version und Umfang. Es
 wird beim Zurückspielen angezeigt, damit niemand versehentlich eine Sicherung
 von vor drei Monaten einspielt, weil das Verzeichnis ähnlich hieß.
 ### Wiederherstellung
 ```bash
 npm run wiederherstellen -- --quelle sicherungen/2026-09-05T14-16-48
 npm run wiederherstellen -- --quelle ... --wirklich
 ```
 Ohne `--wirklich` passiert nichts — es wird nur angezeigt, was geschähe. Das
 ist keine Bequemlichkeit: das Skript überschreibt den gesamten Bestand.
 **Der eigentliche Zweck ist nicht der Notfall, sondern die Probe.** Eine
 Sicherung, die nie zurückgespielt wurde, ist eine Vermutung: der Ordner kann
 leer sein, der Dump abgeschnitten, das Passwort falsch. Man erfährt es an dem
 Tag, an dem man es nicht erfahren will.
 Wie berechtigt das ist, hat sich hier gezeigt. Der erste Rückspielversuch lief
 sauber durch — und hatte dabei **sämtliche Unveränderlichkeitsgarantien der
 Datenbank entfernt**. Der Grund liegt tiefer, als man vermutet:
 `docker/postgres/10-init-app-role.sh` richtet eine Vorgabeprivilegierung ein,
 damit neue Tabellen aus Migrationen automatisch nutzbar sind. `pg_restore`
 legt die Tabellen aber ebenfalls neu an — die Vorgabe greift also auch dort,
 und die `GRANT`-Zeilen aus dem Dump können nur hinzufügen, nie wegnehmen. Die
 Anwendungsrolle durfte danach das Audit-Log ändern, Wiki-Fassungen löschen und
 Kiosk-Vorgänge umschreiben. Nichts an der Anwendung hätte darauf hingewiesen.
 Deshalb setzt das Skript die Sperren nach dem Zurückspielen neu und **prüft
 danach nach**, ob es gewirkt hat. Die Liste dafür steht in
 `scripts/sicherung-sperren.ts`, und ein Test gleicht sie gegen die migrierte
 Datenbank ab: läuft sie auseinander, käme eine Sperre nach einer
 Wiederherstellung nicht zurück, von der niemand mehr weiß, dass es sie gab.
 Nach dem Zurückspielen bleiben drei Handgriffe, die keine Software abnehmen
 kann:
 1. Anmelden — kommt jemand hinein?
 2. Ein Prüfprotokoll öffnen — ist das PDF da?
 3. Die Mitgliederzahl mit der Erwartung vergleichen.
 Erst danach gilt die Sicherung als geprüft.
 ### Die Pipeline
 `.gitea/workflows/pruefung.yml`, zwei Aufträge:
 | Auftrag | Was | Wann |
 |---|---|---|
 | `pruefung` | typecheck, lint, Migrationen, Seed, 599 Unit-Tests | jeder Push und Pull Request |
 | `oberflaeche` | die E2E-Tests über Chromium | nur `main` und Pull Requests |
 Die Trennung ist eine Zeitfrage: der erste Auftrag dauert Minuten, der zweite
 eine Dreiviertelstunde.
 Die Datenbank wird aus `docker/postgres` **gebaut** statt aus einem fertigen
 Image genommen. FLORIAN braucht PostGIS und pgvector, und kein öffentliches
 Image bringt beides mit; ein Dienst-Container mit `postgres:17` ließe die
 Migrationen durchlaufen und scheiterte erst bei der ersten Umkreissuche. Der
 Seed läuft mit, weil er selbst ein Test ist: fällt ein Standardwert um, merkt
 man es hier und nicht, wenn eine Wehr ihn zum ersten Mal ausführt.
 > **Voraussetzung: ein registrierter Runner.** Die Datei allein genügt nicht —
 > Gitea braucht einen `act_runner`, der die Aufträge annimmt. Ist keiner
 > eingerichtet, erscheinen die Läufe als „wartend" und laufen nie. Zum
 > Zeitpunkt dieser Phase war noch keiner registriert; der Ablauf ist also
 > geschrieben, aber nicht im Betrieb erprobt.
 ---
 ## Befehle
 ```bash
 npm run sicherung          # Datenbank und Dateien sichern
 npm run wiederherstellen   # zurueckspielen (Probelauf ohne --wirklich)
 npm run dev              # Entwicklungsserver auf Port 3100
 npm run build            # Produktionsbuild
 npm run worker:dev       # Hintergrundprozess mit Neuladen
 npm run test             # Vitest
-npm run test:e2e         # Playwright
+npm run test:e2e         # Playwright (vorher: npm run db:test-reset)
 npm run lint             # ESLint
 npm run lint:fix         # ESLint mit automatischen Korrekturen
 npm run typecheck        # TypeScript ohne Ausgabe
 npm run db:migrate       # ausstehende Migrationen anwenden
 npm run db:seed          # Beispielwehr einspielen
 npm run db:test-reset    # Testwehr für die E2E-Tests neu aufbauen
 npm run db:studio        # Prisma Studio
 npm run screenshots      # Bilder für docs/ANLEITUNG.md erzeugen
 npm run vapid            # VAPID-Schlüsselpaar für Web-Push erzeugen
 ```
 ## Tests
 ```bash
 npm run test             # Vitest — Unit und Datenbankregeln
 npm run db:test-reset    # einmalig vor dem E2E-Lauf
 npm run test:e2e         # Playwright
 ```
 ### Zwei Wehren in der Datenbank
 Die E2E-Tests laufen gegen eine **eigene Wehr** (`ff-teststelle`), nicht gegen
 die Beispielwehr aus der Anleitung. Der Grund ist ein handfester: bis Phase 8
 schrieben sie in `ff-musterhausen`, und nach fünf Phasen standen dort
 120 Atemschutz-Überwachungen statt einer und 115 Geräte statt 45. Zweimal
 fielen Tests aus, weil ein gesuchter Eintrag von Seite 1 gerutscht war — und
 bei jedem Lauf unterschieden sich alle 72 Bildschirmfotos.
 `npm run db:test-reset` löscht die Testwehr und legt sie neu an, mit denselben
 Beispieldaten. Die Beispielwehr wird dabei nicht angefasst; ein Sicherungsriegel
 im Skript bricht ab, wenn beide Kennungen übereinstimmen.
 Anmeldung der Testwehr: `e2e@teststelle.de` / `Feuerwehr2026`, änderbar über
 `E2E_ADMIN_EMAIL` und `E2E_ADMIN_PASSWORT`.
 ## Dienste und Ports (Entwicklung)
 Bewusst nicht die Standardports, damit FLORIAN neben anderen lokalen Stacks
@@ -1204,6 +1662,30 @@ ohne Traefik. In Produktion terminiert Traefik TLS und verteilt auf
 Der App-Container wendet beim Start ausstehende Migrationen an; der Worker
 tut das bewusst nicht, damit nicht zwei Prozesse gleichzeitig migrieren.
 ### Aktualisieren
 ```bash
 ./update.sh --pruefen   # nachsehen, ob es etwas Neues gibt
 ./update.sh             # einspielen
 ```
 Der Ablauf ist so gebaut, dass er an jeder Stelle abbrechen darf, ohne eine
 halb aktualisierte Anlage zu hinterlassen:
 1. Nachsehen, ob überhaupt etwas Neues da ist — sonst endet es hier.
 2. **Sichern.** Vor allem anderen; ein Update ist der häufigste Anlass, eine
   Sicherung zu brauchen.
 3. Neue Fassung holen und die Abbilder bauen. Schlägt das fehl, läuft die alte
   Fassung unverändert weiter — es wurde noch nichts umgeschaltet.
 4. Umschalten. Der App-Container spielt dabei die Migrationen ein.
 5. Nachsehen, ob die Anwendung wieder antwortet. Tut sie es nach zweieinhalb
   Minuten nicht, stehen die letzten Protokollzeilen da und die Befehle, mit
   denen der vorherige Stand zurückkommt.
 Vorher prüft das Skript, dass Docker, git und die `.env` da sind und dass im
 Verzeichnis keine unverbuchten Änderungen liegen. `--ohne-sicherung` gibt es
 für Testinstallationen; im Betrieb gehört es nicht benutzt.
 ## Datenschutz
 - Keine Telemetrie, keine externen CDNs, keine Google Fonts. Es werden nur
@@ -1,9 +1,11 @@
 # Anleitung
-Bedienung von FLORIAN, Stand Phase 8 (Version 0.9.0). Die Bilder zeigen die
+Bedienung von FLORIAN, Version 1.0.0. Die Bilder zeigen die Beispielwehr aus
-Beispielwehr aus dem Seed und werden mit `npm run screenshots` neu erzeugt.
+dem Seed und werden mit `npm run screenshots` neu erzeugt.
-> Die Kassenverwaltung kommt in Phase 9 dazu. Siehe [ROADMAP.md](ROADMAP.md).
+> **Das hier ist zum Nachschlagen, nicht zum Durchlesen.** Wer anfangen will,
 > nimmt die [Kurzanleitung](KURZANLEITUNG.md) — nach Rollen sortiert, auf ein
 > paar Seiten.
 ---
@@ -1680,9 +1682,9 @@ Prüfen Sie gegen das Foto, das links daneben steht. Dann **Gegenzeichnen**.
 Ohne Vision-Modell funktioniert alles bis auf das Auslesen: der Beleg wird
 fotografiert und abgelegt, die Angaben tragen Sie von Hand ein.
-Die Buchung daraus kommt mit der Kasse in Phase 9. Hier entsteht erst einmal ein
+Ist der Beleg gegengezeichnet, steht in der Liste der erledigten Belege ein
-sauber erfasster Beleg mit Foto — und der ist schon mehr wert als ein
+Knopf **Buchen**. Er führt in einem Schritt ins Kassenbuch — zu wählen sind
-Schuhkarton.
+nur Konto und Kategorie. Siehe [Kapitel 48](#48-buchen).
 ### Das KI-Protokoll
@@ -1704,7 +1706,422 @@ Datensatz, seit dem ersten Tag.
 ---
-## 47. Rollen und was sie dürfen
+## 47. Die Kasse
 Unter **Kasse** stehen alle Konten der Wehr mit ihrem heutigen Bestand.
 ![Kassenübersicht](screenshots/45-kasse-light.png)
 Drei Arten von Konten:
 | Art | Wofür |
 |---|---|
 | **Barkasse** | Die Kassette im Gerätehaus. Wechselgeld für Feste, Kleinausgaben. |
 | **Bankkonto** | Das Girokonto der Wehr. Mit IBAN, damit sich Kontoauszüge zuordnen lassen. |
 | **Rücklage** | Angespartes für eine Beschaffung. Wird nicht laufend bewegt. |
 **Der Bestand wird gerechnet, nicht gespeichert.** Anfangsbestand plus alle
 Buchungen. Wer nachträglich eine Buchung einträgt, sieht den Bestand sofort
 richtig — es gibt keinen zweiten Wert, der danebenläuft.
 ### Beim ersten Mal
 Steht die Kasse leer, bietet die Übersicht an, den **Standardkontenrahmen**
 anzulegen: rund zwanzig Kategorien, wie sie eine Feuerwehrkasse braucht —
 Kraftstoff, Reparatur, Schutzkleidung, Ausbildung, Verpflegung auf der einen
 Seite; Zuschüsse, Spenden, Mitgliedsbeiträge, Veranstaltungen, Kostenersatz
 auf der anderen.
 Sie lassen sich danach umbenennen, ergänzen und um eigene Unterkategorien
 erweitern. Wer eine eigene Gliederung hat, legt sie stattdessen von Hand an.
 ---
 ## 48. Buchen
 ![Kassenbuch](screenshots/46-kassenbuch-light.png)
 Oben stehen drei Summen: Einnahmen, Ausgaben, Saldo. Sie beziehen sich auf
 **alle** Treffer der eingestellten Auswahl, nicht nur auf die angezeigten
 Zeilen — eine Summe unter einer abgeschnittenen Liste bedeutete nichts.
 ### Eine Buchung erfassen
 Der Betrag ist immer positiv; ob es eine Einnahme oder eine Ausgabe ist, steht
 mit den beiden Knöpfen daneben. Eine „negative Ausgabe" gibt es nicht: sie
 wäre eine Einnahme in Verkleidung und in keiner Auswertung als solche zu
 erkennen.
 Sobald ein Verwendungszweck dasteht, schlägt FLORIAN eine Kategorie vor.
 Zuerst aus den **eigenen früheren Buchungen** der Wehr — steht darunter „zuletzt
 so gebucht", ist dieselbe Sache schon einmal so einsortiert worden. Erst wenn
 es dazu nichts gibt, greift eine Stichwortliste.
 Der Vorschlag ist ein Angebot, kein Automatismus: er wird erst übernommen,
 wenn er angeklickt wird. Und ist er unsicher, erscheint gar keiner. Ein
 falscher Vorschlag wäre schlechter als keiner — er wird übernommen, ohne
 gelesen zu werden.
 ### Entwurf und festgeschrieben
 Eine neue Buchung ist zunächst ein **Entwurf**. Sie lässt sich ändern und
 verwerfen, solange der Kassier sie durchsieht.
 Mit **Festschreiben** wird sie unveränderbar. Das ist der Zustand, den eine
 Kassenprüfung erwartet, und dahinter führt kein Weg zurück — auch nicht über
 einen Umweg, die Datenbank lehnt jede Änderung ab.
 Ein Schloss in der Zeile zeigt, welche Buchungen festgeschrieben sind.
 ### Einen Beleg buchen
 Wurde eine Quittung unter **Belege** fotografiert und gegengezeichnet, muss
 sie nicht noch einmal abgetippt werden. In der Liste der erledigten Belege
 steht dort ein Knopf **Buchen**.
 Zu wählen sind nur Konto und Kategorie — alles andere steht schon fest.
 Betrag, Datum und Händler kommen aus dem gegengezeichneten Beleg, und das
 Foto hängt danach an der Buchung. Das ist der Zustand, den eine
 Kassenprüfung erwartet: zu jeder Ausgabe ein Beleg, und zwar an der Buchung
 und nicht in einem Ordner daneben.
 Ein Beleg, der noch nicht gegengezeichnet ist, lässt sich nicht buchen. Er
 ist bis dahin ein von einer Maschine ausgefülltes Formular.
 ### Wenn etwas falsch war
 Bei einem Entwurf: ändern oder verwerfen.
 Bei einer festgeschriebenen Buchung: **Gegenbuchen**. Es entsteht eine zweite
 Buchung mit derselben Summe in die andere Richtung, mit Verweis auf die erste
 und mit dem eingegebenen Grund im Verwendungszweck. Beide bleiben stehen.
 Das sieht nach mehr Aufwand aus, als eine Zahl zu korrigieren, und ist genau
 der Punkt: eine verschwundene Buchung kann ein Kassenprüfer nicht prüfen. Eine
 berichtigte kann er nachvollziehen.
 Das Datum der Gegenbuchung ist immer **heute**. Läge es im geprüften Zeitraum,
 würde die Datenbank sie ablehnen — und das zu Recht.
 ---
 ## 49. Kontoauszug einlesen
 Statt fünfzig Umsätze abzutippen, lässt sich der Auszug aus dem Online-Banking
 einlesen. Zwei Formate:
 | Format | Datei |
 |---|---|
 | **CAMT.053** | `.xml` oder `.camt` |
 | **MT940** | `.txt` oder `.sta` |
 Beides bietet fast jedes Online-Banking zum Herunterladen an, meist unter
 „Umsatzexport" oder „Umsätze exportieren". Welches von beiden, spielt keine
 Rolle — FLORIAN erkennt es am Inhalt.
 ### Was dabei passiert — und was nicht
 Es entstehen **Entwürfe**, keine fertigen Buchungen. Jeder Posten muss danach
 noch durchgesehen und die Kategorie geprüft werden.
 Umsätze, die schon in der Kasse stehen, sind grau hinterlegt und mit „steht
 schon in der Kasse" gekennzeichnet. Sie sind nicht vorausgewählt. Das ist der
 eigentliche Wert der Sache: ein zweimal eingelesener Auszug wäre sonst ein
 doppelt gebuchter Monat, und der fällt erst beim Kassenabschluss auf — also
 drei Monate später.
 Umsätze, die nicht gelesen werden konnten, stehen mit Grund darüber. Sie
 verschwinden nicht stillschweigend.
 ---
 ## 50. Mitgliedsbeiträge
 ![Beiträge](screenshots/47-beitraege-light.png)
 ### Sätze
 Ein Beitragssatz gilt **ab einem Jahr** und wahlweise für eine Abteilung. Ein
 Satz ohne Abteilung gilt für alle, die keinen eigenen haben.
 Rückwirkend wird nichts geändert. Wer den Beitrag erhöht, legt einen neuen
 Satz ab dem kommenden Jahr an — sonst stimmten die Beiträge der vergangenen
 Jahre nicht mehr, und die sind bereits geprüft.
 ### Der Beitragslauf
 Einmal im Jahr, meist im Januar. Vorher zeigt FLORIAN, was entstehen wird:
 - wie viele Beiträge und über welche Summe
 - wie viele Mitglieder für dieses Jahr schon einen haben (die bleiben unberührt)
 - **wer keinen passenden Satz hat**
 Der letzte Punkt ist der wichtige. Das sind die Mitglieder, für die niemand
 entschieden hat, was sie zahlen — entweder fehlt ein Satz für ihre Abteilung
 oder es gibt keinen allgemeinen.
 Der Lauf lässt sich wiederholen. Wer im Februar drei Neue aufgenommen hat,
 startet ihn noch einmal; doppelt entsteht nichts.
 ### Zahlungen und Mahnungen
 Ein Zahlungseingang erzeugt zugleich die **Buchung** im Kassenbuch. Ein
 Häkchen ohne Geld in der Kasse wäre eine Behauptung.
 Gemahnt wird als Sammelaktion: die offenen Beiträge auswählen, mahnen. Die
 Mahnstufe zählt hoch. Ab der fünften Stufe hört FLORIAN auf — was danach
 kommt, entscheidet die Kommandantschaft und nicht die Software.
 Ein **Erlass** braucht eine Begründung. Ohne sie wird er nicht gespeichert:
 ein erlassener Beitrag ohne Grund ist in der Kassenprüfung eine offene Frage,
 und in fünf Jahren weiß es niemand mehr.
 ### Rückstände
 Ganz oben steht die Rückstandsliste über **alle Jahre**, nach Person
 gruppiert. Sie ist die einzige Ansicht, in der auffällt, wer seit drei Jahren
 offen steht — in der Jahresliste sieht das aus wie ein einzelner offener
 Beitrag.
 ---
 ## 51. Rechnungen an Dritte
 ![Rechnungen](screenshots/48-rechnungen-light.png)
 Kostenersatz nach Art. 28 BayFwG (Fehlalarm einer Brandmeldeanlage, Öleinsatz
 mit Verursacher), Vermietung des Schulungsraums, Absicherung einer
 Veranstaltung.
 ### Nummer und Betrag
 Die **Rechnungsnummer** vergibt FLORIAN fortlaufend je Jahr, lückenlos. Eine
 fehlende Nummer muss in der Kassenprüfung erklärt werden, deshalb wird auch
 eine stornierte Rechnung nicht gelöscht, sondern bleibt mit Grund stehen.
 Der **Betrag** ist die Summe der Positionen und wird nicht eingegeben. Ein von
 Hand eingetippter Gesamtbetrag neben Positionen, die etwas anderes ergeben,
 ist der Fehler, den niemand bemerkt, bis der Empfänger anruft.
 Die Menge hat drei Nachkommastellen: Einsatzstunden werden vielerorts
 viertelstündlich abgerechnet, und 0,25 × 47,50 € muss auf den Cent stimmen.
 ### Entwurf, versendet, bezahlt
 Bis zum **Versenden** ist eine Rechnung ein Entwurf und lässt sich vollständig
 ändern. Danach nicht mehr: was beim Empfänger liegt, muss dem entsprechen, was
 hier steht.
 Beim Versenden entsteht das PDF im Hintergrund. Es steht kurz darauf zum
 Herunterladen bereit.
 Der Zahlungseingang erzeugt — wie beim Beitrag — zugleich die Buchung. Wurde
 weniger überwiesen als berechnet, lässt sich der abweichende Betrag eintragen.
 Für eine Korrektur: stornieren und neu schreiben. Eine bezahlte Rechnung wird
 nicht storniert; dort ist zuerst die Buchung gegenzubuchen.
 ---
 ## 52. Kassenprüfung
 ![Kassenabschluss](screenshots/49-kassenabschluss-light.png)
 Einmal im Jahr, meist vor der Jahreshauptversammlung. Zwei Kassenprüfer zählen
 die Kasse und vergleichen mit dem Buch.
 ### Der Ablauf
 1. **Zeitraum wählen.** In der Regel das abgelaufene Kalenderjahr.
 2. **Zählen.** In der Maske stehen links die Bestände laut Buch und rechts
   leere Felder für das Gezählte. Die Reihenfolge ist Absicht: wer erst das
   Buch sieht und dann zählt, zählt, bis es passt.
 3. **Differenz erklären**, falls eine bleibt.
 4. **Prüfer und Prüfdatum eintragen.**
 5. **Festschreiben.**
 Steht ein Hinweis auf noch nicht festgeschriebene Buchungen im Zeitraum: erst
 durchsehen. Das Festschreiben des Abschlusses nimmt sie mit.
 ### Was das Festschreiben bewirkt
 Der Zeitraum ist danach **zu**. Es lässt sich keine Buchung mehr mit einem
 Datum darin anlegen, und keine vorhandene mehr dorthin verschieben. Wer nach
 der Prüfung noch eine Quittung findet, bucht sie mit dem heutigen Datum.
 Der Abschluss selbst ist ebenfalls unveränderbar — Zahlen, Prüfer und
 Erläuterung stehen fest. Nachgetragen wird nur der Prüfbericht, weil das PDF
 im Hintergrund entsteht.
 Ohne Prüfer und Prüfdatum lässt sich nichts festschreiben: ohne beides ist es
 kein Abschluss, sondern eine Notiz. Und eine Differenz ohne Erläuterung
 ebenfalls nicht — sonst steht in fünf Jahren „stimmt nicht" im Bericht und
 niemand weiß mehr, warum.
 ### Der Prüfbericht
 Entsteht als PDF mit vier Unterschriftsfeldern: beide Prüfer, der Kassier und
 der Kommandant. Er lässt sich ausdrucken, unterschreiben und abheften — die
 Papierform bleibt für die Entlastung in der Versammlung die maßgebliche.
 ---
 ## 53. Auswertungen und Export
 Unter **Kasse → Abschluss → Auswertung** stehen die Zahlen für die
 Jahreshauptversammlung:
 - Einnahmen und Ausgaben je Kategorie, absteigend nach Betrag
 - der Verlauf über zwölf Monate
 - das Vorjahr daneben — eine Zahl ohne Vergleich sagt nichts
 Das ist die Ansicht, in der auffällt, dass sich die Kraftstoffkosten verdoppelt
 haben.
 ### Export
 **Kassenbuch als CSV** lädt alle Buchungen eines Jahres herunter: Datum,
 Konto, Richtung, Betrag, Ober- und Unterkategorie, Kontonummer,
 Verwendungszweck, Belegnummer, Gegenüber und ob festgeschrieben.
 Die Datei ist für den Steuerberater oder die Kämmerei gedacht und öffnet in
 Excel ohne Rückfrage richtig: Semikolon als Trennzeichen, Komma als
 Dezimaltrennzeichen, UTF-8 mit Kennung.
 ---
 ## 54. Mehrere Wehren auf einem Server
 Ein FLORIAN kann mehrere Wehren führen — eine Gemeinde mit drei Ortswehren,
 ein Landkreis mit zwanzig. Die Wehren sehen einander dabei **nicht**. Jede
 Abfrage ist an eine Wehr gebunden, und zwar in der Datenbank selbst, nicht im
 Programm.
 ### Konto und Personenakte
 Zwei verschiedene Dinge, und der Unterschied ist der Kern dieses Kapitels:
 | | Was es ist |
 |---|---|
 | **Konto** | Womit Sie sich anmelden. E-Mail und Passwort. Gehört keiner Wehr. |
 | **Personenakte** | Ihr Eintrag in einer Wehr: Dienstgrad, Qualifikationen, Einsätze. |
 | **Zuordnung** | Verbindet beides — je Wehr eine. |
 Wer nur zu einer Wehr gehört, merkt davon nichts: ein Konto, eine Akte, eine
 Zuordnung, und alles sieht aus wie vorher.
 Wer zu **zwei** Wehren gehört — aktiv in der einen, Ehrenmitglied in der
 anderen —, hat trotzdem nur **ein** Passwort. Zwei Akten, ein Konto.
 ### Die Wehr wechseln
 Steht Ihr Konto bei mehreren Wehren, wird der Name der Wehr in der
 Seitenleiste zu einem Auswahlfeld. Ein Klick darauf, und alle Wehren stehen
 untereinander — mit dem Hinweis, ob Sie dort Mitglied oder Kreisaufsicht sind.
 Nach der Anmeldung sind Sie immer in **Ihrer eigenen** Wehr, nicht in einer
 betreuten.
 Nach dem Wechsel wird alles neu geladen. Was Sie danach sehen, gehört zur
 neuen Wehr — es gibt keinen Zustand, in dem Daten der einen unter dem Namen
 der anderen stehen.
 ---
 ## 55. Kreisbrandrat und Kreisbrandinspektion
 Die Kreisebene bekommt Zugang zu den betreuten Wehren, ohne ihnen anzugehören.
 **Sie sieht und ändert nichts.** Das ist keine Einstellung, die jemand
 versehentlich anders setzen kann: eine Aufsichtszuordnung bekommt genau die
 Leserechte und keines der Schreibrechte, und zwar automatisch auch für Module,
 die es noch gar nicht gibt.
 Wer als Aufsicht in einer Wehr unterwegs ist, sieht das durchgehend als Zeile
 über der Ansicht.
 ### Was die Aufsicht sieht
 Mitglieder, Fahrzeuge, Geräte, Prüfungen, Atemschutz, Einsätze, Übungen,
 Qualifikationen, Termine, Wiki, Karte.
 Der **Atemschutz** ist dabei der wichtigste Punkt: ob ein Träger tauglich ist,
 ist genau die Frage, für die es eine Kreisebene gibt.
 ### Was sie nicht sieht
 | | Warum |
 |---|---|
 | **Kasse** | Sie gehört dem Verein oder der Kommune, nicht der Kreisaufsicht. |
 | **Protokoll** | Wer wann was getan hat, bleibt innerhalb der Wehr. |
 | **KI-Protokoll** | Dasselbe. |
 | **Personenexport nach DSGVO** | Das Auskunftsrecht erfüllt die Wehr, die die Daten führt. |
 ### Sie taucht in keiner Mitgliederliste auf
 Die Aufsicht hat in der betreuten Wehr **keine Personenakte**. Sie ist also
 kein Mitglied, erscheint in keiner Liste, in keiner Stärkemeldung und in
 keiner Anwesenheit — und kann als Urheber einer Änderung auch gar nicht
 eingetragen werden, weil sie keine macht.
 Ist der Kreisbrandinspektor zugleich Kommandant seiner Heimatwehr, hat er dort
 ganz normal seine Akte und seine Rollen. Es sind zwei Zuordnungen desselben
 Kontos, mehr nicht.
 ---
 ## 56. Wehren und Konten verwalten
 Unter **Wehren und Konten**. Der Menüpunkt erscheint nur für den, der die
 Installation betreibt — nicht für Kommandanten, auch nicht für
 Administratoren einer einzelnen Wehr.
 > Dieses Merkmal hebt die Trennung zwischen den Wehren auf. Es gehört an so
 > wenige Konten wie möglich, im Regelfall an eines.
 ### Eine Wehr anlegen
 Vollständiger Name, Kurzname und eine **Kennung**. Die Kennung steht später
 im Terminal und in Dateipfaden und lässt sich nicht mehr ändern — also mit
 Bedacht wählen: Kleinbuchstaben, Ziffern, Bindestriche, etwa
 `ff-musterhausen`.
 Die neue Wehr bekommt sofort ihre Rollen samt Rechten. Ein Konto bekommt sie
 nicht: das ist der zweite Schritt.
 ### Ein Konto anlegen
 E-Mail-Adresse und ein erstes Passwort. Die Adresse gilt über alle Wehren
 hinweg und ist damit die Anmeldung.
 Das Passwort steht im Klartext da, damit Sie es weitergeben können — FLORIAN
 verschickt keines. Es gehört nach der ersten Anmeldung geändert.
 Gibt es zu der Adresse schon ein Konto, sagt FLORIAN das und legt **kein
 zweites** an. Wenn diese Person zu einer weiteren Wehr gehören soll, bekommt
 sie eine weitere Zuordnung — genau dafür ist die Trennung da.
 ### Zuordnen
 Konto wählen, **Wehr zuordnen**, dann:
 - **Mitglied** — zusätzlich die Personenakte in dieser Wehr wählen. Zur
  Auswahl steht, wer noch kein Konto hat: eine Akte gehört zu höchstens einem,
  sonst wäre nicht entscheidbar, wer unter ihrem Namen gehandelt hat.
 - **Kreisaufsicht** — keine Akte, nur Leserechte.
 Jede Zuordnung wird **in der betroffenen Wehr** protokolliert. Dort steht also
 nachlesbar, dass jemand von außen Zugang bekommen hat.
 ### Eine Zuordnung beenden
 Über das Papierkorb-Symbol. Die Personenakte in der Wehr bleibt bestehen —
 entfernt wird nur der Zugang. Wer ausgetreten ist, wird in der Mitgliederliste
 ausgetragen, nicht hier.
 ---
 ## 57. Rollen und was sie dürfen
 Neun Rollen, jede mit einem festen Satz Rechte. Die Zuordnung steht zentral in
 `src/lib/authz.ts` und wird beim Seed in die Datenbank gespiegelt — eine Wehr
@@ -1716,10 +2133,11 @@ kann sie also nachträglich zuschneiden, ohne dass jemand Code ändert.
 | **Kommandant** | alles innerhalb der eigenen Wehr, einschließlich Rollen vergeben und Protokoll einsehen |
 | **Gerätewart** | Fahrzeuge und Geräte anlegen, ändern, aussondern; Prüfungen planen und durchführen |
 | **Atemschutzgerätewart** | zusätzlich Atemschutzgeräte, Träger und die Überwachung nach FwDV 7 |
-| **Kassier** | Buchungen und Kassenabschluss (Modul in Phase 9), Belege erfassen und gegenzeichnen |
+| **Kassier** | Kassenbuch, Beiträge, Rechnungen und Kassenabschluss; Belege erfassen und gegenzeichnen |
 | **Schriftführer** | Mitglieder pflegen, Einsätze und Berichte erfassen, den Terminkalender führen |
 | **Ausbilder** | Übungen und Übungstermine planen, Teilnahme, Anwesenheit und Qualifikationen erfassen |
 | **Mitglied** | eigene Daten, Listen lesen, Termine sehen und sich zurückmelden, eigene Benachrichtigungswege einrichten, im Wiki lesen |
 | **Kreisebene** | sieht die betreuten Wehren, ändert nichts — siehe [Kapitel 55](#55-kreisbrandrat-und-kreisbrandinspektion) |
 | **Terminal** | nur anmelden und erfassen — nie verwalten |
 Zwei Dinge sind bewusst so gebaut:
@@ -1738,7 +2156,7 @@ sind nur die Textvorlagen, und die hängen an einem eigenen Recht.
 ---
-## 48. Anmeldung über authentik einrichten
+## 58. Anmeldung über authentik einrichten
 authentik läuft **getrennt** von FLORIAN und ist nicht Teil dieses Stacks.
@@ -1791,7 +2209,7 @@ ganze Wehr aus.
 ---
-## 49. PIN und Ausweiskarte verwalten
+## 59. PIN und Ausweiskarte verwalten
 Wie sich am Terminal angemeldet wird, steht in Kapitel 24. Hier geht es darum,
 was dahinter liegt.
@@ -1814,7 +2232,7 @@ Huber), PIN `471203`.
 ---
-## 50. Was protokolliert wird
+## 60. Was protokolliert wird
 Jede schreibende Änderung erzeugt einen Eintrag mit Zeitpunkt, Person,
 betroffenem Datensatz und den geänderten Feldern im Vorher-Nachher-Vergleich.
@@ -1839,7 +2257,124 @@ jeweiligen Detailseite sichtbar.
 ---
-## 51. Wenn etwas nicht geht
+## 61. Wenn jemand Auskunft über seine Daten verlangt
 Jede Person darf verlangen zu erfahren, welche Daten über sie verarbeitet
 werden — Art. 15 DSGVO. Die Anfrage muss **innerhalb eines Monats** beantwortet
 werden, und sie ist kostenlos.
 ### So geht es
 1. **Mitglieder** öffnen, die Person anklicken.
 2. Rechts oben auf **Datenauskunft**.
 3. **Auskunft erstellen**.
 Danach stehen drei Dinge bereit:
 | | Wofür |
 |---|---|
 | **Die Anzeige** | Was ausgehändigt wird — vor dem Aushändigen |
 | **PDF** | Das Schreiben an die Person. Ausdrucken oder als Datei geben |
 | **JSON** | Nur, wenn die Person die Daten maschinenlesbar verlangt (Art. 20) |
 Das Recht dazu heißt `person.export` und liegt bei Kommandant und
 Administrator.
 ### Was drinsteht
 Dreizehn Abschnitte: Stammdaten, Zugang, Rollen, Qualifikationen,
 arbeitsmedizinische Vorsorge, Belastungsübungen, Einsatz- und
 Übungsbeteiligung, Anwesenheiten, Fahrten, Beiträge, Benachrichtigungswege,
 Ausweise.
 Über jedem steht, **wozu** diese Daten vorliegen. Das ist kein Beiwerk: Art. 15
 verlangt neben den Daten auch die Zwecke und den Hinweis auf die weiteren
 Rechte. Eine bloße Liste erfüllt die Auskunftspflicht nicht.
 **Auch das Unangenehme steht drin** — ein gemahnter Beitrag, eine nicht
 bestandene G26. Eine Auskunft, die auswählt, was gut aussieht, ist keine.
 **Leere Abschnitte bleiben stehen.** „Dazu liegen keine Daten vor" ist eine
 Auskunft.
 **Gesundheitsdaten sind gekennzeichnet.** G26 und Belastungsübungen sind eine
 besondere Kategorie nach Art. 9 — das steht im Bericht ausdrücklich dabei.
 ### Was nicht drinsteht
 Was die Person **getan** hat, erscheint nur als Zahl: „12 durchgeführte
 Prüfungen", „3 gemeldete Mängel".
 Das ist Absicht. Die Prüfprotokolle selbst gehören zum Nachweisbestand der
 Feuerwehr und nicht zu den personenbezogenen Daten eines Mitglieds. Würden sie
 mitgeliefert, käme jeder über eine Selbstauskunft an die kompletten
 Geräteakten — die Auskunftspflicht wäre eine Hintertür.
 ### Der Vorgang wird protokolliert
 Dass eine Auskunft erteilt wurde, steht danach unter **Protokoll**. Das ist
 richtig so: die Auskunft legt alles offen, was über einen Menschen gespeichert
 ist, einschließlich seiner Gesundheitsdaten. Wer sie erstellt hat und wann,
 gehört festgehalten.
 ### Wenn die Person in zwei Wehren geführt wird
 Dann gibt es **zwei** Auskünfte, eine je Wehr. Das ist kein Versehen: jede Wehr
 ist eine eigene Verantwortliche im Sinne der Verordnung und kann nur über die
 Daten Auskunft geben, die sie selbst führt.
 ---
 ## 62. Sicherung und Wiederherstellung
 > **Der wichtigste Satz dieses Kapitels:** Eine Sicherung, die nie
 > zurückgespielt wurde, ist eine Vermutung.
 ### Sichern
 ```bash
 npm run sicherung
 npm run sicherung -- --ziel D:\backups
 ```
 Gesichert wird die Datenbank **und** der Dateispeicher — Prüfprotokolle,
 Einsatzberichte, Fotos, Rechnungen. Beides aus demselben Moment: eine
 Datenbank von heute mit Dateien von gestern ergibt Einträge, die auf nichts
 zeigen.
 Das Ergebnis ist ein Verzeichnis mit Zeitstempel. Es gehört auf ein anderes
 Gerät — eine Sicherung auf derselben Festplatte hilft gegen einen
 Festplattenfehler nicht.
 ### Zurückspielen
 ```bash
 npm run wiederherstellen -- --quelle sicherungen/2026-09-05T14-16-48
 ```
 So passiert **nichts**. Es wird nur angezeigt, aus welchem Moment die
 Sicherung stammt und wie groß sie ist. Erst mit `--wirklich` am Ende wird
 zurückgespielt — und dabei **der gesamte vorhandene Bestand überschrieben**.
 ### Einmal im Jahr proben
 Nicht im Notfall zum ersten Mal. Der Ordner kann leer sein, der Auszug
 abgeschnitten, das Passwort falsch — man erfährt es sonst an dem Tag, an dem
 man es nicht erfahren will.
 Nach dem Zurückspielen prüft das Skript selbst nach, ob die Schutzsperren der
 Datenbank wieder stehen. Drei Handgriffe bleiben trotzdem:
 1. **Anmelden** — kommt jemand hinein?
 2. **Ein Prüfprotokoll öffnen** — ist das PDF da?
 3. **Die Mitgliederzahl** mit der Erwartung vergleichen.
 Erst danach gilt die Sicherung als geprüft. Das Datum der letzten geglückten
 Probe gehört ins Sicherungskonzept.
 ---
 ## 63. Wenn etwas nicht geht
 | Beobachtung | Wahrscheinliche Ursache | Was hilft |
 |---|---|---|
@@ -39,8 +39,10 @@ Faktoren, die in die Schätzung eingehen:
 | 6 | Kartenmodule | 14–18 PT | 3,5–4,5 h | **2:50 h** |
 | 7 | Benachrichtigungen und Termine | 10–13 PT | 2,5–3,5 h | **3:10 h** |
 | 8 | Lokale KI | 9–12 PT | 2,5–3 h | **3:40 h** |
-| 9 | Kassenverwaltung | 8–11 PT | 2–3 h | offen |
+| 9 | Kassenverwaltung | 8–11 PT | 2–3 h | **4:10 h** |
-| | **Summe** | **123–164 PT** | **28–37 h** | |
+| 10 | Mandantenfähigkeit | 4–6 PT | 1–1,5 h | **4:20 h** |
 | 11 | Freigabereife | 5–7 PT | 1,5–2 h | **2:40 h** |
 | | **Summe** | **132–177 PT** | **30,5–40,5 h** | **35:30 h** |
 123–164 Personentage entsprechen etwa **6 bis 8 Monaten Vollzeitarbeit** einer
 einzelnen Person. Zum Vergleich: eine kommerzielle Feuerwehrverwaltung kostet
@@ -422,6 +424,41 @@ Die Unveränderlichkeit festgeschriebener Buchungen kostet hier fast nichts —
 das Muster steht seit Phase 0 mit dem Audit-Log-Trigger und lässt sich
 übernehmen.
 **Tatsächlich: 4:10 h** — die längste Phase bisher. Beide Schätzungen oben
 haben sich bestätigt und zugleich verschoben: MT940 kostete weniger als
 gedacht, weil beide Formate ohne Fremdbibliothek auskommen. Dafür war die
 Unveränderlichkeit nicht das Übernehmen eines Musters, sondern drei
 Trigger mit drei genau begründeten Ausnahmen — und die Ausnahmen sind der
 Teil, der Zeit gekostet hat. Zwei davon sind erst im Test aufgefallen:
 der Prüfbericht, der nach dem Festschreiben entsteht, und die
 DSGVO-Löschung einer Wehr, die an ihren eigenen festgeschriebenen Buchungen
 scheiterte.
 ## Phase 10 — Mandantenfähigkeit
 **Vergleichsaufwand: 4–6 PT** — aus der Kandidatenliste vorgezogen, am
 05.09.2026 umgesetzt.
 | Baustein | PT |
 |---|---:|
 | `Benutzer` und `Mitgliedschaft`, datenerhaltende Umstellung | 1,5 |
 | Anmeldung: Konto statt Akte, Wehrwechsel im Sitzungstoken | 1,5 |
 | Kreisebene mit reinen Leserechten | 1,0 |
 | Wehrwähler und Verwaltung der Installation | 1,5 |
 Die Schätzung ging von „technisch bereits möglich, Oberfläche fehlt" aus —
 und das war zur Hälfte falsch. Datenmodell und RLS trugen tatsächlich mehrere
 Wehren, aber die Anmeldung nicht: Passwort und OIDC-Subject hingen an der
 Personenakte, und die gehört genau einer Wehr. Das war kein Oberflächenthema,
 sondern ein Umbau am Fundament.
 **Tatsächlich: 4:20 h.** Getragen hat eine Entscheidung ganz am Anfang: die
 Sitzung behält ihre Form und entsteht nur anders. Ohne sie wären 61 Dateien
 mit 414 Fundstellen zu ändern gewesen; so waren es acht. Die Zeit ging
 stattdessen in die Absicherung — zwei Trigger, vier CHECKs und elf
 Datenbanktests — und das ist die richtige Verteilung für eine Phase, deren
 einziger Zweck es ist, dass eine Wehr die andere nicht sieht.
 ---
 ## Was hier nicht drin ist
@@ -20,7 +20,465 @@ Die aufgewendete Zeit wandert nach jedem Abschnitt in die Spalte
 | Phase 6 — Kartenmodule | 2:50 h | 1 | 04.09.2026 |
 | Phase 7 — Benachrichtigungen und Termine | 3:10 h | 1 | 04.09.2026 |
 | Phase 8 — Lokale KI | 3:40 h | 1 | 04.09.2026 |
-| **Summe** | **23:00 h** | **10** | |
+| Aufräumarbeiten (Issues #10–#12) | 1:20 h | 1 | 04.09.2026 |
 | Phase 9 — Kassenverwaltung | 4:10 h | 1 | 04.09.2026 |
 | Phase 10 — Mandantenfähigkeit | 4:20 h | 1 | 05.09.2026 |
 | Phase 11 — Freigabereife | 2:40 h | 1 | 05.09.2026 |
 | 1.0.0 — Freigabe | 0:50 h | 1 | 06.09.2026 |
 | **Summe** | **36:20 h** | **15** | |
 ---
 ## 2026-09-06 · 1.0.0 — Freigabe
 **09:20 – 10:10 · 0:50 h · Version 1.0.0**
 ### Was entstanden ist
 Kein Modul. Zwei Dinge, die zum Betrieb gehören, und eine Entscheidung.
 | Was | Wofür |
 |---|---|
 | `update.sh` | Aktualisieren auf einem Linux-Server, in einem Befehl |
 | `docs/KURZANLEITUNG.md` | Der Einstieg für die Wehr, nach Rollen sortiert |
 | Version 1.0.0 | Ab hier semantische Versionierung |
 ### Entscheidungen
 **Das Update-Skript sichert, bevor es irgendetwas anfasst.** Ein Update ist
 der häufigste Anlass, eine Sicherung zu brauchen — und der Moment, in dem
 niemand daran denkt. `--ohne-sicherung` gibt es, aber mit einer Warnung und
 nicht als Vorgabe.
 **Die Reihenfolge ist so gewählt, dass ein Abbruch harmlos bleibt.** Holen und
 Bauen passieren, bevor umgeschaltet wird: schlägt der Bau fehl, läuft die alte
 Fassung unverändert weiter. Erst danach wird umgeschaltet, und ab da nennt die
 Fehlerbehandlung die Befehle für den Rückweg.
 **Die Kurzanleitung ist aufgabenorientiert, nicht modulorientiert.** Die große
 Anleitung hat 63 Kapitel und ist nach Funktionsbereichen sortiert — richtig
 zum Nachschlagen, unbrauchbar zum Anfangen. Die Kurzanleitung fragt stattdessen
 „was willst du tun": ein Gerät prüfen, einen Kontoauszug einlesen, einen
 Termin absagen.
 **Sie erklärt bei jedem heiklen Punkt das Warum.** Warum ein abgeschlossenes
 Prüfprotokoll nicht änderbar ist, warum gegengebucht statt korrigiert wird,
 warum der Atemschutzhinweis stehen bleibt. Wer den Grund kennt, sucht nicht
 nach dem Weg drumherum.
 **Die Roadmap hakt nicht alles ab.** Zwei Freigabevoraussetzungen sind
 organisatorisch und stehen aus — die Abnahme des Löschkonzepts und die
 Schulung. Sie stehen mit ihrem Stand dort, statt stillschweigend als erledigt
 zu gelten. Eine Freigabe, die abhakt, was nicht geprüft wurde, ist keine.
 ### Wo es gehakt hat
 **Die Ursache der Testflackerei gefunden — nach elf Phasen.**
 Beim abschließenden Durchlauf fielen wieder einmal fünf, dann sechs, dann ein
 Test aus, in wechselnder Besetzung. Dieses Mal habe ich nicht weitergemacht,
 sondern fünf Läufe hintereinander mitgeschrieben: betroffen waren immer
 Zusicherungen über Trigger — „Wiki-Fassungen bleiben", „Mandantentrennung",
 „abgeschlossene Prüfprotokolle".
 `ki-datenbank.test.ts` und `atemschutz-datenbank.test.ts` schalteten beim
 Aufräumen ihre Trigger mit `ALTER TABLE ... DISABLE TRIGGER USER` ab. Das ist
 eine Schemaänderung: sie gilt für die ganze Datenbank und für alle. Vitest
 fährt die Testdateien parallel — während also die eine Datei abräumte, prüfte
 die andere gerade, dass genau dieser Trigger greift, und sah keinen.
 `SET LOCAL session_replication_role = 'replica'` bewirkt dasselbe, aber nur in
 der eigenen Transaktion. Danach: fünf Läufe hintereinander 601 grün.
 Rückwirkend erklärt das eine Reihe von Ausfällen, die ich als Flackern
 abgetan habe — sie waren keines. Die Lehre ist unbequem: „läuft einzeln durch,
 also Umgebung" ist eine bequeme Erklärung und oft die falsche.
 | Weiteres | Ursache | Lösung |
 |---|---|---|
 | Ein Datenbanktest ließ sich nur einmal ausführen | `mandanten-datenbank.test.ts` räumte nur am Ende auf; ein abgebrochener Lauf legte den nächsten lahm | Räumt jetzt auch am Anfang auf — dasselbe Muster wie in Phase 10 bei `ki-datenbank` |
 ### Abweichung von der Vorgabe
 **`update.sh` ist nicht auf einem Linux-Server erprobt.** Entwickelt wurde
 unter Windows; geprüft sind die Syntax (`bash -n`), die Hilfe, die
 Argumentbehandlung und der Wächter gegen unverbuchte Änderungen — alles unter
 Git Bash. Der eigentliche Ablauf (fetch, build, up, Gesundheitsprüfung) läuft
 erst dort, wo FLORIAN wirklich steht.
 Das ist keine Nachlässigkeit, sondern die Grenze dieser Umgebung. Beim ersten
 echten Update gehört `./update.sh --pruefen` vorangestellt: es holt nichts und
 ändert nichts, zeigt aber, ob Docker, git und die `.env` gefunden werden.
 ### Nachweise
 - `npm run typecheck` — ohne Ausgabe
 - `npm run lint` — ohne Befund
 - `npm run test` — 601 Tests grün
 - `bash -n update.sh` — Syntax in Ordnung
 - `./update.sh --help` und `--quatsch` — Ausgabe und Ablehnung wie vorgesehen
 - Der Wächter gegen unverbuchte Änderungen greift (an einem schmutzigen
  Arbeitsverzeichnis geprüft)
 - Alle acht Bilder der Kurzanleitung existieren
 - `npm run test` **fünfmal hintereinander** — jedes Mal 601 grün. Das war
  nach elf Phasen der erste Lauf, bei dem ich das behaupten kann
 - `npm run test:e2e` — **268 grün, kein Fehlschlag, kein Flackern.** Ebenfalls
  der erste vollständig saubere Durchlauf in diesem Projekt
 - `npm run build` — sauber
 ---
 ## 2026-09-05 · Phase 11 — Freigabereife
 **14:30 – 17:10 · 2:40 h · Version 0.12.0**
 ### Was entstanden ist
 Kein Modul, sondern die drei Software-Voraussetzungen für 1.0.0.
 | Bereich | Umfang |
 |---|---|
 | Auskunft | `lib/dsgvo/auskunft.ts` und `bericht.ts`, `person.auskunft`, Dialog auf der Mitgliederseite |
 | Sicherung | `scripts/sicherung.ts`, `wiederherstellen.ts`, `sicherung-zugang.ts`, `sicherung-sperren.ts` |
 | Pipeline | `.gitea/workflows/pruefung.yml` mit zwei Aufträgen |
 | Tests | 18 neue: 9 gegen die Auskunft, 11 gegen die Sicherung |
 ### Entscheidungen
 **Die Auskunft trennt „über mich" von „von mir".** Was über die Person
 gespeichert ist, steht vollständig drin — auch der gemahnte Beitrag und die
 nicht bestandene G26. Was die Person *getan* hat, steht als Zahl drin. Die
 zwölf Prüfprotokolle, die sie unterschrieben hat, gehören zum Nachweisbestand
 der Wehr; vollständig ausgeliefert käme jeder über eine Selbstauskunft an die
 Geräteakten, und die Auskunftspflicht wäre eine Hintertür.
 **Über jedem Abschnitt steht der Zweck.** Art. 15 Abs. 1 verlangt nicht nur
 die Daten, sondern auch Zwecke, Empfänger und den Hinweis auf die weiteren
 Rechte. Eine Liste ohne das sieht aus wie eine Auskunft und ist keine — das ist
 der Unterschied zwischen einem Datenbankexport und einem Schreiben an einen
 Menschen.
 **Eine Mutation, keine Abfrage.** Das Erstellen der Auskunft *ist* die
 Offenlegung, und die gehört ins Protokoll. Als Abfrage würde sie
 zwischengespeichert und mehrfach ausgeführt — sie wäre entweder nicht oder
 zwanzigmal vermerkt.
 **Sicherung und Wiederherstellung gehören zusammen.** Deshalb sind es zwei
 Skripte in einem Zug und nicht eines. Der Probelauf ist die Vorgabe; ohne
 `--wirklich` geschieht nichts.
 **Eine Liste, zwei Verwendungen.** `sicherung-sperren.ts` treibt sowohl das
 Wiederherstellen der Sperren als auch deren Prüfung. Zwei Listen wären zwei
 Wahrheiten, und die falsche fiele erst im Notfall auf.
 **Die Pipeline baut das eigene Postgres-Image.** Ein Dienst-Container mit
 `postgres:17` ließe die Migrationen durchlaufen und scheiterte erst bei der
 ersten Umkreissuche — die Pipeline prüfte dann etwas anderes als den Betrieb.
 ### Wo es gehakt hat
 | Problem | Ursache | Lösung |
 |---|---|---|
 | **Eine Wiederherstellung entfernte alle Unveränderlichkeitsgarantien** | Zuerst `--no-acl` im Dump. Und selbst ohne das Flag greift beim Zurückspielen die Vorgabeprivilegierung aus dem Init-Skript: jede von `pg_restore` neu angelegte Tabelle bekommt alle Rechte, und `GRANT` kann nur hinzufügen | Das Skript setzt die Sperren nach dem Zurückspielen neu und prüft danach nach. Gefunden haben es vier Datenbanktests direkt nach der ersten Rückspielprobe |
 | `pg_dump` lehnte die Verbindungszeichenkette ab | Prisma hängt `?schema=public` an — „invalid URI query parameter" | Die URL wird zerlegt, Benutzer und Datenbank gehen als Flags, das Passwort über `PGPASSWORD` |
 | Feldnamen im Auskunftssammler stimmten reihenweise nicht | Aus dem Gedächtnis geschrieben statt aus dem Schema gelesen: `alarmierung` statt `alarmiertUm`, `beginn` statt `beginnUm`, `gemeldetVonId` statt `melderId` | Der Typechecker hat sie alle einzeln benannt — zehn Durchgänge, jeder eine Zeile |
 | Ein eigener Test war falsch, nicht der Code | `new URL("localhost:5432")` gelingt in Node: „localhost:" gilt als Protokoll | Die Zusicherung prüft jetzt, was wirklich greift — die Protokollprüfung eine Zeile später |
 | Ein Vorlagentest fiel im vollen Lauf aus | Er klickte auf „Speichern“, bevor React lief — dann verschickt das Formular sich selbst, und die Fehlerfläche entsteht nie. Unter Last dauert das Hydrieren länger. Dasselbe Muster wie beim Anmeldeskript in Phase 8 | Er wartet jetzt auf einen client-seitig erzeugten Knopf, bevor er klickt |
 ### Abweichung von der Vorgabe
 **Die Pipeline ist nicht erprobt.** Sie ist geschrieben und syntaktisch
 geprüft, aber in Gitea war zum Zeitpunkt dieser Phase kein `act_runner`
 registriert. Ohne Runner erscheinen die Läufe als „wartend" und laufen nie.
 Ob der Ablauf durchläuft, zeigt sich erst, wenn einer eingerichtet ist — das
 steht so auch im README, damit niemand sich auf eine Prüfung verlässt, die
 nicht stattfindet.
 ### Nachweise
 - `npm run typecheck` — ohne Ausgabe
 - `npm run lint` — ohne Befund
 - `npm run test` — 599 Tests grün, davon 18 neu
 - Auskunft von Hand erzeugt: 13 Abschnitte, 28 Angaben, 58 kB PDF
 - **Sicherung und Wiederherstellung vollständig durchgeführt**: ein nach der
  Sicherung angelegter Datensatz war danach weg, alle Zahlen stimmten wieder,
  und die 599 Tests liefen nach dem Zurückspielen grün — einschließlich derer,
  die die Sperren prüfen
 ---
 ## 2026-09-05 · Phase 10 — Mandantenfähigkeit
 **08:10 – 12:30 · 4:20 h · Version 0.11.0**
 ### Was entstanden ist
 Die einzige Phase bisher, die die Anmeldung selbst anfasst.
 | Bereich | Umfang |
 |---|---|
 | Datenmodell | `Benutzer`, `Mitgliedschaft`, `MitgliedschaftArt`; `Person` verliert die Anmeldefelder |
 | Absicherung | RLS für `mitgliedschaft`, zwei Trigger, vier CHECKs, ein REVOKE |
 | Anmeldung | `lib/auth.ts` neu: Konto statt Akte, Mitgliedschaftswahl, Wehrwechsel im Token |
 | Rechte | Rolle `AUFSICHT`, gefiltert statt aufgezählt; `istVerwalter` als Kontomerkmal |
 | Oberfläche | Wehrwähler, Aufsichtshinweis, `/wehren` zur Verwaltung |
 | Tests | 19 neue Unit-Tests (11 gegen die Datenbank), 13 E2E-Tests |
 ### Entscheidungen
 **Die Sitzung behält ihre Form.** `sitzung.organisationId` und
 `sitzung.personId` werden an 329 bzw. 85 Stellen in 61 Dateien gelesen. Hätte
 sich ihre Bedeutung geändert, wäre das ein Umbau durch das halbe Projekt
 geworden. Stattdessen entsteht die Sitzung nur *anders* — aus der aktiven
 Mitgliedschaft statt aus der Person. Keine dieser 61 Dateien musste angefasst
 werden.
 **`personId` ist nullbar geworden.** Das war die eine Ausnahme davon, und zwar
 absichtlich: eine Aufsichtssitzung hat keine Akte. Der Typechecker hat daraus
 eine Liste gemacht — genau fünf Stellen verlangen eine Person, und alle fünf
 sind Dinge, an denen die Kreisaufsicht nichts verloren hat (Anmeldemarke,
 Dienstausweis, Prüfungswizard, Dateiupload, Atemschutz). Ein `?? ""` hätte
 dieselben fünf Stellen still passieren lassen.
 **`Benutzer` ohne `organisationId`.** Die zweite Ausnahme von der
 Architekturregel nach `Berechtigung` — und dieselbe Begründung: die Tabelle
 steht über allen Mandanten, weil sie der Angelpunkt ist, an dem ein Mensch zu
 mehreren Wehren gehört. Geschützt über Rechte statt RLS.
 **`AUFSICHT` steht nicht im Prisma-Enum.** Alle anderen Rollen werden einem
 Menschen in einer Wehr zugewiesen. Diese ergibt sich aus der Mitgliedschaftsart.
 Sie vergebbar zu machen hiesse, dass jemand innerhalb einer Wehr Rechte an
 einer anderen verteilen könnte.
 **Ihre Rechte werden gefiltert, nicht aufgezählt.** Alles, was `.lesen` heißt,
 minus vier ausdrückliche Ausnahmen. Eine Liste von Hand wäre bei Phase 11
 veraltet, und zwar unbemerkt — ein neues Modul brächte Rechte mit, die niemand
 nachträgt. So bekommt die Aufsicht neue Leserechte automatisch und neue
 Schreibrechte nie. Der Test dazu ist entsprechend formuliert: nicht „diese
 dreizehn Rechte", sondern „kein einziges, das nicht lesen heißt".
 **Die Kasse ist ausgenommen**, obwohl `kasse.lesen` auf `.lesen` endet. Sie
 gehört dem Verein oder der Kommune, nicht der Kreisaufsicht. Sie wäre nur
 deshalb dabei gewesen, weil das Recht zufällig richtig heißt — und genau
 dagegen ist die Ausnahmeliste da.
 **Die Migration ist datenerhaltend, mit Abbruchprüfung.** Konten und
 Zuordnungen entstehen, *bevor* die alten Spalten fallen; am Ende prüft ein
 `DO`-Block, dass keine Person mit Anmeldedaten ohne Konto dasteht, und bricht
 sonst ab. Eine Migration, die die Anmeldung anfasst und auf halbem Weg
 liegenbleibt, sperrt alle aus.
 ### Wo es gehakt hat
 | Problem | Ursache | Lösung |
 |---|---|---|
 | Nach dem Wehrwechsel landete alles auf der Anmeldeseite | `aktuelleSitzung()` verlangte eine Personenkennung — die Aufsicht hat keine und galt damit als nicht angemeldet | Eine Sitzung ist gültig, wenn Wehr und Konto feststehen; die Akte darf fehlen |
 | Der Wechsel schien nicht zu greifen | Er griff: das Token trug die neue Wehr. Es war der dritte hängengebliebene Entwicklungsserver dieser Woche — `npm run build` neben laufendem `next dev` macht `.next` unbrauchbar, und der Server antwortet danach nur noch mit 500 | Server beenden, `.next` löschen. Diesmal notiert, damit es nicht ein viertes Mal passiert |
 | Der Seed brach ab | Er legt die Rollen aus `ROLLEN` an, und dort steht jetzt `AUFSICHT` — die es im Prisma-Enum bewusst nicht gibt | Im Seed gefiltert, mit Begründung |
 | `unstable_update` nahm den Wechselwunsch nicht an | Es akzeptiert nur `Partial<Session>` | Der Wunsch reist als `user.mitgliedschaftId` und wird serverseitig gegen die Mitgliedschaften geprüft |
 | Die Nachbarwehr war fest verdrahtet | `ff-nachbarshausen` für jeden Mandanten — genau die Vermischung von Test- und Beispieldaten, die Phase 8 beseitigt hat | Aus dem Mandanten abgeleitet: `<slug>-nachbar` |
 | Ein alter Datenbanktest wurde unzuverlässig | `ki-datenbank.test.ts` legte Wehr und Person idempotent an, die Wiki-Seite aber nicht. Die neue Testdatei verschob die Reihenfolge, und ein Rest aus einem abgebrochenen Lauf ließ den ganzen Datei-Lauf scheitern | Auch dort ein `upsert` |
 | Nach `db:test-reset` zeigte der Wehrwähler nur noch die betreute Wehr | Der Reset löschte die Testwehr, aber nicht ihre Nachbarwehr. Der Seed sah die Nachbarwehr, hielt alles für erledigt und legte die Mitgliedschaft in der neuen Testwehr nie wieder an | Der Reset nimmt Nachbarwehr und Kreiskonto mit; der Seed prüft beide Teile getrennt statt mit einem gemeinsamen Ausstieg. Gefunden hat es ein E2E-Test |
 | Im vollen Lauf fielen fremde Testdateien mit „Anmeldung fehlgeschlagen“ aus | Der Fehlversuch-Test meldete sich mit der Adresse des Administrators an. Fünf Fehlversuche sperren das Konto fünf Minuten — bei zwei Projekten und Wiederholungen kam das zusammen, und alle anderen Dateien brauchen dasselbe Konto | Der Test nimmt jetzt eine Adresse, die es nicht gibt. Die Meldung muss ohnehin dieselbe sein, damit sie nicht verrät, ob es die Adresse gibt |
 ### Abweichung von der Vorgabe
 **Zwei Architekturregeln bekommen eine dokumentierte Ausnahme.**
 „Jede Tabelle hat `organisationId`" gilt für `Benutzer` nicht — sie kann es
 nicht, ohne den Zweck der Tabelle aufzuheben. Die Ausnahme steht im Schema, in
 der Migration und in der Roadmap, und die Tabelle ist dafür über Rechte
 geschützt statt über RLS.
 „Berechtigungen zentral in `lib/authz.ts`" gilt für den Verwalterzugang nicht:
 er hängt an `Benutzer.istVerwalter` und nicht an einem Recht. Rechte gelten je
 Wehr — ein Recht, das in Wehr A vergeben wird und in Wehr B wirkt, wäre die
 Hintertür, die diese Phase gerade schließen soll.
 ### Nachweise
 - `npm run typecheck` — ohne Ausgabe
 - `npm run lint` — ohne Befund
 - `npm run test` — 581 Tests grün, davon 11 neu gegen eine echte Datenbank
 - `npm run test:e2e` — grün über Desktop und Tablet, davon 26 neu
 - `npm run db:seed` und `npm run db:test-reset` — beide Mandanten samt
  Nachbarwehr und Kreisebene
 - Anmeldung nach der Umstellung von Hand geprüft: Konto gefunden, Passwort
  richtig, Sitzung trägt Konto, Mitgliedschaft und Verwaltermerkmal
 ---
 ## 2026-09-04 · Phase 9 — Kassenverwaltung
 **12:40 – 16:50 · 4:10 h · Version 0.10.0**
 ### Was entstanden ist
 Neun Modelle, drei Trigger, zwölf CHECKs, sechs Router, fünf Ansichten und
 ein Kassenjahr im Seed.
 Der Reihe nach, wie es CLAUDE.md vorgibt: Schema, Migration, Serverlogik, UI,
 Tests.
 | Bereich | Umfang |
 |---|---|
 | Datenmodell | `Kassenkonto`, `Buchungskategorie`, `Buchung`, `Beitragssatz`, `Beitrag`, `Rechnung`, `Rechnungsposition`, `Kassenabschluss`, `Abschlussposten` |
 | Absicherung | RLS für alle neun Tabellen, drei Trigger, zwölf CHECKs, ein REVOKE |
 | Bibliothek | `lib/kasse/betrag.ts`, `bankimport.ts`, `vorschlag.ts`, `texte.ts`, `dokumente.ts` |
 | Router | Konten, Kategorien, Buchungen, Beiträge, Rechnungen, Abschluss |
 | Oberfläche | Übersicht, Kassenbuch, Beiträge, Rechnungen, Abschluss mit Auswertung |
 | Hintergrund | Rechnungs-PDF, Kassenprüfbericht, Meldung überfälliger Posten |
 | Tests | 67 Unit-Tests (13 gegen eine echte Datenbank), 13 E2E-Tests |
 ### Entscheidungen
 **Die Sperren sitzen in der Datenbank, nicht im Router.** Die ganze Phase
 hängt an einem Satz: was geprüft ist, ändert sich nicht mehr. Ein
 Zustandscheck in `buchung.aendern` erfüllt das nicht — er gilt für genau
 diesen einen Weg. Ein zweiter Router, ein Skript, ein Import, und der geprüfte
 Bestand ist ein anderer, ohne dass irgendwo etwas auffällt. Also drei Trigger:
 festgeschriebene Buchung unveränderbar, geprüfter Zeitraum zu, festgeschriebener
 Abschluss fest.
 **Jeder Trigger hat genau eine Ausnahme, und jede hat einen Grund.** Die
 Buchung lässt den Verweis auf ihre Gegenbuchung eintragen — eine Stornierung
 entsteht später, sie einzutragen ist keine Änderung des Vorgangs, sondern
 seine Fortschreibung. Der Abschluss lässt den Prüfbericht nachtragen, denn das
 PDF entsteht im Hintergrund und damit nach dem Festschreiben. Ohne diese
 Ausnahme gäbe es nie einen Bericht.
 **Der Bestand wird gerechnet, nie gespeichert.** Ein gespeicherter Bestand
 neben einer nachgetragenen Buchung wäre falsch, ohne falsch auszusehen — und
 genau danach sucht ein Kassenprüfer. Bei den Größenordnungen einer
 Feuerwehrkasse kostet das Rechnen nichts.
 **Der Kategorievorschlag geht dem eigenen Bestand vor der Stichwortliste
 nach.** Wenn eine Wehr Diesel seit Jahren unter „Fahrzeuge" bucht statt unter
 „Kraftstoff", ist das ihre Entscheidung, und sie soll dabei bleiben dürfen.
 Die Stichwortliste greift erst, wenn es noch keinen Bestand gibt. Unter der
 Hälfte gemeinsamer Wörter schweigt der Vorschlag: ein falscher wird
 übernommen, ohne gelesen zu werden.
 **Der Bankimport erzeugt Entwürfe, keine Buchungen.** Und jeder Umsatz trägt
 eine Kennung, damit ein zweimal eingelesener Auszug als solcher erkannt wird.
 Ohne das wäre es ein doppelt gebuchter Monat, und der fiele erst beim
 Kassenabschluss auf — also drei Monate später.
 **Kein XML-Parser für CAMT.** Gebraucht werden sechs Felder aus einer flachen
 Struktur, die Datei kommt von der eigenen Bank. Der Parser ist kürzer als die
 Einbindung, und in einer Anwendung ohne Netzzugang ist jede Abhängigkeit
 weniger eine Sorge weniger. Namensräume werden ignoriert — genau das, was ein
 Parser hier auch täte.
 **In der Prüfmaske stehen die gezählten Felder leer.** Der Buchbestand ist zu
 sehen, weil der Prüfer ihn für die Differenz braucht. Vorbelegt wird nichts:
 wer erst das Buch sieht und dann zählt, zählt, bis es passt.
 ### Wo es gehakt hat
 | Problem | Ursache | Lösung |
 |---|---|---|
 | Der Abschluss ließ sich nicht mit seinem Bericht versehen | Der Trigger sperrte auch `berichtDateiId` — das PDF entsteht aber erst nach dem Festschreiben | Ausnahme für genau dieses Feld, wie beim Stornierungsverweis der Buchung |
 | Die Rechnungsnummer war ein Wettlauf | Höchste lesen, dann schreiben: zwei gleichzeitige Rechnungen lesen dieselbe Nummer | Zusammenstoß erkennen und die nächste nehmen; gefunden hat es der parallele E2E-Lauf über zwei Projekte |
 | Eine Organisation ließ sich nicht mehr löschen | Der DELETE-Trigger der Buchung kannte den Aufbewahrungsschalter nicht, den Audit-Log und Prüfprotokoll haben | `app.audit_bereinigung` auch dort — ohne ihn wäre die DSGVO-Löschung nicht durchführbar |
 | Der Datenbanktest ließ sich nur einmal ausführen | Dieselbe Ursache: das Aufräumen scheiterte an den festgeschriebenen Buchungen, und der Rest lief im nächsten Lauf gegen einen geprüften Zeitraum | siehe oben |
 | E2E: „Barkasse" fand sieben Elemente | Das Wort steht auch in Verwendungszwecken | über die Kartenüberschrift angesprochen |
 | E2E: die erste Maifest-Zeile war die falsche | Absteigend sortiert steht das laufende Jahr oben, und das ist nicht festgeschrieben | eine Buchung genommen, die es nur im Vorjahr gibt — und die Gegenprobe dazu |
 | Prisma wollte zum zehnten Mal die Trigramm-Indizes aus Phase 1 löschen | Sie stehen in einer Roh-SQL-Migration, nicht im Schema | 30 DropIndex-Blöcke entfernt, Kommentar in die Migration |
 | Der volle E2E-Lauf meldete quer durch alle Module Fehler | `npm run build` während eines laufenden `next dev`: der Produktionslauf überschreibt `.next`, und der Entwicklungsserver antwortet danach nur noch mit 500 | Entwicklungsserver beenden, `.next` löschen, neu laufen lassen — 239 grün |
 | Ein E2E-Test aus Phase 0 wurde rot | Er sicherte zu, dass die Kasse **kein** Verweis ist — die Zusicherung ist mit dieser Phase abgelaufen | umgeschrieben: die Kasse ist jetzt ein Verweis. Ein künftiges Modul zum Ausgrauen gibt es nicht mehr |
 ### Abweichung von der Vorgabe
 Keine. `Phase-9.md` ist vollständig umgesetzt, einschließlich CAMT.053, MT940,
 Nummernkreis, Kassenprüfbericht und Export.
 Der Beleg-Anhang an einer Buchung nutzt den `Belegentwurf` aus Phase 8 mit —
 er hat dafür einen `buchungId` bekommen. Fotografieren und Erfassen war
 bereits da; neu ist nur, dass daraus eine Buchung wird.
 ### Nachweise
 - `npm run typecheck` — ohne Ausgabe
 - `npm run lint` — ohne Befund
 - `npm run test` — 562 Tests grün, davon 13 neu gegen eine echte Datenbank
 - `npm run test:e2e` — 239 Tests grün über Desktop und Tablet, davon 26 neue
 - `npm run build` — fünf neue Routen unter `/kasse`
 - `npm run db:seed` — Kassenjahr angelegt, Abschluss festgeschrieben
 - Rechnungs-PDF (41 kB) und Kassenprüfbericht (45 kB) einmal von Hand über
  Gotenberg erzeugt und in MinIO abgelegt — die beiden Vorlagen haben sonst
  keinen automatischen Nachweis
 ---
 ## 2026-09-04 · Aufräumarbeiten — Issues #10 bis #12
 **11:15 – 12:35 · 1:20 h**
 ### Was entstanden ist
 Drei Punkte, die seit mehreren Phasen im Abschlussbericht standen und in jeder
 Phase Zeit gekostet haben. Diesmal als Issues angelegt und abgearbeitet.
 | Issue | Kern |
 |---|---|
 | #11 | ESLint hatte keine Konfiguration — `npm run lint` prüfte nichts |
 | #12 | `<div>` in einem `<p>` auf der Einsatzseite, seit Phase 3 |
 | #10 | Die E2E-Tests schrieben in die Beispielwehr |
 ### Entscheidungen
 **ESLint zuerst.** Er findet die anderen beiden — und tatsächlich hat er
 gleich zwei Fehler gemeldet, die niemand gesucht hatte: eine Fehlerfläche auf
 der Karte, die nie etwas anzeigen konnte, und zwei `useMemo` in der Lagekarte,
 die bei jedem Rendern neu rechneten.
 **Keine Formatierungsregeln.** Die macht Prettier. Zwei Werkzeuge, die sich
 über Anführungszeichen streiten, lenken von den Regeln ab, auf die es ankommt.
 **Auch keine typgestützten Regeln.** `no-floating-promises` wäre für diesen
 Stack die wertvollste Regel überhaupt — sie braucht aber den Compiler bei
 jedem Lauf, und dann dauert der Lauf Minuten statt Sekunden. Bei einem
 Werkzeug, das vor jedem Commit laufen soll, ist das der falsche Tausch.
 **Das Badge wurde ein `<span>`, nicht der Absatz ein `<div>`.** Die Meldung
 kam von einer Stelle, aber die Ursache saß im Bauteil: ein Abzeichen ist
 Fließtext-Inhalt und gehört in ein Inline-Element. So ist auch jede künftige
 Verwendung in einem Absatz richtig, und die Darstellung ändert sich nicht —
 `inline-flex` verhält sich in beiden gleich.
 **Eine zweite Wehr statt Aufräumen nach dem Lauf.** Ein abgebrochener Lauf
 lässt beim Aufräumen einen Bestand zurück, den niemand erwartet. Ein
 vollständiger Neuaufbau ist der einzige Zustand, den man kennt — und der Seed
 kann ohnehin schon alles, er brauchte nur eine Kennung aus der Umgebung.
 **Ein Riegel gegen den eigenen Fehler.** `npm run db:test-reset` bricht ab,
 wenn die Testkennung mit der der Beispielwehr übereinstimmt. Ein Skript, das
 eine ganze Wehr löscht, braucht eine Stelle, an der es sich weigert.
 ### Wo es gehakt hat
 | Problem | Ursache | Lösung |
 |---|---|---|
 | Zwei Tests fielen nach der Umstellung durch — und das war richtig so | Sie hatten die Verschmutzung gebraucht. `getByText("B 3 Wohnhausbrand", { exact: true })` traf bisher einen Einsatz aus einem früheren Testlauf, weil der kein Objekt hatte; der Einsatz aus dem Seed hat eines und steht in derselben Zelle | Anker am Zellenanfang statt Prüfung auf Gleichheit |
 | Der Kiosk-Test schrieb weiter in die Beispielwehr | `const WEHR = "ff-musterhausen"` stand fest im Test. Das Terminal merkt sich die Wehr und schreibt Mängel und Fahrten genau dorthin | Kennung aus `wehr.ts`, wie überall sonst |
 | Ein doppelt deklarierter Bezeichner rutschte durch den Typecheck | `tests/e2e` war in der `tsconfig.json` ausgeschlossen | Ausnahme entfernt. Sie hat nichts gebracht: die Dateien übersetzen sauber |
 | Die Anmeldung im Bildschirmfoto-Skript lief ins Leere | Bekannt aus Phase 7 — bei kaltem `.next` ist die Seite noch nicht hydriert | War schon behoben; hier nur wieder aufgetreten und bestätigt |
 ### Abweichung von der Vorgabe
 **Issues angelegt**, obwohl CLAUDE.md das ausdrücklich verbietet („Niemals ein
 Issue anlegen"). Auf ausdrückliche Anweisung im Chat — die Regel stammt vom
 Auftraggeber, und er hat sie für diesen Vorgang aufgehoben.
 ### Nachweise
 - `npx tsc --noEmit` — ohne Ausgabe, jetzt **einschließlich** `tests/e2e`
 - `npm run lint` — ohne Beanstandung
 - `npm run test` — 495 Tests grün
 - `npx playwright test` — grün gegen die Testwehr
 - Die Beispielwehr steht danach unverändert auf dem Seed-Stand: 49 Geräte,
  8 Einsätze, 1 Atemschutzüberwachung, 19 Termine, 4 Wiki-Seiten
 ---
@@ -0,0 +1,283 @@
 # FLORIAN — Kurzanleitung
 Alles, was man am Anfang braucht, auf ein paar Seiten. Nach Rollen sortiert:
 such dir den Abschnitt, der zu dir gehört, und lies den Rest später.
 Ausführlich steht alles in der [Anleitung](ANLEITUNG.md) — 63 Kapitel, zum
 Nachschlagen, nicht zum Durchlesen.
 ---
 ## Für alle
 ### Anmelden
 FLORIAN läuft im Browser. Die Adresse bekommst du vom Kommandanten.
 ![Anmeldung](screenshots/01-anmeldung-light.png)
 Nach der Anmeldung landest du auf der Übersicht: was ansteht, was fällig ist,
 was gemeldet wurde.
 **Das Passwort gehört nach der ersten Anmeldung geändert.** Oben rechts auf
 deinen Namen.
 ### Was du überall findest
 | Links in der Leiste | Wofür |
 |---|---|
 | **Übersicht** | Die Startseite: Fristen, Mängel, nächste Termine |
 | **Termine** | Übungsabende, Lehrgänge, Versammlungen — mit Rückmeldung |
 | **Dienstausweis** | Dein Ausweis mit QR-Code, auch fürs Handy |
 | **Wissen** | Merkblätter und Dienstanweisungen der Wehr |
 Du siehst nur, was zu deiner Rolle gehört. Fehlt dir etwas, sag dem
 Kommandanten Bescheid — Rollen werden dort vergeben.
 ### Zu einem Termin zurückmelden
 **Termine** öffnen, den Termin anklicken, **Zusagen** oder **Absagen**. Fertig.
 Wer absagt, kann einen Grund angeben; das hilft dem Ausbilder bei der Planung.
 ### Am Terminal im Gerätehaus
 Am Wandtablet meldest du dich mit **PIN oder Ausweiskarte** an — nicht mit
 E-Mail und Passwort. Deine PIN bekommst du vom Kommandanten.
 ![Terminal](screenshots/25-kiosk-kacheln-light.png)
 Dort geht: anmelden zum Dienst, einen Mangel melden, eine Fahrt eintragen,
 Schutzkleidung zur Reinigung geben.
 ---
 ## Für den Gerätewart
 Das ist der Bereich, in dem FLORIAN am meisten abnimmt.
 ### Der wichtigste Bildschirm: Prüfungen
 ![Fristen](screenshots/11-fristen-light.png)
 Unter **Prüfungen** steht, was wann fällig wird. Rot heißt überfällig, gelb
 heißt demnächst. Die Fristen rechnet FLORIAN selbst aus den Prüfintervallen
 der Gerätetypen aus — du musst nichts nachhalten.
 ### Ein Gerät prüfen
 1. **Prüfungen** → das fällige Gerät anklicken → **Prüfung durchführen**.
 2. Die Checkliste durchgehen. Sie kommt aus der Wartungsvorlage des Gerätetyps.
 3. Ergebnis eintragen, unterschreiben, abschließen.
 ![Prüfprotokoll](screenshots/18-pruefprotokoll-light.png)
 Danach entsteht ein **Prüfprotokoll als PDF** — das ist der Nachweis gegenüber
 der Unfallkasse.
 > **Achtung:** Ein abgeschlossenes Protokoll lässt sich nicht mehr ändern. Das
 > ist Absicht — ein nachträglich änderbarer Nachweis wäre keiner. Ist etwas
 > falsch, wird eine neue Prüfung erfasst.
 ### Ein Gerät anlegen
 **Geräte** → **Gerät anlegen**. Pflicht sind nur Inventarnummer und
 Bezeichnung; der Rest kann nachkommen.
 Wähle möglichst einen **Gerätetyp** — daran hängen Prüfintervall und
 Lebensdauer, und ohne Typ rechnet FLORIAN keine Frist.
 ### Einen Mangel bearbeiten
 Mängel kommen meist vom Terminal — jemand meldet sie beim Einrücken.
 **Mängel** → anklicken → jemandem zuweisen → nach der Behebung **erledigen**.
 Ein Gerät mit einem schweren Mangel wird automatisch gesperrt.
 ### Was noch dazugehört
 | Wo | Wofür |
 |---|---|
 | **Rückrufe** | Herstellerrückrufe: welche eurer Geräte betroffen sind |
 | **Lebensdauer** | Helme, Schläuche, Schutzkleidung mit Höchstalter |
 | **Fahrzeuge** | Beladung nach Geräteräumen |
 ---
 ## Für den Atemschutzgerätewart
 > **Der wichtigste Satz zuerst:** Die Überwachungstafel am Fahrzeug bleibt
 > führend. FLORIAN ergänzt sie, ersetzt sie nicht. Das steht auch dauerhaft
 > über jeder Ansicht, und es soll dort stehen.
 ### Wer darf unter Pressluftatmer?
 ![Atemschutz](screenshots/31-atemschutz-light.png)
 **Atemschutz** zeigt jeden Träger mit seinem Stand: G26, Belastungsübung,
 Einsatzübung. Wer eine der Voraussetzungen nicht erfüllt, steht rot da — mit
 Klartext, woran es liegt, nicht nur mit einer Farbe.
 ### Eine G26 eintragen
 **Atemschutz** → **Nachweise** → Person wählen → G26 erfassen. Untersuchungsdatum,
 Ergebnis und Gültigkeit reichen; den Befund speichert FLORIAN bewusst nicht.
 Dasselbe für Belastungsübungen.
 ### Eine Überwachung führen
 **Atemschutz** → **Überwachung eröffnen**. Trupp zusammenstellen, Druckwerte
 in Intervallen eintragen, Rückzugsdruck im Blick behalten. FLORIAN rechnet den
 Rückzugsdruck und warnt, bevor es knapp wird.
 ![Überwachung](screenshots/33-atemschutz-ueberwachung-light.png)
 Nach dem Ende entsteht ein vollständiges Protokoll als PDF.
 > Solange ein Trupp im Einsatz ist, lässt sich die Überwachung nicht beenden.
 ---
 ## Für den Kommandanten
 ### Mitglieder und Rollen
 **Mitglieder** → Person anklicken → Rollen vergeben.
 Neun Rollen, jede mit festem Rechteumfang. Die wichtigsten: Gerätewart,
 Atemschutzgerätewart, Kassier, Schriftführer, Ausbilder.
 **Jemand kommt nicht hinein?** Dann hat die Person eine Akte, aber kein Konto.
 Konten verwaltet, wer den Server betreibt — unter *Wehren und Konten*.
 ### Einen Einsatz erfassen
 **Einsätze** → **Einsatz anlegen**. Die sechs Zeitstempel (Alarmierung,
 Ausrücken, Eintreffen, Einsatzende, Einrücken, Einsatzbereitschaft), die
 beteiligten Fahrzeuge und die Mannschaft.
 ![Einsatz](screenshots/22-einsatz-light.png)
 Daraus entsteht der **Einsatzbericht als PDF** und die Statistik fürs Jahr.
 ### Kostenersatz abrechnen
 Fehlalarm einer Brandmeldeanlage, Öleinsatz mit Verursacher, vermieteter
 Schulungsraum: **Kasse** → **Rechnungen** → *Rechnung schreiben*. Die Nummer
 vergibt FLORIAN fortlaufend.
 ### Wenn jemand Auskunft über seine Daten verlangt
 Kommt selten vor, hat aber eine Frist von einem Monat.
 **Mitglieder** → Person → **Datenauskunft** → *Auskunft erstellen*. Daraus
 entsteht ein PDF mit allem, was über die Person gespeichert ist. Ausdrucken
 und aushändigen, fertig.
 ---
 ## Für den Kassier
 ![Kasse](screenshots/45-kasse-light.png)
 ### Buchen
 **Kasse** → **Buchungen** → *Buchung erfassen*. Der Betrag ist immer positiv;
 ob Einnahme oder Ausgabe, sagen die beiden Knöpfe daneben.
 FLORIAN schlägt eine Kategorie vor — meist die richtige, weil er nachsieht,
 wie ihr dieselbe Sache zuletzt gebucht habt.
 ### Kontoauszug einlesen
 Statt fünfzig Umsätze abzutippen: im Online-Banking den **Umsatzexport**
 herunterladen (CAMT.053 oder MT940), dann **Kasse** → **Buchungen** →
 *Kontoauszug*.
 Es entstehen **Entwürfe**, keine fertigen Buchungen — durchsehen musst du sie.
 Umsätze, die schon in der Kasse stehen, erkennt FLORIAN und hakt sie nicht
 noch einmal ab.
 ### Beiträge
 Einmal im Jahr: **Kasse** → **Beiträge** → *Beitragslauf*. Vorher steht da, wie
 viele Beiträge entstehen — und wer keinen passenden Satz hat.
 Zahlungen hakst du in der Liste ab; dabei entsteht gleich die Buchung.
 ### Festschreiben — und was das bedeutet
 Eine neue Buchung ist erst einmal ein **Entwurf** und änderbar. Mit
 *Festschreiben* wird sie unveränderbar.
 Ist danach etwas falsch, wird **gegengebucht**: eine zweite Buchung in die
 andere Richtung, mit Begründung. Beide bleiben stehen. Das sieht nach mehr
 Aufwand aus und ist genau der Punkt — eine verschwundene Buchung kann ein
 Kassenprüfer nicht prüfen, eine berichtigte schon.
 ### Kassenprüfung
 **Kasse** → **Abschluss** → *Kassenprüfung anlegen*. Links steht der Bestand
 laut Buch, rechts trägst du ein, was gezählt wurde.
 Bleibt eine Differenz, muss sie erklärt werden — sonst lässt sich der Abschluss
 nicht festschreiben. In fünf Jahren weiß sonst niemand mehr, woher sie kam.
 Danach entsteht der **Kassenprüfbericht als PDF** mit Unterschriftsfeldern.
 ---
 ## Für den, der den Server betreibt
 ### Sichern
 ```bash
 npm run sicherung
 ```
 Sichert Datenbank **und** Dateien. Das Ergebnis gehört auf ein anderes Gerät —
 eine Sicherung auf derselben Festplatte hilft gegen einen Festplattenfehler
 nicht.
 ### Einmal im Jahr proben
 ```bash
 npm run wiederherstellen -- --quelle sicherungen/<Ordner>
 ```
 So passiert nichts, es wird nur angezeigt, was geschähe. Erst mit `--wirklich`
 wird zurückgespielt.
 > Eine Sicherung, die nie zurückgespielt wurde, ist eine Vermutung. Der Ordner
 > kann leer sein, der Auszug abgeschnitten — man erfährt es sonst an dem Tag,
 > an dem man es nicht erfahren will.
 ### Aktualisieren
 ```bash
 ./update.sh --pruefen    # nachsehen, ob es etwas Neues gibt
 ./update.sh              # einspielen
 ```
 Das Skript sichert von sich aus, bevor es etwas anfasst, und sagt bei einem
 Fehler, wie der vorherige Stand zurückkommt.
 ---
 ## Wenn etwas nicht geht
 | Was | Woran es meist liegt |
 |---|---|
 | **Anmeldung geht nicht** | Nach fünf Fehlversuchen ist das Konto fünf Minuten gesperrt. Kurz warten. |
 | **Ein Menüpunkt fehlt** | Die Rolle fehlt. Der Kommandant vergibt sie unter *Mitglieder*. |
 | **Ein PDF entsteht nicht** | Es wird im Hintergrund erzeugt; nach ein paar Sekunden die Seite neu laden. |
 | **Das Terminal meldet niemanden an** | PIN falsch, oder das Tablet ist nicht mehr eingerichtet. |
 | **Eine Buchung lässt sich nicht ändern** | Sie ist festgeschrieben. Gegenbuchen. |
 Steht die Antwort nicht dabei: [Anleitung, letztes Kapitel](ANLEITUNG.md).
 ---
 *FLORIAN läuft auf einem Server, den die Feuerwehr selbst betreibt. Es gibt
 keine Telemetrie, keine Cloud und keine Weitergabe an Dritte — die Daten
 bleiben im Gerätehaus.*
@@ -18,8 +18,10 @@ Phase 5  ████████████████████  fertig
 Phase 6  ████████████████████  fertig      0.7.0
 Phase 7  ████████████████████  fertig      0.8.0
 Phase 8  ████████████████████  fertig      0.9.0
-Phase 9  ░░░░░░░░░░░░░░░░░░░░  als Nächstes 0.10.0
+Phase 9  ████████████████████  fertig      0.10.0
-Freigabe ░░░░░░░░░░░░░░░░░░░░  offen       1.0.0
+Phase 10 ████████████████████  fertig      0.11.0
 Phase 11 ████████████████████  fertig      0.12.0
 Freigabe ████████████████████  fertig      1.0.0
 ```
 ---
@@ -234,7 +236,7 @@ Dafür bleibt **alles andere ohne Modell vollständig benutzbar**: Wiki lesen un
 schreiben, Wortsuche, Belege ablegen, beide Protokolle. Wo etwas fehlt, steht
 ein Satz, der sagt was fehlt und wie es ohne geht.
-## Phase 9 — Kassenverwaltung · als Nächstes
+## Phase 9 — Kassenverwaltung · fertig
 Am 03.09.2026 ergänzt. Die Rolle `KASSIER` war seit Phase 0 angelegt, ein Modul
 dazu fehlte in der ursprünglichen Planung. Spezifikation: `Phase-9.md`.
@@ -253,20 +255,92 @@ Kassenabschluss friert seinen Zeitraum ein, danach nimmt die Buchungsmaske
 kein Datum daraus mehr an. Beträge durchgängig als `DECIMAL(12,2)`, nie als
 Fließkommazahl.
-**Danach kann die Wehr:** ihre Kasse führen und den Kassenprüfbericht auf
+Beides sitzt in Triggern und nicht im Router: ein vergessener Zustandscheck,
 ein Skript oder ein Import würden sonst reichen, um den geprüften Bestand zu
 ändern, ohne dass irgendwo etwas auffällt.
 **Die Wehr kann jetzt:** ihre Kasse führen und den Kassenprüfbericht auf
 Knopfdruck erzeugen.
-## 1.0.0 — Freigabe
+## Phase 10 — Mandantenfähigkeit · fertig
 Am 05.09.2026 ergänzt. Datenmodell und RLS trugen seit Phase 0 mehrere Wehren;
 was fehlte, war alles darüber.
 - `Benutzer` und `Mitgliedschaft`: das Anmeldekonto ist von der Personenakte
  gelöst. Ein Mensch, ein Passwort, beliebig viele Wehren.
 - Wehrwähler in der Seitenleiste — er erscheint nur, wenn es etwas zu wählen
  gibt.
 - Die Rolle `AUFSICHT` für die Kreisebene: Kreisbrandrat und
  Kreisbrandinspektion sehen die betreuten Wehren und ändern nichts.
 - Verwaltung der Installation unter `/wehren`: Wehren anlegen, Konten führen,
  Zuordnungen vergeben.
 Die Entscheidung, die alles andere bestimmt: **das Konto trägt keine
 Mandantenkennung.** Es kann keine tragen — es ist ja der Angelpunkt, an dem
 ein Mensch zu mehreren Wehren gehört. Geschützt wird es deshalb wie
 `Berechtigung` über Rechte statt über Row Level Security, und was ein Konto in
 einer Wehr darf, entscheidet nicht es selbst, sondern seine `Mitgliedschaft` —
 und die trägt `organisationId` wie jede andere Tabelle.
 **Bewusst nicht dabei:** wehrübergreifende Auswertungen. Eine Zahl über
 mehrere Wehren hinweg braucht eine abgestimmte Definition, und ohne die ist
 sie schlimmer als keine. Die Aufsicht sieht jede Wehr einzeln.
 **Die Wehr kann jetzt:** sich einen Server mit anderen teilen, ohne dass
 jemand über die Grenze sieht — und die Kreisebene kann hineinschauen, ohne
 etwas anfassen zu können.
 ## Phase 11 — Freigabereife · fertig
 Am 05.09.2026 umgesetzt. Kein Modul, sondern die drei Software-Voraussetzungen
 für die Freigabe.
 - **Auskunft nach Art. 15 DSGVO.** Das Recht `person.export` stand seit Phase 0
  im Katalog und war zugewiesen — umgesetzt war nichts. Ohne Auskunftsseite ist
  ein Löschkonzept nicht abnehmbar.
 - **Sicherung und Wiederherstellung** mit einer durchgeführten Rückspielprobe.
 - **Pipeline** in Gitea Actions: typecheck, lint, Migrationen, Seed und Tests.
 Die Rückspielprobe hat sich sofort bezahlt gemacht: der erste Versuch lief
 sauber durch und hatte dabei sämtliche Unveränderlichkeitsgarantien der
 Datenbank entfernt. Gefunden haben es die Datenbanktests unmittelbar danach —
 also genau die Probe, wegen der 1.0.0 sie verlangt.
 **Die Wehr kann jetzt:** eine Selbstauskunft erteilen, ihren Bestand sichern
 und ihn nachweislich zurückholen.
 ## 1.0.0 — Freigabe · am 06.09.2026 erteilt
 Kein neues Modul, sondern eine Entscheidung: die Wehr setzt FLORIAN im
-Echtbetrieb ein. Voraussetzungen:
+Echtbetrieb ein.
- Datenübernahme aus der bisherigen Verwaltung abgeschlossen und abgeglichen
+**Damit das nicht zur Formalie wird, hier der Stand jeder Voraussetzung — auch
- Sicherungskonzept steht und ist einmal wiederhergestellt worden
+der offenen.** Eine Freigabe, die alles abhakt, was ohnehin nicht geprüft
- Schulung von Kommandant, Gerätewart und Atemschutzgerätewart erfolgt
+wurde, ist keine.
- Löschkonzept nach DSGVO abgenommen
+
- Der Hinweis zur analogen Atemschutzüberwachung wird bewusst und
+| Voraussetzung | Stand |
-  dokumentiert abgeschaltet — oder bewusst stehen gelassen
+|---|---|
 | Datenübernahme aus der bisherigen Verwaltung | **entfällt.** Die Wehr pflegt den Bestand von Hand ein; es gibt kein Altsystem, aus dem übernommen würde. Für Mitglieder, Fahrzeuge und Geräte steht der Import-Assistent bereit, falls sich das ändert. |
 | Sicherungskonzept steht und ist einmal wiederhergestellt worden | **erledigt** mit Phase 11. Die Probe hat dabei einen Fehler gefunden, der sonst erst im Notfall aufgefallen wäre. |
 | Löschkonzept nach DSGVO | **technisch vollständig** seit Phase 11: Auskunft nach Art. 15, Anonymisierung im Aufbewahrungslauf, konfigurierbare Fristen. Die Abnahme durch die Wehr ist ein organisatorischer Schritt und steht aus. |
 | Schulung von Kommandant, Gerätewart und Atemschutzgerätewart | **steht aus.** Sie läuft nach der Freigabe; Grundlage ist die [Kurzanleitung](KURZANLEITUNG.md). |
 | Hinweis zur analogen Atemschutzüberwachung | **bewusst stehen gelassen.** `ATEMSCHUTZ_HINWEIS=true`. FLORIAN bleibt damit ergänzend; die Tafel am Fahrzeug ist führend. Das Abschalten verlangt ohnehin einen Kommandantenbeschluss samt Fundstelle. |
 Die beiden offenen Punkte sind **organisatorisch, nicht technisch**: an der
 Software hängt nichts davon ab. Sie stehen hier, damit später nachlesbar ist,
 was zum Zeitpunkt der Freigabe erledigt war und was nicht.
 ### Was 1.0.0 bedeutet — und was nicht
 **Bedeutet:** Der Funktionsumfang ist vollständig, die Datenbank ist stabil,
 Migrationen sind aufwärtskompatibel, und ab hier gilt semantische
 Versionierung. Ein Update bricht nichts, ohne dass es in der Hauptnummer
 steht.
 **Bedeutet nicht:** dass keine Fehler mehr da sind. Es bedeutet, dass die
 Wehr echte Daten hineingeben kann, ohne befürchten zu müssen, sie beim
 nächsten Update zu verlieren.
 ---
@@ -276,8 +350,11 @@ Am 03.09.2026 entschieden:
 | Punkt | Entscheidung |
 |---|---|
-| Kassenmodul | Wird als **Phase 9** ergänzt. Spezifikation in `Phase-9.md`, Aufwand 8–11 PT. |
+| Kassenmodul | Als **Phase 9** ergänzt und mit 0.10.0 umgesetzt. Spezifikation in `Phase-9.md`. |
 | `Berechtigung` ohne `organisationId` | Bleibt so. Die Tabelle ist der systemweite Katalog dessen, was die Software kann, für alle Wehren identisch — mandantenbezogen wird es erst über `RolleBerechtigung`. Für die Anwendungsrolle nur lesbar. |
 | `Benutzer` ohne `organisationId` | Notwendige Ausnahme, seit Phase 10. Die Tabelle ist der Angelpunkt der Doppelmitgliedschaft — mit Mandantenkennung könnte sie das nicht sein. Geschützt über Rechte statt RLS, wie `Berechtigung`: die Anwendungsrolle darf lesen und die Anmeldefelder fortschreiben, mehr nicht. |
 | `AUFSICHT` nicht im Prisma-Enum | Die Kreisebene ergibt sich aus der Mitgliedschaftsart, nicht aus einer Rollenzuweisung. Vergebbar zu machen hiesse, dass jemand innerhalb einer Wehr Rechte an einer anderen verteilen könnte. |
 | `istVerwalter` als Kontomerkmal | Kein Recht. Rechte gelten je Wehr; wer Wehren anlegt, steht über allen. Ein Recht, das in Wehr A vergeben wird und in Wehr B wirkt, wäre die Hintertür, die Phase 10 vermeiden soll. |
 | Löschausnahme im Audit-Log | Bleibt so. `UPDATE` ist dauerhaft gesperrt, `DELETE` nur mit `SET LOCAL app.audit_bereinigung = 'an'` im Aufbewahrungslauf des Workers. Ohne diese Ausnahme wäre das Löschkonzept nach DSGVO nicht umsetzbar. |
 ## Weitere Kandidaten für später
@@ -288,10 +365,8 @@ Am 03.09.2026 entschieden:
 | Kleiderkammer und Wäscheverwaltung | in Phase 4 nur als Wizard, ohne Bestandsführung | 4–6 PT |
 | Jugendfeuerwehr mit eigener Abzeichenverwaltung | eigene Fachlichkeit | 5–7 PT |
 | Schnittstelle zur Integrierten Leitstelle | Alarmdaten automatisch übernehmen | 6–10 PT, stark abhängig von der ILS |
 | Mehrere Wehren je Installation | technisch bereits möglich, Oberfläche fehlt | 4–6 PT |
-Die Mandantenfähigkeit ist der Punkt, der ohne Zusatzaufwand am weitesten
+Die Mandantenfähigkeit ist mit **Phase 10** umgesetzt: umschalten, Kreisebene,
-trägt: das Datenmodell und RLS können bereits mehrere Wehren. Was fehlt, ist
+Doppelmitgliedschaft, Verwaltung. Offen geblieben sind bewusst die
-eine Oberfläche zum Umschalten und ein Konzept für gemeindeübergreifende
+gemeindeübergreifenden Auswertungen — dafür braucht es zuerst eine abgestimmte
-Auswertungen. Für einen Landkreis, der mehrere Wehren betreiben will, wäre das
+Definition dessen, was verglichen werden soll.
 der nächste sinnvolle Schritt.
@@ -0,0 +1,135 @@
 import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { FlatCompat } from "@eslint/eslintrc";
 /**
 * ESLint-Konfiguration.
 *
 * Bis Phase 8 gab es ein Skript `npm run lint`, aber keine Konfiguration —
 * der Aufruf tat also nichts. Ein Werkzeug, das aussieht, als prüfe es etwas,
 * und nichts prüft, ist schlechter als gar keines: es steht in der
 * Befehlsliste, jemand ruft es auf, bekommt keine Beanstandung und hält das
 * für ein Ergebnis.
 *
 * Zwei Festlegungen bestimmen, was hier drinsteht:
 *
 * **Keine Formatierungsregeln.** Die macht Prettier. Zwei Werkzeuge, die sich
 * über Anführungszeichen und Zeilenlängen streiten, sind eines zu viel — und
 * die Streitpunkte lenken von den Regeln ab, auf die es ankommt.
 *
 * **Nur Regeln, die einen echten Fehler anzeigen.** Der Maßstab sind die
 * Fehler, die in diesem Projekt tatsächlich passiert sind:
 *
 *   - `react-hooks/exhaustive-deps` hätte den Kiosk-Fehler aus Phase 4
 *     gemeldet: eine Mutation von React Query in den Abhängigkeiten eines
 *     useCallback, wodurch der Wiederholungszeitgeber der Warteschlange nie
 *     ansprang. Gefunden hat ihn damals ein E2E-Test — teuer.
 *   - unbenutzte Importe blieben in Phase 7 zweimal liegen und fielen erst
 *     beim Lesen auf.
 *   - `react/jsx-key` und `react/no-unescaped-entities` kommen aus den
 *     Next-Regeln und fangen genau die Sorte Flüchtigkeitsfehler, die man
 *     beim Lesen überliest.
 *
 * Bewusst **nicht** eingeschaltet sind die typgestützten Regeln von
 * typescript-eslint (`no-floating-promises` und Verwandte). Sie brauchen den
 * Compiler bei jedem Lauf, und der Lauf dauert dann Minuten statt Sekunden —
 * bei einem Werkzeug, das vor jedem Commit laufen soll, ist das der falsche
 * Tausch. `npm run typecheck` deckt den größten Teil davon ohnehin ab.
 */
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const compat = new FlatCompat({ baseDirectory: __dirname });
 /** Die Konfiguration selbst — benannt, damit sie kein anonymer Export ist. */
 const konfiguration = [
  {
    ignores: [
      ".next/**",
      "node_modules/**",
      "playwright-report/**",
      "test-results/**",
      "coverage/**",
      "docs/**",
      // Von Prisma erzeugt, nicht von Hand geschrieben.
      "src/generated/**",
      "next-env.d.ts",
      // Ein gewoehnliches Node-Skript fuer den Healthcheck des Containers.
      // Es laeuft ausserhalb des Bundles, ist CommonJS und hat mit den
      // Next-Regeln nichts zu tun.
      "docker/healthcheck.js",
    ],
  },
  // Die Next-Regeln über die alte Schreibweise einbinden: eslint-config-next
  // liefert noch keine Flat Config.
  ...compat.extends("next/core-web-vitals", "next/typescript"),
  {
    rules: {
      /**
       * Unbenutztes ist ein Fehler, kein Schönheitsmakel: ein Import, den
       * niemand braucht, ist meistens der Rest einer halb zurückgebauten
       * Änderung.
       *
       * Ausnahme sind Bezeichner mit führendem Unterstrich — so wird in
       * diesem Projekt seit Phase 0 gekennzeichnet, dass ein Parameter
       * absichtlich ungenutzt bleibt (`_anfrage`, `_abo`).
       */
      "@typescript-eslint/no-unused-vars": [
        "error",
        {
          argsIgnorePattern: "^_",
          varsIgnorePattern: "^_",
          caughtErrorsIgnorePattern: "^_",
        },
      ],
      /**
       * Die Regel, die den teuersten Fehler des Projekts gemeldet hätte.
       * Bewusst als Fehler und nicht als Warnung: Warnungen liest nach zwei
       * Wochen niemand mehr.
       */
      "react-hooks/exhaustive-deps": "error",
      /**
       * `any` schaltet den Compiler ab. Wo es unvermeidlich ist — bei
       * Roh-SQL und beim Auswerten fremder Antworten —, steht es mit einer
       * Ausnahmezeile und einer Begründung da.
       */
      "@typescript-eslint/no-explicit-any": "error",
      /** Ein leeres catch verschluckt genau den Fehler, den man sucht. */
      "no-empty": ["error", { allowEmptyCatch: false }],
      /**
       * `console.log` gehört nicht in den Bestand. `console.info`, `.warn`
       * und `.error` schon — der Worker und die Integrationen schreiben ihre
       * Meldungen so, und die will man im Betrieb sehen.
       */
      "no-console": ["error", { allow: ["info", "warn", "error"] }],
    },
  },
  {
    // In Tests ist `console.log` beim Fehlersuchen legitim, und die
    // Abhängigkeitsregel für Hooks greift dort ohnehin nicht.
    files: ["tests/**/*.ts", "tests/**/*.tsx", "scripts/**/*.ts", "prisma/**/*.ts"],
    rules: {
      "no-console": "off",
    },
  },
  {
    // Der Service Worker läuft außerhalb des Bundles und kennt weder Node
    // noch die Browser-Globals in der Fassung, die ESLint hier annimmt.
    files: ["public/sw.js"],
    languageOptions: {
      globals: { self: "readonly", caches: "readonly", clients: "readonly" },
    },
    rules: {
      "no-undef": "off",
    },
  },
 ];
 export default konfiguration;
@@ -1,6 +1,6 @@
 {
  "name": "florian",
-  "version": "0.9.0",
+  "version": "1.0.0",
  "private": true,
  "description": "FLORIAN — Feuerwehr-Verwaltungsplattform",
  "engines": {
@@ -12,7 +12,8 @@
    "start": "next start -p 3100",
    "worker": "tsx --conditions=react-server src/worker/index.ts",
    "worker:dev": "tsx watch --conditions=react-server src/worker/index.ts",
-    "lint": "next lint",
+    "lint": "eslint .",
    "lint:fix": "eslint . --fix",
    "typecheck": "tsc --noEmit",
    "test": "vitest run",
    "test:watch": "vitest",
@@ -22,6 +23,9 @@
    "db:migrate:dev": "prisma migrate dev",
    "db:push": "prisma db push",
    "db:seed": "tsx prisma/seed.ts",
    "sicherung": "tsx scripts/sicherung.ts",
    "wiederherstellen": "tsx scripts/wiederherstellen.ts",
    "db:test-reset": "tsx scripts/testdaten.ts",
    "db:studio": "prisma studio",
    "screenshots": "tsx scripts/screenshots.ts",
    "icons": "tsx scripts/icons.ts",
@@ -0,0 +1,346 @@
 -- =============================================================================
 -- Phase 9 — Kassenverwaltung
 --
 -- HINWEIS zu den entfernten DropIndex-Bloecken: Prisma schlaegt bei jeder
 -- Migration erneut vor, die von Hand angelegten GiST- und Trigram-Indizes aus
 -- Phase 1 abzuraeumen. Es kennt sie nicht, weil sie nicht aus dem Schema
 -- stammen. Neunte Migration in Folge, in der sie wieder herausgenommen werden.
 -- =============================================================================
 -- CreateEnum
 CREATE TYPE "KontoArt" AS ENUM ('BAR', 'BANK', 'RUECKLAGE');
 -- CreateEnum
 CREATE TYPE "BuchungsArt" AS ENUM ('EINNAHME', 'AUSGABE');
 -- CreateEnum
 CREATE TYPE "BeitragStand" AS ENUM ('OFFEN', 'BEZAHLT', 'ERLASSEN', 'GEMAHNT');
 -- CreateEnum
 CREATE TYPE "RechnungStand" AS ENUM ('ENTWURF', 'VERSENDET', 'BEZAHLT', 'GEMAHNT', 'STORNIERT');
 -- CreateEnum
 CREATE TYPE "RechnungsAnlass" AS ENUM ('FEHLALARM', 'OELEINSATZ', 'VERANSTALTUNG', 'VERMIETUNG', 'SONSTIGES');
 -- AlterTable
 ALTER TABLE "belegentwurf" ADD COLUMN     "buchungId" UUID;
 -- CreateTable
 CREATE TABLE "kassenkonto" (
    "id" UUID NOT NULL,
    "organisationId" UUID NOT NULL,
    "bezeichnung" VARCHAR(120) NOT NULL,
    "art" "KontoArt" NOT NULL DEFAULT 'BAR',
    "iban" VARCHAR(34),
    "bic" VARCHAR(11),
    "anfangsbestand" DECIMAL(12,2) NOT NULL DEFAULT 0,
    "bemerkung" VARCHAR(500),
    "aktiv" BOOLEAN NOT NULL DEFAULT true,
    "erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
    "geaendertAm" TIMESTAMPTZ(3) NOT NULL,
    "geloeschtAm" TIMESTAMPTZ(3),
    CONSTRAINT "kassenkonto_pkey" PRIMARY KEY ("id")
 );
 -- CreateTable
 CREATE TABLE "buchungskategorie" (
    "id" UUID NOT NULL,
    "organisationId" UUID NOT NULL,
    "name" VARCHAR(120) NOT NULL,
    "art" "BuchungsArt" NOT NULL,
    "oberkategorieId" UUID,
    "kontonummer" VARCHAR(20),
    "bemerkung" VARCHAR(500),
    "aktiv" BOOLEAN NOT NULL DEFAULT true,
    "erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
    "geaendertAm" TIMESTAMPTZ(3) NOT NULL,
    "geloeschtAm" TIMESTAMPTZ(3),
    CONSTRAINT "buchungskategorie_pkey" PRIMARY KEY ("id")
 );
 -- CreateTable
 CREATE TABLE "buchung" (
    "id" UUID NOT NULL,
    "organisationId" UUID NOT NULL,
    "kontoId" UUID NOT NULL,
    "kategorieId" UUID NOT NULL,
    "datum" DATE NOT NULL,
    "art" "BuchungsArt" NOT NULL,
    "betrag" DECIMAL(12,2) NOT NULL,
    "verwendungszweck" VARCHAR(300) NOT NULL,
    "belegnummer" VARCHAR(60),
    "personId" UUID,
    "lieferant" VARCHAR(200),
    "gegenkontoId" UUID,
    "belegDateiId" UUID,
    "festgeschriebenAm" TIMESTAMPTZ(3),
    "storniertVonId" UUID,
    "erfasstVonId" UUID,
    "erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
    "geaendertAm" TIMESTAMPTZ(3) NOT NULL,
    CONSTRAINT "buchung_pkey" PRIMARY KEY ("id")
 );
 -- CreateTable
 CREATE TABLE "beitragssatz" (
    "id" UUID NOT NULL,
    "organisationId" UUID NOT NULL,
    "bezeichnung" VARCHAR(120) NOT NULL,
    "betrag" DECIMAL(12,2) NOT NULL,
    "abteilung" VARCHAR(60),
    "abJahr" INTEGER NOT NULL,
    "aktiv" BOOLEAN NOT NULL DEFAULT true,
    "erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
    "geaendertAm" TIMESTAMPTZ(3) NOT NULL,
    CONSTRAINT "beitragssatz_pkey" PRIMARY KEY ("id")
 );
 -- CreateTable
 CREATE TABLE "beitrag" (
    "id" UUID NOT NULL,
    "organisationId" UUID NOT NULL,
    "personId" UUID NOT NULL,
    "jahr" INTEGER NOT NULL,
    "satzId" UUID,
    "betrag" DECIMAL(12,2) NOT NULL,
    "stand" "BeitragStand" NOT NULL DEFAULT 'OFFEN',
    "buchungId" UUID,
    "bezahltAm" DATE,
    "mahnstufe" INTEGER NOT NULL DEFAULT 0,
    "gemahntAm" DATE,
    "erlassGrund" VARCHAR(300),
    "bemerkung" VARCHAR(500),
    "erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
    "geaendertAm" TIMESTAMPTZ(3) NOT NULL,
    CONSTRAINT "beitrag_pkey" PRIMARY KEY ("id")
 );
 -- CreateTable
 CREATE TABLE "rechnung" (
    "id" UUID NOT NULL,
    "organisationId" UUID NOT NULL,
    "nummer" VARCHAR(20) NOT NULL,
    "anlass" "RechnungsAnlass" NOT NULL DEFAULT 'SONSTIGES',
    "stand" "RechnungStand" NOT NULL DEFAULT 'ENTWURF',
    "empfaenger" VARCHAR(200) NOT NULL,
    "empfaengerZusatz" VARCHAR(200),
    "strasse" VARCHAR(200),
    "plz" VARCHAR(10),
    "ort" VARCHAR(120),
    "einsatzId" UUID,
    "datum" DATE NOT NULL,
    "faelligAm" DATE NOT NULL,
    "betrag" DECIMAL(12,2) NOT NULL,
    "bemerkung" VARCHAR(1000),
    "buchungId" UUID,
    "bezahltAm" DATE,
    "gemahntAm" DATE,
    "mahnstufe" INTEGER NOT NULL DEFAULT 0,
    "pdfDateiId" UUID,
    "erstelltVonId" UUID,
    "erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
    "geaendertAm" TIMESTAMPTZ(3) NOT NULL,
    CONSTRAINT "rechnung_pkey" PRIMARY KEY ("id")
 );
 -- CreateTable
 CREATE TABLE "rechnungsposition" (
    "id" UUID NOT NULL,
    "organisationId" UUID NOT NULL,
    "rechnungId" UUID NOT NULL,
    "reihenfolge" INTEGER NOT NULL,
    "bezeichnung" VARCHAR(300) NOT NULL,
    "menge" DECIMAL(12,3) NOT NULL DEFAULT 1,
    "einheit" VARCHAR(20),
    "einzelpreis" DECIMAL(12,2) NOT NULL,
    "gesamtpreis" DECIMAL(12,2) NOT NULL,
    "erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
    CONSTRAINT "rechnungsposition_pkey" PRIMARY KEY ("id")
 );
 -- CreateTable
 CREATE TABLE "kassenabschluss" (
    "id" UUID NOT NULL,
    "organisationId" UUID NOT NULL,
    "vonAm" DATE NOT NULL,
    "bisAm" DATE NOT NULL,
    "bestandLautBuch" DECIMAL(12,2) NOT NULL,
    "gezaehlterBestand" DECIMAL(12,2) NOT NULL,
    "differenz" DECIMAL(12,2) NOT NULL,
    "erlaeuterung" VARCHAR(2000),
    "prueferId" UUID,
    "zweiterPrueferId" UUID,
    "geprueftAm" DATE,
    "berichtDateiId" UUID,
    "festgeschriebenAm" TIMESTAMPTZ(3),
    "erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
    "geaendertAm" TIMESTAMPTZ(3) NOT NULL,
    CONSTRAINT "kassenabschluss_pkey" PRIMARY KEY ("id")
 );
 -- CreateTable
 CREATE TABLE "abschlussposten" (
    "id" UUID NOT NULL,
    "organisationId" UUID NOT NULL,
    "abschlussId" UUID NOT NULL,
    "kontoId" UUID NOT NULL,
    "bestandLautBuch" DECIMAL(12,2) NOT NULL,
    "gezaehlterBestand" DECIMAL(12,2) NOT NULL,
    "differenz" DECIMAL(12,2) NOT NULL,
    "bemerkung" VARCHAR(500),
    "erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
    CONSTRAINT "abschlussposten_pkey" PRIMARY KEY ("id")
 );
 -- CreateIndex
 CREATE INDEX "kassenkonto_organisationId_aktiv_idx" ON "kassenkonto"("organisationId", "aktiv");
 -- CreateIndex
 CREATE UNIQUE INDEX "kassenkonto_organisationId_bezeichnung_key" ON "kassenkonto"("organisationId", "bezeichnung");
 -- CreateIndex
 CREATE INDEX "buchungskategorie_organisationId_art_idx" ON "buchungskategorie"("organisationId", "art");
 -- CreateIndex
 CREATE UNIQUE INDEX "buchungskategorie_organisationId_name_key" ON "buchungskategorie"("organisationId", "name");
 -- CreateIndex
 CREATE INDEX "buchung_organisationId_datum_idx" ON "buchung"("organisationId", "datum" DESC);
 -- CreateIndex
 CREATE INDEX "buchung_organisationId_kontoId_datum_idx" ON "buchung"("organisationId", "kontoId", "datum");
 -- CreateIndex
 CREATE INDEX "buchung_organisationId_kategorieId_idx" ON "buchung"("organisationId", "kategorieId");
 -- CreateIndex
 CREATE INDEX "beitragssatz_organisationId_abJahr_idx" ON "beitragssatz"("organisationId", "abJahr");
 -- CreateIndex
 CREATE UNIQUE INDEX "beitragssatz_organisationId_abteilung_abJahr_key" ON "beitragssatz"("organisationId", "abteilung", "abJahr");
 -- CreateIndex
 CREATE INDEX "beitrag_organisationId_jahr_stand_idx" ON "beitrag"("organisationId", "jahr", "stand");
 -- CreateIndex
 CREATE UNIQUE INDEX "beitrag_personId_jahr_key" ON "beitrag"("personId", "jahr");
 -- CreateIndex
 CREATE INDEX "rechnung_organisationId_stand_idx" ON "rechnung"("organisationId", "stand");
 -- CreateIndex
 CREATE INDEX "rechnung_organisationId_datum_idx" ON "rechnung"("organisationId", "datum" DESC);
 -- CreateIndex
 CREATE UNIQUE INDEX "rechnung_organisationId_nummer_key" ON "rechnung"("organisationId", "nummer");
 -- CreateIndex
 CREATE INDEX "rechnungsposition_organisationId_idx" ON "rechnungsposition"("organisationId");
 -- CreateIndex
 CREATE UNIQUE INDEX "rechnungsposition_rechnungId_reihenfolge_key" ON "rechnungsposition"("rechnungId", "reihenfolge");
 -- CreateIndex
 CREATE INDEX "kassenabschluss_organisationId_bisAm_idx" ON "kassenabschluss"("organisationId", "bisAm" DESC);
 -- CreateIndex
 CREATE INDEX "abschlussposten_organisationId_idx" ON "abschlussposten"("organisationId");
 -- CreateIndex
 CREATE UNIQUE INDEX "abschlussposten_abschlussId_kontoId_key" ON "abschlussposten"("abschlussId", "kontoId");
 -- AddForeignKey
 ALTER TABLE "belegentwurf" ADD CONSTRAINT "belegentwurf_buchungId_fkey" FOREIGN KEY ("buchungId") REFERENCES "buchung"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "kassenkonto" ADD CONSTRAINT "kassenkonto_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "buchungskategorie" ADD CONSTRAINT "buchungskategorie_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "buchungskategorie" ADD CONSTRAINT "buchungskategorie_oberkategorieId_fkey" FOREIGN KEY ("oberkategorieId") REFERENCES "buchungskategorie"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "buchung" ADD CONSTRAINT "buchung_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "buchung" ADD CONSTRAINT "buchung_kontoId_fkey" FOREIGN KEY ("kontoId") REFERENCES "kassenkonto"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "buchung" ADD CONSTRAINT "buchung_kategorieId_fkey" FOREIGN KEY ("kategorieId") REFERENCES "buchungskategorie"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "buchung" ADD CONSTRAINT "buchung_personId_fkey" FOREIGN KEY ("personId") REFERENCES "person"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "buchung" ADD CONSTRAINT "buchung_erfasstVonId_fkey" FOREIGN KEY ("erfasstVonId") REFERENCES "person"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "buchung" ADD CONSTRAINT "buchung_belegDateiId_fkey" FOREIGN KEY ("belegDateiId") REFERENCES "datei"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "buchung" ADD CONSTRAINT "buchung_storniertVonId_fkey" FOREIGN KEY ("storniertVonId") REFERENCES "buchung"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "beitragssatz" ADD CONSTRAINT "beitragssatz_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "beitrag" ADD CONSTRAINT "beitrag_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "beitrag" ADD CONSTRAINT "beitrag_personId_fkey" FOREIGN KEY ("personId") REFERENCES "person"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "beitrag" ADD CONSTRAINT "beitrag_satzId_fkey" FOREIGN KEY ("satzId") REFERENCES "beitragssatz"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "beitrag" ADD CONSTRAINT "beitrag_buchungId_fkey" FOREIGN KEY ("buchungId") REFERENCES "buchung"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "rechnung" ADD CONSTRAINT "rechnung_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "rechnung" ADD CONSTRAINT "rechnung_buchungId_fkey" FOREIGN KEY ("buchungId") REFERENCES "buchung"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "rechnung" ADD CONSTRAINT "rechnung_pdfDateiId_fkey" FOREIGN KEY ("pdfDateiId") REFERENCES "datei"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "rechnung" ADD CONSTRAINT "rechnung_erstelltVonId_fkey" FOREIGN KEY ("erstelltVonId") REFERENCES "person"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "rechnungsposition" ADD CONSTRAINT "rechnungsposition_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "rechnungsposition" ADD CONSTRAINT "rechnungsposition_rechnungId_fkey" FOREIGN KEY ("rechnungId") REFERENCES "rechnung"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "kassenabschluss" ADD CONSTRAINT "kassenabschluss_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "kassenabschluss" ADD CONSTRAINT "kassenabschluss_prueferId_fkey" FOREIGN KEY ("prueferId") REFERENCES "person"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "kassenabschluss" ADD CONSTRAINT "kassenabschluss_zweiterPrueferId_fkey" FOREIGN KEY ("zweiterPrueferId") REFERENCES "person"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "kassenabschluss" ADD CONSTRAINT "kassenabschluss_berichtDateiId_fkey" FOREIGN KEY ("berichtDateiId") REFERENCES "datei"("id") ON DELETE SET NULL ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "abschlussposten" ADD CONSTRAINT "abschlussposten_organisationId_fkey" FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "abschlussposten" ADD CONSTRAINT "abschlussposten_abschlussId_fkey" FOREIGN KEY ("abschlussId") REFERENCES "kassenabschluss"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- AddForeignKey
 ALTER TABLE "abschlussposten" ADD CONSTRAINT "abschlussposten_kontoId_fkey" FOREIGN KEY ("kontoId") REFERENCES "kassenkonto"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
@@ -0,0 +1,306 @@
 -- =============================================================================
 -- Phase 9 — Mandantentrennung und die Regeln, die eine Kasse prüffähig machen
 --
 -- Drei Dinge stehen hier und nicht im Anwendungscode, weil sie auch dann
 -- gelten müssen, wenn jemand an der Anwendung vorbei schreibt:
 --
 --   1. **Eine festgeschriebene Buchung ist unveränderbar.** Ein Kassenbuch,
 --      in dem man rückwirkend ändern kann, ist vor der Kassenprüfung wertlos.
 --   2. **Ein festgeschriebener Abschluss friert seinen Zeitraum ein.** Sonst
 --      hätte der geprüfte Bestand am Tag nach der Prüfung eine andere Zahl.
 --   3. **Rechnerisch Unmögliches wird abgewiesen** — negative Beträge, ein
 --      Ende vor dem Beginn, eine Buchung, die gleichzeitig an ein Mitglied und
 --      an einen Lieferanten geht.
 -- =============================================================================
 -- -----------------------------------------------------------------------------
 -- Row Level Security
 -- -----------------------------------------------------------------------------
 DO $$
 DECLARE
    tabelle text;
 BEGIN
    FOREACH tabelle IN ARRAY ARRAY[
        'kassenkonto',
        'buchungskategorie',
        'buchung',
        'beitragssatz',
        'beitrag',
        'rechnung',
        'rechnungsposition',
        'kassenabschluss',
        'abschlussposten'
    ]
    LOOP
        EXECUTE format('ALTER TABLE %I ENABLE ROW LEVEL SECURITY', tabelle);
        EXECUTE format('ALTER TABLE %I FORCE ROW LEVEL SECURITY', tabelle);
        EXECUTE format('DROP POLICY IF EXISTS %I ON %I', tabelle || '_mandant', tabelle);
        EXECUTE format(
            'CREATE POLICY %I ON %I FOR ALL '
            'USING ("organisationId" = aktuelle_organisation()) '
            'WITH CHECK ("organisationId" = aktuelle_organisation())',
            tabelle || '_mandant', tabelle
        );
    END LOOP;
 END $$;
 -- -----------------------------------------------------------------------------
 -- Prüfbedingungen
 -- -----------------------------------------------------------------------------
 -- Der Betrag ist positiv; die Richtung steht in "art". Eine Buchung über
 -- minus zwölf Euro wäre eine zweite Art, dasselbe auszudrücken — und die
 -- Summenformel müsste dann beide beherrschen.
 ALTER TABLE "buchung" ADD CONSTRAINT "buchung_betrag_positiv" CHECK ("betrag" > 0);
 -- Entweder ein Mitglied oder ein Dritter. Beides zusammen wäre nicht
 -- auswertbar: bei „wer hat wie viel bekommen" stünde derselbe Betrag zweimal.
 ALTER TABLE "buchung" ADD CONSTRAINT "buchung_gegenueber_eindeutig" CHECK (
    NOT ("personId" IS NOT NULL AND "lieferant" IS NOT NULL)
 );
 -- Eine Umbuchung auf dasselbe Konto ist keine.
 ALTER TABLE "buchung" ADD CONSTRAINT "buchung_gegenkonto_verschieden" CHECK (
    "gegenkontoId" IS NULL OR "gegenkontoId" <> "kontoId"
 );
 ALTER TABLE "beitrag" ADD CONSTRAINT "beitrag_betrag_nicht_negativ" CHECK ("betrag" >= 0);
 ALTER TABLE "beitrag" ADD CONSTRAINT "beitrag_jahr_plausibel" CHECK (
    "jahr" BETWEEN 1900 AND 2200
 );
 ALTER TABLE "beitrag" ADD CONSTRAINT "beitrag_mahnstufe_plausibel" CHECK (
    "mahnstufe" BETWEEN 0 AND 5
 );
 -- Ein erlassener Beitrag ohne Begründung ist in der Kassenprüfung eine offene
 -- Frage. Lieber gleich hier verlangen als hinterher erklären.
 ALTER TABLE "beitrag" ADD CONSTRAINT "beitrag_erlass_begruendet" CHECK (
    "stand" <> 'ERLASSEN' OR "erlassGrund" IS NOT NULL
 );
 -- Bezahlt heißt: es gibt einen Tag, an dem gezahlt wurde.
 ALTER TABLE "beitrag" ADD CONSTRAINT "beitrag_bezahlt_datiert" CHECK (
    "stand" <> 'BEZAHLT' OR "bezahltAm" IS NOT NULL
 );
 ALTER TABLE "beitragssatz" ADD CONSTRAINT "beitragssatz_betrag_nicht_negativ" CHECK (
    "betrag" >= 0
 );
 ALTER TABLE "rechnung" ADD CONSTRAINT "rechnung_betrag_nicht_negativ" CHECK ("betrag" >= 0);
 ALTER TABLE "rechnung" ADD CONSTRAINT "rechnung_faellig_nach_datum" CHECK (
    "faelligAm" >= "datum"
 );
 ALTER TABLE "rechnungsposition" ADD CONSTRAINT "position_menge_positiv" CHECK ("menge" > 0);
 ALTER TABLE "rechnungsposition" ADD CONSTRAINT "position_preis_nicht_negativ" CHECK (
    "einzelpreis" >= 0 AND "gesamtpreis" >= 0
 );
 ALTER TABLE "kassenabschluss" ADD CONSTRAINT "abschluss_zeitraum_sinnvoll" CHECK (
    "bisAm" >= "vonAm"
 );
 -- Die Differenz ist keine freie Eingabe, sondern das Ergebnis. Wer sie von
 -- Hand setzt, verdeckt genau das, was die Prüfung finden soll.
 ALTER TABLE "kassenabschluss" ADD CONSTRAINT "abschluss_differenz_stimmt" CHECK (
    "differenz" = "gezaehlterBestand" - "bestandLautBuch"
 );
 ALTER TABLE "abschlussposten" ADD CONSTRAINT "posten_differenz_stimmt" CHECK (
    "differenz" = "gezaehlterBestand" - "bestandLautBuch"
 );
 -- Ein festgeschriebener Abschluss braucht Prüfer und Datum. Ohne beides ist
 -- er kein Abschluss, sondern eine Notiz.
 ALTER TABLE "kassenabschluss" ADD CONSTRAINT "abschluss_pruefung_vollstaendig" CHECK (
    "festgeschriebenAm" IS NULL
    OR ("prueferId" IS NOT NULL AND "geprueftAm" IS NOT NULL)
 );
 -- -----------------------------------------------------------------------------
 -- Suche und Auswertung
 -- -----------------------------------------------------------------------------
 -- Der Verwendungszweck ist das Feld, in dem gesucht wird — „wo war noch die
 -- Rechnung von der Werkstatt".
 CREATE INDEX IF NOT EXISTS "buchung_suche_zweck"
    ON "buchung" USING gin ("verwendungszweck" gin_trgm_ops);
 CREATE INDEX IF NOT EXISTS "buchung_suche_lieferant"
    ON "buchung" USING gin ("lieferant" gin_trgm_ops);
 -- Offene Posten: die Liste, die der Kassier vor der Jahreshauptversammlung
 -- braucht.
 CREATE INDEX IF NOT EXISTS "beitrag_offen"
    ON "beitrag" ("organisationId", "jahr")
    WHERE "stand" IN ('OFFEN', 'GEMAHNT');
 CREATE INDEX IF NOT EXISTS "rechnung_offen"
    ON "rechnung" ("organisationId", "faelligAm")
    WHERE "stand" IN ('VERSENDET', 'GEMAHNT');
 -- Noch nicht festgeschriebene Buchungen — der Stapel, den jemand durchsieht.
 CREATE INDEX IF NOT EXISTS "buchung_offen"
    ON "buchung" ("organisationId", "datum")
    WHERE "festgeschriebenAm" IS NULL;
 -- -----------------------------------------------------------------------------
 -- Rechte
 -- -----------------------------------------------------------------------------
 DO $$
 BEGIN
    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'florian_app') THEN
        EXECUTE 'GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO florian_app';
        EXECUTE 'GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO florian_app';
        EXECUTE 'REVOKE INSERT, UPDATE, DELETE ON "berechtigung" FROM florian_app';
        EXECUTE 'REVOKE UPDATE, DELETE ON "audit_log" FROM florian_app';
        EXECUTE 'REVOKE UPDATE, DELETE ON "kiosk_vorgang" FROM florian_app';
        EXECUTE 'REVOKE UPDATE, DELETE ON "druckmessung" FROM florian_app';
        EXECUTE 'REVOKE UPDATE, DELETE ON "atemschutz_ereignis" FROM florian_app';
        EXECUTE 'REVOKE DELETE ON "benachrichtigung" FROM florian_app';
        EXECUTE 'REVOKE DELETE ON "ki_vorgang" FROM florian_app';
        EXECUTE 'REVOKE UPDATE, DELETE ON "wikiversion" FROM florian_app';
        -- Ein festgeschriebener Abschluss lässt sich nicht wegräumen. Das
        -- Löschen einzelner Buchungen bleibt möglich, solange sie nicht
        -- festgeschrieben sind — den Rest erledigt der Trigger unten, weil
        -- ein pauschales REVOKE auch den Entwurfsstapel unlöschbar machen
        -- würde.
        EXECUTE 'REVOKE DELETE ON "kassenabschluss" FROM florian_app';
    END IF;
 END $$;
 -- -----------------------------------------------------------------------------
 -- Eine festgeschriebene Buchung ist unveränderbar
 -- -----------------------------------------------------------------------------
 -- Änderbar bleibt genau eines: der Verweis auf die Buchung, die diese hier
 -- aufhebt. Eine Stornierung entsteht ja erst später — sie einzutragen ist
 -- keine Änderung des Vorgangs, sondern seine Fortschreibung.
 CREATE OR REPLACE FUNCTION buchung_unveraenderlich()
 RETURNS TRIGGER AS $$
 BEGIN
    IF TG_OP = 'DELETE' THEN
        -- Die eine Ausnahme ist der Aufbewahrungslauf, derselbe Schalter wie
        -- beim Audit-Log und beim Pruefprotokoll. Ohne ihn liesse sich eine
        -- Organisation nicht mehr loeschen -- und genau das verlangt die
        -- DSGVO, wenn eine Wehr das System verlaesst.
        IF coalesce(current_setting('app.audit_bereinigung', true), '') = 'an' THEN
            RETURN OLD;
        END IF;
        IF OLD."festgeschriebenAm" IS NOT NULL THEN
            RAISE EXCEPTION
                'Diese Buchung ist seit % festgeschrieben und laesst sich nicht loeschen. '
                'Korrekturen laufen ueber eine Gegenbuchung.', OLD."festgeschriebenAm";
        END IF;
        RETURN OLD;
    END IF;
    IF OLD."festgeschriebenAm" IS NULL THEN
        RETURN NEW;
    END IF;
    IF NEW."datum" IS DISTINCT FROM OLD."datum"
       OR NEW."betrag" IS DISTINCT FROM OLD."betrag"
       OR NEW."art" IS DISTINCT FROM OLD."art"
       OR NEW."kontoId" IS DISTINCT FROM OLD."kontoId"
       OR NEW."kategorieId" IS DISTINCT FROM OLD."kategorieId"
       OR NEW."verwendungszweck" IS DISTINCT FROM OLD."verwendungszweck"
       OR NEW."personId" IS DISTINCT FROM OLD."personId"
       OR NEW."lieferant" IS DISTINCT FROM OLD."lieferant"
       OR NEW."belegnummer" IS DISTINCT FROM OLD."belegnummer"
       OR NEW."festgeschriebenAm" IS DISTINCT FROM OLD."festgeschriebenAm" THEN
        RAISE EXCEPTION
            'Diese Buchung ist seit % festgeschrieben. Korrekturen laufen ueber eine '
            'Gegenbuchung mit Verweis, nie durch Aendern.', OLD."festgeschriebenAm";
    END IF;
    RETURN NEW;
 END;
 $$ LANGUAGE plpgsql;
 DROP TRIGGER IF EXISTS buchung_unveraenderlich_trigger ON "buchung";
 CREATE TRIGGER buchung_unveraenderlich_trigger
    BEFORE UPDATE OR DELETE ON "buchung"
    FOR EACH ROW
    EXECUTE FUNCTION buchung_unveraenderlich();
 -- -----------------------------------------------------------------------------
 -- Ein festgeschriebener Abschluss friert seinen Zeitraum ein
 -- -----------------------------------------------------------------------------
 -- Gilt für neue Buchungen und für das Verschieben vorhandener. Ohne die
 -- zweite Hälfte könnte man eine Buchung nachträglich in einen geprüften
 -- Zeitraum hineindatieren — und der geprüfte Bestand stimmte nicht mehr.
 CREATE OR REPLACE FUNCTION buchung_zeitraum_offen()
 RETURNS TRIGGER AS $$
 DECLARE
    abschluss RECORD;
 BEGIN
    SELECT "vonAm", "bisAm", "geprueftAm"
      INTO abschluss
      FROM "kassenabschluss"
     WHERE "organisationId" = NEW."organisationId"
       AND "festgeschriebenAm" IS NOT NULL
       AND NEW."datum" BETWEEN "vonAm" AND "bisAm"
     LIMIT 1;
    IF FOUND THEN
        RAISE EXCEPTION
            'Der Zeitraum vom % bis % ist mit dem Kassenabschluss vom % geprueft und '
            'abgeschlossen. Fuer eine Korrektur bitte mit heutigem Datum gegenbuchen.',
            abschluss."vonAm", abschluss."bisAm", abschluss."geprueftAm";
    END IF;
    RETURN NEW;
 END;
 $$ LANGUAGE plpgsql;
 DROP TRIGGER IF EXISTS buchung_zeitraum_offen_trigger ON "buchung";
 CREATE TRIGGER buchung_zeitraum_offen_trigger
    BEFORE INSERT OR UPDATE OF "datum" ON "buchung"
    FOR EACH ROW
    EXECUTE FUNCTION buchung_zeitraum_offen();
 -- -----------------------------------------------------------------------------
 -- Ein festgeschriebener Abschluss bleibt, wie er ist
 -- -----------------------------------------------------------------------------
 -- Aenderbar bleibt genau eines: der Verweis auf den erzeugten Bericht. Das PDF
 -- entsteht im Hintergrund und damit erst nach dem Festschreiben — es
 -- nachzutragen ist keine Aenderung des Abschlusses, sondern seine
 -- Fertigstellung. Dieselbe Ausnahme wie beim Stornierungsverweis der Buchung.
 CREATE OR REPLACE FUNCTION abschluss_unveraenderlich()
 RETURNS TRIGGER AS $$
 BEGIN
    IF OLD."festgeschriebenAm" IS NULL THEN
        RETURN NEW;
    END IF;
    IF NEW."vonAm" IS NOT DISTINCT FROM OLD."vonAm"
       AND NEW."bisAm" IS NOT DISTINCT FROM OLD."bisAm"
       AND NEW."bestandLautBuch" IS NOT DISTINCT FROM OLD."bestandLautBuch"
       AND NEW."gezaehlterBestand" IS NOT DISTINCT FROM OLD."gezaehlterBestand"
       AND NEW."differenz" IS NOT DISTINCT FROM OLD."differenz"
       AND NEW."erlaeuterung" IS NOT DISTINCT FROM OLD."erlaeuterung"
       AND NEW."prueferId" IS NOT DISTINCT FROM OLD."prueferId"
       AND NEW."zweiterPrueferId" IS NOT DISTINCT FROM OLD."zweiterPrueferId"
       AND NEW."geprueftAm" IS NOT DISTINCT FROM OLD."geprueftAm"
       AND NEW."festgeschriebenAm" IS NOT DISTINCT FROM OLD."festgeschriebenAm" THEN
        RETURN NEW;
    END IF;
    RAISE EXCEPTION
        'Der Kassenabschluss vom % ist festgeschrieben. Zahlen und Pruefer lassen sich '
        'nicht mehr aendern.', OLD."geprueftAm";
 END;
 $$ LANGUAGE plpgsql;
 DROP TRIGGER IF EXISTS abschluss_unveraenderlich_trigger ON "kassenabschluss";
 CREATE TRIGGER abschluss_unveraenderlich_trigger
    BEFORE UPDATE ON "kassenabschluss"
    FOR EACH ROW
    EXECUTE FUNCTION abschluss_unveraenderlich();
@@ -0,0 +1,189 @@
 -- =============================================================================
 -- Phase 10 — Mandantenfähigkeit: Konto und Mitgliedschaft
 --
 -- Bis hierher war die Personenakte zugleich das Anmeldekonto: Passwort-Hash
 -- und OIDC-Subject hingen an `person`, und `person` gehört genau einer Wehr.
 -- Ein Mensch konnte damit nicht zu zwei Wehren gehören, ohne zwei Passwörter
 -- zu haben — und die Anmeldung per E-Mail war mehrdeutig, sobald dieselbe
 -- Adresse in zwei Wehren stand (die Eindeutigkeit galt nur je Organisation).
 --
 -- Ab jetzt:
 --
 --   benutzer        das Konto. Global eindeutige E-Mail, ein Passwort.
 --   mitgliedschaft  die Zugehörigkeit zu einer Wehr, mit oder ohne Akte.
 --   person          bleibt die Akte je Wehr — ohne Anmeldedaten.
 --
 -- DIESE MIGRATION IST DATENERHALTEND. Jede Person mit Anmeldedaten bekommt
 -- ein Konto und eine Mitgliedschaft, bevor die Spalten fallen. Wer schon
 -- heute in zwei Wehren mit derselben E-Mail steht, bekommt EIN Konto mit ZWEI
 -- Mitgliedschaften — also genau das, was vorher nicht möglich war.
 --
 -- HINWEIS zu den entfernten DropIndex-Bloecken: Prisma schlaegt bei jeder
 -- Migration erneut vor, die von Hand angelegten GiST- und Trigram-Indizes aus
 -- Phase 1 abzuraeumen. Es kennt sie nicht, weil sie nicht aus dem Schema
 -- stammen. Zehnte Migration in Folge, in der sie herausgenommen werden.
 -- =============================================================================
 -- CreateEnum
 CREATE TYPE "MitgliedschaftArt" AS ENUM ('MITGLIED', 'AUFSICHT');
 -- CreateTable
 CREATE TABLE "benutzer" (
    "id" UUID NOT NULL,
    "email" VARCHAR(200) NOT NULL,
    "passwortHash" VARCHAR(120),
    "passwortGeaendertAm" TIMESTAMPTZ(3),
    "oidcSubject" VARCHAR(255),
    "oidcGruppen" TEXT[] DEFAULT ARRAY[]::TEXT[],
    "letzteAnmeldung" TIMESTAMPTZ(3),
    "fehlversuche" INTEGER NOT NULL DEFAULT 0,
    "gesperrtBis" TIMESTAMPTZ(3),
    "aktiv" BOOLEAN NOT NULL DEFAULT true,
    "istVerwalter" BOOLEAN NOT NULL DEFAULT false,
    "erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
    "geaendertAm" TIMESTAMPTZ(3) NOT NULL,
    "geloeschtAm" TIMESTAMPTZ(3),
    CONSTRAINT "benutzer_pkey" PRIMARY KEY ("id")
 );
 -- CreateTable
 CREATE TABLE "mitgliedschaft" (
    "id" UUID NOT NULL,
    "organisationId" UUID NOT NULL,
    "benutzerId" UUID NOT NULL,
    "personId" UUID,
    "art" "MitgliedschaftArt" NOT NULL DEFAULT 'MITGLIED',
    "aktiv" BOOLEAN NOT NULL DEFAULT true,
    "vergebenVonId" UUID,
    "erstelltAm" TIMESTAMPTZ(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
    "geaendertAm" TIMESTAMPTZ(3) NOT NULL,
    CONSTRAINT "mitgliedschaft_pkey" PRIMARY KEY ("id")
 );
 -- CreateIndex
 CREATE UNIQUE INDEX "benutzer_email_key" ON "benutzer"("email");
 CREATE UNIQUE INDEX "benutzer_oidcSubject_key" ON "benutzer"("oidcSubject");
 CREATE INDEX "benutzer_oidcSubject_idx" ON "benutzer"("oidcSubject");
 CREATE UNIQUE INDEX "mitgliedschaft_benutzerId_organisationId_key"
    ON "mitgliedschaft"("benutzerId", "organisationId");
 CREATE UNIQUE INDEX "mitgliedschaft_personId_key" ON "mitgliedschaft"("personId");
 CREATE INDEX "mitgliedschaft_organisationId_art_idx"
    ON "mitgliedschaft"("organisationId", "art");
 -- AddForeignKey
 ALTER TABLE "mitgliedschaft" ADD CONSTRAINT "mitgliedschaft_organisationId_fkey"
    FOREIGN KEY ("organisationId") REFERENCES "organisation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 ALTER TABLE "mitgliedschaft" ADD CONSTRAINT "mitgliedschaft_benutzerId_fkey"
    FOREIGN KEY ("benutzerId") REFERENCES "benutzer"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 ALTER TABLE "mitgliedschaft" ADD CONSTRAINT "mitgliedschaft_personId_fkey"
    FOREIGN KEY ("personId") REFERENCES "person"("id") ON DELETE CASCADE ON UPDATE CASCADE;
 -- -----------------------------------------------------------------------------
 -- Die Umstellung der vorhandenen Anmeldungen
 -- -----------------------------------------------------------------------------
 -- Ein Konto je E-Mail-Adresse, über alle Wehren hinweg.
 --
 -- Angelegt wird nur für Personen, die sich überhaupt anmelden konnten: mit
 -- Passwort-Hash oder OIDC-Subject. Eine Akte ohne beides ist eine Akte und
 -- kein Konto — dabei bleibt es.
 --
 -- `DISTINCT ON (lower(email))` entscheidet bei mehreren Akten mit derselben
 -- Adresse: die älteste gewinnt und stellt die Anmeldedaten. Die anderen
 -- werden gleich darunter zu weiteren Mitgliedschaften desselben Kontos.
 INSERT INTO "benutzer" (
    "id", "email", "passwortHash", "passwortGeaendertAm",
    "oidcSubject", "oidcGruppen", "letzteAnmeldung", "fehlversuche",
    "gesperrtBis", "aktiv", "istVerwalter", "erstelltAm", "geaendertAm"
 )
 SELECT DISTINCT ON (lower(p."email"))
    gen_random_uuid(),
    lower(p."email"),
    p."passwortHash",
    p."passwortGeaendertAm",
    p."oidcSubject",
    p."oidcGruppen",
    p."letzteAnmeldung",
    p."fehlversuche",
    p."gesperrtBis",
    p."aktiv",
    -- Wer bislang SUPERADMIN war, verwaltet ab jetzt die Installation. Das
    -- ist der einzige Weg, auf dem dieses Merkmal je gesetzt wird, ohne dass
    -- ein Mensch es vergibt.
    EXISTS (
        SELECT 1
          FROM "person_rolle" pr
          JOIN "rolle" r ON r."id" = pr."rolleId"
         WHERE pr."personId" = p."id"
           AND r."schluessel" = 'SUPERADMIN'
    ),
    p."erstelltAm",
    now()
  FROM "person" p
 WHERE p."email" IS NOT NULL
   AND p."geloeschtAm" IS NULL
   AND (p."passwortHash" IS NOT NULL OR p."oidcSubject" IS NOT NULL)
 ORDER BY lower(p."email"), p."erstelltAm" ASC;
 -- Je Akte eine Mitgliedschaft am passenden Konto.
 --
 -- Auch für die Akten, die beim Anlegen der Konten übergangen wurden: genau
 -- sie sind die Doppelmitgliedschaften, um die es in dieser Phase geht.
 INSERT INTO "mitgliedschaft" (
    "id", "organisationId", "benutzerId", "personId", "art", "aktiv",
    "erstelltAm", "geaendertAm"
 )
 SELECT
    gen_random_uuid(),
    p."organisationId",
    b."id",
    p."id",
    'MITGLIED',
    p."aktiv",
    p."erstelltAm",
    now()
  FROM "person" p
  JOIN "benutzer" b ON b."email" = lower(p."email")
 WHERE p."email" IS NOT NULL
   AND p."geloeschtAm" IS NULL
   AND (p."passwortHash" IS NOT NULL OR p."oidcSubject" IS NOT NULL);
 -- Ein zweites Konto in derselben Wehr kann es nach der Umstellung nicht
 -- geben — der eindeutige Index oben hätte es verhindert. Diese Prüfung ist
 -- die Gegenprobe: schlägt sie an, ist etwas an den Annahmen falsch, und die
 -- Migration bricht ab, statt einen halben Zustand zu hinterlassen.
 DO $$
 DECLARE
    ohne_konto INTEGER;
 BEGIN
    SELECT count(*) INTO ohne_konto
      FROM "person" p
     WHERE p."geloeschtAm" IS NULL
       AND (p."passwortHash" IS NOT NULL OR p."oidcSubject" IS NOT NULL)
       AND NOT EXISTS (SELECT 1 FROM "mitgliedschaft" m WHERE m."personId" = p."id");
    IF ohne_konto > 0 THEN
        RAISE EXCEPTION
            'Umstellung unvollstaendig: % Personen mit Anmeldedaten haben kein Konto '
            'bekommen. Vermutlich fehlt ihnen die E-Mail-Adresse.', ohne_konto;
    END IF;
 END $$;
 -- -----------------------------------------------------------------------------
 -- Erst jetzt fallen die alten Spalten
 -- -----------------------------------------------------------------------------
 DROP INDEX IF EXISTS "person_organisationId_oidcSubject_key";
 DROP INDEX IF EXISTS "person_oidcSubject_idx";
 ALTER TABLE "person"
    DROP COLUMN "passwortHash",
    DROP COLUMN "passwortGeaendertAm",
    DROP COLUMN "oidcSubject",
    DROP COLUMN "oidcGruppen",
    DROP COLUMN "letzteAnmeldung",
    DROP COLUMN "fehlversuche",
    DROP COLUMN "gesperrtBis";
@@ -0,0 +1,153 @@
 -- =============================================================================
 -- Phase 10 — Mandantenfähigkeit: Absicherung
 --
 -- Zwei Tabellen, zwei sehr verschiedene Schutzbedürfnisse.
 --
 -- `mitgliedschaft` trägt `organisationId` und wird behandelt wie jede andere
 -- Tabelle: Row Level Security, Policy auf die aktuelle Organisation. Wer in
 -- Wehr A angemeldet ist, sieht die Mitgliedschaften von Wehr A — und damit
 -- übrigens auch nicht, in welchen anderen Wehren ein Kollege noch geführt
 -- wird. Das ist Absicht.
 --
 -- `benutzer` trägt bewusst KEINE `organisationId` und kann es nicht: sie ist
 -- der Angelpunkt, an dem ein Mensch zu mehreren Wehren gehört. RLS greift hier
 -- also nicht. Stattdessen wird sie über Rechte geschützt — dieselbe Lösung wie
 -- bei `berechtigung` aus Phase 0, und aus demselben Grund: eine Tabelle, die
 -- über allen Mandanten steht, gehört nicht in die Hand der Anwendungsrolle.
 -- =============================================================================
 -- -----------------------------------------------------------------------------
 -- Row Level Security für die Mitgliedschaft
 -- -----------------------------------------------------------------------------
 ALTER TABLE "mitgliedschaft" ENABLE ROW LEVEL SECURITY;
 ALTER TABLE "mitgliedschaft" FORCE ROW LEVEL SECURITY;
 DROP POLICY IF EXISTS "mitgliedschaft_mandant" ON "mitgliedschaft";
 CREATE POLICY "mitgliedschaft_mandant" ON "mitgliedschaft" FOR ALL
    USING ("organisationId" = aktuelle_organisation())
    WITH CHECK ("organisationId" = aktuelle_organisation());
 -- -----------------------------------------------------------------------------
 -- Prüfbedingungen
 -- -----------------------------------------------------------------------------
 -- Eine Mitgliedschaft als MITGLIED braucht die Personenakte — sie ist ja
 -- genau die Verbindung zwischen Konto und Wehr. Die Aufsicht darf keine
 -- haben: die Kreisebene gehört der Wehr nicht an und hat dort nichts in der
 -- Mitgliederliste zu suchen.
 ALTER TABLE "mitgliedschaft" ADD CONSTRAINT "mitgliedschaft_akte_passend" CHECK (
    ("art" = 'MITGLIED' AND "personId" IS NOT NULL)
    OR ("art" = 'AUFSICHT' AND "personId" IS NULL)
 );
 -- Die Akte muss zu derselben Wehr gehören wie die Mitgliedschaft. Ein
 -- Fremdschlüssel allein sagt darüber nichts — er prüft nur, dass es die Akte
 -- gibt, nicht, wo sie liegt. Ohne diese Bedingung ließe sich ein Konto über
 -- eine Akte aus Wehr A in Wehr B hineinhängen, und die Sitzung stünde mit
 -- einer personId da, die dort niemandem gehört.
 CREATE OR REPLACE FUNCTION mitgliedschaft_akte_gleiche_wehr()
 RETURNS TRIGGER AS $$
 DECLARE
    akte_wehr uuid;
 BEGIN
    IF NEW."personId" IS NULL THEN
        RETURN NEW;
    END IF;
    SELECT "organisationId" INTO akte_wehr FROM "person" WHERE "id" = NEW."personId";
    IF akte_wehr IS DISTINCT FROM NEW."organisationId" THEN
        RAISE EXCEPTION
            'Die Personenakte gehoert zu einer anderen Wehr als die Mitgliedschaft. '
            'Ein Konto wird je Wehr an die dortige Akte gehaengt.';
    END IF;
    RETURN NEW;
 END;
 $$ LANGUAGE plpgsql;
 DROP TRIGGER IF EXISTS mitgliedschaft_akte_gleiche_wehr_trigger ON "mitgliedschaft";
 CREATE TRIGGER mitgliedschaft_akte_gleiche_wehr_trigger
    BEFORE INSERT OR UPDATE OF "personId", "organisationId" ON "mitgliedschaft"
    FOR EACH ROW
    EXECUTE FUNCTION mitgliedschaft_akte_gleiche_wehr();
 -- Eine E-Mail-Adresse ohne @ ist keine. Die Anmeldung hängt daran, und ein
 -- Konto, mit dem sich niemand anmelden kann, fällt sonst erst auf, wenn es
 -- jemand versucht.
 ALTER TABLE "benutzer" ADD CONSTRAINT "benutzer_email_plausibel" CHECK (
    "email" LIKE '%@%.%' AND length("email") >= 6
 );
 -- Ein Konto ohne jeden Anmeldeweg wäre eine Karteileiche. Entweder ein
 -- Passwort oder ein OIDC-Subject — sonst ist es keines.
 ALTER TABLE "benutzer" ADD CONSTRAINT "benutzer_anmeldeweg_vorhanden" CHECK (
    "passwortHash" IS NOT NULL OR "oidcSubject" IS NOT NULL
 );
 -- -----------------------------------------------------------------------------
 -- Rechte
 -- -----------------------------------------------------------------------------
 DO $$
 BEGIN
    IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'florian_app') THEN
        EXECUTE 'GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO florian_app';
        EXECUTE 'GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO florian_app';
        EXECUTE 'REVOKE INSERT, UPDATE, DELETE ON "berechtigung" FROM florian_app';
        EXECUTE 'REVOKE UPDATE, DELETE ON "audit_log" FROM florian_app';
        EXECUTE 'REVOKE UPDATE, DELETE ON "kiosk_vorgang" FROM florian_app';
        EXECUTE 'REVOKE UPDATE, DELETE ON "druckmessung" FROM florian_app';
        EXECUTE 'REVOKE UPDATE, DELETE ON "atemschutz_ereignis" FROM florian_app';
        EXECUTE 'REVOKE DELETE ON "benachrichtigung" FROM florian_app';
        EXECUTE 'REVOKE DELETE ON "ki_vorgang" FROM florian_app';
        EXECUTE 'REVOKE UPDATE, DELETE ON "wikiversion" FROM florian_app';
        EXECUTE 'REVOKE DELETE ON "kassenabschluss" FROM florian_app';
        -- Konten legt die Anwendungsrolle nicht an und löscht sie nicht.
        --
        -- Beides geht über den Systemzugang, also über denselben Weg, über
        -- den sich schon heute die Anmeldung eine Person sucht (RLS kennt vor
        -- der Anmeldung ja noch keine Organisation). UPDATE bleibt erlaubt,
        -- weil jede Anmeldung eines schreibt: letzte Anmeldung, Fehlversuche,
        -- Sperre. Ein REVOKE darauf hiesse, dass niemand sich mehr anmelden
        -- kann.
        EXECUTE 'REVOKE INSERT, DELETE ON "benutzer" FROM florian_app';
    END IF;
 END $$;
 -- -----------------------------------------------------------------------------
 -- Ein Konto behält seine Kennung
 -- -----------------------------------------------------------------------------
 -- Was die Anwendungsrolle am Konto ändern darf, ist genau das, was bei jeder
 -- Anmeldung anfällt. Alles Übrige — E-Mail, Passwort, Verwalterrecht —
 -- gehört in die Kontenverwaltung und damit an den Systemzugang.
 --
 -- Ohne diese Sperre wäre `istVerwalter` über jeden Weg erreichbar, der ein
 -- Konto schreibt. Und ein Merkmal, das die Mandantentrennung aufhebt, darf
 -- nicht dort gesetzt werden können, wo eine Wehr ihre eigenen Daten pflegt.
 CREATE OR REPLACE FUNCTION benutzer_kennung_unveraenderlich()
 RETURNS TRIGGER AS $$
 BEGIN
    IF current_user <> 'florian_app' THEN
        RETURN NEW;
    END IF;
    IF NEW."email" IS DISTINCT FROM OLD."email"
       OR NEW."istVerwalter" IS DISTINCT FROM OLD."istVerwalter"
       OR NEW."oidcSubject" IS DISTINCT FROM OLD."oidcSubject" THEN
        RAISE EXCEPTION
            'E-Mail, OIDC-Subject und das Verwalterrecht eines Kontos werden ueber die '
            'Kontenverwaltung geaendert, nicht aus einer Wehr heraus.';
    END IF;
    RETURN NEW;
 END;
 $$ LANGUAGE plpgsql;
 DROP TRIGGER IF EXISTS benutzer_kennung_unveraenderlich_trigger ON "benutzer";
 CREATE TRIGGER benutzer_kennung_unveraenderlich_trigger
    BEFORE UPDATE ON "benutzer"
    FOR EACH ROW
    EXECUTE FUNCTION benutzer_kennung_unveraenderlich();
@@ -107,6 +107,21 @@ enum FahrzeugArt {
 }
 /// Dienstgrad nach bayerischer Feuerwehr-Dienstgradverordnung (Auswahl).
 /// Wie jemand zu einer Wehr gehört.
 ///
 /// MITGLIED ist der Regelfall: das Konto hängt an einer Personenakte in dieser
 /// Wehr und bringt deren Rollen mit.
 ///
 /// AUFSICHT ist die Kreisebene — Kreisbrandrat, Kreisbrandinspektion. Sie
 /// gehört der Wehr nicht an, hat dort also auch keine Personenakte, und darf
 /// ausschließlich lesen. Ein Kreisbrandinspektor, der zugleich Mitglied seiner
 /// Heimatwehr ist, hat schlicht zwei Mitgliedschaften: dort MITGLIED, in den
 /// betreuten Wehren AUFSICHT.
 enum MitgliedschaftArt {
  MITGLIED
  AUFSICHT
 }
 enum Dienstgrad {
  FEUERWEHRANWAERTER
  FEUERWEHRMANN
@@ -153,6 +168,7 @@ model Organisation {
  geloeschtAm DateTime? @db.Timestamptz(3)
  personen            Person[]
  mitgliedschaften    Mitgliedschaft[]
  rollen              Rolle[]
  personRollen        PersonRolle[]
  rolleRechte         RolleBerechtigung[]
@@ -234,6 +250,17 @@ model Organisation {
  diktate        Diktat[]
  belegentwuerfe Belegentwurf[]
  // Phase 9 — Kassenverwaltung
  kassenkonten        Kassenkonto[]
  buchungskategorien  Buchungskategorie[]
  buchungen           Buchung[]
  beitragssaetze      Beitragssatz[]
  beitraege           Beitrag[]
  rechnungen          Rechnung[]
  rechnungspositionen Rechnungsposition[]
  kassenabschluesse   Kassenabschluss[]
  abschlussposten     Abschlussposten[]
  @@index([aktiv])
  @@map("organisation")
 }
@@ -269,17 +296,12 @@ model Person {
  /// Aktiver Dienst, passiv, Jugendfeuerwehr, Ehrenmitglied.
  abteilung      String?   @db.VarChar(60)
-  /// bcrypt-Hash für den lokalen Login. Null, wenn nur OIDC genutzt wird.
+  /// Die Anmeldedaten liegen seit Phase 10 am `Benutzer`, nicht mehr hier.
-  passwortHash        String?   @db.VarChar(120)
+  ///
-  passwortGeaendertAm DateTime? @db.Timestamptz(3)
+  /// Der Grund ist die Doppelmitgliedschaft: wer in zwei Wehren geführt wird,
-  /// "sub"-Claim aus authentik. Verknüpft die Person mit dem OIDC-Konto.
+  /// hat dort zwei Akten — aber ein Passwort. Lägen Hash und OIDC-Subject
-  oidcSubject         String?   @db.VarChar(255)
+  /// weiterhin an der Akte, gäbe es zwei davon, die auseinanderlaufen können,
-  /// Gruppen aus dem letzten OIDC-Login — nur zur Nachvollziehbarkeit.
+  /// und die Anmeldung per E-Mail wäre mehrdeutig.
  oidcGruppen         String[]  @default([])
  letzteAnmeldung DateTime? @db.Timestamptz(3)
  fehlversuche    Int       @default(0)
  gesperrtBis     DateTime? @db.Timestamptz(3)
  aktiv Boolean @default(true)
  /// Profilbild. Liegt wie alles andere in MinIO.
@@ -290,6 +312,7 @@ model Person {
  geloeschtAm DateTime? @db.Timestamptz(3)
  organisation               Organisation    @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  mitgliedschaft             Mitgliedschaft? @relation("MitgliedschaftPerson")
  avatar                     Datei?          @relation("PersonAvatar", fields: [avatarDateiId], references: [id], onDelete: SetNull)
  rollen                     PersonRolle[]   @relation("PersonRollenInhaber")
  vergebeneRollen            PersonRolle[]   @relation("PersonRollenVergeber")
@@ -356,19 +379,112 @@ model Person {
  erfassteBelege          Belegentwurf[] @relation("BelegentwurfErfasser")
  bestaetigteBelege       Belegentwurf[] @relation("BelegentwurfBestaetiger")
-  /// E-Mail und OIDC-Subject sind je Wehr eindeutig, nicht global — dieselbe
+  // Phase 9 — Kassenverwaltung
-  /// Person kann in zwei Wehren Mitglied sein.
+  buchungen                 Buchung[]         @relation("BuchungPerson")
  erfassteBuchungen         Buchung[]         @relation("BuchungErfasser")
  beitraege                 Beitrag[]         @relation("BeitragPerson")
  gepruefteAbschluesse      Kassenabschluss[] @relation("AbschlussPruefer")
  zweitgepruefteAbschluesse Kassenabschluss[] @relation("AbschlussZweitpruefer")
  erstellteRechnungen       Rechnung[]        @relation("RechnungErsteller")
  /// Die E-Mail ist je Wehr eindeutig, nicht global: dieselbe Person kann in
  /// zwei Wehren eine Akte haben. Angemeldet wird sich nicht damit, sondern
  /// mit der E-Mail des `Benutzer` — die ist global eindeutig.
  @@unique([organisationId, email])
  @@unique([organisationId, oidcSubject])
  @@unique([organisationId, mitgliedsnummer])
  @@index([organisationId, nachname, vorname])
  @@index([organisationId, aktiv])
  @@index([oidcSubject])
  @@map("person")
 }
 /// Eine Rolle innerhalb einer Wehr. Die Systemrollen legt der Seed an; eigene
 /// Rollen kann der Kommandant ergänzen.
 /// Ein Anmeldekonto.
 ///
 /// **Die einzige Tabelle neben `Berechtigung` ohne `organisationId`** — und
 /// zwar notwendigerweise: sie ist der Angelpunkt, an dem ein Mensch zu
 /// mehreren Wehren gehören kann. Ein Konto mit Mandantenkennung könnte genau
 /// das nicht.
 ///
 /// Sie ist deshalb auch nicht über Row Level Security geschützt, sondern über
 /// Rechte: die Anwendungsrolle darf sie nur lesen und die Anmeldefelder
 /// fortschreiben, angelegt und verändert werden Konten über den
 /// Systemzugang. Was ein Konto in einer Wehr sehen darf, entscheidet nicht es
 /// selbst, sondern seine `Mitgliedschaft` — und die trägt `organisationId`
 /// wie jede andere Tabelle.
 model Benutzer {
  id String @id @default(uuid()) @db.Uuid
  /// Global eindeutig. Das ist der Unterschied zur E-Mail an der Personenakte:
  /// die ist eine Kontaktangabe je Wehr, diese hier ist die Anmeldung.
  email String @unique @db.VarChar(200)
  /// bcrypt-Hash für den lokalen Login. Null, wenn nur OIDC genutzt wird.
  passwortHash        String?   @db.VarChar(120)
  passwortGeaendertAm DateTime? @db.Timestamptz(3)
  /// "sub"-Claim aus authentik.
  oidcSubject         String?   @unique @db.VarChar(255)
  /// Gruppen aus dem letzten OIDC-Login — nur zur Nachvollziehbarkeit.
  oidcGruppen         String[]  @default([])
  letzteAnmeldung DateTime? @db.Timestamptz(3)
  fehlversuche    Int       @default(0)
  gesperrtBis     DateTime? @db.Timestamptz(3)
  aktiv           Boolean   @default(true)
  /// Verwaltet die Installation: Wehren anlegen und in jede hineinschalten.
  ///
  /// Bewusst ein Merkmal des Kontos und keine Rolle innerhalb einer Wehr. Eine
  /// Rolle gilt je Organisation — wer Wehren anlegt, steht aber über allen,
  /// und ein Recht, das in Wehr A vergeben wird und in Wehr B wirkt, wäre
  /// genau die Art Hintertür, die die Mandantentrennung aushöhlt.
  istVerwalter Boolean @default(false)
  erstelltAm  DateTime  @default(now()) @db.Timestamptz(3)
  geaendertAm DateTime  @updatedAt @db.Timestamptz(3)
  geloeschtAm DateTime? @db.Timestamptz(3)
  mitgliedschaften Mitgliedschaft[]
  @@index([oidcSubject])
  @@map("benutzer")
 }
 /// Die Zugehörigkeit eines Kontos zu einer Wehr.
 ///
 /// Sie ist das, was eine Sitzung ausmacht: erst die Wahl einer Mitgliedschaft
 /// entscheidet, welche Wehr in `app.current_organisation` steht und welche
 /// Rollen gelten. Wer nur eine hat — die allermeisten —, merkt davon nichts.
 model Mitgliedschaft {
  id             String @id @default(uuid()) @db.Uuid
  organisationId String @db.Uuid
  benutzerId     String @db.Uuid
  /// Die Personenakte in dieser Wehr. Bei AUFSICHT leer: die Kreisebene ist
  /// dort nicht Mitglied und soll auch in keiner Mitgliederliste auftauchen.
  personId String? @db.Uuid
  art   MitgliedschaftArt @default(MITGLIED)
  aktiv Boolean           @default(true)
  /// Wer sie eingerichtet hat. Bei der Umstellung aus Phase 10 leer.
  vergebenVonId String?  @db.Uuid
  erstelltAm    DateTime @default(now()) @db.Timestamptz(3)
  geaendertAm   DateTime @updatedAt @db.Timestamptz(3)
  organisation Organisation @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  benutzer     Benutzer     @relation(fields: [benutzerId], references: [id], onDelete: Cascade)
  person       Person?      @relation("MitgliedschaftPerson", fields: [personId], references: [id], onDelete: Cascade)
  /// Ein Konto gehört einer Wehr höchstens einmal an.
  @@unique([benutzerId, organisationId])
  /// Und eine Personenakte hängt an höchstens einem Konto — sonst wäre nicht
  /// entscheidbar, wer unter ihrem Namen gehandelt hat.
  @@unique([personId])
  @@index([organisationId, art])
  @@map("mitgliedschaft")
 }
 model Rolle {
  id             String @id @default(uuid()) @db.Uuid
  organisationId String @db.Uuid
@@ -602,6 +718,11 @@ model Datei {
  alsDiktataufnahme Diktat[]       @relation("DiktatAufnahme")
  alsBelegfoto      Belegentwurf[] @relation("BelegentwurfFoto")
  // Phase 9
  alsBuchungsbeleg      Buchung[]         @relation("BuchungBeleg")
  alsRechnungsPdf       Rechnung[]        @relation("RechnungPdf")
  alsKassenpruefbericht Kassenabschluss[] @relation("AbschlussBericht")
  @@unique([bucket, objektSchluessel])
  @@index([organisationId, entitaet, entitaetId])
  @@index([organisationId, kategorie])
@@ -3601,7 +3722,11 @@ model Belegentwurf {
  geaendertAm DateTime  @updatedAt @db.Timestamptz(3)
  geloeschtAm DateTime? @db.Timestamptz(3)
  /// Die Buchung, die daraus geworden ist (Phase 9). Leer heißt: noch keine.
  buchungId String? @db.Uuid
  organisation  Organisation @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  buchung       Buchung?     @relation(fields: [buchungId], references: [id], onDelete: SetNull)
  fotoDatei     Datei        @relation("BelegentwurfFoto", fields: [fotoDateiId], references: [id], onDelete: Restrict)
  kiVorgang     KiVorgang?   @relation(fields: [kiVorgangId], references: [id], onDelete: SetNull)
  erfasstVon    Person?      @relation("BelegentwurfErfasser", fields: [erfasstVonId], references: [id], onDelete: SetNull)
@@ -3611,3 +3736,435 @@ model Belegentwurf {
  @@index([organisationId, belegdatum])
  @@map("belegentwurf")
 }
 // =============================================================================
 // Phase 9 — Kassenverwaltung
 //
 // Drei Festlegungen bestimmen alles Weitere. Sie stehen hier, weil sie sich
 // im Schema abbilden und nicht bloß in der Anwendung durchgesetzt werden:
 //
 //   1. **Beträge sind DECIMAL(12,2), niemals Fließkomma.** 0,1 + 0,2 ist in
 //      binärer Fließkommadarstellung nicht 0,3, und eine Kasse, die sich um
 //      Cent verrechnet, ist keine Kasse. Zwölf Stellen reichen für zehn
 //      Milliarden — mehr als jede Wehr je bewegt.
 //
 //   2. **Eine festgeschriebene Buchung ist unveränderbar.** Korrekturen laufen
 //      über eine Gegenbuchung mit Verweis auf das Original. Das ist keine
 //      Förmlichkeit: ein Kassenbuch, in dem man rückwirkend ändern kann, ist
 //      vor der Kassenprüfung wertlos. Der Trigger in der Migration setzt es
 //      durch.
 //
 //   3. **Der Kassenabschluss friert seinen Zeitraum ein.** Danach nimmt die
 //      Buchungsmaske kein Datum daraus mehr an. Sonst hätte der geprüfte
 //      Bestand am Tag nach der Prüfung eine andere Zahl.
 //
 // Der Betrag ist immer **positiv**; die Richtung steht in `art`. Ein
 // vorzeichenbehafteter Betrag wäre kürzer, aber jede Auswertung müsste dann
 // darauf vertrauen, dass das Vorzeichen zur Kategorie passt — und beim ersten
 // Tippfehler stimmt die Summe nicht mehr.
 // =============================================================================
 /// Welche Art von Konto.
 enum KontoArt {
  /// Die Barkasse im Gerätehaus. Wird bei der Prüfung gezählt.
  BAR
  /// Ein Bankkonto. Wird gegen den Auszug geprüft.
  BANK
  /// Rücklage für eine bestimmte Anschaffung — getrennt geführt, damit
  /// niemand versehentlich das Geld für das neue Fahrzeug verbraucht.
  RUECKLAGE
 }
 /// Geht Geld ein oder hinaus.
 enum BuchungsArt {
  EINNAHME
  AUSGABE
 }
 /// Wie es um einen Beitrag steht.
 enum BeitragStand {
  OFFEN
  BEZAHLT
  /// Erlassen — bei Härtefällen, Ehrenmitgliedern, Jugendlichen.
  ERLASSEN
  GEMAHNT
 }
 /// Wie es um eine Rechnung steht.
 enum RechnungStand {
  ENTWURF
  VERSENDET
  BEZAHLT
  GEMAHNT
  STORNIERT
 }
 /// Woraus eine Rechnung an Dritte entsteht.
 enum RechnungsAnlass {
  /// Böswilliger oder fahrlässig ausgelöster Fehlalarm.
  FEHLALARM
  /// Ölspur, auslaufende Betriebsstoffe — nach Verursacherprinzip.
  OELEINSATZ
  /// Absicherung, Brandsicherheitswache bei einer Veranstaltung.
  VERANSTALTUNG
  /// Vermietung von Gerät oder Räumen.
  VERMIETUNG
  SONSTIGES
 }
 /// Ein Konto der Wehr.
 model Kassenkonto {
  id             String @id @default(uuid()) @db.Uuid
  organisationId String @db.Uuid
  bezeichnung String   @db.VarChar(120)
  art         KontoArt @default(BAR)
  /// Nur bei Bankkonten. Wird in Auswertungen nie vollständig angezeigt.
  iban String? @db.VarChar(34)
  bic  String? @db.VarChar(11)
  /// Der Bestand zu Beginn der Aufzeichnung. Alles Weitere ergibt sich aus
  /// den Buchungen — er wird nie nachträglich „korrigiert".
  anfangsbestand Decimal @default(0) @db.Decimal(12, 2)
  bemerkung String? @db.VarChar(500)
  aktiv     Boolean @default(true)
  erstelltAm  DateTime  @default(now()) @db.Timestamptz(3)
  geaendertAm DateTime  @updatedAt @db.Timestamptz(3)
  geloeschtAm DateTime? @db.Timestamptz(3)
  organisation Organisation      @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  buchungen    Buchung[]
  posten       Abschlussposten[]
  @@unique([organisationId, bezeichnung])
  @@index([organisationId, aktiv])
  @@map("kassenkonto")
 }
 /// Wofür Geld ausgegeben oder eingenommen wurde.
 ///
 /// Zweistufig: eine Oberkategorie („Fahrzeuge") mit Unterkategorien
 /// („Kraftstoff", „Reparatur"). Mehr Ebenen braucht eine Wehr nicht, und jede
 /// weitere macht die Auswertung unlesbar.
 model Buchungskategorie {
  id             String @id @default(uuid()) @db.Uuid
  organisationId String @db.Uuid
  name String      @db.VarChar(120)
  art  BuchungsArt
  /// Die Oberkategorie. Leer heißt: das hier ist eine.
  oberkategorieId String? @db.Uuid
  /// Nummer im Kontenrahmen der Gemeinde — für den Export an die Kämmerei.
  kontonummer String? @db.VarChar(20)
  bemerkung String? @db.VarChar(500)
  aktiv     Boolean @default(true)
  erstelltAm  DateTime  @default(now()) @db.Timestamptz(3)
  geaendertAm DateTime  @updatedAt @db.Timestamptz(3)
  geloeschtAm DateTime? @db.Timestamptz(3)
  organisation    Organisation        @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  oberkategorie   Buchungskategorie?  @relation("Kategoriebaum", fields: [oberkategorieId], references: [id], onDelete: SetNull)
  unterkategorien Buchungskategorie[] @relation("Kategoriebaum")
  buchungen       Buchung[]
  @@unique([organisationId, name])
  @@index([organisationId, art])
  @@map("buchungskategorie")
 }
 /// Eine Buchung.
 ///
 /// Der Betrag ist positiv, die Richtung steht in `art`. Festgeschrieben heißt:
 /// unveränderbar und nicht löschbar — die Datenbank hält dagegen. Wer sich
 /// vertan hat, bucht dagegen; die Gegenbuchung verweist auf das Original, und
 /// beide bleiben stehen.
 model Buchung {
  id             String @id @default(uuid()) @db.Uuid
  organisationId String @db.Uuid
  kontoId     String @db.Uuid
  kategorieId String @db.Uuid
  /// Das Buchungsdatum, nicht der Zeitpunkt der Erfassung. Danach richtet
  /// sich, in welchen Abschluss die Buchung fällt.
  datum  DateTime    @db.Date
  art    BuchungsArt
  betrag Decimal     @db.Decimal(12, 2)
  verwendungszweck String  @db.VarChar(300)
  belegnummer      String? @db.VarChar(60)
  /// Wer das Geld bekommen oder gegeben hat. Entweder eine Person der Wehr
  /// **oder** ein Dritter als Text — nie beides.
  personId  String? @db.Uuid
  lieferant String? @db.VarChar(200)
  /// Bei einer Umbuchung zwischen zwei eigenen Konten das Gegenkonto.
  gegenkontoId String? @db.Uuid
  belegDateiId String? @db.Uuid
  /// Festgeschrieben: ab hier unveränderbar.
  festgeschriebenAm DateTime? @db.Timestamptz(3)
  /// Die Buchung, die diese hier aufhebt — und umgekehrt.
  storniertVonId String? @db.Uuid
  erfasstVonId String?  @db.Uuid
  erstelltAm   DateTime @default(now()) @db.Timestamptz(3)
  geaendertAm  DateTime @updatedAt @db.Timestamptz(3)
  organisation Organisation      @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  konto        Kassenkonto       @relation(fields: [kontoId], references: [id], onDelete: Restrict)
  kategorie    Buchungskategorie @relation(fields: [kategorieId], references: [id], onDelete: Restrict)
  person       Person?           @relation("BuchungPerson", fields: [personId], references: [id], onDelete: SetNull)
  erfasstVon   Person?           @relation("BuchungErfasser", fields: [erfasstVonId], references: [id], onDelete: SetNull)
  belegDatei   Datei?            @relation("BuchungBeleg", fields: [belegDateiId], references: [id], onDelete: SetNull)
  storniertVon Buchung?          @relation("Stornierung", fields: [storniertVonId], references: [id], onDelete: SetNull)
  storniert    Buchung[]         @relation("Stornierung")
  beitraege    Beitrag[]
  rechnungen   Rechnung[]
  belegentwurf Belegentwurf[]
  @@index([organisationId, datum(sort: Desc)])
  @@index([organisationId, kontoId, datum])
  @@index([organisationId, kategorieId])
  @@map("buchung")
 }
 /// Was ein Mitglied im Jahr zahlt.
 ///
 /// Je Abteilung ein Satz: Aktive zahlen anderes als Jugend, Ehrenmitglieder
 /// oft nichts. Der Satz gilt ab einem Jahr und wird nicht rückwirkend
 /// geändert — sonst stimmen die Beiträge vergangener Jahre nicht mehr.
 model Beitragssatz {
  id             String @id @default(uuid()) @db.Uuid
  organisationId String @db.Uuid
  bezeichnung String  @db.VarChar(120)
  betrag      Decimal @db.Decimal(12, 2)
  /// Für welche Abteilung. Leer heißt: für alle, die keinen eigenen Satz haben.
  abteilung String? @db.VarChar(60)
  /// Ab welchem Jahr er gilt.
  abJahr Int
  aktiv Boolean @default(true)
  erstelltAm  DateTime @default(now()) @db.Timestamptz(3)
  geaendertAm DateTime @updatedAt @db.Timestamptz(3)
  organisation Organisation @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  beitraege    Beitrag[]
  @@unique([organisationId, abteilung, abJahr])
  @@index([organisationId, abJahr])
  @@map("beitragssatz")
 }
 /// Der Beitrag einer Person für ein Jahr.
 model Beitrag {
  id             String @id @default(uuid()) @db.Uuid
  organisationId String @db.Uuid
  personId String @db.Uuid
  jahr     Int
  satzId String? @db.Uuid
  betrag Decimal @db.Decimal(12, 2)
  stand BeitragStand @default(OFFEN)
  /// Die Buchung, mit der bezahlt wurde. Erst sie macht aus „bezahlt" eine
  /// Zahl in der Kasse.
  buchungId String?   @db.Uuid
  bezahltAm DateTime? @db.Date
  /// Wie oft gemahnt wurde. Null heißt: noch nicht.
  mahnstufe   Int       @default(0)
  gemahntAm   DateTime? @db.Date
  /// Bei Erlass: warum. Ein erlassener Beitrag ohne Begründung ist in der
  /// Kassenprüfung eine offene Frage.
  erlassGrund String?   @db.VarChar(300)
  bemerkung String? @db.VarChar(500)
  erstelltAm  DateTime @default(now()) @db.Timestamptz(3)
  geaendertAm DateTime @updatedAt @db.Timestamptz(3)
  organisation Organisation  @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  person       Person        @relation("BeitragPerson", fields: [personId], references: [id], onDelete: Cascade)
  satz         Beitragssatz? @relation(fields: [satzId], references: [id], onDelete: SetNull)
  buchung      Buchung?      @relation(fields: [buchungId], references: [id], onDelete: SetNull)
  @@unique([personId, jahr])
  @@index([organisationId, jahr, stand])
  @@map("beitrag")
 }
 /// Eine Rechnung an Dritte.
 ///
 /// Fehlalarm, Ölspur, Absicherung einer Veranstaltung. Nummer aus dem
 /// Nummernkreis (`JJJJ-NNNN`), PDF über Gotenberg.
 model Rechnung {
  id             String @id @default(uuid()) @db.Uuid
  organisationId String @db.Uuid
  nummer String          @db.VarChar(20)
  anlass RechnungsAnlass @default(SONSTIGES)
  stand  RechnungStand   @default(ENTWURF)
  /// An wen. Bewusst als Text und nicht als Verweis: der Empfänger ist in
  /// aller Regel niemand, den die Wehr dauerhaft führt.
  empfaenger       String  @db.VarChar(200)
  empfaengerZusatz String? @db.VarChar(200)
  strasse          String? @db.VarChar(200)
  plz              String? @db.VarChar(10)
  ort              String? @db.VarChar(120)
  /// Worauf sie sich bezieht.
  einsatzId String? @db.Uuid
  datum     DateTime @db.Date
  faelligAm DateTime @db.Date
  /// Summe der Positionen. Wird beim Speichern gerechnet, nicht eingegeben.
  betrag Decimal @db.Decimal(12, 2)
  bemerkung String? @db.VarChar(1000)
  /// Die Buchung des Zahlungseingangs.
  buchungId String?   @db.Uuid
  bezahltAm DateTime? @db.Date
  gemahntAm DateTime? @db.Date
  mahnstufe Int       @default(0)
  pdfDateiId String? @db.Uuid
  erstelltVonId String?  @db.Uuid
  erstelltAm    DateTime @default(now()) @db.Timestamptz(3)
  geaendertAm   DateTime @updatedAt @db.Timestamptz(3)
  organisation Organisation        @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  buchung      Buchung?            @relation(fields: [buchungId], references: [id], onDelete: SetNull)
  pdfDatei     Datei?              @relation("RechnungPdf", fields: [pdfDateiId], references: [id], onDelete: SetNull)
  erstelltVon  Person?             @relation("RechnungErsteller", fields: [erstelltVonId], references: [id], onDelete: SetNull)
  positionen   Rechnungsposition[]
  @@unique([organisationId, nummer])
  @@index([organisationId, stand])
  @@index([organisationId, datum(sort: Desc)])
  @@map("rechnung")
 }
 /// Eine Zeile auf einer Rechnung.
 model Rechnungsposition {
  id             String @id @default(uuid()) @db.Uuid
  organisationId String @db.Uuid
  rechnungId     String @db.Uuid
  reihenfolge Int
  bezeichnung String  @db.VarChar(300)
  /// Menge mit drei Nachkommastellen — Einsatzstunden werden viertelstündlich
  /// abgerechnet, und 0,25 muss genau sein.
  menge       Decimal @default(1) @db.Decimal(12, 3)
  einheit     String? @db.VarChar(20)
  einzelpreis Decimal @db.Decimal(12, 2)
  /// Menge × Einzelpreis, beim Speichern gerechnet.
  gesamtpreis Decimal @db.Decimal(12, 2)
  erstelltAm DateTime @default(now()) @db.Timestamptz(3)
  organisation Organisation @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  rechnung     Rechnung     @relation(fields: [rechnungId], references: [id], onDelete: Cascade)
  @@unique([rechnungId, reihenfolge])
  @@index([organisationId])
  @@map("rechnungsposition")
 }
 /// Ein Kassenabschluss.
 ///
 /// Der Vorgang, für den es die ganze Kasse gibt: zwei Kassenprüfer setzen sich
 /// hin, zählen das Bargeld, vergleichen die Kontoauszüge und unterschreiben.
 /// Danach ist der Zeitraum zu — die Buchungsmaske nimmt kein Datum daraus mehr
 /// an.
 ///
 /// Zwei Prüfer, weil es die Satzung fast jeder Wehr so vorsieht. Der zweite
 /// ist trotzdem optional: eine Wehr, die gerade nur einen hat, soll deshalb
 /// nicht ohne Abschluss dastehen.
 model Kassenabschluss {
  id             String @id @default(uuid()) @db.Uuid
  organisationId String @db.Uuid
  vonAm DateTime @db.Date
  bisAm DateTime @db.Date
  /// Summe über alle Konten, aus den Buchungen gerechnet.
  bestandLautBuch   Decimal @db.Decimal(12, 2)
  /// Was tatsächlich gezählt wurde.
  gezaehlterBestand Decimal @db.Decimal(12, 2)
  /// gezaehlt minus laut Buch. Positiv heißt: es war mehr da.
  differenz         Decimal @db.Decimal(12, 2)
  /// Eine Differenz ohne Erklärung ist der Punkt, an dem eine Kassenprüfung
  /// hängen bleibt.
  erlaeuterung String? @db.VarChar(2000)
  prueferId        String?   @db.Uuid
  zweiterPrueferId String?   @db.Uuid
  geprueftAm       DateTime? @db.Date
  berichtDateiId String? @db.Uuid
  /// Festgeschrieben: ab hier ist der Zeitraum zu.
  festgeschriebenAm DateTime? @db.Timestamptz(3)
  erstelltAm  DateTime @default(now()) @db.Timestamptz(3)
  geaendertAm DateTime @updatedAt @db.Timestamptz(3)
  organisation   Organisation      @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  pruefer        Person?           @relation("AbschlussPruefer", fields: [prueferId], references: [id], onDelete: SetNull)
  zweiterPruefer Person?           @relation("AbschlussZweitpruefer", fields: [zweiterPrueferId], references: [id], onDelete: SetNull)
  berichtDatei   Datei?            @relation("AbschlussBericht", fields: [berichtDateiId], references: [id], onDelete: SetNull)
  posten         Abschlussposten[]
  @@index([organisationId, bisAm(sort: Desc)])
  @@map("kassenabschluss")
 }
 /// Was auf einem Konto zum Abschluss stand.
 ///
 /// Je Konto eine Zeile: der Kassenprüfer zählt das Bargeld und liest den
 /// Kontostand vom Auszug ab. Eine einzelne Summe über alles würde verbergen,
 /// auf welchem Konto die Differenz sitzt.
 model Abschlussposten {
  id             String @id @default(uuid()) @db.Uuid
  organisationId String @db.Uuid
  abschlussId    String @db.Uuid
  kontoId        String @db.Uuid
  bestandLautBuch   Decimal @db.Decimal(12, 2)
  gezaehlterBestand Decimal @db.Decimal(12, 2)
  differenz         Decimal @db.Decimal(12, 2)
  bemerkung String? @db.VarChar(500)
  erstelltAm DateTime @default(now()) @db.Timestamptz(3)
  organisation Organisation    @relation(fields: [organisationId], references: [id], onDelete: Cascade)
  abschluss    Kassenabschluss @relation(fields: [abschlussId], references: [id], onDelete: Cascade)
  konto        Kassenkonto     @relation(fields: [kontoId], references: [id], onDelete: Restrict)
  @@unique([abschlussId, kontoId])
  @@index([organisationId])
  @@map("abschlussposten")
 }
@@ -21,6 +21,9 @@
 * Zustellkanäle: niemand wird ungefragt benachrichtigt, auch nicht im Seed.
 * Ab Phase 8 dazu: vier Wiki-Seiten mit eigenem Text — Prüffristen,
 * Atemschutz-Merkblatt, Schlauchpflege und Alarmierungsordnung.
 * Ab Phase 9 dazu: das Kassenjahr — drei Konten, der Standardkontenrahmen,
 * gut dreißig Buchungen über zwei Jahre, die Mitgliedsbeiträge mit Rückständen,
 * zwei Rechnungen und die festgeschriebene Kassenprüfung des Vorjahres.
 *
 * Das Skript läuft über DIRECT_DATABASE_URL, also mit dem Eigentümer-Zugang,
 * der Row Level Security umgehen darf. Anders ginge es nicht: der Seed legt
@@ -36,11 +39,14 @@ import {
  Alarmierungsart,
  AnwesenheitAnlass,
  AusweisTokenTyp,
  BeitragStand,
  BuchungsArt,
  ChecklistenpunktTyp,
  EinsatzFunktion,
  EinsatzKategorie,
  EinsatzStatus,
  Dienstgrad,
  KontoArt,
  DruckArt,
  EreignisArt,
  FahrtZweck,
@@ -51,6 +57,7 @@ import {
  LebensdauerBezug,
  LebensdauerKategorie,
  MangelPrioritaet,
  MitgliedschaftArt,
  MangelStatus,
  PrismaClient,
  PruefErgebnis,
@@ -58,6 +65,8 @@ import {
  PruefungStatus,
  QualifikationsArt,
  RolleSchluessel,
  RechnungsAnlass,
  RechnungStand,
  SignaturRolle,
  HydrantStatus,
  HydrantTyp,
@@ -82,7 +91,26 @@ const prisma = new PrismaClient({
 });
 const RUNDEN = Number(process.env.AUTH_BCRYPT_ROUNDS ?? 12);
-const ORGANISATION_SLUG = "ff-musterhausen";
+
 /**
 * Welche Wehr angelegt wird.
 *
 * Vorgabe ist die Beispielwehr, die in den Bildschirmfotos und in der
 * Anleitung steht. Über die Umgebung lässt sich eine zweite anlegen — genau
 * dafür gibt es `npm run db:test-reset`:
 *
 *     SEED_SLUG=ff-teststelle SEED_NAME="Freiwillige Feuerwehr Teststelle" \
 *     SEED_KURZNAME="FF Teststelle" SEED_ADMIN_EMAIL=e2e@teststelle.de \
 *     npm run db:seed
 *
 * Der Grund ist ein handfester: die E2E-Tests haben bis Phase 8 in die
 * Beispielwehr geschrieben. Nach fünf Phasen standen dort 94 Atemschutz-
 * Überwachungen statt einer, und bei jedem Testlauf änderten sich alle
 * Bildschirmfotos. Seitdem laufen sie gegen eine eigene Wehr.
 */
 const ORGANISATION_SLUG = process.env.SEED_SLUG ?? "ff-musterhausen";
 const ORGANISATION_NAME = process.env.SEED_NAME ?? "Freiwillige Feuerwehr Musterhausen";
 const ORGANISATION_KURZNAME = process.env.SEED_KURZNAME ?? "FF Musterhausen";
 function log(nachricht: string): void {
  console.info(`[seed] ${nachricht}`);
@@ -147,8 +175,8 @@ async function organisationAnlegen() {
    update: {},
    create: {
      slug: ORGANISATION_SLUG,
-      name: "Freiwillige Feuerwehr Musterhausen",
+      name: ORGANISATION_NAME,
-      kurzname: "FF Musterhausen",
+      kurzname: ORGANISATION_KURZNAME,
      strasse: "Hauptstraße 12",
      plz: "85354",
      ort: "Musterhausen",
@@ -171,7 +199,13 @@ async function rollenAnlegen(organisationId: string, katalog: Map<string, string
  const rollenKarte = new Map<string, string>();
-  for (const schluessel of ROLLEN) {
+  // AUFSICHT ist keine vergebbare Rolle und steht deshalb auch nicht im
  // Prisma-Enum. Sie ergibt sich seit Phase 10 daraus, dass ein Konto einer
  // Wehr als Kreisaufsicht zugeordnet ist — sie hier anzulegen hiesse, dass
  // jemand sie innerhalb einer Wehr vergeben könnte.
  const vergebbar = ROLLEN.filter((schluessel) => schluessel !== "AUFSICHT");
  for (const schluessel of vergebbar) {
    const rolle = await prisma.rolle.upsert({
      where: {
        organisationId_schluessel: {
@@ -472,12 +506,31 @@ async function adminAnlegen(organisationId: string, rollenKarte: Map<string, str
      nachname: "Administrator",
      email,
      dienstgrad: Dienstgrad.KEIN,
      passwortHash: await bcrypt.hash(passwort, RUNDEN),
      passwortGeaendertAm: new Date(),
      abteilung: "Verwaltung",
    },
  });
  // Das Konto seit Phase 10 getrennt von der Akte. Die E-Mail ist global
  // eindeutig — wird derselbe Seed für eine zweite Wehr gefahren, entsteht
  // deshalb kein zweites Konto, sondern eine zweite Mitgliedschaft. Genau so
  // sieht Doppelmitgliedschaft in echt aus.
  const konto = await prisma.benutzer.upsert({
    where: { email },
    update: {},
    create: {
      email,
      passwortHash: await bcrypt.hash(passwort, RUNDEN),
      passwortGeaendertAm: new Date(),
      istVerwalter: true,
    },
  });
  await prisma.mitgliedschaft.upsert({
    where: { benutzerId_organisationId: { benutzerId: konto.id, organisationId } },
    update: {},
    create: { organisationId, benutzerId: konto.id, personId: admin.id },
  });
  const rolleId = rollenKarte.get(RolleSchluessel.SUPERADMIN);
  if (rolleId) {
    await prisma.personRolle.upsert({
@@ -3228,6 +3281,861 @@ async function wikiAnlegen(organisationId: string): Promise<void> {
  );
 }
 // -----------------------------------------------------------------------------
 // Phase 9 — Kassenverwaltung
 //
 // Ein Kassenjahr, wie es eine Wehr wirklich hat: drei Konten, der
 // Standardkontenrahmen, gut dreißig Buchungen über zwei Jahre, die
 // Mitgliedsbeiträge, zwei Rechnungen und die abgeschlossene Kassenprüfung
 // des Vorjahres.
 //
 // Die Reihenfolge ist hier nicht beliebig, und das ist kein Zufall des
 // Skripts, sondern die Absicherung selbst: sobald der Abschluss für das
 // Vorjahr festgeschrieben ist, lehnt ein Trigger jede weitere Buchung mit
 // einem Datum in diesem Zeitraum ab. Erst die Buchungen, dann der Abschluss —
 // wer es umdreht, bekommt vom Seed dieselbe Fehlermeldung wie der Kassier,
 // der drei Wochen nach der Prüfung noch eine Quittung findet.
 // -----------------------------------------------------------------------------
 async function kassendatenAnlegen(organisationId: string): Promise<void> {
  const vorhanden = await prisma.kassenkonto.count({ where: { organisationId } });
  if (vorhanden > 0) {
    log("Kassendaten bereits vorhanden — übersprungen.");
    return;
  }
  const { STANDARDKATEGORIEN } = await import("../src/lib/kasse/vorschlag");
  const jahr = new Date().getUTCFullYear();
  const vorjahr = jahr - 1;
  // --- Konten ---------------------------------------------------------------
  const bar = await prisma.kassenkonto.create({
    data: {
      organisationId,
      bezeichnung: "Barkasse",
      art: KontoArt.BAR,
      anfangsbestand: "250.00",
      bemerkung: "Kassette im Kommandantenzimmer. Wechselgeld für Feste.",
    },
  });
  const giro = await prisma.kassenkonto.create({
    data: {
      organisationId,
      bezeichnung: "Girokonto Raiffeisenbank",
      art: KontoArt.BANK,
      iban: "DE02701500000000594937",
      bic: "SSKMDEMM",
      anfangsbestand: "4800.00",
    },
  });
  const ruecklage = await prisma.kassenkonto.create({
    data: {
      organisationId,
      bezeichnung: "Rücklage Fahrzeugbeschaffung",
      art: KontoArt.RUECKLAGE,
      iban: "DE02120300000000202051",
      anfangsbestand: "12000.00",
      bemerkung: "Angespart für den Ersatz des MTW. Wird nicht laufend bewegt.",
    },
  });
  // --- Kontenrahmen ---------------------------------------------------------
  //
  // Zwei Durchgänge: erst die Oberkategorien, dann die Unterkategorien mit
  // ihrem Verweis. Anders ginge es nicht, der Baum verweist auf sich selbst.
  const kategorien = new Map<string, string>();
  for (const eintrag of STANDARDKATEGORIEN.filter((k) => !k.oberkategorie)) {
    const angelegt = await prisma.buchungskategorie.create({
      data: { organisationId, name: eintrag.name, art: eintrag.art },
    });
    kategorien.set(eintrag.name, angelegt.id);
  }
  for (const eintrag of STANDARDKATEGORIEN.filter((k) => k.oberkategorie)) {
    const angelegt = await prisma.buchungskategorie.create({
      data: {
        organisationId,
        name: eintrag.name,
        art: eintrag.art,
        oberkategorieId: kategorien.get(eintrag.oberkategorie!) ?? null,
      },
    });
    kategorien.set(eintrag.name, angelegt.id);
  }
  const kategorie = (name: string): string => {
    const id = kategorien.get(name);
    if (!id) throw new Error(`Kategorie fehlt im Standardkontenrahmen: ${name}`);
    return id;
  };
  const kassier = await prisma.person.findFirst({
    where: {
      organisationId,
      rollen: { some: { rolle: { schluessel: RolleSchluessel.KASSIER } } },
    },
    select: { id: true },
  });
  // --- Buchungen ------------------------------------------------------------
  //
  // Das Vorjahr vollständig und festgeschrieben, das laufende Jahr bis in den
  // Sommer und noch offen. So zeigt die Ansicht beide Zustände: das
  // geschlossene Buch und das, in dem noch gearbeitet wird.
  type Zeile = {
    konto: string;
    monat: number;
    tag: number;
    art: BuchungsArt;
    betrag: string;
    kategorie: string;
    zweck: string;
    gegenueber?: string;
    beleg?: string;
  };
  const vorjahrszeilen: Zeile[] = [
    {
      konto: giro.id,
      monat: 1,
      tag: 15,
      art: BuchungsArt.EINNAHME,
      betrag: "6500.00",
      kategorie: "Zuschüsse",
      zweck: "Gemeindezuschuss laufender Betrieb",
      gegenueber: "Gemeinde Musterhausen",
      beleg: "Z-2024-01",
    },
    {
      konto: giro.id,
      monat: 2,
      tag: 3,
      art: BuchungsArt.AUSGABE,
      betrag: "1284.50",
      kategorie: "Versicherungen",
      zweck: "Jahresprämie Fahrzeug- und Unfallversicherung",
      gegenueber: "Bayerische Versicherungskammer",
    },
    {
      konto: giro.id,
      monat: 3,
      tag: 12,
      art: BuchungsArt.AUSGABE,
      betrag: "412.90",
      kategorie: "Kraftstoff",
      zweck: "Diesel LF 20, Sammelrechnung Februar",
      gegenueber: "Tankstelle Musterhausen",
    },
    {
      konto: giro.id,
      monat: 4,
      tag: 8,
      art: BuchungsArt.AUSGABE,
      betrag: "2340.00",
      kategorie: "Atemschutz",
      zweck: "Zwei Pressluftatmer, Ersatzbeschaffung",
      gegenueber: "Dräger Safety",
      beleg: "RE-2024-114",
    },
    {
      konto: giro.id,
      monat: 5,
      tag: 22,
      art: BuchungsArt.AUSGABE,
      betrag: "868.00",
      kategorie: "Prüfungen",
      zweck: "Wiederkehrende Prüfung Drehleiter",
      gegenueber: "TÜV Süd",
    },
    {
      konto: bar.id,
      monat: 6,
      tag: 15,
      art: BuchungsArt.EINNAHME,
      betrag: "3860.00",
      kategorie: "Veranstaltungen",
      zweck: "Maifest, Getränke- und Speisenverkauf",
    },
    {
      konto: bar.id,
      monat: 6,
      tag: 15,
      art: BuchungsArt.AUSGABE,
      betrag: "1420.60",
      kategorie: "Verpflegung",
      zweck: "Maifest, Einkauf Getränke und Fleisch",
      gegenueber: "Getränke Hofmann",
    },
    {
      konto: giro.id,
      monat: 7,
      tag: 2,
      art: BuchungsArt.AUSGABE,
      betrag: "1150.00",
      kategorie: "Schutzkleidung",
      zweck: "Vier Einsatzjacken, Ersatz nach Verschleiß",
      gegenueber: "Feuerwehrbedarf Barth",
    },
    {
      konto: giro.id,
      monat: 9,
      tag: 18,
      art: BuchungsArt.AUSGABE,
      betrag: "624.00",
      kategorie: "Ausbildung",
      zweck: "Lehrgangsgebühren Maschinistenlehrgang",
      gegenueber: "Landkreis Musterkreis",
    },
    {
      konto: giro.id,
      monat: 10,
      tag: 30,
      art: BuchungsArt.AUSGABE,
      betrag: "398.20",
      kategorie: "Wasser und Strom",
      zweck: "Abschlagszahlung Strom Gerätehaus",
      gegenueber: "Stadtwerke Musterhausen",
    },
    {
      konto: giro.id,
      monat: 11,
      tag: 14,
      art: BuchungsArt.EINNAHME,
      betrag: "780.00",
      kategorie: "Spenden",
      zweck: "Spenden aus der Haussammlung",
    },
    {
      konto: giro.id,
      monat: 12,
      tag: 20,
      art: BuchungsArt.AUSGABE,
      betrag: "36.00",
      kategorie: "Bankgebühren",
      zweck: "Kontoführung viertes Quartal",
    },
  ];
  const laufendeZeilen: Zeile[] = [
    {
      konto: giro.id,
      monat: 1,
      tag: 20,
      art: BuchungsArt.EINNAHME,
      betrag: "6500.00",
      kategorie: "Zuschüsse",
      zweck: "Gemeindezuschuss laufender Betrieb",
      gegenueber: "Gemeinde Musterhausen",
    },
    {
      konto: giro.id,
      monat: 2,
      tag: 5,
      art: BuchungsArt.AUSGABE,
      betrag: "1341.80",
      kategorie: "Versicherungen",
      zweck: "Jahresprämie Fahrzeug- und Unfallversicherung",
      gegenueber: "Bayerische Versicherungskammer",
    },
    {
      konto: giro.id,
      monat: 2,
      tag: 28,
      art: BuchungsArt.AUSGABE,
      betrag: "487.40",
      kategorie: "Kraftstoff",
      zweck: "Diesel LF 20 und MTW, Sammelrechnung Februar",
      gegenueber: "Tankstelle Musterhausen",
    },
    {
      konto: giro.id,
      monat: 3,
      tag: 14,
      art: BuchungsArt.AUSGABE,
      betrag: "1890.00",
      kategorie: "Reparatur",
      zweck: "Kupplung MTW, Werkstattrechnung",
      gegenueber: "Werkstatt Müller GmbH",
      beleg: "RE-4471",
    },
    {
      konto: giro.id,
      monat: 4,
      tag: 3,
      art: BuchungsArt.AUSGABE,
      betrag: "212.00",
      kategorie: "Verwaltung",
      zweck: "Büromaterial und Druckerpatronen",
      gegenueber: "Schreibwaren Ludwig",
    },
    {
      konto: bar.id,
      monat: 5,
      tag: 1,
      art: BuchungsArt.EINNAHME,
      betrag: "4120.00",
      kategorie: "Veranstaltungen",
      zweck: "Maifest, Getränke- und Speisenverkauf",
    },
    {
      konto: bar.id,
      monat: 5,
      tag: 1,
      art: BuchungsArt.AUSGABE,
      betrag: "1588.30",
      kategorie: "Verpflegung",
      zweck: "Maifest, Einkauf Getränke und Fleisch",
      gegenueber: "Getränke Hofmann",
    },
    {
      konto: bar.id,
      monat: 5,
      tag: 6,
      art: BuchungsArt.AUSGABE,
      betrag: "2500.00",
      kategorie: "Verwaltung",
      zweck: "Einzahlung Barkasse auf das Girokonto nach dem Maifest",
    },
    {
      konto: giro.id,
      monat: 5,
      tag: 6,
      art: BuchungsArt.EINNAHME,
      betrag: "2500.00",
      kategorie: "Veranstaltungen",
      zweck: "Einzahlung aus der Barkasse nach dem Maifest",
    },
    {
      konto: giro.id,
      monat: 6,
      tag: 11,
      art: BuchungsArt.AUSGABE,
      betrag: "742.00",
      kategorie: "Prüfungen",
      zweck: "Schlauchprüfung, 40 Stück B und C",
      gegenueber: "Schlauchpflege Nordbayern",
    },
    {
      konto: giro.id,
      monat: 6,
      tag: 25,
      art: BuchungsArt.AUSGABE,
      betrag: "36.00",
      kategorie: "Bankgebühren",
      zweck: "Kontoführung zweites Quartal",
    },
    {
      konto: ruecklage.id,
      monat: 7,
      tag: 1,
      art: BuchungsArt.EINNAHME,
      betrag: "3000.00",
      kategorie: "Zuschüsse",
      zweck: "Jährliche Zuführung zur Fahrzeugrücklage",
      gegenueber: "Gemeinde Musterhausen",
    },
  ];
  async function buchungAnlegen(zeile: Zeile, festgeschrieben: boolean, buchungsjahr: number) {
    return prisma.buchung.create({
      data: {
        organisationId,
        kontoId: zeile.konto,
        kategorieId: kategorie(zeile.kategorie),
        datum: datum(buchungsjahr, zeile.monat, zeile.tag),
        art: zeile.art,
        betrag: zeile.betrag,
        verwendungszweck: zeile.zweck,
        lieferant: zeile.gegenueber ?? null,
        belegnummer: zeile.beleg ?? null,
        erfasstVonId: kassier?.id ?? null,
        festgeschriebenAm: festgeschrieben ? datum(vorjahr + 1, 2, 10) : null,
      },
    });
  }
  for (const zeile of vorjahrszeilen) {
    await buchungAnlegen(zeile, true, vorjahr);
  }
  for (const zeile of laufendeZeilen) {
    await buchungAnlegen(zeile, false, jahr);
  }
  // --- Beiträge -------------------------------------------------------------
  const satzAktive = await prisma.beitragssatz.create({
    data: {
      organisationId,
      bezeichnung: "Aktive und Passive",
      betrag: "25.00",
      abteilung: null,
      abJahr: vorjahr,
    },
  });
  const satzJugend = await prisma.beitragssatz.create({
    data: {
      organisationId,
      bezeichnung: "Jugendfeuerwehr",
      betrag: "10.00",
      abteilung: "Jugendfeuerwehr",
      abJahr: vorjahr,
    },
  });
  const mitglieder = await prisma.person.findMany({
    where: { organisationId, aktiv: true, austrittsdatum: null },
    orderBy: { mitgliedsnummer: "asc" },
    select: { id: true, abteilung: true },
  });
  const beitragsKategorie = kategorie("Mitgliedsbeiträge");
  // Die meisten haben bezahlt, zwei stehen offen, einer ist gemahnt, einem
  // wurde erlassen. Das ist die Verteilung, die eine Wehr im Herbst wirklich
  // vor sich hat — und der Grund, warum es die Rückstandsliste gibt.
  for (const [stelle, person] of mitglieder.entries()) {
    const jugend = person.abteilung === "Jugendfeuerwehr";
    const satz = jugend ? satzJugend : satzAktive;
    const betrag = jugend ? "10.00" : "25.00";
    let buchungId: string | null = null;
    let stand: BeitragStand = BeitragStand.BEZAHLT;
    let bezahltAm: Date | null = datum(jahr, 2, 12 + (stelle % 10));
    let mahnstufe = 0;
    let gemahntAm: Date | null = null;
    let erlassGrund: string | null = null;
    if (stelle % 7 === 3) {
      stand = BeitragStand.OFFEN;
      bezahltAm = null;
    } else if (stelle % 11 === 5) {
      stand = BeitragStand.GEMAHNT;
      bezahltAm = null;
      mahnstufe = 1;
      gemahntAm = datum(jahr, 6, 30);
    } else if (stelle % 13 === 9) {
      stand = BeitragStand.ERLASSEN;
      bezahltAm = null;
      erlassGrund = "Längere Erkrankung, Beschluss der Kommandantschaft vom 12.03.";
    }
    if (stand === BeitragStand.BEZAHLT && bezahltAm) {
      const buchung = await prisma.buchung.create({
        data: {
          organisationId,
          kontoId: giro.id,
          kategorieId: beitragsKategorie,
          datum: bezahltAm,
          art: BuchungsArt.EINNAHME,
          betrag,
          verwendungszweck: `Mitgliedsbeitrag ${jahr}`,
          personId: person.id,
          erfasstVonId: kassier?.id ?? null,
        },
      });
      buchungId = buchung.id;
    }
    await prisma.beitrag.create({
      data: {
        organisationId,
        personId: person.id,
        jahr,
        satzId: satz.id,
        betrag,
        stand,
        buchungId,
        bezahltAm,
        mahnstufe,
        gemahntAm,
        erlassGrund,
      },
    });
  }
  // --- Rechnungen -----------------------------------------------------------
  const kostenersatz = kategorie("Kostenersatz");
  const fehlalarmBuchung = await prisma.buchung.create({
    data: {
      organisationId,
      kontoId: giro.id,
      kategorieId: kostenersatz,
      datum: datum(jahr, 4, 28),
      art: BuchungsArt.EINNAHME,
      betrag: "612.00",
      verwendungszweck: `Zahlungseingang Rechnung ${jahr}-0001`,
      lieferant: "Möbelhaus Sonnleitner GmbH",
      erfasstVonId: kassier?.id ?? null,
    },
  });
  await prisma.rechnung.create({
    data: {
      organisationId,
      nummer: `${jahr}-0001`,
      anlass: RechnungsAnlass.FEHLALARM,
      stand: RechnungStand.BEZAHLT,
      empfaenger: "Möbelhaus Sonnleitner GmbH",
      strasse: "Industriestraße 14",
      plz: "91315",
      ort: "Musterhausen",
      datum: datum(jahr, 3, 28),
      faelligAm: datum(jahr, 4, 25),
      betrag: "612.00",
      bemerkung:
        "Fehlalarm der Brandmeldeanlage am 26.03., verursacht durch Staub bei Umbauarbeiten. " +
        "Kostenersatz nach Art. 28 Abs. 2 Nr. 4 BayFwG.",
      buchungId: fehlalarmBuchung.id,
      bezahltAm: datum(jahr, 4, 28),
      erstelltVonId: kassier?.id ?? null,
      positionen: {
        create: [
          {
            organisationId,
            reihenfolge: 0,
            bezeichnung: "Einsatz LF 20, angefangene Stunde",
            menge: "1",
            einheit: "Std.",
            einzelpreis: "396.00",
            gesamtpreis: "396.00",
          },
          {
            organisationId,
            reihenfolge: 1,
            bezeichnung: "Einsatzkräfte, je angefangene Stunde",
            menge: "9",
            einheit: "Pers.",
            einzelpreis: "24.00",
            gesamtpreis: "216.00",
          },
        ],
      },
    },
  });
  await prisma.rechnung.create({
    data: {
      organisationId,
      nummer: `${jahr}-0002`,
      anlass: RechnungsAnlass.VERMIETUNG,
      stand: RechnungStand.VERSENDET,
      empfaenger: "Trachtenverein Almrausch Musterhausen e. V.",
      empfaengerZusatz: "z. Hd. Frau Vorstand Berger",
      strasse: "Dorfplatz 2",
      plz: "91315",
      ort: "Musterhausen",
      datum: datum(jahr, 6, 20),
      faelligAm: datum(jahr, 7, 18),
      betrag: "180.00",
      bemerkung: "Überlassung des Schulungsraums für die Jahresversammlung am 14.06.",
      erstelltVonId: kassier?.id ?? null,
      positionen: {
        create: [
          {
            organisationId,
            reihenfolge: 0,
            bezeichnung: "Nutzung Schulungsraum, Tagespauschale",
            menge: "1",
            einheit: "Tag",
            einzelpreis: "150.00",
            gesamtpreis: "150.00",
          },
          {
            organisationId,
            reihenfolge: 1,
            bezeichnung: "Reinigung",
            menge: "1",
            einheit: "pauschal",
            einzelpreis: "30.00",
            gesamtpreis: "30.00",
          },
        ],
      },
    },
  });
  // --- Kassenprüfung des Vorjahres -----------------------------------------
  //
  // Zuletzt, und das ist der Punkt: ab hier ist der Zeitraum zu. Jede weitere
  // Buchung mit einem Datum aus dem Vorjahr wird von der Datenbank abgelehnt.
  const pruefer = await prisma.person.findMany({
    where: { organisationId, aktiv: true, austrittsdatum: null },
    orderBy: { mitgliedsnummer: "desc" },
    take: 2,
    select: { id: true },
  });
  // Die Zahlen sind nicht erfunden, sondern die Summe der Buchungen oben:
  // Barkasse 250,00 + 3.860,00 − 1.420,60, Giro 4.800,00 + 7.280,00 − 7.113,60,
  // Rücklage unberührt. Ein Seed mit erfundenen Beständen wäre genau der
  // Fall, den die Kassenprüfung finden soll.
  const vorjahrsposten = [
    { konto: bar.id, buch: "2689.40", gezaehlt: "2686.20" },
    { konto: giro.id, buch: "4966.40", gezaehlt: "4966.40" },
    { konto: ruecklage.id, buch: "12000.00", gezaehlt: "12000.00" },
  ];
  const abschluss = await prisma.kassenabschluss.create({
    data: {
      organisationId,
      vonAm: datum(vorjahr, 1, 1),
      bisAm: datum(vorjahr, 12, 31),
      bestandLautBuch: "19655.80",
      gezaehlterBestand: "19652.60",
      differenz: "-3.20",
      erlaeuterung:
        "In der Barkasse fehlen 3,20 €. Zurückzuführen auf das Maifest: das Wechselgeld " +
        "wurde am Abend gezählt, ein Beleg über den Nachkauf von Eis fehlt. Die Prüfer " +
        "halten den Betrag für erklärbar und schlagen Entlastung vor.",
      prueferId: pruefer[0]?.id ?? null,
      zweiterPrueferId: pruefer[1]?.id ?? null,
      geprueftAm: datum(vorjahr + 1, 2, 8),
      festgeschriebenAm: datum(vorjahr + 1, 2, 10),
      posten: {
        create: vorjahrsposten.map((posten) => ({
          organisationId,
          kontoId: posten.konto,
          bestandLautBuch: posten.buch,
          gezaehlterBestand: posten.gezaehlt,
          differenz: (Number(posten.gezaehlt) - Number(posten.buch)).toFixed(2),
        })),
      },
    },
  });
  log(
    `Kasse: 3 Konten, ${STANDARDKATEGORIEN.length} Kategorien, ` +
      `${vorjahrszeilen.length + laufendeZeilen.length} Buchungen, ` +
      `${mitglieder.length} Beiträge, 2 Rechnungen und die Kassenprüfung ${vorjahr} ` +
      `(festgeschrieben — der Zeitraum ist zu, Abschluss ${abschluss.id.slice(0, 8)})`,
  );
 }
 // -----------------------------------------------------------------------------
 // Phase 10 — Mandantenfähigkeit
 //
 // Eine zweite, kleine Wehr und ein Konto, das beide sieht.
 //
 // Ohne die zweite Wehr lässt sich die ganze Phase nicht ausprobieren: der
 // Wehrwähler erscheint erst, wenn es etwas zu wählen gibt, und eine
 // Mandantentrennung, die nie zwei Mandanten hatte, ist keine geprüfte.
 //
 // Die Geschichte ist die übliche in Bayern: der Kommandant von Musterhausen
 // ist zugleich Kreisbrandinspektor und betreut die Nachbarwehr. In seiner
 // eigenen Wehr führt er alles, in der betreuten sieht er zu — mehr nicht.
 //
 // Nachbarshausen bleibt bewusst dünn: drei Leute, ein Fahrzeug. Es soll
 // zeigen, dass die Trennung hält, und nicht die Beispieldaten verdoppeln.
 // -----------------------------------------------------------------------------
 /**
 * Die Nachbarwehr leitet sich aus der Wehr ab, die gerade angelegt wird.
 *
 * Fest verdrahtet wäre sie das, was Phase 8 gerade beseitigt hat: der
 * Testlauf und die Beispielwehr griffen auf denselben Datensatz zu. So bekommt
 * jeder Mandant sein eigenes Paar — und die Trennung gilt auch für das, womit
 * sie geprüft wird.
 */
 const NACHBAR_SLUG = `${ORGANISATION_SLUG}-nachbar`;
 const NACHBAR_NAME = `${ORGANISATION_NAME} — Nachbarwehr`;
 const NACHBAR_KURZNAME = `${ORGANISATION_KURZNAME} Nachbar`;
 const KBI_EMAIL = process.env.SEED_KBI_EMAIL ?? `kbi@${ORGANISATION_SLUG}.de`;
 async function kreisebeneAnlegen(
  heimatOrganisationId: string,
  katalog: Map<string, string>,
 ): Promise<void> {
  /**
   * Zwei Teile, zwei Prüfungen — und das ist wichtiger, als es aussieht.
   *
   * Ein gemeinsamer Ausstieg am Anfang hätte heißen: steht die Nachbarwehr,
   * geschieht gar nichts mehr. Genau das ist beim Zurücksetzen der Testwehr
   * passiert — die Nachbarwehr blieb stehen, die Mitgliedschaft in der neuen
   * Testwehr wurde nie wieder angelegt, und der Wehrwähler zeigte nur noch
   * die betreute Wehr. Gefunden hat das ein E2E-Test.
   */
  const nachbar =
    (await prisma.organisation.findUnique({ where: { slug: NACHBAR_SLUG } })) ??
    (await nachbarwehrAnlegen(katalog));
  // --- Das Konto, das beide Wehren sieht ------------------------------------
  await kreiskontoAnlegen(heimatOrganisationId, nachbar.id);
 }
 /** Die Nachbarwehr: dünn besetzt, ein Fahrzeug. Sie soll zeigen, dass die
 *  Trennung hält, und nicht die Beispieldaten verdoppeln. */
 async function nachbarwehrAnlegen(katalog: Map<string, string>) {
  const nachbar = await prisma.organisation.create({
    data: {
      slug: NACHBAR_SLUG,
      name: NACHBAR_NAME,
      kurzname: NACHBAR_KURZNAME,
      strasse: "Dorfstraße 3",
      plz: "91316",
      ort: "Nachbarshausen",
      landkreis: "Musterkreis",
      funkPraefix: "Florian Nachbarshausen",
    },
  });
  const nachbarRollen = await rollenAnlegen(nachbar.id, katalog);
  const besetzung: Array<{
    vorname: string;
    nachname: string;
    nummer: string;
    dienstgrad: Dienstgrad;
    rolle: RolleSchluessel;
  }> = [
    {
      vorname: "Georg",
      nachname: "Sailer",
      nummer: "0001",
      dienstgrad: Dienstgrad.BRANDMEISTER,
      rolle: RolleSchluessel.KOMMANDANT,
    },
    {
      vorname: "Marianne",
      nachname: "Kraus",
      nummer: "0002",
      dienstgrad: Dienstgrad.LOESCHMEISTER,
      rolle: RolleSchluessel.GERAETEWART,
    },
    {
      vorname: "Tobias",
      nachname: "Ostermeier",
      nummer: "0003",
      dienstgrad: Dienstgrad.FEUERWEHRMANN,
      rolle: RolleSchluessel.MITGLIED,
    },
  ];
  for (const eintrag of besetzung) {
    const person = await prisma.person.create({
      data: {
        organisationId: nachbar.id,
        vorname: eintrag.vorname,
        nachname: eintrag.nachname,
        mitgliedsnummer: eintrag.nummer,
        dienstgrad: eintrag.dienstgrad,
        abteilung: "Aktive",
        eintrittsdatum: datum(2012, 4, 1),
      },
    });
    const rolleId = nachbarRollen.get(eintrag.rolle);
    if (rolleId) {
      await prisma.personRolle.create({
        data: { organisationId: nachbar.id, personId: person.id, rolleId },
      });
    }
  }
  const standort = await prisma.standort.create({
    data: {
      organisationId: nachbar.id,
      name: "Gerätehaus Nachbarshausen",
      art: StandortArt.GERAETEHAUS,
      strasse: "Dorfstraße 3",
      plz: "91316",
      ort: "Nachbarshausen",
    },
  });
  await prisma.fahrzeug.create({
    data: {
      organisationId: nachbar.id,
      funkrufname: "Florian Nachbarshausen 42/1",
      bezeichnung: "TSF-W",
      art: FahrzeugArt.LOESCHFAHRZEUG,
      kennzeichen: "MK-FW 421",
      baujahr: 2009,
      standortId: standort.id,
    },
  });
  log(`Nachbarwehr angelegt: ${besetzung.length} Personen, 1 Fahrzeug.`);
  return nachbar;
 }
 /** Das Konto der Kreisebene: Mitglied in der Heimatwehr, Aufsicht nebenan. */
 async function kreiskontoAnlegen(heimatOrganisationId: string, nachbarId: string) {
  const kommandant = await prisma.person.findFirst({
    where: {
      organisationId: heimatOrganisationId,
      rollen: { some: { rolle: { schluessel: RolleSchluessel.KOMMANDANT } } },
    },
    orderBy: { mitgliedsnummer: "asc" },
  });
  if (!kommandant) {
    log("Kein Kommandant gefunden — die Kreisebene wird übersprungen.");
    return;
  }
  const email = KBI_EMAIL;
  const passwort = process.env.SEED_KBI_PASSWORT ?? "Feuerwehr2026";
  const konto = await prisma.benutzer.upsert({
    where: { email },
    update: {},
    create: {
      email,
      passwortHash: await bcrypt.hash(passwort, RUNDEN),
      passwortGeaendertAm: new Date(),
    },
  });
  // In der eigenen Wehr: Mitglied mit allem, was seine Rollen hergeben.
  await prisma.mitgliedschaft.upsert({
    where: {
      benutzerId_organisationId: {
        benutzerId: konto.id,
        organisationId: heimatOrganisationId,
      },
    },
    update: {},
    create: {
      organisationId: heimatOrganisationId,
      benutzerId: konto.id,
      personId: kommandant.id,
      art: MitgliedschaftArt.MITGLIED,
    },
  });
  // In der Nachbarwehr: Aufsicht. Ohne Akte — er gehört ihr nicht an und
  // steht deshalb auch in keiner ihrer Mitgliederlisten.
  await prisma.mitgliedschaft.upsert({
    where: {
      benutzerId_organisationId: { benutzerId: konto.id, organisationId: nachbarId },
    },
    update: {},
    create: {
      organisationId: nachbarId,
      benutzerId: konto.id,
      art: MitgliedschaftArt.AUFSICHT,
    },
  });
  log(
    `Kreisebene: ${email} — Mitglied in ${ORGANISATION_KURZNAME}, ` +
      `Aufsicht in ${NACHBAR_KURZNAME}.`,
  );
 }
 // -----------------------------------------------------------------------------
 // Ablauf
 // -----------------------------------------------------------------------------
@@ -3274,8 +4182,16 @@ async function main(): Promise<void> {
  // Phase 8 — Lokale KI
  await wikiAnlegen(organisation.id);
  // Phase 9 — Kassenverwaltung
  await kassendatenAnlegen(organisation.id);
  // Phase 10 — Mandantenfähigkeit: eine zweite Wehr und die Kreisebene
  await kreisebeneAnlegen(organisation.id, katalog);
  log("Fertig.");
  log("");
  log(`Wehr: ${ORGANISATION_NAME} (${ORGANISATION_SLUG})`);
  log("");
  log("Anmeldung für den Erststart:");
  log(`  E-Mail:   ${process.env.SEED_ADMIN_EMAIL ?? "admin@beispielwehr.de"}`);
  log(`  Passwort: ${process.env.SEED_ADMIN_PASSWORT ?? "Feuerwehr2026"}`);
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
florian.wilde	3b20abcb23	Version 1.0.0 — Freigabe für den Echtbetrieb (#17 ) Pruefung / pruefung (push) Canceled after 0s Details Pruefung / oberflaeche (push) Canceled after 0s Details	2026-09-06 20:08:16 +00:00
florian.wilde	14cc4de9b8	Phase 11: Freigabereife (#16 ) Pruefung / pruefung (push) Canceled after 0s Details Pruefung / oberflaeche (push) Canceled after 0s Details	2026-09-06 20:05:49 +00:00
florian.wilde	91742a0dd7	Phase 10: Mandantenfähigkeit (#15 )	2026-09-05 13:47:46 +00:00
florian.wilde	2b53556175	Phase 9: Kassenverwaltung (#14 )	2026-09-05 02:30:51 +00:00
florian.wilde	d70acad4cd	Aufräumarbeiten: ESLint, DOM-Verschachtelung, eigene Testwehr (#13 )	2026-09-04 13:43:53 +00:00
Florian WildeandClaude Opus 5	7196c7110c	Aufraeumarbeiten: ESLint, DOM-Verschachtelung, eigene Testwehr ESLint hatte keine Konfiguration — das Skript "npm run lint" pruefte nichts. Jetzt Flat Config ohne Formatierungsregeln, dafuer mit den Regeln, die die Fehler dieses Projekts gemeldet haetten. Er hat gleich zwei gefunden, die niemand gesucht hatte. Das Badge rendert ein span statt eines div. Damit ist die Meldung "div cannot be a descendant of p" weg, die seit Phase 3 auf der Einsatzseite stand — sie ist der klassische Ausloeser fuer einen Hydration-Fehler. Die E2E-Tests laufen gegen eine eigene Wehr. Nach fuenf Phasen standen in der Beispielwehr 120 Atemschutz-Ueberwachungen statt einer und 115 Geraete statt 45; bei jedem Lauf aenderten sich alle Bildschirmfotos. Der Bestand ist einmal zurueckgesetzt, npm run db:test-reset baut die Testwehr neu auf. Behoben nebenbei: - Die Fehlerflaeche der Karte konnte nie etwas anzeigen. - Zwei useMemo der Lagekarte rechneten bei jedem Rendern neu. - tests/e2e war vom Typecheck ausgenommen und liess einen doppelt deklarierten Bezeichner durch. Closes #10 Closes #11 Closes #12 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-04 13:24:48 +02:00