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>
This commit is contained in:
Florian Wilde
2026-09-03 08:31:08 +02:00
co-authored by Claude Opus 5
parent 4b3021bb50
commit 26b62a3477
79 changed files with 11738 additions and 217 deletions
+211
View File
@@ -0,0 +1,211 @@
import { expect, test, type Page } from "@playwright/test";
/**
* E2E-Tests für Phase 1.
*
* Geprüft werden die Wege, die eine Wehr täglich geht: in der Geräteliste
* suchen, ein Gerät öffnen, die Beladung eines Fahrzeugs ansehen, und über
* einen gescannten QR-Code auf der richtigen Seite landen.
*
* Voraussetzung: Stack läuft, Datenbank ist migriert und geseedet.
*/
const ADMIN_EMAIL = process.env.SEED_ADMIN_EMAIL ?? "admin@beispielwehr.de";
const ADMIN_PASSWORT = process.env.SEED_ADMIN_PASSWORT ?? "Feuerwehr2026";
async function anmelden(page: Page): Promise<void> {
await page.goto("/anmelden");
await page.getByLabel("E-Mail-Adresse").fill(ADMIN_EMAIL);
await page.getByLabel("Passwort").fill(ADMIN_PASSWORT);
await page.getByRole("button", { name: "Anmelden" }).click();
await page.waitForURL("/");
}
test.beforeEach(async ({ page }) => {
await anmelden(page);
});
test.describe("Geräteliste", () => {
test("zeigt die Geräte der Wehr", async ({ page }) => {
await page.goto("/geraete");
await expect(page.getByRole("heading", { name: "Geräte" })).toBeVisible();
// Aus dem Seed: die Inventarnummern beginnen bei INV-0001.
await expect(page.getByRole("link", { name: "INV-0001" })).toBeVisible();
await expect(page.getByText(/\d+ Geräte/)).toBeVisible();
});
test("filtert über die Suche", async ({ page }) => {
await page.goto("/geraete");
await expect(page.getByRole("link", { name: "INV-0001" })).toBeVisible();
await page.getByLabel("Geräte durchsuchen").fill("Pressluftatmer");
// Die Suche ist entprellt — deshalb auf das Ergebnis warten, nicht auf die Zeit.
await expect(page.getByRole("cell", { name: "Pressluftatmer PA 94" }).first()).toBeVisible();
await expect(page.getByRole("cell", { name: "Feuerwehrhelm F220" })).toHaveCount(0);
});
test("meldet verständlich, wenn die Suche nichts findet", async ({ page }) => {
await page.goto("/geraete");
await page.getByLabel("Geräte durchsuchen").fill("gibtesnichtxyz");
await expect(page.getByText("Kein Gerät gefunden")).toBeVisible();
});
test("blendet Spalten aus und wieder ein", async ({ page }) => {
await page.goto("/geraete");
await expect(page.getByRole("columnheader", { name: /Hersteller/i })).toBeVisible();
await page.getByRole("button", { name: "Spalten" }).click();
await page.getByRole("checkbox", { name: "Hersteller" }).click();
await expect(page.getByRole("columnheader", { name: /Hersteller/i })).toHaveCount(0);
});
test("zeigt Sammelaktionen, sobald etwas ausgewählt ist", async ({ page }) => {
await page.goto("/geraete");
await expect(page.getByRole("link", { name: "INV-0001" })).toBeVisible();
await page.getByRole("checkbox", { name: "INV-0001 auswählen" }).click();
await expect(page.getByText("1 Gerät ausgewählt")).toBeVisible();
await expect(page.getByRole("button", { name: "Etiketten drucken" })).toBeVisible();
});
});
test.describe("Gerätedetail", () => {
test("zeigt Angaben, QR-Code und Lagerung", async ({ page }) => {
await page.goto("/geraete");
await page.getByRole("link", { name: "INV-0001" }).click();
await expect(page.getByRole("heading", { name: "Angaben" })).toBeVisible();
await expect(page.getByRole("heading", { name: "QR-Code" })).toBeVisible();
await expect(page.getByAltText(/QR-Code für INV-0001/)).toBeVisible();
await expect(page.getByText("Lagerung")).toBeVisible();
});
test("übernimmt das Prüfintervall aus dem Gerätetyp, wenn am Gerät keines steht", async ({
page,
}) => {
await page.goto("/geraete");
await page.getByRole("link", { name: "INV-0001" }).click();
await expect(page.getByText(/aus dem Gerätetyp/)).toBeVisible();
});
});
test.describe("QR-Route", () => {
test("leitet von /g/<inventarnummer> auf das Gerät weiter", async ({ page }) => {
await page.goto("/g/INV-0001");
await expect(page).toHaveURL(/\/geraete\/[0-9a-f-]{36}/);
await expect(page.getByText("INV-0001").first()).toBeVisible();
});
test("erklärt verständlich, wenn es die Nummer nicht gibt", async ({ page }) => {
await page.goto("/g/INV-GIBTESNICHT");
await expect(page.getByText("Kein Gerät gefunden")).toBeVisible();
await expect(page.getByText("INV-GIBTESNICHT")).toBeVisible();
});
test("schickt nicht Angemeldete erst zur Anmeldung", async ({ browser }) => {
// Frischer Kontext ohne Sitzungscookie.
const kontext = await browser.newContext();
const seite = await kontext.newPage();
await seite.goto("/g/INV-0001");
await expect(seite).toHaveURL(/\/anmelden/);
await kontext.close();
});
});
test.describe("Fahrzeuge", () => {
test("zeigt die Fahrzeuge als Kacheln", async ({ page }) => {
await page.goto("/fahrzeuge");
await expect(page.getByRole("heading", { name: "Fahrzeuge" })).toBeVisible();
await expect(page.getByRole("link", { name: /Florian Musterhausen 40\/1/ })).toBeVisible();
});
test("zeigt die Beladung nach Geräteräumen", async ({ page }) => {
await page.goto("/fahrzeuge");
await page.getByRole("link", { name: /Florian Musterhausen 40\/1/ }).click();
await expect(page.getByRole("heading", { name: "Beladung" })).toBeVisible();
// Die Beladeordnung aus dem Seed: G1 bis G6, Heck, Dach, Mannschaftsraum.
await expect(page.getByText("G1", { exact: true })).toBeVisible();
await expect(page.getByText("Dach", { exact: true })).toBeVisible();
});
});
test.describe("Qualifikationen", () => {
test("zeigt Ablaufwarnungen und den Katalog", async ({ page }) => {
await page.goto("/qualifikationen");
await expect(page.getByRole("heading", { name: "Qualifikationen" })).toBeVisible();
await expect(page.getByRole("heading", { name: "Läuft ab" })).toBeVisible();
await expect(page.getByRole("heading", { name: "Katalog" })).toBeVisible();
await expect(page.getByText("Atemschutzgeräteträger").first()).toBeVisible();
});
});
test.describe("Mitglieder", () => {
test("gruppiert nach Abteilung", async ({ page }) => {
await page.goto("/mitglieder");
await expect(page.getByRole("heading", { name: "Mitglieder" })).toBeVisible();
await expect(page.getByRole("heading", { name: /^Aktive \(/ })).toBeVisible();
await expect(page.getByRole("link", { name: "Huber, Andreas" })).toBeVisible();
});
test("zeigt Qualifikationen am Mitglied", async ({ page }) => {
await page.goto("/mitglieder");
await page.getByRole("link", { name: "Huber, Andreas" }).click();
await expect(page.getByRole("heading", { name: "Qualifikationen" })).toBeVisible();
await expect(page.getByRole("heading", { name: "Terminal-Zugang" })).toBeVisible();
});
});
test.describe("Import", () => {
test("führt durch die drei Schritte und zeigt die Vorschau", async ({ page }) => {
await page.goto("/geraete/importieren");
await expect(page.getByRole("heading", { name: "1. Datei wählen" })).toBeVisible();
const csv = [
"Inventarnummer;Bezeichnung;Hersteller;Indienststellung",
"E2E-001;Testgerät A;Beispiel;01.03.2024",
"E2E-002;Testgerät B;Beispiel;kein Datum",
].join("\n");
await page.setInputFiles("#datei", {
name: "test-geraete.csv",
mimeType: "text/csv",
buffer: Buffer.from(csv, "utf8"),
});
// Schritt 2 erscheint erst, wenn der Server die Datei gelesen hat.
await expect(page.getByRole("heading", { name: "2. Spalten zuordnen" })).toBeVisible();
await expect(page.getByRole("heading", { name: "Vorschau" })).toBeVisible();
// Eine Zeile ist gut, eine hat ein unlesbares Datum.
await expect(page.getByText("1 von 2 Zeilen sind übernehmbar")).toBeVisible();
await expect(page.getByRole("button", { name: /1 Zeilen übernehmen/ })).toBeEnabled();
});
test("verweigert die Übernahme, wenn ein Pflichtfeld nicht zugeordnet ist", async ({ page }) => {
await page.goto("/geraete/importieren");
await page.setInputFiles("#datei", {
name: "unvollstaendig.csv",
mimeType: "text/csv",
buffer: Buffer.from("Inventarnummer\nE2E-100\n", "utf8"),
});
await expect(page.getByText(/Diesen Pflichtfeldern ist keine Spalte zugeordnet/)).toBeVisible();
});
});