🔄 Workflow — Von Null zum gescannten Kabel

„Einmal gesteckt, einmal gescannt — nächste 20 Jahre."

Überblick

VORBEREITUNG          INSTALLATION          BETRIEB
──────────            ────────────          ───────
Farbcode festlegen    Clip aufstecken       QR scannen
Labels drucken     →  Tag befestigen     →  DB abfragen
Clips drucken         Seal verifizieren     Seal prüfen

Schritt 1 — Farbcode festlegen

Vor dem ersten Clip: Segment-Mapping definieren und dokumentieren.

cp docs/farbcode.md docs/farbcode_STANDORT.md
# Eigene Segmente eintragen
# Einmal für den ganzen Standort — dann nie wieder ändern

Regel: Ein Standort, ein Farbcode. Für immer.

Schritt 2 — Clips drucken

# TPU 95A für flexible Kabel (Cat6, RJ45)
# PETG für harte Montage (Patch-Panel, PDU)
# Resin für maximale Präzision (kleine ∅, viele Stück)

ls models/tpu/          # Flexible Varianten
ls models/resin/        # Hochpräzise Varianten

Druckparameter:
- Layer: 0.2mm
- Walls: 3
- Infill: 20% (Gyroid)
- Supports: keine (Clip ist selbsttragend)

Schritt 3 — QR-Labels generieren

Einzelnes Kabel:

python qr-labels/generator.py \
  --id "R03-SW01-P01" \
  --segment data \
  --rack "RZ-A-R03" \
  --pdu "PDU-A01" \
  --port "Gi0/1"

Ganzes Rack (Batch):

# 1. Template anpassen
cp qr-labels/templates/rack.json qr-labels/templates/mein_rack.json
nano qr-labels/templates/mein_rack.json

# 2. Alle Labels in einem Schritt generieren
python qr-labels/generator.py --batch qr-labels/templates/mein_rack.json

Schritt 4 — Installation am Kabel

Kabelende
    │
    ▼
1. Farbclip aufstecken (passende Farbe = Segment)
    │
2. Kabelbinder durch Clip-Notch führen
    │
3. QR-Label-Lasche unter Kabelbinder klemmen
    │
4. Kabelbinder festziehen (Seal ist jetzt geschlossen)
    │
5. QR scannen → Datenbank

Seal-Prinzip:
Der Kabelbinder verbindet Clip + QR-Tag untrennbar.
Fehlt der Tag → Kabel wurde bewegt → Alarm.
Fehlt der Clip → Segment unbekannt → sofort nacharbeiten.

Schritt 5 — Scan & Verifizierung

Kamera/Scanner:

python scanner/scan_to_db.py scan --source camera

Manuelle Eingabe (bei batch-Ersterfassung):

python scanner/scan_to_db.py scan --source file --input scans.txt

Kabel prüfen:

python scanner/scan_to_db.py verify R03-SW01-P01

Rack-Übersicht:

python scanner/scan_to_db.py list --rack RZ-A-R03
python scanner/scan_to_db.py list --segment ipmi

Schritt 6 — NetBox / CMDB Export (optional)

python scanner/scan_to_db.py export --output export_netbox.json
# → JSON direkt in NetBox API importierbar

Regeln im Betrieb

1. Kein Kabel ohne Clip. Ausnahme muss dokumentiert sein.
2. Kein Clip ohne QR-Tag. Farbe allein reicht nicht.
3. Kein QR-Tag ohne Scan. Ungescanntoes = nicht existierendes Kabel.
4. Segment-Farbcode ändert sich nie. Lieber neues Mapping-Dokument.
5. Bei Umbau: alten Seal entfernen, neuen setzen, neu scannen.

Notfall-Protokoll

Kabel gefunden ohne CrumbSeal?

1. Kabel tracen (wohin führt es?)
2. Segment identifizieren (Tester, VLAN-Scanner)
3. Clip + Label + Scan → in DB aufnehmen
4. Im Ticket dokumentieren: "Kabel nachbeschriftet"

Jeder unbeschriftete Krümel ist ein zukünftiges Problem.
#jederkrümelzählt

Zeitaufwand

Vergleich Oldschool (handgeschrieben, 4× T-Binder): ~8–12 min + nicht scanbar.