CrumbCodex-v.0.0/samen/pelikan_bauplan_v1.md

Pelikan v1 – Bauplan, damit er im Wald atmet

Alias: Crumbcase / RKL-Koffer 🟡🌲 Ziel: Ein mobiler, robuster Knoten, der offline wie online arbeiten kann, mit Licht/Sound/Displays als Resonanz – damit der Wald atmet und Kinder Fragen stellen können.

---

🧭 Kurzfassung

• Mechanik: Boden- und Deckelplatten (Holz/Multiplex) + TPU-Snap-Verbinder; alles lösbar (Klett, Schrauben nur wo nötig).
• Strom: 230 V In → Mehrfachsteckdose → 5 V/10 A Schalt‑Netzteil (USB‑Rails) + optional 24 V für PoE; LiFePO₄‑Akkupack als Mini‑UPS.
• Netz: MikroTik Router (Hotspot + Mesh) → RPi 5 (Hailo) → ESP32 (WS2812 Status‑LED) → Kameras & Sensoren.
• Software: Edge‑Stack (MQTT, Eule, Qdrant optional, Doctor‑Skripte), Web‑Status peli.local.
• Prinzip: Resonanz statt Kontrolle – sichtbar, reversibel, leise wartbar.

---

🌱 Prinzipien (Crumb‑Codex)

1. Reversibel: Klett > Kabelbinder, Steck > Klebe, Schraube nur an tragenden Punkten.
2. Sichtbar: LEDs/Displays zeigen Zustand (Boot, Netz, Fehler).
3. Sicher: Sicherungen, Zugentlastung, getrennte AC/DC, Berührungsschutz.
4. Modular: Monolith v1, aber Schnittstellen für Ausbau (PoE, Akku, weitere I/O).
5. Offen: Open‑Source, Dokumentation, Kinder dürfen schauen/fragen.

---

🧱 Architektur (Überblick)

Energie → 230 V In • Mehrfachsteckdose • 5 V/10 A PSU • (optional 24 V PSU/Boost für PoE) • LiFePO₄ Mini‑UPS Rechner → RPi 5 + Hailo • Dual‑HDMI‑Touch • USB‑C Kamerarails Netz → MikroTik RouterOS (Hotspot + VLAN) • WAN via LTE/5G‑Hotspot oder Ethernet Resonanz → ESP32 + WS2812 LED‑Leiste (MQTT) • Taster/Buzzer Daten → Eule CLI/API • (optional) Qdrant Edge • Sync zur Online‑Instanz (VPN) Gehäuse → Pelican‑Case; Deckel: Displays+Router / Boden: Strom+Rechner.

---

🧩 Stückliste (BOM – Mindestsetup)

• Pelican‑Case 15xx (gelb).
• 2× HDMI‑Touch 5–7″ (Deckel), VESA/Lasch‑Montage.
• MikroTik Router (hEX/AX/MAP je nach Ports).
• RPi 5 + Hailo M.2 / USB; 128 GB+ µSD/SSD.
• 5 V/10 A Schaltnetzteil (Industrie‑Brick) + USB‑C DC‑Module (Rails für Cams, 5 V out).
• Mehrfachsteckdose (innen), Kaltgeräte‑Einspeisung mit Zugentlastung.
• ESP32 + WS2812B LED‑Strip (Deckelrand).
• TPU‑Verbinder: T‑Joiner, Side‑Clips (3D‑Druck) + Klett‑Bänder.
• Sicherungen (5×20 mm oder Inline), Ferrite, Schrumpf.
• Kamera(s) USB‑C/CSI nach Bedarf; HDMI‑Kabel kurz, 90°‑Stecker.

Optional: 24 V Netzteil/Boost + PoE‑Injector/Switch; LiFePO₄ 4S (BMS) als UPS; Buzzer, Not‑Aus.

---

🪚 Mechanik & Layer

Messen & Platten

• Innenmaß immer selbst messen (Toleranzen, Dichtlippe!).
• Boden/Deckel je eine Grundplatte; falls Material kürzer ist → 2‑teilige Platten mit TPU‑T‑Joinern über die Mittelnaht.

TPU‑Verbinder (Snap, bündig)

• Mittelfuge: pro Plattenkante 6 mm × 3 mm Nut; T‑Joiner: stem ≈ 5.6 mm, cap 12×3 mm, 3–4 Stück je Naht.

• Seitenhalt:

  • Clip‑mit‑Lippe hakt unter Innenkante.
  • Press‑Clip klemmt mit TPU‑Keil gegen die Wand (bohrfrei).

• Druck (TPU 95A): 0.25–0.30 mm, 3 Perimeter, 35–45 % Gyroid, 225–235 °C/50 °C.

• Kanten der Holzplatten brechen (0.5 mm Fase), EVA‑Pads 0.5–1 mm gegen Klappern.

Deckel

• Displays + Router auf Einlegeplatte; Service‑Loop, 90°‑HDMI, LED‑Strip entlang Dichtung (Klebekanal).

Boden

• 230 V‑Sektion links (Steckdose, Einspeisung, Sicherung, Zugentlastung).
• 5 V‑PSU und USB‑Rails rechts; RPi mittig mit Luft.
• Rot/Schwarz Busbars nur für DC; AC immer getrennt führen.

---

⚡ Strom & Sicherheit

• Einspeisung: Kaltgerätebuchse mit Zugentlastung + Feinsicherung.
• Schutz: AC‑Abdeckung (Finger‑safe), PE‑Erdung der PSU‑Gehäuse.
• 5 V/10 A liefert RPi, Displays, Kameras; USB‑C‑Rails mit 3–5 A‑Modulen (Kurzschluss‑schutz).
• 24 V PoE (optional): eigener Kreis; Injector/Switch.
• Mini‑UPS (LiFePO₄ 4S): Ladegerät 14.6 V + BMS; ideal‑ORing (Diode/MOSFET) → sauberer Übergang.
• Thermik: Lüftungslochblech der PSU frei; ggf. 5 V‑Silent‑Lüfter (PWM via RPi).
• EMI: Ferrite auf HDMI/USB‑Bündeln, sternförmige Masse.

Power‑Budget (Daumen): RPi 5 ~7–10 W, je HDMI‑Touch 3–5 W, Router 3–6 W, LED‑Strip 2–6 W (mittel). 10 A@5 V reicht i. d. R. (Reserve >30 %).

---

🌐 Netzwerk & Dienste

MikroTik (Beispiel)

• SSIDs: RKL (offen/Captive) und PELIMESH (WPA2, Crew).
• VLANs: 10 „Kids“ (Internet optional), 20 „Crew“, 30 „IoT“ (MQTT/LED).
• DHCP: feste Ranges; mDNS/Avahi für peli.local.
• Captive‑Startseite erklärt Projekt + lokale Links.
• Fallback‑IP: 192.168.77.1

Edge‑Stack (RPi)

• MQTT (mosquitto) → crumb/led/status, crumb/sensor/#.
• Eule CLI/API lokal.
• (Optional) Qdrant Edge für Offline‑Suche (kleine Collections).
• Web‑Status: http://peli.local (LED‑Farbe, IPs, Logs).
• Doctor‑Skripte: strato_doctor_plus.sh/crumb_doctor.sh read‑only Checks.

Licht‑Resonanz (ESP32)

• Topics: crumb/led/set → {mode:"ok|warn|error|think", color:"#rrggbb"}.
• Boot‑Pattern: sanfter „Atmer“.
• Error‑Code: 3× rot (Netz down), 2× gelb (Sensor), cyan‑Pulse (LLM busy).

Online‑Brücke (später)

• STRATO/Cloud nur als Spiegel: Reverse‑Proxy, Qdrant‑Sync, TTYD über Auth.
• Trennung Edge ≠ Online per .env (Qdrant URL, HF_HOME etc.).

---

📸 Displays & Kameras

• Dual‑HDMI Touch: oben System‑Status, unten App/Console; Helligkeit per GPIO/I²C dimmen.
• Cams: 5 V‑USB‑C Rails, kurze Kabel, Klett‑Führung; optional Flexarm‑Halter.

---

🧪 Aufbau – in 12 Schritten

1. Innenmaß nehmen, Boden/Deckelplatten zuschneiden.
2. Mittelfugen‑Nuten fräsen (6×3 mm).
3. TPU‑T‑Joiner testdrucken (stem 5.4/5.6/5.8) → passenden wählen.
4. Platten einsetzen, mit Side‑Clips an der Wand sichern.
5. Einspeisung montieren: Buchse, Sicherung, Zugentlastung, Mehrfachsteckdose.
6. 5 V‑PSU verschrauben, USB‑Rails verdrahten (Beschriftung!).
7. Router in den Deckel, Displays verkabeln (Service‑Loop).
8. RPi 5 + Hailo mittig, SSD einpassen, Ferrite setzen.
9. ESP32 + LED‑Strip ankleben, MQTT‑WLAN testen.
10. Kabelmanagement: Klett, Nummern, Trennung AC/DC.
11. Deckel/Boden‑Smoke‑Test (ohne Last, dann Last).
12. Web‑Status & Captive prüfen, Foto machen, atmen lassen.

---

✅ Inbetriebnahme‑Checkliste

• 230 V rein, LED atmet → OK.
• peli.local erreichbar, Router‑GUI ok.
• Displays zeigen Statusseite.
• MQTT‑Ping → LED wechselt Farbe.
• Kamera wird erkannt, Bild kommt.
• (Optional) Qdrant /healthz ok.

---

🧯 Sicherheit & Reisen

• Finger‑safe an AC, PE geprüft, PSU verschraubt.
• Kein Metall frei schwebend, Zugentlastungen überall.
• Reise: Akku abklemmbar, Inhalt deklarieren (Edu/Research), Fotos & Liste bereithalten.

---

🔁 Pflege & Update

• Backups: RPi‑Image, Router‑Export, .env.
• Logs monatlich sichten (Doctor‑Skripte).
• Firmware halbjährlich: MikroTik, RPi‑Kernel, ESP32.
• Mechanik nachziehen: Clips, Klett, Pads.

---

🌐 Modi (Beispiele)

• Klassenzimmer: Hotspot RKL, Captive zeigt Übungen & Blocks.
• Wald/Field: Offline‑Mesh; LED reagiert auf Sensoren (Luft, Lautstärke).
• Festival/Pop‑up: Projektions‑/Streaming‑Koffer; TTYD gesichert über Proxy.

---

📜 Lizenz & Credits

Lizenz: CKL – Children’s Knowledge License. Crew: OZM × Crumbforest × Freunde. RKL – Regenbogen‑Krümel‑Login: Zugang ohne Angst, mit Resonanz.

Jeder Pelikan trägt ein Stück Wald in sich. Jede Frage ist ein Blatt – und der Koffer hilft beim Atmen.