hwr.tags - Intelligentes Smart-Tag & QR-System

Mit hwr.tags bietet hwr ein durchgängiges, hardware- und softwarebasiertes Kennzeichnungssystem für Arbeitsmittel, Maschinen, Messgeräte und Kundenanlagen. Es verbindet physische Etiketten und laser-gravierte Industrie-Tags über einen universellen Kurzlink (https://hwr.app/t/[code]) nahtlos mit der Software-Plattform.

Das System unterscheidet beim Scan in Echtzeit zwischen internen Mitarbeitern im Büro, Monteuren auf der Baustelle und externen Dritten (z. B. Findern verlorener Werkzeuge).

1. Systemarchitektur & Grundprinzip

Klassische Inventaretiketten stoßen im Handwerksalltag schnell an Grenzen: Barcodes verschmutzen, fortlaufende Nummern sind ohne Zugriff auf die Büro-Software nichtssagend und bei Verlust gibt es keinen direkten Kommunikationskanal.

hwr.tags löst diese Probleme durch eine dreistufige Architektur:

Eindeutiger 6-stelliger Code (Crockford Base32):
- Jeder Tag besitzt eine unverwechselbare 6-stellige Kennung (z. B. 2FDDKJ oder M8VMNG).
- Verwechslungssicher: Der Zeichensatz schließt optisch ähnliche Zeichen (wie 0, O, 1, I, L) gezielt aus, um Ablesefehler auf staubigen Baustellen oder am Telefon zu verhindern.
- Kompakter QR-Code: Durch die minimale Zeichenlänge bleibt der QR-Code auch auf kleinsten Etiketten (z. B. 29 × 15 mm) grobkörnig und ist selbst bei Beschädigungen oder schlechten Lichtverhältnissen sofort scanbar.
Universelle Kurz-URL (hwr.app/t/[code]):
- Die Domain leitet jeden Scan über einen intelligenten Resolver.
- Der Server analysiert Gerätetyp, Authentifizierungsstatus und Organisationszugehörigkeit und steuert das passende Ziel an.
Zentrales Register & Revisionssicherheit:
- Alle Tags sind mandantenübergreifend in der Tabelle smart_tags registriert.
- Kollisionsfreie Generierung stellt sicher, dass kein Code im gesamten hwr-Ökosystem doppelt existiert.

2. Die zwei Tag-Klassen

hwr.tags unterscheidet zwischen zwei Kategorien:

A. hwr.tags Industrie-Hardware (Premium-Tags)

Einsatzbereich: Hochwertige Maschinen, Akkugeräte, Bohrhämmer, Steigtechnik, Firmenfahrzeuge und raue Baustellenumgebungen.
Eigenschaften: Resistent gegen Schmierstoffe, Öle, Chemikalien, UV-Strahlung, Hochdruckreiniger und mechanischen Abrieb.
Fertigung: Vorgefertigte, gravierte Metall- oder Acrylharz-Tags mit integriertem QR-Code und Klartext-Kennung.
Sicherheits-Authentifizierung: Jeder Hardware-Tag wird vor der Auslieferung in Chargen (batch_number) im System registriert. Ein Betrieb kann nur Tags aktivieren, die offiziell zertifiziert sind. Dies schützt vor gefälschten Codes und fremder Code-Kaperung.

B. Selbstdruck-Etiketten (`SELBSTDRUCK`)

Einsatzbereich: Standard-Handwerkzeuge, Koffer, Kleingeräte, Prüfaufkleber und temporäre Kennzeichnungen.
Flexibilität: Direkter Ausdruck aus dem hwr.manager auf handelsüblichen Druckern:
- Etikettenbögen (A4): Avery Zweckform 3659 (12er), 3474 (24er), 3658 (24er), etc.
- Rollendrucker: Brother QL-Serie (z. B. Endlos- und Einzeletiketten 62 × 29 mm, 54 × 29 mm).
Automatischer Lifecycle: Beim Anlegen eines Geräte-Exemplars oder einer Anlage registriert das System den Tag automatisch im Status activated mit der Charge SELBSTDRUCK.

3. Revisionssichere Inventarnummern (`INV-YYYY-XXXX`)

Neben dem globalen Tag-Code benötigt jeder Betrieb eine eigene, betriebsinterne Inventarnummer für Buchhaltung, Inventur und Versicherung.

Automatischer Nummernkreis: Über den Trigger trg_product_instances_inventory_number erhält jedes neu angelegte Exemplar (egal ob im Web, mobil oder per Import) vollautomatisch die nächste freie Nummer aus dem Nummernkreis inventory (z. B. INV-2026-0001, INV-2026-0002).
Lückenlose Datenmigration: Auch bestehende Altdaten werden bei Aktivierung des Systems verlustfrei nachgepflegt.
Manuelle Anpassung: Bei Bedarf kann die Inventarnummer in den Stammdaten überschrieben werden (z. B. bei Übernahme bestehender Betriebsnummern). Das System prüft dabei automatisch auf Dubletten innerhalb des Mandanten.

4. Etiketten-Layouts im Druckdialog

Der Druckdialog (StorageBinPrintModal mit DeviceLabelSvg) bietet zwei praxiserprobte Layoutvarianten:

Typ A: Gerätekennzeichnung (Große Inventarnummer)

Kopfzeile (Oben): Artikelbezeichnung / Gerätename in kompakter Großschrift (z. B. HILTI TE 70-ATC).
Hero-Bereich (Mitte): Prominente, extragroße Inventarnummer in tabular-nums (z. B. INV-2026-0005).
Fußzeile (Unten): Gerätekennung und Details (z. B. #01 · Seriennummer oder #01 · Werkstattlager).
Rechts: Smart-Tag QR-Code mit der Kurz-URL hwr.app/t/[code].

Typ B: Produktspezifikation

Hero-Bereich (Mitte): Fokus auf die vollständige Produktbezeichnung (mehrzeilig, ideal für Typenschilder und Verbrauchsgeräte).
Fußzeile (Unten): Kompakte Zeile mit Inventar- und Seriennummer (Inv: INV-2026-0005 · SN: 123456).
Rechts: Smart-Tag QR-Code mit Kurz-URL.

5. Die intelligente Kontext-Weiche (`/t/[code]`)

Wird ein Tag gescannt, analysiert der Resolver den Kontext des Aufrufers und leitet ihn dynamisch weiter:

                          QR-Code Scan (hwr.app/t/2FDDKJ)
                                         |
                       +-----------------+-----------------+
                       |                                   |
              Eingeloggt im Betrieb             Nicht eingeloggt / Extern
                       |                                   |
              +--------+--------+                          v
              |                 |               Öffentliche Schutzseite
          Desktop             Mobil                        |
              |                 |             +------------+------------+
              v                 v             |                         |
      manager.hwr.app    Smart App-Bridge   Finder meldet Fund    Mitarbeiter tippt
     (Exemplar-Detail)          |          (Rückruf-Formular)    "In hwr App öffnen"
                                v                                       |
                       Native App / mobile                              v

Fall 1: Desktop-Browser (Büro / Werkstattleiter)

Ist der Benutzer am PC im hwr.manager angemeldet und gehört zur Eigentümer-Organisation des Tags, springt der Browser direkt in die Detailansicht:
- Bei Geräte-Exemplaren: /inventory/articles/[productId]?tab=instances&instanceId=[instanceId]
- Bei Anlagen: /assets
Hier können sofort Prüfberichte, Reparaturen, Rechnungen oder Stammdaten eingesehen und bearbeitet werden.

Fall 2: Mobiles Gerät (Smartphone / Tablet vor Ort)

Der Desktop-Manager ist für große Monitore konzipiert. Auf Smartphones wird deshalb nicht auf manager.hwr.app weitergeleitet.
Stattdessen schaltet sich die Smart Mobile App-Bridge ein:
- Android (Chrome): Verwendet einen Intent-Link (intent://t/[code]#Intent;scheme=hwr;package=de.hwr.app;S.browser_fallback_url=...). Ist die native App installiert, öffnet sich diese sofort. Andernfalls leitet Chrome automatisch auf https://mobile.hwr.app?code=[code] weiter.
- iOS (Safari): Triggert das Scheme hwr://t/[code]. Bleibt der Browser im Vordergrund, greift nach 1,2 Sekunden der automatische Fallback auf die mobile Web-App.
Der Monteur landet direkt im Schnellscan- bzw. Buchungsdialog des Geräts.

Fall 3: Externer Finder / Dritter (Diebstahl- & Verlustschutz)

Wird das Gerät von einer fremden Person oder ohne Login gescannt, erscheint die öffentliche Fund- und Serviceseite:
- Datenschutz: Es werden keine Preise, Einkaufskonditionen, internen Notizen oder Monteurnamen angezeigt.
- Kontaktaufnahme: Der Finder sieht den Firmennamen, Notfall-Telefonnummern und ein unkompliziertes Fundmelde-Formular (Name, Telefonnummer, Fundort).
- Fundmeldung per Push/E-Mail: Nach dem Absenden erhält der Betrieb sofort eine Benachrichtigung mit den Angaben des Finders.
- Mitarbeiter-Banner: Für eigene Mitarbeiter, die ein Gerät privat oder mit einem neuen Handy scannen, befindet sich ganz oben der Button „hwr Mitarbeiter? In mobiler App öffnen“.

6. Kill-Switch & Sicherheits-Sperrung (`/superadmin/tags`)

Sollte ein Werkzeug gestohlen werden, verloren gehen oder ein Etikett kompromittiert worden sein, verfügt hwr über einen zentralen Kill-Switch:

Tag-Verwaltung aufrufen: Unter Superadmin -> hwr.tags (/superadmin/tags) können Administratoren alle Tags mandantenübergreifend einsehen und durchsuchen.
Sperren (Revoke): Mit einem Klick auf „Sperren“ wird der Status des Tags sofort auf revoked gesetzt.
Auswirkung beim Scan:
- Jeder weitere Aufruf der URL hwr.app/t/[code] wird sofort abgefangen.
- Es werden keinerlei Kontaktdaten oder Gerätedetails mehr ausgeliefert.
- Stattdessen erscheint ein Sicherheits-Stopp:
  - „hwr Sicherheits-Status: Dieser hwr.tag wurde deaktiviert. Der Code wurde administrativ gesperrt oder aus dem Verkehr gezogen.“
Reaktivierung: Wird ein verlorenes Gerät wiedergefunden, kann der Tag mit einem Klick auf „Freigeben“ reaktiviert werden.

7. Praxiseinsatz in hwr.mobile

Auf der Baustelle oder am Service-Fahrzeug unterstützt der Tag den täglichen Workflow:

QuickScan: Über das Kamerasymbol in der mobilen App wird der Tag in Millisekunden erfasst.
Werkzeug-Übergabe: Ausgabe von Maschinen an Mitarbeiter mit digitaler Gegenzeichnung.
Prüffristen & UVV (DGUV V3): Der Prüfer scannt den Tag am Gerät, wählt „Prüfung bestanden“, fotografiert den Zustand und das neue Prüfintervall wird automatisch in die Datenbank übertragen.
Lagerplatz-Zuweisung: Schnelles Umlagern von Werkzeugen zwischen Zentrallager, Baustellencontainer und KFZ-Fahrzeugregalen.

8. Best Practices für Handwerksbetriebe

Anbringungsort wählen: Bringen Sie Tags an Stellen an, die vor direktem Schlageinfluss und starker Hitzeentwicklung geschützt sind (z. B. Griffmulden, Motorgehäuserückseite).
Untergrund reinigen: Vor dem Aufkleben von Folienetiketten die Stelle gründlich mit Isopropanol entfetten.
Schutzlaminat verwenden: Bei Selbstdruck-Etiketten auf Baustellen empfiehlt sich ein transparentes Überklebeschutzlaminat gegen Feuchtigkeit und Reibung.
Verlust sofort sperren: Sobald der Verlust einer Maschine bemerkt wird, den Tag im System als „gesperrt“ markieren, um Missbrauch zu verhindern.