Florian WildeandClaude Opus 5
791523027f
Phase 4: eine eigene Oberflaeche unter /kiosk fuer das Wandtablet in der Fahrzeughalle — mit Handschuhen bedienbar und arbeitsfaehig, wenn das Netz weg ist. Datenmodell: Fahrt, Anwesenheit, Waescheabgabe, Inventurgang, Inventurposten, KioskVorgang und SyncKonflikt. Die Kennung eines Vorgangs erzeugt der Browser beim Einreihen und ist damit der Idempotenzschluessel; kommt derselbe Vorgang nach abgebrochener Uebertragung erneut an, erkennt ihn der Server wieder. Die Datenbank setzt vier Regeln selbst durch und verweigert UPDATE und DELETE auf kiosk_vorgang. Offline: von Hand geschriebener Service Worker, Warteschlange in der IndexedDB (Dexie), Fotos als Blob daneben, sichtbarer Zustand als Leiste ueber allem. Was sich beim Nachtragen nicht anwenden laesst, landet als Konflikt unter /terminal statt verworfen zu werden. Dazu: Anmeldung per Ausweis, PIN oder signierter QR-Marke vom Handy, Hallenmonitor mit optionalen DWD-Warnungen, Installation als App. Behoben: die Warteschlange zog ihren Wiederholungstakt bei jedem Rendern neu auf und haette einen liegen gebliebenen Vorgang nie ein zweites Mal geschickt. Gefunden vom Offline-E2E-Test. 31 neue Tests (20 Unit, 11 gegen eine echte Datenbank, 9 E2E je Browser). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
82 lines
2.8 KiB
TypeScript
82 lines
2.8 KiB
TypeScript
import "server-only";
|
|
import QRCode from "qrcode";
|
|
import { env } from "@/lib/env";
|
|
|
|
/**
|
|
* QR-Codes für Geräte.
|
|
*
|
|
* Der Code enthält eine kurze URL auf die eigene Installation:
|
|
*
|
|
* https://<florian>/g/<inventarnummer>
|
|
*
|
|
* Bewusst die Inventarnummer und nicht die UUID: Die Nummer steht ohnehin
|
|
* lesbar auf dem Etikett, ist kurz genug für einen groben Code mit dicken
|
|
* Modulen, und wer den Code mit einem beliebigen Scanner liest, sieht sofort,
|
|
* um welches Gerät es geht. Eine UUID wäre 36 Zeichen lang und für niemanden
|
|
* lesbar.
|
|
*
|
|
* Die URL ist keine Berechtigung: /g/<nr> leitet nur weiter, und die Zielseite
|
|
* verlangt eine Anmeldung wie jede andere auch. Wer den Aufkleber fotografiert,
|
|
* bekommt dadurch keinen Zugang.
|
|
*/
|
|
|
|
/** Fehlerkorrektur. "M" verträgt rund 15 % Verlust — genug für ein Etikett,
|
|
* das im Geräteraum Staub und Schrammen abbekommt. */
|
|
const FEHLERKORREKTUR = "M" as const;
|
|
|
|
export function qrZiel(inventarnummer: string): string {
|
|
const basis = env.APP_URL.replace(/\/+$/, "");
|
|
return `${basis}/g/${encodeURIComponent(inventarnummer)}`;
|
|
}
|
|
|
|
/**
|
|
* QR-Code als SVG. SVG statt PNG, weil der Etikettenbogen als PDF gerendert
|
|
* wird — dort skaliert eine Vektorgrafik ohne Treppenkanten.
|
|
*/
|
|
export async function qrAlsSvg(inventarnummer: string, groesseMm = 20): Promise<string> {
|
|
const svg = await QRCode.toString(qrZiel(inventarnummer), {
|
|
type: "svg",
|
|
errorCorrectionLevel: FEHLERKORREKTUR,
|
|
margin: 0,
|
|
width: Math.round(groesseMm * 8),
|
|
});
|
|
|
|
// qrcode setzt feste Pixelmaße; für das PDF sollen Millimeter gelten.
|
|
return svg
|
|
.replace(/width="[^"]+"/, `width="${groesseMm}mm"`)
|
|
.replace(/height="[^"]+"/, `height="${groesseMm}mm"`);
|
|
}
|
|
|
|
/** QR-Code als Data-URI. Für die Anzeige in der Gerätedetailseite. */
|
|
export async function qrAlsDataUri(inventarnummer: string, groessePx = 256): Promise<string> {
|
|
return QRCode.toDataURL(qrZiel(inventarnummer), {
|
|
errorCorrectionLevel: FEHLERKORREKTUR,
|
|
margin: 1,
|
|
width: groessePx,
|
|
color: { dark: "#000000ff", light: "#ffffffff" },
|
|
});
|
|
}
|
|
|
|
/**
|
|
* QR-Code aus beliebigem Text.
|
|
*
|
|
* Die Funktionen darüber setzen alle eine Inventarnummer voraus und bauen
|
|
* daraus die Geräteadresse. Ab Phase 4 gibt es Codes, die keine Adresse
|
|
* enthalten, sondern eine signierte Anmeldemarke — die soll unverändert im
|
|
* Code stehen.
|
|
*/
|
|
export async function qrTextAlsDataUri(text: string, groessePx = 256): Promise<string> {
|
|
return QRCode.toDataURL(text, {
|
|
errorCorrectionLevel: FEHLERKORREKTUR,
|
|
margin: 1,
|
|
width: groessePx,
|
|
color: { dark: "#000000ff", light: "#ffffffff" },
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Die Auswertung gescannter Codes steht in qr-parser.ts — sie läuft im
|
|
* Browser und darf deshalb nicht in einem "server-only"-Modul liegen.
|
|
*/
|
|
export { inventarnummerAusScan } from "@/lib/stammdaten/qr-parser";
|