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
co-authored by
Claude Opus 5
Claude Opus 5
parent
4b3021bb50
commit
26b62a3477
@@ -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();
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,10 @@
|
||||
/**
|
||||
* Ersatz für das Paket "server-only" im Testlauf.
|
||||
*
|
||||
* Das echte Paket wirft beim Import, sobald es außerhalb einer Server-
|
||||
* Komponente geladen wird — genau dafür ist es da. Vitest ist aber weder
|
||||
* Server noch Browser, und Module wie lib/stammdaten/import.ts sollen sich
|
||||
* trotzdem testen lassen. Die Schutzwirkung im Anwendungscode bleibt
|
||||
* unberührt: dort wird weiterhin das echte Paket eingebunden.
|
||||
*/
|
||||
export {};
|
||||
@@ -0,0 +1,308 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import {
|
||||
GERAET_FELDER,
|
||||
PERSON_FELDER,
|
||||
auswahlLesen,
|
||||
datumLesen,
|
||||
dezimalLesen,
|
||||
jaNeinLesen,
|
||||
normalisiereUeberschrift,
|
||||
spaltenZuordnen,
|
||||
wertLesen,
|
||||
zahlLesen,
|
||||
} from "@/lib/stammdaten/import-felder";
|
||||
import { csvLesen, formatErkennen, textAusPuffer, vorschauErstellen } from "@/lib/stammdaten/import";
|
||||
|
||||
/**
|
||||
* Tests für den Import.
|
||||
*
|
||||
* Der Import ist die Stelle, an der eine Wehr das Vertrauen in die Software
|
||||
* gewinnt oder verliert: Wenn hier Spalten verrutschen, stehen später falsche
|
||||
* Seriennummern an falschen Geräten, und das merkt niemand, bis jemand am
|
||||
* Regal steht.
|
||||
*
|
||||
* Geprüft wird deshalb nicht nur der Normalfall, sondern vor allem das, was
|
||||
* in echten Tabellen tatsächlich vorkommt: deutsche Datumsformate, Semikolon
|
||||
* als Trennzeichen, Windows-1252, Excel-Seriennummern, Dubletten.
|
||||
*/
|
||||
|
||||
describe("Datum lesen", () => {
|
||||
it("versteht das deutsche Format", () => {
|
||||
expect(datumLesen("02.09.2026").wert).toEqual(new Date(Date.UTC(2026, 8, 2, 12)));
|
||||
expect(datumLesen("2.9.2026").wert).toEqual(new Date(Date.UTC(2026, 8, 2, 12)));
|
||||
});
|
||||
|
||||
it("versteht zweistellige Jahre nach der üblichen Grenze", () => {
|
||||
expect(datumLesen("02.09.26").wert?.getUTCFullYear()).toBe(2026);
|
||||
expect(datumLesen("02.09.85").wert?.getUTCFullYear()).toBe(1985);
|
||||
});
|
||||
|
||||
it("versteht ISO", () => {
|
||||
expect(datumLesen("2026-09-02").wert).toEqual(new Date(Date.UTC(2026, 8, 2, 12)));
|
||||
});
|
||||
|
||||
it("versteht die Seriennummer, die Excel intern benutzt", () => {
|
||||
// 45000 Tage nach dem 30.12.1899 ist der 15.03.2023.
|
||||
const ergebnis = datumLesen("45000");
|
||||
expect(ergebnis.ok).toBe(true);
|
||||
expect(ergebnis.wert?.getUTCFullYear()).toBe(2023);
|
||||
expect(ergebnis.wert?.getUTCMonth()).toBe(2);
|
||||
expect(ergebnis.wert?.getUTCDate()).toBe(15);
|
||||
});
|
||||
|
||||
it("weist Tage ab, die es nicht gibt", () => {
|
||||
expect(datumLesen("31.02.2026").ok).toBe(false);
|
||||
expect(datumLesen("32.01.2026").ok).toBe(false);
|
||||
expect(datumLesen("01.13.2026").ok).toBe(false);
|
||||
});
|
||||
|
||||
it("weist unplausible Jahre ab", () => {
|
||||
expect(datumLesen("01.01.1850").ok).toBe(false);
|
||||
expect(datumLesen("01.01.2200").ok).toBe(false);
|
||||
});
|
||||
|
||||
it("lässt leere Felder durch, ohne einen Wert zu setzen", () => {
|
||||
const ergebnis = datumLesen(" ");
|
||||
expect(ergebnis.ok).toBe(true);
|
||||
expect(ergebnis.wert).toBeUndefined();
|
||||
});
|
||||
|
||||
it("meldet Unsinn mit einer verständlichen Meldung", () => {
|
||||
const ergebnis = datumLesen("demnächst");
|
||||
expect(ergebnis.ok).toBe(false);
|
||||
expect(ergebnis.fehler).toContain("TT.MM.JJJJ");
|
||||
});
|
||||
});
|
||||
|
||||
describe("Zahlen lesen", () => {
|
||||
it("versteht Tausenderpunkte", () => {
|
||||
expect(zahlLesen("1.234").wert).toBe(1234);
|
||||
expect(zahlLesen("12").wert).toBe(12);
|
||||
});
|
||||
|
||||
it("versteht deutsche und englische Dezimalschreibweise", () => {
|
||||
expect(dezimalLesen("1.234,56").wert).toBeCloseTo(1234.56);
|
||||
expect(dezimalLesen("1,234.56").wert).toBeCloseTo(1234.56);
|
||||
expect(dezimalLesen("1234,56").wert).toBeCloseTo(1234.56);
|
||||
expect(dezimalLesen("1234.56").wert).toBeCloseTo(1234.56);
|
||||
});
|
||||
|
||||
it("verkraftet ein Eurozeichen", () => {
|
||||
expect(dezimalLesen("1.899,00 €").wert).toBeCloseTo(1899);
|
||||
});
|
||||
|
||||
it("weist Text ab", () => {
|
||||
expect(zahlLesen("etwa zwölf").ok).toBe(false);
|
||||
expect(dezimalLesen("teuer").ok).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe("Ja/Nein lesen", () => {
|
||||
it("versteht die Schreibweisen aus echten Tabellen", () => {
|
||||
for (const wahr of ["ja", "J", "x", "1", "WAHR", "true"]) {
|
||||
expect(jaNeinLesen(wahr).wert, wahr).toBe(true);
|
||||
}
|
||||
for (const falsch of ["nein", "N", "0", "falsch", "-"]) {
|
||||
expect(jaNeinLesen(falsch).wert, falsch).toBe(false);
|
||||
}
|
||||
});
|
||||
|
||||
it("weist Unklares ab, statt zu raten", () => {
|
||||
expect(jaNeinLesen("vielleicht").ok).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe("Auswahlwerte", () => {
|
||||
const auswahl = { einsatzbereit: "EINSATZBEREIT", "Prüfung fällig": "PRUEFUNG_FAELLIG" };
|
||||
|
||||
it("erkennt die Anzeigeform", () => {
|
||||
expect(auswahlLesen("einsatzbereit", auswahl).wert).toBe("EINSATZBEREIT");
|
||||
});
|
||||
|
||||
it("erkennt auch den gespeicherten Wert", () => {
|
||||
expect(auswahlLesen("PRUEFUNG_FAELLIG", auswahl).wert).toBe("PRUEFUNG_FAELLIG");
|
||||
});
|
||||
|
||||
it("ist bei Umlauten und Schreibweise nachsichtig", () => {
|
||||
expect(auswahlLesen("pruefung faellig", auswahl).wert).toBe("PRUEFUNG_FAELLIG");
|
||||
expect(auswahlLesen(" Einsatzbereit ", auswahl).wert).toBe("EINSATZBEREIT");
|
||||
});
|
||||
|
||||
it("nennt bei einem falschen Wert die erlaubten", () => {
|
||||
const ergebnis = auswahlLesen("kaputt", auswahl);
|
||||
expect(ergebnis.ok).toBe(false);
|
||||
expect(ergebnis.fehler).toContain("einsatzbereit");
|
||||
});
|
||||
});
|
||||
|
||||
describe("Überschriften normalisieren", () => {
|
||||
it("macht Umlaute und Sonderzeichen vergleichbar", () => {
|
||||
expect(normalisiereUeberschrift("Nächste Prüfung")).toBe("naechstepruefung");
|
||||
expect(normalisiereUeberschrift("INVENTAR-NR.")).toBe("inventarnr");
|
||||
expect(normalisiereUeberschrift("Größe (kg)")).toBe("groessekg");
|
||||
});
|
||||
});
|
||||
|
||||
describe("Spalten zuordnen", () => {
|
||||
it("erkennt die üblichen Überschriften von selbst", () => {
|
||||
const zuordnung = spaltenZuordnen(
|
||||
["Inventarnummer", "Bezeichnung", "Hersteller", "Seriennummer"],
|
||||
GERAET_FELDER,
|
||||
);
|
||||
|
||||
expect(zuordnung["Inventarnummer"]).toBe("inventarnummer");
|
||||
expect(zuordnung["Bezeichnung"]).toBe("bezeichnung");
|
||||
expect(zuordnung["Hersteller"]).toBe("hersteller");
|
||||
expect(zuordnung["Seriennummer"]).toBe("seriennummer");
|
||||
});
|
||||
|
||||
it("erkennt auch abweichende Schreibweisen", () => {
|
||||
const zuordnung = spaltenZuordnen(["Inv.-Nr.", "Fabrikat", "Serien-Nr"], GERAET_FELDER);
|
||||
|
||||
expect(zuordnung["Inv.-Nr."]).toBe("inventarnummer");
|
||||
expect(zuordnung["Fabrikat"]).toBe("hersteller");
|
||||
expect(zuordnung["Serien-Nr"]).toBe("seriennummer");
|
||||
});
|
||||
|
||||
it("vergibt jedes Zielfeld höchstens einmal", () => {
|
||||
const zuordnung = spaltenZuordnen(["Name", "Bezeichnung"], GERAET_FELDER);
|
||||
const vergeben = Object.values(zuordnung).filter(Boolean);
|
||||
expect(new Set(vergeben).size).toBe(vergeben.length);
|
||||
});
|
||||
|
||||
it("lässt unbekannte Spalten leer, statt zu raten", () => {
|
||||
const zuordnung = spaltenZuordnen(["Lieblingsfarbe"], PERSON_FELDER);
|
||||
expect(zuordnung["Lieblingsfarbe"]).toBeNull();
|
||||
});
|
||||
});
|
||||
|
||||
describe("Werte gegen die Feldbeschreibung prüfen", () => {
|
||||
const inventarnummer = GERAET_FELDER.find((feld) => feld.schluessel === "inventarnummer")!;
|
||||
const bemerkung = GERAET_FELDER.find((feld) => feld.schluessel === "bemerkung")!;
|
||||
|
||||
it("meldet ein fehlendes Pflichtfeld", () => {
|
||||
const ergebnis = wertLesen(inventarnummer, "");
|
||||
expect(ergebnis.ok).toBe(false);
|
||||
expect(ergebnis.fehler).toContain("Pflichtfeld");
|
||||
});
|
||||
|
||||
it("meldet zu lange Werte mit Zahlen", () => {
|
||||
const ergebnis = wertLesen(bemerkung, "x".repeat(1500));
|
||||
expect(ergebnis.ok).toBe(false);
|
||||
expect(ergebnis.fehler).toContain("1500");
|
||||
});
|
||||
});
|
||||
|
||||
describe("CSV lesen", () => {
|
||||
it("erkennt das Semikolon, das Excel im Deutschen schreibt", () => {
|
||||
const tabelle = csvLesen("Inventarnummer;Bezeichnung\nINV-001;Pressluftatmer\n");
|
||||
|
||||
expect(tabelle.spalten).toEqual(["Inventarnummer", "Bezeichnung"]);
|
||||
expect(tabelle.zeilen).toHaveLength(1);
|
||||
expect(tabelle.zeilen[0]?.["Bezeichnung"]).toBe("Pressluftatmer");
|
||||
});
|
||||
|
||||
it("kommt auch mit Komma zurecht", () => {
|
||||
const tabelle = csvLesen("Inventarnummer,Bezeichnung\nINV-001,Schlauch\n");
|
||||
expect(tabelle.zeilen[0]?.["Bezeichnung"]).toBe("Schlauch");
|
||||
});
|
||||
|
||||
it("überspringt leere Zeilen", () => {
|
||||
const tabelle = csvLesen("A;B\n1;2\n\n\n3;4\n");
|
||||
expect(tabelle.zeilen).toHaveLength(2);
|
||||
});
|
||||
});
|
||||
|
||||
describe("Zeichensatz erkennen", () => {
|
||||
it("entfernt eine UTF-8-BOM", () => {
|
||||
const puffer = Buffer.concat([Buffer.from([0xef, 0xbb, 0xbf]), Buffer.from("Prüfung", "utf8")]);
|
||||
expect(textAusPuffer(puffer)).toBe("Prüfung");
|
||||
});
|
||||
|
||||
it("fällt bei Windows-1252 auf latin1 zurück", () => {
|
||||
// "Prüfung" in Windows-1252: das ü ist ein einzelnes Byte 0xFC.
|
||||
const puffer = Buffer.from([0x50, 0x72, 0xfc, 0x66, 0x75, 0x6e, 0x67]);
|
||||
expect(textAusPuffer(puffer)).toBe("Prüfung");
|
||||
});
|
||||
});
|
||||
|
||||
describe("Formaterkennung", () => {
|
||||
it("erkennt die unterstützten Endungen", () => {
|
||||
expect(formatErkennen("geraete.csv")).toBe("csv");
|
||||
expect(formatErkennen("Geräte.XLSX")).toBe("xlsx");
|
||||
expect(formatErkennen("export.txt")).toBe("csv");
|
||||
});
|
||||
|
||||
it("gibt bei allem anderen null zurück", () => {
|
||||
expect(formatErkennen("bestand.pdf")).toBeNull();
|
||||
expect(formatErkennen("ohne-endung")).toBeNull();
|
||||
});
|
||||
});
|
||||
|
||||
describe("Vorschau", () => {
|
||||
const csv = [
|
||||
"Inventarnummer;Bezeichnung;Hersteller;Indienststellung;Preis",
|
||||
"INV-001;Pressluftatmer;Dräger;01.03.2019;1.899,00",
|
||||
"INV-002;Feuerwehrleine;Bauer;15.06.2021;249,50",
|
||||
";Ohne Nummer;Unbekannt;01.01.2020;100",
|
||||
"INV-001;Doppelte Nummer;Dräger;01.01.2020;100",
|
||||
"INV-004;Schlauch;Ziegler;kein Datum;80",
|
||||
].join("\n");
|
||||
|
||||
const vorschau = () => vorschauErstellen(csvLesen(csv), "geraet");
|
||||
|
||||
it("ordnet die Spalten von selbst zu", () => {
|
||||
const ergebnis = vorschau();
|
||||
expect(ergebnis.zuordnung["Inventarnummer"]).toBe("inventarnummer");
|
||||
expect(ergebnis.zuordnung["Preis"]).toBe("anschaffungspreis");
|
||||
});
|
||||
|
||||
it("wandelt Werte in den richtigen Typ", () => {
|
||||
const erste = vorschau().zeilen[0];
|
||||
expect(erste?.werte.inventarnummer).toBe("INV-001");
|
||||
expect(erste?.werte.anschaffungspreis).toBeCloseTo(1899);
|
||||
expect(erste?.werte.indienststellung).toBeInstanceOf(Date);
|
||||
});
|
||||
|
||||
it("markiert die Zeile ohne Pflichtfeld als nicht übernehmbar", () => {
|
||||
const dritte = vorschau().zeilen[2];
|
||||
expect(dritte?.uebernehmbar).toBe(false);
|
||||
expect(dritte?.fehler.some((f) => f.meldung.includes("Pflichtfeld"))).toBe(true);
|
||||
});
|
||||
|
||||
it("erkennt Dubletten innerhalb der Datei und nennt die erste Zeile", () => {
|
||||
const vierte = vorschau().zeilen[3];
|
||||
expect(vierte?.uebernehmbar).toBe(false);
|
||||
expect(vierte?.fehler.some((f) => f.meldung.includes("Zeile 1"))).toBe(true);
|
||||
});
|
||||
|
||||
it("markiert ein unlesbares Datum, ohne die Zeile stillschweigend zu verwerfen", () => {
|
||||
const fuenfte = vorschau().zeilen[4];
|
||||
expect(fuenfte?.uebernehmbar).toBe(false);
|
||||
expect(fuenfte?.fehler[0]?.feld).toBe("Indienststellung");
|
||||
});
|
||||
|
||||
it("zählt übernehmbare und fehlerhafte Zeilen getrennt", () => {
|
||||
const ergebnis = vorschau();
|
||||
expect(ergebnis.anzahlUebernehmbar).toBe(2);
|
||||
expect(ergebnis.anzahlFehlerhaft).toBe(3);
|
||||
expect(ergebnis.zeilen).toHaveLength(5);
|
||||
});
|
||||
|
||||
it("meldet Pflichtfelder, denen gar keine Spalte zugeordnet ist", () => {
|
||||
const ohneBezeichnung = vorschauErstellen(csvLesen("Inventarnummer\nINV-001\n"), "geraet");
|
||||
expect(ohneBezeichnung.fehlendePflichtfelder).toContain("Bezeichnung");
|
||||
expect(ohneBezeichnung.anzahlUebernehmbar).toBe(0);
|
||||
});
|
||||
|
||||
it("folgt einer von Hand geänderten Zuordnung", () => {
|
||||
const tabelle = csvLesen("Spalte A;Spalte B\nINV-9;Schlauch\n");
|
||||
const ergebnis = vorschauErstellen(tabelle, "geraet", {
|
||||
"Spalte A": "inventarnummer",
|
||||
"Spalte B": "bezeichnung",
|
||||
});
|
||||
|
||||
expect(ergebnis.anzahlUebernehmbar).toBe(1);
|
||||
expect(ergebnis.zeilen[0]?.werte.inventarnummer).toBe("INV-9");
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,254 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import { inventarnummerAusScan } from "@/lib/stammdaten/qr-parser";
|
||||
import {
|
||||
abgeleiteterGeraetStatus,
|
||||
effektiverWert,
|
||||
fristzustand,
|
||||
lebensdauerEnde,
|
||||
naechstePruefung,
|
||||
qualifikationGueltigBis,
|
||||
tageBis,
|
||||
} from "@/lib/stammdaten/fristen";
|
||||
|
||||
/**
|
||||
* Tests für die QR-Route und die Fristenrechnung.
|
||||
*
|
||||
* Beides entscheidet darüber, ob ein Gerät als einsatzbereit gilt. Ein Fehler
|
||||
* in der Fristenrechnung ist gefährlicher als ein Fehler in der Oberfläche:
|
||||
* Er fällt niemandem auf, bis die Unfallkasse fragt.
|
||||
*
|
||||
* Alle Zeitangaben werden mit einem festen "heute" gerechnet, damit die Tests
|
||||
* nicht von der Uhr abhängen und um Mitternacht anders ausgehen.
|
||||
*/
|
||||
|
||||
const HEUTE = new Date(Date.UTC(2026, 8, 3, 10, 0, 0)); // 3. September 2026
|
||||
|
||||
describe("QR-Scan auswerten", () => {
|
||||
it("liest die Inventarnummer aus der eigenen URL", () => {
|
||||
expect(inventarnummerAusScan("https://florian.beispielwehr.de/g/INV-0042")).toBe("INV-0042");
|
||||
});
|
||||
|
||||
it("liest sie auch aus einem bloßen Pfad", () => {
|
||||
expect(inventarnummerAusScan("/g/INV-0042")).toBe("INV-0042");
|
||||
});
|
||||
|
||||
it("dekodiert Sonderzeichen aus der URL", () => {
|
||||
expect(inventarnummerAusScan("https://florian.local/g/INV%2F12")).toBe("INV/12");
|
||||
});
|
||||
|
||||
it("nimmt eine blanke Nummer an — alte Etiketten sollen weiter gehen", () => {
|
||||
expect(inventarnummerAusScan("INV-0042")).toBe("INV-0042");
|
||||
expect(inventarnummerAusScan(" 12345 ")).toBe("12345");
|
||||
});
|
||||
|
||||
it("weist fremde URLs ab", () => {
|
||||
expect(inventarnummerAusScan("https://www.draeger.com/produkt/pa94")).toBeNull();
|
||||
expect(inventarnummerAusScan("http://beispiel.de")).toBeNull();
|
||||
});
|
||||
|
||||
it("weist leere und unsinnige Eingaben ab", () => {
|
||||
expect(inventarnummerAusScan("")).toBeNull();
|
||||
expect(inventarnummerAusScan(" ")).toBeNull();
|
||||
expect(inventarnummerAusScan("WIFI:S=Geraetehaus;T=WPA;P=geheim;;")).toBeNull();
|
||||
});
|
||||
|
||||
it("weist übermäßig lange Zeichenketten ab", () => {
|
||||
expect(inventarnummerAusScan("A".repeat(200))).toBeNull();
|
||||
});
|
||||
});
|
||||
|
||||
describe("Nächste Prüfung", () => {
|
||||
it("rechnet ab der letzten Prüfung", () => {
|
||||
const termin = naechstePruefung({
|
||||
letztePruefung: new Date(Date.UTC(2026, 2, 1)),
|
||||
intervallMonate: 12,
|
||||
});
|
||||
expect(termin?.getUTCFullYear()).toBe(2027);
|
||||
expect(termin?.getUTCMonth()).toBe(2);
|
||||
});
|
||||
|
||||
it("nimmt ersatzweise die Indienststellung, wenn noch nie geprüft wurde", () => {
|
||||
const termin = naechstePruefung({
|
||||
indienststellung: new Date(Date.UTC(2026, 0, 15)),
|
||||
intervallMonate: 6,
|
||||
});
|
||||
expect(termin?.getUTCMonth()).toBe(6);
|
||||
});
|
||||
|
||||
it("bevorzugt die letzte Prüfung vor der Indienststellung", () => {
|
||||
const termin = naechstePruefung({
|
||||
letztePruefung: new Date(Date.UTC(2026, 5, 1)),
|
||||
indienststellung: new Date(Date.UTC(2020, 0, 1)),
|
||||
intervallMonate: 12,
|
||||
});
|
||||
expect(termin?.getUTCFullYear()).toBe(2027);
|
||||
});
|
||||
|
||||
it("gibt ohne Intervall keinen Termin zurück — das ist kein Fehler", () => {
|
||||
expect(naechstePruefung({ letztePruefung: HEUTE, intervallMonate: null })).toBeNull();
|
||||
expect(naechstePruefung({ letztePruefung: HEUTE, intervallMonate: 0 })).toBeNull();
|
||||
});
|
||||
|
||||
it("gibt ohne jeden Anhaltspunkt keinen Termin zurück", () => {
|
||||
expect(naechstePruefung({ intervallMonate: 12 })).toBeNull();
|
||||
});
|
||||
});
|
||||
|
||||
describe("Lebensdauer", () => {
|
||||
it("rechnet ab Indienststellung, wenn das die Vorgabe ist", () => {
|
||||
const ende = lebensdauerEnde({
|
||||
herstellungsdatum: new Date(Date.UTC(2010, 0, 1)),
|
||||
indienststellung: new Date(Date.UTC(2012, 0, 1)),
|
||||
lebensdauerJahre: 10,
|
||||
bezug: "INDIENSTSTELLUNG",
|
||||
});
|
||||
expect(ende?.getUTCFullYear()).toBe(2022);
|
||||
});
|
||||
|
||||
it("rechnet ab Herstellung, wenn die Vorschrift das verlangt", () => {
|
||||
// Seile und Druckbehälter altern ab Herstellung, nicht ab Einbau.
|
||||
const ende = lebensdauerEnde({
|
||||
herstellungsdatum: new Date(Date.UTC(2010, 0, 1)),
|
||||
indienststellung: new Date(Date.UTC(2012, 0, 1)),
|
||||
lebensdauerJahre: 10,
|
||||
bezug: "HERSTELLUNG",
|
||||
});
|
||||
expect(ende?.getUTCFullYear()).toBe(2020);
|
||||
});
|
||||
|
||||
it("weicht auf das andere Datum aus, wenn eines fehlt", () => {
|
||||
const ende = lebensdauerEnde({
|
||||
indienststellung: new Date(Date.UTC(2015, 0, 1)),
|
||||
lebensdauerJahre: 5,
|
||||
bezug: "HERSTELLUNG",
|
||||
});
|
||||
expect(ende?.getUTCFullYear()).toBe(2020);
|
||||
});
|
||||
|
||||
it("gibt ohne Lebensdauer nichts zurück", () => {
|
||||
expect(
|
||||
lebensdauerEnde({ indienststellung: HEUTE, lebensdauerJahre: null }),
|
||||
).toBeNull();
|
||||
});
|
||||
});
|
||||
|
||||
describe("Fristzustand", () => {
|
||||
it("erkennt überfällig, fällig und in Ordnung", () => {
|
||||
expect(fristzustand(new Date(Date.UTC(2026, 7, 1)), 30, HEUTE)).toBe("ueberfaellig");
|
||||
expect(fristzustand(new Date(Date.UTC(2026, 8, 3)), 30, HEUTE)).toBe("faellig");
|
||||
expect(fristzustand(new Date(Date.UTC(2026, 8, 20)), 30, HEUTE)).toBe("bald_faellig");
|
||||
expect(fristzustand(new Date(Date.UTC(2027, 0, 1)), 30, HEUTE)).toBe("in_ordnung");
|
||||
});
|
||||
|
||||
it("achtet auf die Vorwarnzeit", () => {
|
||||
const in60Tagen = new Date(Date.UTC(2026, 10, 2));
|
||||
expect(fristzustand(in60Tagen, 30, HEUTE)).toBe("in_ordnung");
|
||||
expect(fristzustand(in60Tagen, 90, HEUTE)).toBe("bald_faellig");
|
||||
});
|
||||
|
||||
it("meldet ohne Frist genau das", () => {
|
||||
expect(fristzustand(null, 30, HEUTE)).toBe("ohne_frist");
|
||||
expect(fristzustand(undefined, 30, HEUTE)).toBe("ohne_frist");
|
||||
});
|
||||
|
||||
it("zählt Tage in beide Richtungen", () => {
|
||||
expect(tageBis(new Date(Date.UTC(2026, 8, 13)), HEUTE)).toBe(10);
|
||||
expect(tageBis(new Date(Date.UTC(2026, 7, 24)), HEUTE)).toBe(-10);
|
||||
expect(tageBis(null, HEUTE)).toBeNull();
|
||||
});
|
||||
});
|
||||
|
||||
describe("Abgeleiteter Gerätestatus", () => {
|
||||
it("setzt auf Prüfung fällig, wenn der Termin vorbei ist", () => {
|
||||
expect(
|
||||
abgeleiteterGeraetStatus({
|
||||
aktuellerStatus: "EINSATZBEREIT",
|
||||
naechstePruefung: new Date(Date.UTC(2026, 7, 1)),
|
||||
heute: HEUTE,
|
||||
}),
|
||||
).toBe("PRUEFUNG_FAELLIG");
|
||||
});
|
||||
|
||||
it("setzt zurück auf einsatzbereit, wenn der Termin wieder in der Zukunft liegt", () => {
|
||||
expect(
|
||||
abgeleiteterGeraetStatus({
|
||||
aktuellerStatus: "PRUEFUNG_FAELLIG",
|
||||
naechstePruefung: new Date(Date.UTC(2027, 0, 1)),
|
||||
heute: HEUTE,
|
||||
}),
|
||||
).toBe("EINSATZBEREIT");
|
||||
});
|
||||
|
||||
it("sperrt ein Gerät mit abgelaufener Lebensdauer", () => {
|
||||
expect(
|
||||
abgeleiteterGeraetStatus({
|
||||
aktuellerStatus: "EINSATZBEREIT",
|
||||
naechstePruefung: new Date(Date.UTC(2027, 0, 1)),
|
||||
lebensdauerBis: new Date(Date.UTC(2026, 0, 1)),
|
||||
heute: HEUTE,
|
||||
}),
|
||||
).toBe("GESPERRT");
|
||||
});
|
||||
|
||||
it("lässt die Lebensdauer schwerer wiegen als eine fällige Prüfung", () => {
|
||||
expect(
|
||||
abgeleiteterGeraetStatus({
|
||||
aktuellerStatus: "EINSATZBEREIT",
|
||||
naechstePruefung: new Date(Date.UTC(2026, 0, 1)),
|
||||
lebensdauerBis: new Date(Date.UTC(2026, 0, 1)),
|
||||
heute: HEUTE,
|
||||
}),
|
||||
).toBe("GESPERRT");
|
||||
});
|
||||
|
||||
it("fasst von Hand gesetzte Zustände nicht an", () => {
|
||||
for (const status of ["GESPERRT", "AUSGESONDERT", "IN_REPARATUR"] as const) {
|
||||
expect(
|
||||
abgeleiteterGeraetStatus({
|
||||
aktuellerStatus: status,
|
||||
naechstePruefung: new Date(Date.UTC(2027, 0, 1)),
|
||||
heute: HEUTE,
|
||||
}),
|
||||
status,
|
||||
).toBe(status);
|
||||
}
|
||||
});
|
||||
|
||||
it("lässt ein Gerät ohne Fristen einsatzbereit", () => {
|
||||
expect(
|
||||
abgeleiteterGeraetStatus({ aktuellerStatus: "EINSATZBEREIT", heute: HEUTE }),
|
||||
).toBe("EINSATZBEREIT");
|
||||
});
|
||||
});
|
||||
|
||||
describe("Vorgabe des Gerätetyps", () => {
|
||||
it("lässt den Wert am Gerät gewinnen", () => {
|
||||
expect(effektiverWert(6, 12)).toBe(6);
|
||||
});
|
||||
|
||||
it("greift auf den Typ zurück, wenn am Gerät nichts steht", () => {
|
||||
expect(effektiverWert(null, 12)).toBe(12);
|
||||
expect(effektiverWert(undefined, 12)).toBe(12);
|
||||
});
|
||||
|
||||
it("gibt null zurück, wenn beide leer sind", () => {
|
||||
expect(effektiverWert(null, null)).toBeNull();
|
||||
});
|
||||
|
||||
it("behandelt die 0 als gesetzten Wert, nicht als fehlend", () => {
|
||||
expect(effektiverWert(0, 12)).toBe(0);
|
||||
});
|
||||
});
|
||||
|
||||
describe("Gültigkeit einer Qualifikation", () => {
|
||||
it("rechnet die Gültigkeitsdauer auf das Erwerbsdatum", () => {
|
||||
const bis = qualifikationGueltigBis(new Date(Date.UTC(2026, 2, 1)), 36);
|
||||
expect(bis?.getUTCFullYear()).toBe(2029);
|
||||
expect(bis?.getUTCMonth()).toBe(2);
|
||||
});
|
||||
|
||||
it("gibt bei unbefristeten Qualifikationen kein Ablaufdatum zurück", () => {
|
||||
expect(qualifikationGueltigBis(HEUTE, null)).toBeNull();
|
||||
expect(qualifikationGueltigBis(HEUTE, 0)).toBeNull();
|
||||
});
|
||||
});
|
||||
Reference in New Issue
Block a user