Initial commit: Crumbforest Architecture Refinement v1 (Clean)

docs/crumbforest/__.md

@@ -0,0 +1,79 @@
+# 🌿 crumbforest\_plantlogik.md
+
+## Einleitung
+
+Im Crumbforest wachsen nicht nur Bits und Geschichten – auch Pflanzen dürfen wurzeln schlagen. Dieses Dokument beschreibt, wie Krümel mit Hilfe von Sensorik, Terminal-Kommandos und spielerischer Neugier den Kreislauf der Natur digital entdecken. Ziel ist es, Bewusstsein für nachhaltige Ernährung, Verantwortung und Technologiewissen zu verbinden.
+
+---
+
+## 1. Warum Pflanzen im Crumbforest?
+
+* **Nachhaltigkeit erleben**: Kinder beobachten in Echtzeit, wie Salat, Basilikum oder Tomaten wachsen.
+* **Verantwortung übernehmen**: Durch Gießmissionen, Lichtsteuerung und Datenpflege.
+* **Natur & Technik vereinen**: Sensorwerte verstehen, Temperatur lesen, Feuchtigkeit deuten.
+* **Kreisläufe begreifen**: Fotosynthese, Wasserverbrauch und Wachstum – im eigenen Bitgarten.
+
+---
+
+## 2. Technische Komponenten
+
+* **Sensorik**
+
+  * Feuchtigkeitssensor (z. B. Capacitive Soil Moisture)
+  * Temperatur- & Luftfeuchtesensor (DHT22)
+  * Licht- & UV-Sensor (TSL2591 oder BH1750)
+* **Microcontroller**: Raspberry Pi Zero oder ESP32
+* **Schnittstellen**: I2C, GPIO
+* **Anbindung an den Crumbforest-Terminal**: Logs, Alerts, Missionen
+
+---
+
+## 3. Terminal-Integration (Beispiele)
+
+```bash
+# Aktuelle Pflanzenwerte anzeigen
+$ growlog.sh
+
+# Gießmission starten
+$ giess_mission.sh --pflanze "Tomate"
+
+# Pflanzentagebuch öffnen
+$ nano /home/kruemel/pflanzentagebuch/tomate.txt
+```
+
+---
+
+## 4. Rollen im Pflanzenuniversum
+
+* **CapaciTobi** 🌰 (Erklärt elektrische Kapazität und Sensorverhalten)
+* **Wurzelwächterin** 🌾 (Poetische Erzählerin über Erdleben und Rhizome)
+* **BotaniX** 🌿 (Open-Source Pflanzencode-Kurator und Mission-Logik-Manager)
+
+---
+
+## 5. Typische Missionen
+
+* "Gieß den Salat, bevor er schlappmacht"
+* "Lichtkurve der Basilikum-Pflanze aufzeichnen"
+* "Warum mag Tomate kein kaltes Wasser?"
+* "Finde die Uhrzeit, zu der dein Sensor den Höchstwert meldet"
+
+---
+
+## 6. Vision
+
+Eine kleine Hydroponik-Einheit auf jedem Fensterbrett. Krümel lernen, dass Technik nicht nur blinkt, sondern lebt. Das Logbuch ihrer Pflanzen wird zum Teil ihrer Geschichte. Vielleicht wachsen sie so selbst – mit jedem Blatt, das sich öffnet.
+
+---
+
+## 7. Nächste Schritte
+
+* [ ] GPIO-Verkabelung dokumentieren
+* [ ] `growlog.sh` mit JSON-Ausgabe integrieren
+* [ ] Pflanzentagebuch als API bereitstellen
+* [ ] QR-Code für Pflanze + Missionen zum Ausdrucken erstellen
+* [ ] Schülerprojekte pilotieren
+
+---
+
+✨ "Wer Wurzeln versteht, programmiert mit Herz."