🔒 CrumbSeal

Kabel-Kennzeichnung für das nächste Jahrzehnt.
Farbe. Clip. QR. Fertig.

╔══════════════════════════════════════════════════════╗
║                                                      ║
║              CrumbSeal v0.1                         ║
║     Open Source · CKL Licensed · Made in RZ        ║
║                                                      ║
║       #jederkrümelzählt                             ║
║                                                      ║
╚══════════════════════════════════════════════════════╝

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

🌱 Warum CrumbSeal?

Ein gewöhnlicher Werktag im Rechenzentrum. Zweites Rack wird abgebaut.
Doppelboden auf. Klimarauschen. 60×60 Bodenplatten-Matrix.
Gefühlte 100 Kabel — jedes mit handgeschriebenen T-Bindern:
2.2.1.42 | PDU-A04 | IPMI-007 | R1-PDU-B
Manchmal bis zu vier einzelne Tags pro Kabelende.
So macht man das seit 20 Jahren.

CrumbSeal ist die Antwort.

• 🎨 Farbe = Netzwerk-Segment auf einen Blick
• 🔒 Clip = Kabelende mechanisch identifiziert, wiederverwendbar
• 📱 QR = vollständige Daten in 3 Sekunden scanbar
• ♻️ Seal = einmal gesetzt, verifiziert, tamper-evident

🗂️ Repo-Struktur

crumbseal/
│
├── README.md                    ← du bist hier
├── LICENSE                      ← MIT + CKL Basis
├── LICENSE.d/
│   ├── CKL-v1.0.md             ← Crumbforest Kernel License
│   └── CKL-Kids-v1.0.md        ← Crumb Kids License
│
├── docs/
│   ├── farbcode.md             ← Farbring = Segment Mapping
│   ├── workflow.md             ← Schritt-für-Schritt Install & Scan
│   ├── material.md             ← TPU vs Resin — Entscheidungshilfe
│   └── philosophy.md           ← Warum wir das so gebaut haben
│
├── models/
│   ├── tpu/                    ← Flexible Clips (TPU 95A)
│   │   ├── crumbseal_6mm.stl
│   │   ├── crumbseal_8mm.stl
│   │   └── crumbseal_10mm.stl
│   ├── resin/                  ← Hochpräzise Clips (ABS-Like Resin)
│   │   ├── crumbseal_6mm.stl
│   │   └── crumbseal_8mm.stl
│   └── rings/                  ← Farbringe (separat, wenn gewünscht)
│       └── ring_universal.stl
│
├── qr-labels/
│   ├── generator.py            ← QR-Code + ID → druckfertig
│   ├── batch.py                ← Massendruck für Bestand
│   ├── templates/
│   │   ├── single.json         ← Template: ein Kabel
│   │   └── rack.json           ← Template: komplettes Rack
│   └── generated/              ← .gitignored — nur lokal
│
├── scanner/
│   ├── scan_to_db.py           ← Scan → CMDB / NetBox / DCIM
│   ├── verify_seal.py          ← Seal-Integrität prüfen
│   └── README.md               ← Scanner-Integration
│
└── examples/
    ├── farbcode_example.md     ← Beispiel-Belegung (anonymisiert)
    └── rack_sheet_template.md  ← Rack-Dokumentations-Vorlage

🎨 Farbcode — Schnellreferenz

Die vollständige Tabelle und Anpassungshilfe: docs/farbcode.md

🔧 Schnellstart

1. Clip drucken

# Kobra 3 / Bambu P2S / jeder FDM-Drucker
# TPU 95A, 0.2mm Layer, 3 Walls, 20% Infill
# Druckzeit pro Clip: ~8 Minuten
ls models/tpu/

2. Farbcode festlegen

# Eigene Mapping-Tabelle anlegen
cp docs/farbcode.md docs/mein_farbcode.md
# Anpassen auf eigene Segmente

3. QR-Label generieren

pip install qrcode pillow
python qr-labels/generator.py \
  --id "SW01-P12" \
  --segment "Data" \
  --rack "RZ-A-R03" \
  --pdu "PDU-A04" \
  --color blue

4. Scan & Verify

python scanner/scan_to_db.py --source camera
# Scannt QR → prüft Seal → schreibt in CMDB

🏗️ Hardware-Setup

Getestet mit:

Label-Drucker:
- Brother P-touch / QL-Serie → TZe-Tapes, QR-fähig
- Niimbot B18 → thermal, klein, Bluetooth
- Bambu Lab (3D gedruckte Tags) → Multicolor direkt

🌀 Das CrumbSeal-Prinzip

Kabelende
    │
    ▼
[Farbclip] ← Segment auf einen Blick
    │
[Kabelbinder] ← hält Clip + Tag
    │
[QR-Lasche] ← vollständige Daten
    │
    └── Scan → Datenbank
              └── IP · PDU · Port · Rack · Datum

Seal-Prinzip:
Einmal gesetzt wird der Clip mit Kabelbinder und QR-Tag zu einem untrennbaren Tripel.
Fehlt das Tag → wurde das Kabel bewegt.
Fehlt der Clip → Segment unbekannt.
Alles vorhanden und gescannt → ✅ verifiziert.

🤝 Mitmachen

Forks willkommen. Attribution geschätzt. Geist beachtet.

git clone https://git.crumbforest.org/crumbforest/crumbseal
cd crumbseal

Issues, Ideen, Verbesserungen → öffne ein Issue oder einen PR.
Besonders willkommen: neue STL-Varianten, andere Kabeldurchmesser, CMDB-Integrationen.

📜 Lizenz

MIT License + Crumbforest Kernel License (CKL) v1.0

Die CKL ist kein juristisches Dokument — sie ist eine Haltung.
Lies sie. Beachte sie. Baue im gleichen Geist.

„Wenn du den Kernel nutzt, lass ihn wie ein Krümel sein:
klein, freundlich, neugierig, offen —
und bereit, in jede Richtung zu wachsen."

→ LICENSE · LICENSE.d/CKL-v1.0.md

🌲 Teil des CrumbForest

CrumbSeal ist ein Projekt im CrumbForest-Ökosystem.

CrumbForest
    ├── CrumbCore       ← AI-Chat, RAG, Characters
    ├── CrumbSeal  ←   ← Kabel-Kennzeichnung (dieses Repo)
    ├── CrumbPage       ← Admin-Handbücher
    └── CrumbPanda      ← BashPanda Support-Wissen

#jederkrümelzählt 🌲

Gebaut an einem langen Tag im Doppelboden, mit Klimarauschen und 60×60 Bodenplatten.
Weil DE es wollte. Weil wir es gebaut haben. Mit Herz.