Files
FireAdministration/src/app/(app)/geraete/scannen/scanner.tsx
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

191 lines
6.0 KiB
TypeScript

"use client";
import * as React from "react";
import { useRouter } from "next/navigation";
import { BrowserQRCodeReader } from "@zxing/browser";
import type { Result } from "@zxing/library";
import { Camera, CameraOff, KeyboardIcon, RefreshCw } from "lucide-react";
import { Button } from "@/components/ui/button";
import { Input } from "@/components/ui/input";
import { Label } from "@/components/ui/label";
import { Fehlermeldung } from "@/components/stammdaten/anzeige";
import { inventarnummerAusScan } from "@/lib/stammdaten/qr-parser";
/**
* QR-Scanner über die Kamera.
*
* Bewusst mit @zxing/browser statt der eingebauten BarcodeDetector-API: die
* gibt es in Firefox und in Safari auf dem iPad nicht, und im Gerätehaus steht
* genau so ein Tablet.
*
* Zwei Dinge, die in der Praxis zählen:
* - Die Kamera wird beim Verlassen der Seite wirklich freigegeben. Sonst
* bleibt die Leuchte an und der nächste Aufruf bekommt kein Bild.
* - Es gibt immer einen Weg ohne Kamera. Wenn die Freigabe verweigert wurde
* oder das Etikett zerkratzt ist, tippt man die Nummer ein.
*/
export function Scanner() {
const router = useRouter();
const videoRef = React.useRef<HTMLVideoElement>(null);
const steuerungRef = React.useRef<{ stop: () => void } | null>(null);
const [laeuft, setLaeuft] = React.useState(false);
const [fehler, setFehler] = React.useState<string | null>(null);
const [letzterScan, setLetzterScan] = React.useState<string | null>(null);
const [eingabe, setEingabe] = React.useState("");
const stoppen = React.useCallback(() => {
steuerungRef.current?.stop();
steuerungRef.current = null;
setLaeuft(false);
}, []);
// Kamera in jedem Fall freigeben, auch bei einem Wechsel per Zurück-Taste.
React.useEffect(() => stoppen, [stoppen]);
const oeffnen = React.useCallback(
(inventarnummer: string) => {
stoppen();
router.push(`/g/${encodeURIComponent(inventarnummer)}`);
},
[router, stoppen],
);
async function starten() {
setFehler(null);
setLetzterScan(null);
if (!videoRef.current) return;
if (!navigator.mediaDevices?.getUserMedia) {
setFehler(
"Dieser Browser gibt keinen Kamerazugriff frei. Bitte die Inventarnummer eintippen.",
);
return;
}
try {
const leser = new BrowserQRCodeReader();
const steuerung = await leser.decodeFromVideoDevice(
undefined,
videoRef.current,
(ergebnis: Result | undefined) => {
if (!ergebnis) return;
const roh = ergebnis.getText();
const nummer = inventarnummerAusScan(roh);
if (!nummer) {
// Fremde Codes kommen ständig vor — der Hersteller-Barcode klebt
// oft direkt daneben. Kein Abbruch, nur ein Hinweis.
setLetzterScan(roh);
return;
}
oeffnen(nummer);
},
);
steuerungRef.current = steuerung;
setLaeuft(true);
} catch (ausnahme) {
const name = (ausnahme as { name?: string })?.name;
if (name === "NotAllowedError") {
setFehler(
"Der Kamerazugriff wurde abgelehnt. Er lässt sich in den Browsereinstellungen wieder freigeben — oder Sie tippen die Inventarnummer ein.",
);
} else if (name === "NotFoundError") {
setFehler("An diesem Gerät wurde keine Kamera gefunden.");
} else {
setFehler(`Die Kamera ließ sich nicht öffnen: ${String(ausnahme)}`);
}
}
}
function eingabeAbsenden(ereignis: React.FormEvent) {
ereignis.preventDefault();
const nummer = inventarnummerAusScan(eingabe);
if (!nummer) {
setFehler("Das sieht nicht nach einer Inventarnummer aus.");
return;
}
oeffnen(nummer);
}
return (
<div className="space-y-6">
{fehler && <Fehlermeldung meldung={fehler} />}
<div className="overflow-hidden rounded-lg border border-[var(--border)] bg-black">
{/* eslint-disable-next-line jsx-a11y/media-has-caption */}
<video
ref={videoRef}
className="aspect-video w-full object-cover"
playsInline
muted
aria-label="Kamerabild zum Scannen"
/>
</div>
<div className="flex flex-wrap gap-2">
{laeuft ? (
<Button variant="outline" onClick={stoppen}>
<CameraOff aria-hidden />
Kamera anhalten
</Button>
) : (
<Button onClick={starten}>
<Camera aria-hidden />
Kamera starten
</Button>
)}
{laeuft && (
<Button variant="ghost" onClick={() => void starten()}>
<RefreshCw aria-hidden />
Neu starten
</Button>
)}
</div>
{letzterScan && (
<p className="rounded-md border border-[var(--border)] bg-[var(--muted)] p-3 text-sm">
Erkannt, aber kein FLORIAN-Etikett:{" "}
<span className="break-all font-mono text-xs">{letzterScan}</span>
<br />
<span className="text-[var(--muted-foreground)]">
Vermutlich der Barcode des Herstellers. Bitte den Aufkleber mit dem FLORIAN-Code
scannen.
</span>
</p>
)}
<form
onSubmit={eingabeAbsenden}
className="space-y-2 rounded-lg border border-[var(--border)] p-4"
>
<Label htmlFor="inventarnummer" className="flex items-center gap-2">
<KeyboardIcon className="size-4" aria-hidden />
Oder Inventarnummer eintippen
</Label>
<div className="flex gap-2">
<Input
id="inventarnummer"
value={eingabe}
onChange={(ereignis) => setEingabe(ereignis.target.value)}
placeholder="INV-0042"
autoComplete="off"
/>
<Button type="submit" disabled={!eingabe.trim()}>
Öffnen
</Button>
</div>
<p className="text-xs text-[var(--muted-foreground)]">
Funktioniert auch ohne Kamera — praktisch, wenn das Etikett unleserlich geworden ist.
</p>
</form>
</div>
);
}