Files
Florian WildeandClaude Opus 5 791523027f Terminal im Geraetehaus mit Offline-Betrieb ergaenzen
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>
2026-09-03 18:35:48 +02:00

91 lines
3.0 KiB
TypeScript

import { afterEach, describe, expect, it, vi } from "vitest";
import {
MARKE_FEHLER_TEXT,
MARKE_GUELTIG_SEKUNDEN,
markeErzeugen,
markePruefen,
} from "@/lib/kiosk/anmeldemarke";
/**
* Die Anmeldemarke ist ein Anmeldeweg — sie verdient dieselbe Sorgfalt wie ein
* Passwort. Geprüft wird deshalb nicht nur der gute Fall, sondern vor allem,
* was passiert, wenn jemand an der Marke dreht.
*/
const PERSON = "8f7d3b1e-2c4a-4e6f-9a1b-0c2d4e6f8a1b";
const ORGANISATION = "1a2b3c4d-5e6f-4a8b-9c0d-1e2f3a4b5c6d";
afterEach(() => {
vi.useRealTimers();
});
describe("Anmeldemarke", () => {
it("erkennt die eigene Marke wieder", () => {
const marke = markeErzeugen(PERSON, ORGANISATION);
const ergebnis = markePruefen(marke);
expect(ergebnis).toEqual({ personId: PERSON, organisationId: ORGANISATION });
});
it("weist eine Marke ab, an der jemand gedreht hat", () => {
const marke = markeErzeugen(PERSON, ORGANISATION);
// Andere Person, alte Signatur — der klassische Versuch.
const fremde = marke.replace(PERSON, "0000ffff-1111-4222-8333-444455556666");
expect(markePruefen(fremde)).toEqual({ fehler: "verfaelscht" });
});
it("weist eine Marke ab, deren Signatur gefälscht wurde", () => {
const marke = markeErzeugen(PERSON, ORGANISATION);
const teile = marke.split(".");
const verdreht = [...teile.slice(0, 3), "x".repeat(teile[3]!.length)].join(".");
expect(markePruefen(verdreht)).toEqual({ fehler: "verfaelscht" });
});
it("erkennt etwas, das gar keine Marke ist", () => {
expect(markePruefen("")).toEqual({ fehler: "ungueltig" });
expect(markePruefen("https://beispiel.de/g/INV-0001")).toEqual({ fehler: "ungueltig" });
expect(markePruefen("a.b.c")).toEqual({ fehler: "ungueltig" });
});
it("läuft nach der festgelegten Zeit ab", () => {
vi.useFakeTimers();
const marke = markeErzeugen(PERSON, ORGANISATION);
// Kurz vor Ablauf gilt sie noch.
vi.advanceTimersByTime((MARKE_GUELTIG_SEKUNDEN - 1) * 1000);
expect(markePruefen(marke)).toHaveProperty("personId", PERSON);
// Zwei Sekunden später nicht mehr — das abfotografierte Handy nützt nichts.
vi.advanceTimersByTime(2000);
expect(markePruefen(marke)).toEqual({ fehler: "abgelaufen" });
});
it("nimmt keine Marke aus der Zukunft an", () => {
vi.useFakeTimers();
vi.advanceTimersByTime(10 * 60 * 1000);
const spaetere = markeErzeugen(PERSON, ORGANISATION);
vi.setSystemTime(new Date(Date.now() - 5 * 60 * 1000));
expect(markePruefen(spaetere)).toEqual({ fehler: "abgelaufen" });
});
it("hat für jeden Fehler einen Satz, den man am Terminal lesen kann", () => {
for (const text of Object.values(MARKE_FEHLER_TEXT)) {
expect(text.length).toBeGreaterThan(10);
expect(text).toMatch(/[.!]$/);
}
});
it("erzeugt bei jedem Aufruf eine andere Marke", () => {
vi.useFakeTimers();
const erste = markeErzeugen(PERSON, ORGANISATION);
vi.advanceTimersByTime(1000);
const zweite = markeErzeugen(PERSON, ORGANISATION);
expect(erste).not.toBe(zweite);
});
});