Files
FireAdministration/prisma/migrations/20260903000100_stammdaten_rls/migration.sql
T
Florian WildeandClaude Opus 5 26b62a3477 Phase 1: Stammdatenverwaltung
Ab hier fuehrt die Wehr ihren Bestand in FLORIAN.

Datenmodell:
- Standort, Geraeteraum, Geraetetyp, Qualifikationstyp und Qualifikation
- Fahrzeug um Fahrgestellnummer, DIN-Typ, Erstzulassung, Sitzplaetze,
  Tankinhalt und UVV-Frist erweitert
- Geraet um Geraetetyp, Lebensdauerkategorie, errechnetes Lebensdauerende,
  Anschaffungspreis und die Lagerung erweitert
- Ein Geraet steht entweder an einem Standort oder ist auf einem Fahrzeug
  verlastet. Eine Pruefbedingung setzt das durch, ein Trigger stellt zusaetzlich
  sicher, dass ein angegebener Geraeteraum zum angegebenen Fahrzeug gehoert.
- RLS auf allen neuen Tabellen, Trigram-Indizes fuer die Volltextsuche

Fachlogik:
- lib/stammdaten/fristen.ts rechnet Prueftermine, Lebensdauer und den
  abgeleiteten Geraetestatus. Der Geraetetyp gibt vor, das Geraet darf
  abweichen.
- lib/stammdaten/qr.ts und qr-parser.ts erzeugen und lesen die Codes
- lib/stammdaten/etiketten.ts baut den A4-Bogen mit 65 Etiketten
- lib/stammdaten/import.ts liest CSV und Excel, erkennt deutsche Datums- und
  Zahlenformate, Windows-1252 und Dubletten innerhalb der Datei
- lib/pdf.ts spricht Gotenberg an

Oberflaeche:
- Geraeteliste mit Volltextsuche, Statusfilter, serverseitiger Sortierung,
  Blaettern, Spaltenauswahl und Massenbearbeitung
- Geraetedetail mit QR-Code, Pruefvorgabe aus dem Geraetetyp und Verlauf
- Fahrzeugliste und -detail mit Beladung nach Beladeordnung
- Mitgliederliste nach Abteilung, Mitgliedsdetail mit Qualifikationen
- Qualifikationen mit Ablaufwarnung je Vorwarnzeit des Typs
- Import-Assistent mit Zuordnung und Vorschau vor dem Uebernehmen
- QR-Scanner ueber die Kamera, mit Eingabefeld als Rueckfallweg

Behoben:
- Fristenrechnung lief ueber startOfDay aus date-fns und damit in der Zeitzone
  des Servers. Ein DATE aus der Datenbank kommt als UTC-Mitternacht und wurde
  dadurch auf den Vortag geschoben — Fristen waeren einen Tag zu frueh faellig
  geworden. Jetzt eigene Kalenderarithmetik auf UTC-Bestandteilen.
- ctx.sitzung blieb in tRPC-Prozeduren nullbar, weil t.middleware() die
  Verengung der vorigen Middleware verwirft. Middleware jetzt direkt an .use().
- CardTitle war ein div und damit keine Ueberschrift. Wer mit einer
  Sprachausgabe arbeitet, springt von Ueberschrift zu Ueberschrift; Karten
  tauchten in dieser Navigation nicht auf.

Daten und Tests:
- Seed um 3 Standorte, 20 Geraeteraeume, 14 Geraetetypen mit echten
  Pruefvorgaben, 49 Geraete und 107 Qualifikationen erweitert
- 104 Vitest-Tests (vorher 32), 44 Playwright-Tests (vorher 10)
- Anleitung um sieben bebilderte Abschnitte erweitert, Changelog, Devlog,
  Aufwandsschaetzung und Roadmap fortgeschrieben

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-03 08:31:08 +02:00

173 lines
6.7 KiB
PL/PgSQL

-- =============================================================================
-- Phase 1: Mandantentrennung, Lagerungsregel und Suchindizes.
--
-- Die vorige Migration hat die Tabellen angelegt. Ohne Row Level Security wären
-- sie für die Anwendungsrolle offen — jede neue Tabelle muss deshalb dieselbe
-- Behandlung bekommen wie die aus Phase 0.
--
-- Dazu kommen zwei Dinge, die sich nur in der Datenbank sauber durchsetzen
-- lassen: die Regel, wo ein Gerät liegen darf, und schnelle Volltextsuche.
-- =============================================================================
-- -----------------------------------------------------------------------------
-- Row Level Security für die neuen Tabellen
-- -----------------------------------------------------------------------------
DO $$
DECLARE
tabelle text;
BEGIN
FOREACH tabelle IN ARRAY ARRAY[
'standort',
'geraeteraum',
'geraetetyp',
'qualifikationstyp',
'qualifikation'
]
LOOP
EXECUTE format('ALTER TABLE %I ENABLE ROW LEVEL SECURITY', 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;
$$;
-- -----------------------------------------------------------------------------
-- Bestandsdaten auf die neue Lagerungsregel bringen.
--
-- Vor Phase 1 konnte ein Gerät nur einen Freitext-Lagerort haben. Damit die
-- Prüfbedingung weiter unten greift, braucht jedes Gerät ohne Fahrzeug jetzt
-- einen echten Standort. Je Wehr wird dafür ein Gerätehaus angelegt, sofern
-- noch keines existiert.
-- -----------------------------------------------------------------------------
INSERT INTO "standort" ("id", "organisationId", "name", "kuerzel", "art", "erstelltAm", "geaendertAm")
SELECT
gen_random_uuid(),
o."id",
'Gerätehaus',
'GH',
'GERAETEHAUS',
now(),
now()
FROM "organisation" o
WHERE NOT EXISTS (
SELECT 1 FROM "standort" s WHERE s."organisationId" = o."id"
);
UPDATE "geraet" g
SET "standortId" = (
SELECT s."id"
FROM "standort" s
WHERE s."organisationId" = g."organisationId"
AND s."art" = 'GERAETEHAUS'
ORDER BY s."erstelltAm"
LIMIT 1
)
WHERE g."fahrzeugId" IS NULL
AND g."standortId" IS NULL;
-- Fahrzeuge dem Gerätehaus zuordnen, sofern noch kein Standort gesetzt ist.
UPDATE "fahrzeug" f
SET "standortId" = (
SELECT s."id"
FROM "standort" s
WHERE s."organisationId" = f."organisationId"
AND s."art" = 'GERAETEHAUS'
ORDER BY s."erstelltAm"
LIMIT 1
)
WHERE f."standortId" IS NULL;
-- -----------------------------------------------------------------------------
-- Wo ein Gerät liegen darf.
--
-- Entweder es steht an einem Standort — dann ist kein Fahrzeug gesetzt. Oder es
-- ist auf einem Fahrzeug verlastet — dann ist kein Standort gesetzt, und der
-- Geräteraum darf angegeben werden, muss aber nicht (manches liegt lose in der
-- Kabine). Beides gleichzeitig oder gar nichts ist eine Falschangabe.
--
-- Dass ein angegebener Geräteraum auch wirklich zum angegebenen Fahrzeug
-- gehört, lässt sich als CHECK nicht ausdrücken — das prüft der Trigger
-- darunter.
-- -----------------------------------------------------------------------------
ALTER TABLE "geraet" ADD CONSTRAINT "geraet_lagerung_eindeutig" CHECK (
("standortId" IS NOT NULL AND "fahrzeugId" IS NULL AND "geraeteraumId" IS NULL)
OR ("standortId" IS NULL AND "fahrzeugId" IS NOT NULL)
);
CREATE OR REPLACE FUNCTION geraeteraum_gehoert_zum_fahrzeug()
RETURNS trigger
LANGUAGE plpgsql
AS $$
DECLARE
raum_fahrzeug uuid;
BEGIN
IF NEW."geraeteraumId" IS NULL THEN
RETURN NEW;
END IF;
SELECT "fahrzeugId" INTO raum_fahrzeug
FROM "geraeteraum"
WHERE "id" = NEW."geraeteraumId";
IF raum_fahrzeug IS DISTINCT FROM NEW."fahrzeugId" THEN
RAISE EXCEPTION
'Der Geraeteraum gehoert nicht zu dem angegebenen Fahrzeug.'
USING ERRCODE = 'check_violation';
END IF;
RETURN NEW;
END;
$$;
CREATE TRIGGER geraet_raum_pruefen
BEFORE INSERT OR UPDATE OF "fahrzeugId", "geraeteraumId" ON "geraet"
FOR EACH ROW EXECUTE FUNCTION geraeteraum_gehoert_zum_fahrzeug();
-- -----------------------------------------------------------------------------
-- Volltextsuche.
--
-- Die Listen sollen auf Tippen reagieren, auch bei einigen tausend Geräten.
-- pg_trgm macht ILIKE '%text%' indexfähig — ohne diese Indizes läuft jede
-- Suche als vollständiger Tabellendurchlauf.
-- -----------------------------------------------------------------------------
CREATE INDEX "geraet_suche_bezeichnung" ON "geraet" USING gin ("bezeichnung" gin_trgm_ops);
CREATE INDEX "geraet_suche_inventarnummer" ON "geraet" USING gin ("inventarnummer" gin_trgm_ops);
CREATE INDEX "geraet_suche_seriennummer" ON "geraet" USING gin ("seriennummer" gin_trgm_ops);
CREATE INDEX "geraet_suche_hersteller" ON "geraet" USING gin ("hersteller" gin_trgm_ops);
CREATE INDEX "fahrzeug_suche_funkrufname" ON "fahrzeug" USING gin ("funkrufname" gin_trgm_ops);
CREATE INDEX "fahrzeug_suche_bezeichnung" ON "fahrzeug" USING gin ("bezeichnung" gin_trgm_ops);
CREATE INDEX "fahrzeug_suche_kennzeichen" ON "fahrzeug" USING gin ("kennzeichen" gin_trgm_ops);
CREATE INDEX "person_suche_nachname" ON "person" USING gin ("nachname" gin_trgm_ops);
CREATE INDEX "person_suche_vorname" ON "person" USING gin ("vorname" gin_trgm_ops);
CREATE INDEX "geraetetyp_suche_name" ON "geraetetyp" USING gin ("name" gin_trgm_ops);
CREATE INDEX "standort_suche_name" ON "standort" USING gin ("name" gin_trgm_ops);
-- Räumliche Abfragen auf Standorte, ab Phase 6 gebraucht.
CREATE INDEX "standort_koordinaten" ON "standort" USING gist ("koordinaten");
-- -----------------------------------------------------------------------------
-- Rechte für die Anwendungsrolle auf die neuen Tabellen.
-- -----------------------------------------------------------------------------
DO $$
BEGIN
IF EXISTS (SELECT 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 'GRANT EXECUTE ON FUNCTION aktuelle_organisation() TO florian_app';
-- Die Einschraenkungen aus Phase 0 gelten unveraendert weiter.
EXECUTE 'REVOKE INSERT, UPDATE, DELETE ON "berechtigung" FROM florian_app';
EXECUTE 'REVOKE UPDATE, DELETE ON "audit_log" FROM florian_app';
ELSE
RAISE NOTICE 'Rolle florian_app nicht vorhanden — Rechtevergabe uebersprungen.';
END IF;
END;
$$;