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
+232
View File
@@ -0,0 +1,232 @@
import Link from "next/link";
import { redirect } from "next/navigation";
import { AlertTriangle } from "lucide-react";
import { aktuelleSitzung } from "@/lib/auth";
import { hatRecht } from "@/lib/authz";
import { fuerOrganisation } from "@/lib/db";
import { alsDatum, personName } from "@/lib/utils";
import { qualifikationZustand } from "@/lib/stammdaten/fristen";
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
import { Badge } from "@/components/ui/badge";
import {
Table,
TableBody,
TableCell,
TableHead,
TableHeader,
TableRow,
} from "@/components/ui/table";
import { FristAnzeige, NichtsGefunden } from "@/components/stammdaten/anzeige";
export const metadata = { title: "Qualifikationen" };
const ART_TEXT: Record<string, string> = {
LEHRGANG: "Lehrgang",
BEFAEHIGUNG: "Befähigung",
UNTERSUCHUNG: "Untersuchung",
FUEHRERSCHEIN: "Führerschein",
UNTERWEISUNG: "Unterweisung",
SONSTIGES: "Sonstiges",
};
/**
* Qualifikationen mit Ablaufwarnung.
*
* Oben steht, was abgelaufen ist oder demnächst abläuft — das ist der Grund,
* warum jemand diese Seite öffnet. Der Katalog der Typen steht darunter.
*
* Gewarnt wird mit der Vorwarnzeit des jeweiligen Typs, nicht mit einer
* pauschalen Frist: eine G26.3-Untersuchung braucht mehr Vorlauf als eine
* jährliche Unterweisung, weil erst ein Termin beim Arzt gefunden werden muss.
*/
export default async function QualifikationenSeite() {
const sitzung = await aktuelleSitzung();
if (!sitzung) redirect("/anmelden");
if (!hatRecht(sitzung, "qualifikation.lesen")) redirect("/");
const daten = await fuerOrganisation(sitzung.organisationId, async (db) => {
const in180Tagen = new Date(Date.now() + 180 * 864e5);
const [ablaufend, typen] = await Promise.all([
db.qualifikation.findMany({
where: {
geloeschtAm: null,
gueltigBis: { not: null, lte: in180Tagen },
person: { aktiv: true, geloeschtAm: null },
},
include: {
typ: {
select: {
id: true,
name: true,
kuerzel: true,
art: true,
vorwarnzeitTage: true,
einsatzrelevant: true,
},
},
person: { select: { id: true, vorname: true, nachname: true } },
},
orderBy: { gueltigBis: "asc" },
take: 100,
}),
db.qualifikationstyp.findMany({
where: { geloeschtAm: null },
orderBy: [{ art: "asc" }, { name: "asc" }],
include: { _count: { select: { qualifikationen: true } } },
}),
]);
return { ablaufend, typen };
});
const dringend = daten.ablaufend.filter((eintrag) => {
const zustand = qualifikationZustand(eintrag.gueltigBis, eintrag.typ.vorwarnzeitTage);
return zustand === "ueberfaellig" || zustand === "faellig" || zustand === "bald_faellig";
});
return (
<div className="space-y-6">
<div>
<h1 className="text-2xl font-semibold tracking-tight">Qualifikationen</h1>
<p className="text-sm text-[var(--muted-foreground)]">
Lehrgänge, Befähigungen und Untersuchungen der Mannschaft.
</p>
</div>
<Card>
<CardHeader>
<div className="flex items-start gap-3">
<AlertTriangle
className={
dringend.length > 0
? "mt-0.5 size-5 shrink-0 text-[var(--pruefung-faellig)]"
: "mt-0.5 size-5 shrink-0 text-[var(--muted-foreground)]"
}
aria-hidden
/>
<div>
<CardTitle>Läuft ab</CardTitle>
<CardDescription>
{dringend.length === 0
? "Derzeit läuft nichts innerhalb der jeweiligen Vorwarnzeit ab."
: `${dringend.length} ${dringend.length === 1 ? "Qualifikation ist" : "Qualifikationen sind"} innerhalb der Vorwarnzeit oder bereits abgelaufen.`}
</CardDescription>
</div>
</div>
</CardHeader>
{dringend.length > 0 && (
<CardContent className="px-0 pb-0">
<Table>
<TableHeader>
<TableRow>
<TableHead className="pl-6">Mitglied</TableHead>
<TableHead>Qualifikation</TableHead>
<TableHead>Art</TableHead>
<TableHead className="text-right">Erworben</TableHead>
<TableHead className="pr-6 text-right">Gültig bis</TableHead>
</TableRow>
</TableHeader>
<TableBody>
{dringend.map((eintrag) => (
<TableRow key={eintrag.id}>
<TableCell className="pl-6 font-medium">
<Link
href={`/mitglieder/${eintrag.person.id}`}
className="underline-offset-4 hover:underline"
>
{personName(eintrag.person)}
</Link>
</TableCell>
<TableCell>
{eintrag.typ.name}
{eintrag.typ.einsatzrelevant && (
<Badge variant="gesperrt" className="ml-2">
einsatzrelevant
</Badge>
)}
</TableCell>
<TableCell className="text-sm text-[var(--muted-foreground)]">
{ART_TEXT[eintrag.typ.art] ?? eintrag.typ.art}
</TableCell>
<TableCell className="text-right tabellenzahlen">
{alsDatum(eintrag.erworbenAm)}
</TableCell>
<TableCell className="pr-6 text-right">
<FristAnzeige
datum={eintrag.gueltigBis}
vorwarnTage={eintrag.typ.vorwarnzeitTage}
/>
</TableCell>
</TableRow>
))}
</TableBody>
</Table>
</CardContent>
)}
</Card>
<Card>
<CardHeader>
<CardTitle>Katalog</CardTitle>
<CardDescription>
Welche Qualifikationen die Wehr führt, und wie lange sie jeweils gelten.
</CardDescription>
</CardHeader>
<CardContent className="px-0 pb-0">
{daten.typen.length === 0 ? (
<div className="px-6 pb-6">
<NichtsGefunden
titel="Noch keine Qualifikationstypen angelegt"
hinweis="Erst wenn Typen wie „Maschinist“ oder „G26.3“ angelegt sind, lassen sich Qualifikationen zuweisen."
/>
</div>
) : (
<Table>
<TableHeader>
<TableRow>
<TableHead className="pl-6">Bezeichnung</TableHead>
<TableHead>Kürzel</TableHead>
<TableHead>Art</TableHead>
<TableHead className="text-right">Gültigkeit</TableHead>
<TableHead className="text-right">Vorwarnzeit</TableHead>
<TableHead className="pr-6 text-right">Erfasst</TableHead>
</TableRow>
</TableHeader>
<TableBody>
{daten.typen.map((typ) => (
<TableRow key={typ.id}>
<TableCell className="pl-6 font-medium">
{typ.name}
{typ.einsatzrelevant && (
<Badge variant="secondary" className="ml-2">
einsatzrelevant
</Badge>
)}
</TableCell>
<TableCell className="tabellenzahlen">{typ.kuerzel ?? "—"}</TableCell>
<TableCell className="text-sm text-[var(--muted-foreground)]">
{ART_TEXT[typ.art] ?? typ.art}
</TableCell>
<TableCell className="text-right">
{typ.gueltigkeitMonate
? `${typ.gueltigkeitMonate} Monate`
: "unbefristet"}
</TableCell>
<TableCell className="text-right tabellenzahlen">
{typ.vorwarnzeitTage} Tage
</TableCell>
<TableCell className="pr-6 text-right tabellenzahlen">
{typ._count.qualifikationen}
</TableCell>
</TableRow>
))}
</TableBody>
</Table>
)}
</CardContent>
</Card>
</div>
);
}