feat(tags): QR-Aufkleber, Geraeteseite, Etikettendruck und Scanner
Prüfung / pruefung (pull_request) Canceled after 0s
Prüfung / pruefung (push) Canceled after 0s
Prüfung / e2e (pull_request) Canceled after 0s
Prüfung / e2e (push) Canceled after 0s

Der Einstieg, fuer den die Anwendung gebaut ist: scannen, sehen was zu tun ist,
loslegen. `/t/<tagCode>` kennt drei Faelle — registriertes Geraet, vorgedruckter
Tag, unbekannter Code —, die Geraeteseite zeigt Zuweisungen, Schnellstart und
Historie, und beides ist am Handy bedienbar.

Im QR steht ausschliesslich `{APP_URL}/t/{tagCode}`: kein Name, keine
Seriennummer, kein Besitzer. Ein Aufkleber haengt jahrelang sichtbar am Geraet
und wird von jedem Telefon gelesen; was darauf steht, ist veroeffentlicht. Die
Masse sind gemessen, nicht behauptet: ein echtes PDF liefert 62 x 29 mm und A4,
und ein bei 300 dpi gerastertes Etikett wird mit demselben Decoder
zurueckgelesen, den auch der Scanner benutzt.

Drei Defekte zeigte erst der gebaute Stand, alle an den Naehten zwischen den
parallel gebauten Teilen: „Starten“ setzte IN_ARBEIT und sprang nicht, „Vorlage
zuweisen“ bot Vorlagen an, die der Dienst danach ablehnte, und die Geraeteliste
verlinkte nichts. Der unabhaengige Review fand drei Blocker — darunter, dass der
Scanner nie die native BarcodeDetector-API benutzte und dass ein Unterpfad in
APP_URL aus dem gedruckten QR herausfiel.

Closes #14

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Florian Wilde
2026-09-25 21:30:12 +02:00
co-authored by Claude Opus 5
parent c78a6ac1af
commit 5f1b0d1435
58 changed files with 4828 additions and 54 deletions
+51
View File
@@ -0,0 +1,51 @@
import { describe, expect, it } from "vitest";
import { tagCodeAusFund } from "@/lib/tagcode";
/**
* Was ein gescannter Code bedeutet (#014).
*
* Die Kamera findet alles Moegliche: den eigenen Aufkleber, den QR-Code auf
* einer Paketmarke, einen Link ins Intranet. Diese Entscheidung liegt deshalb in
* einer reinen Funktion und nicht in der Kamerakomponente — dort waere sie nur
* von Hand pruefbar, und zwar genau einmal.
*/
describe("Ein Fund des Scanners", () => {
it("nimmt die Adresse vom Aufkleber", () => {
expect(tagCodeAusFund("https://laufzettel.firma.de/t/LZ-7K3F9Q")).toBe("LZ-7K3F9Q");
});
it("nimmt sie auch von einem anderen Host", () => {
/*
* Der Aufkleber klebt jahrelang. Zieht die Anwendung um oder steht ein
* zweiter Name davor, waere ein Vergleich mit APP_URL der Grund, warum der
* Scanner plötzlich nichts mehr erkennt — obwohl der Code stimmt.
*/
expect(tagCodeAusFund("http://10.0.0.5:3000/t/LZ-7K3F9Q")).toBe("LZ-7K3F9Q");
});
it("nimmt den blanken Code, auch klein geschrieben", () => {
expect(tagCodeAusFund("LZ-7K3F9Q")).toBe("LZ-7K3F9Q");
expect(tagCodeAusFund(" lz-7k3f9q ")).toBe("LZ-7K3F9Q");
});
it("weist alles andere ab, statt zu raten", () => {
for (const fund of [
"",
" ",
"https://laufzettel.firma.de/geraete/abc",
"https://laufzettel.firma.de/t/",
"https://laufzettel.firma.de/t/LZ-7K3F9Q/extra",
// Verwechselbare Zeichen gibt es im Alphabet nicht – ein Code mit O, I
// oder 1 ist keiner, auch wenn er wie einer aussieht.
"LZ-7K3F9O",
"LZ-ABCDE",
"nur text",
]) {
expect(tagCodeAusFund(fund), fund).toBeNull();
}
});
it("verkraftet eine prozentkodierte Adresse", () => {
expect(tagCodeAusFund("https://laufzettel.firma.de/t/LZ%2D7K3F9Q")).toBe("LZ-7K3F9Q");
});
});