feat(tags): QR-Aufkleber, Geraeteseite, Etikettendruck und Scanner
Prüfung / pruefung (push) 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 was merged in pull request #28.
This commit is contained in:
2026-09-25 19:30:50 +00:00
co-authored by Claude Opus 5
parent c78a6ac1af
commit e7a2e2d5c7
58 changed files with 4828 additions and 54 deletions
+28
View File
@@ -21,3 +21,31 @@ export function oeffentlicheAdresse(pfad: string, ersatzHerkunft: string): URL {
}
return new URL(pfad, ersatzHerkunft);
}
/**
* Die Basisadresse der Anwendung – **mit** ihrem Pfad (#014).
*
* `oeffentlicheAdresse` loest einen absoluten Pfad gegen die Basis auf, und
* dabei faellt ein Unterpfad heraus: aus `https://firma.de/laufzettel` und
* `/t/LZ-…` wird `https://firma.de/t/LZ-…`. Fuer eine Umleitung im laufenden
* Betrieb faellt das niemandem auf, weil der Reverse Proxy den Pfad ohnehin
* wieder anhaengt. Auf einem **gedruckten Aufkleber** ist es das Ende: er zeigt
* fuer immer ins Leere.
*
* Wer eine Adresse baut, die jemand behaelt, nimmt deshalb diese Basis und
* haengt relativ an. Der Schraegstrich am Ende entscheidet darueber, ob das
* letzte Pfadstueck ersetzt oder ergaenzt wird — er wird hier gesetzt, statt
* darauf zu hoffen.
*/
export function basisAdresse(ersatzHerkunft: string): URL {
const roh = process.env["APP_URL"]?.trim();
let basis: URL;
try {
basis = new URL(roh || ersatzHerkunft);
} catch {
// Eine unbrauchbare APP_URL soll den Druck nicht blockieren.
basis = new URL(ersatzHerkunft);
}
if (!basis.pathname.endsWith("/")) basis.pathname += "/";
return basis;
}