QR-Etiketten im Makerspace: Link, Layout und Scan-Workflow
Das Ressourcenetikett enthält einen kompakten Link unter /r/{code}. Layout, Material und Scan-Workflow entscheiden, ob es in der Werkstatt funktioniert.
Open Inventory
Technische Notizen · MIT-lizenziert
Kurz zusammengefasst
- Ressourcenlinks verwenden kurze Codes unter
/r/{code} - Etikett und ausführender Scan-Workflow sind getrennte Konzepte
- Druckmaß, Kontrast, Material und Scanabstand gehören in den Test
Echte App-Aufnahme
QR und Code 128 im echten Labeldesigner
Vor dem Druck
Was im Ressourcen-QR steckt
lib/resource-short-link.ts erzeugt aus der Resource-UUID einen kurzen Code. Das Etikett kodiert dann eine URL unter /r/{code}. Die Route löst den Code serverseitig wieder in die UUID auf und leitet zum Datensatz weiter.
Der Kurzlink umgeht keine Berechtigungen. Ohne gültige Sitzung landet der Browser zuerst bei der Anmeldung und wird danach zum Inventareintrag zurückgeführt. Name, Kennung und Standort sollten trotzdem als lesbarer Text auf dem Etikett stehen.
Der Etikettendesigner kann QR-Code, Bild, Name, Identifier, Code 128, URL und Standort platzieren. Die Maße werden in Millimetern gespeichert. Presets sind nur Startwerte; Browser, Druckertreiber und reales Medium bleiben Teil der Ausgabe.
Werkstatt-Workflow
Pilot mit echten Werkzeugen
- 01
Standorte und Rechte festlegen
Lege Räume, Schränke und Regale als Standorte an. Prüfe getrennt, wer Datensätze ändern, Etiketten verwalten und Bestand buchen darf.
- 02
Pilotgruppe inventarisieren
Starte mit einer überschaubaren Gruppe, etwa Handmaschinen. Wähle serialisierte Einheiten für individuell verfolgte Geräte und Mengenbestand für austauschbares Verbrauchsmaterial.
- 03
Layout in Millimetern bauen
Drucke Name, kurze Kennung, Standort und einen ausreichend großen QR-Code. Vermeide kleine Schmuckelemente, die Lesbarkeit und Haltbarkeit nicht verbessern.
- 04
Druck und Scan testen
Scanne aus typischem Abstand, mit Werkstattlicht und einem nicht frisch gereinigten Etikett. Prüfe außerdem Anmeldung, mobile Ansicht und Rückweg zum Regal.
- 05
Setup versionieren und wiederverwenden
Passe Vorlage und Befestigung nach dem Pilot an. Gespeicherte Setups haben eine Revision und schützen parallele Änderungen vor stillem Überschreiben.
Zwei Arten von Scan
Ressourcenlink und Scan-Ausführung sind getrennt
Ein Ressourcenetikett öffnet nur einen vorhandenen Datensatz. Konfigurierbare Scan-Workflows sind ein eigener Pfad: Sie lesen fremde Codes, extrahieren den relevanten Wert und können eine serialisierte Einheit nach einer Vorschau ändern.
Vor der Mutation zeigt der Server Ziel und Diff. Die Ausführung läuft mit Idempotency-Key in einer Transaktion zusammen mit Bestandsbewegung und Audit-Eintrag. Ist die Vorschau veraltet, muss sie neu geladen werden. Für einfache Ausleihe kann das Öffnen des Datensatzes trotzdem der kürzere Weg sein.
- Der visuelle Browser-Scanner benötigt HTTPS oder localhost und eine Kamerafreigabe.
- Alternativ kann ein QR-Foto hochgeladen oder der decodierte Inhalt eingefügt werden.
- Ein Scan-Workflow arbeitet derzeit mit serialisiertem Inventar, weil er eine konkrete Einheit identifiziert.
- Externe Codes sollten zunächst mit realen Exemplaren getestet werden; nicht jeder aufgedruckte Code enthält eine stabile, eindeutige Kennung.
Physische Realität
Drucker und Material sind Teil des Systems
Staub, Öl, Abrieb, Rundungen und Metallflächen entscheiden über die Lebensdauer eines Etiketts. Reinige die Fläche, wähle ein für den Untergrund geeignetes Material und platziere den Code dort, wo er beim normalen Gebrauch nicht übergriffen wird. Bei kleinen, heißen oder stark beanspruchten Werkzeugen kann ein Anhänger besser sein als ein Aufkleber.
Der Browser nutzt beim Drucken den Systemdialog. Ein Netzwerkdrucker muss deshalb im Betriebssystem eingerichtet, die richtige Mediengröße gewählt und die Seitenskalierung deaktiviert sein. Open Inventory kann den Druckinhalt vorbereiten, aber keine mechanischen Druckerprobleme oder ungeeignetes Verbrauchsmaterial ausgleichen.
Open Inventory ist MIT-lizenziert und Open Source. Bei lokaler Speicherung laufen Anwendung, PostgreSQL und Uploads auf der eigenen Infrastruktur. Wer Openinary oder optionale KI-Anbieter konfiguriert, nutzt dagegen zusätzliche externe Datenpfade; diese gehören in die Betriebsdokumentation des Makerspaces.
Weiterführend