feat(tags): QR-Aufkleber, Geraeteseite, Etikettendruck und Scanner

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>
2026-09-25 19:30:50 +00:00
parent c78a6ac1af
commit e7a2e2d5c7
58 changed files with 4828 additions and 54 deletions
@@ -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");
+  });
+});