🌲 Die Waldmitte

Hier steht die Infrastruktur. Hier wird gebaut.

Was ist die Waldmitte?

Die Waldmitte ist das technische Rückgrat des Crumbforest.

Hier findest du:
- Docker-Container und Compose-Files
- FastAPI-Backend und CRM-Systeme
- CLI-Tools und Monitoring
- Hardware-Specs (ESP32, LoRa, Sensoren)
- Build-Logs und technische Protokolle

Dies ist kein Ort für Anfänger.
Aber für die, die bereit sind zu bauen.

Für wen ist die Waldmitte?

Für Gärtner - die, die den Wald pflegen:
- Entwickler, die Code schreiben
- Sysadmins, die Server hüten
- Hardware-Bastler, die ESPs flashen
- DevOps-Leute, die CI/CD aufbauen
- Alle, die "unter die Haube" schauen wollen

Was findest du hier? (77 Dokumente)

🐳 Docker (11 Dokumente)

Im Ordner docker/:

Container-Setup für Crumbforest:
- CakePHP (PHP 8.3+) mit Authentication
- MariaDB (kuchenwald)
- Adminer (Port 8081)
- TTYD (Terminal, Port 7681)
- Qdrant (Vektor-DB, Port 6333)

Schlüsseldokumente:
- docker_cake_ttyd_setup.md - Setup-Anleitung
- Docker_june.md - Statusbericht Juni
- README_crumforest_docker.md - Docker-README

Zugriffspunkte:
- http://localhost:8080 - CakePHP App
- http://localhost:8081 - Adminer
- http://localhost:7681 - TTYD Terminal
- http://localhost:6333/dashboard - Qdrant Dashboard

🌐 CrumbCore (17 Dokumente)

Im Ordner crumbcore/:

Das Herz des Systems:
- FastAPI Backend mit 15 Charakter-Rollen
- RAG (Retrieval-Augmented Generation) über Qdrant
- Multi-Provider AI: OpenAI, Claude, Gemini, OpenRouter
- CRM mit Diary/Journal-System
- 4 Themes: Standard, Accessible, High Contrast, Admin Dark

Live unter: 194.164.194.191 🟢

Schlüsseldokumente:
- crumbcore_v1.md - Haupt-Doku
- crumbcore_onboarding.md - Für neue Entwickler
- crumbcrm_v1.md - CRM-System
- CrumbOS.md - Betriebssystem-Konzept

Demo-Login: demo@crumb.local / demo123

🛠️ Tools (11 Dokumente)

Im Ordner tools/:

CLI-Tools für Operations:
- cf-tools.sh - Snapshot-Management (/var/cf)
- crumbpages-doktor.sh - System-Diagnostik (496 Zeilen, 6 Module)
- vector-index - Qdrant-Indexierung
- eule - RAG-basierte Suche
- ssh-agent-guard - SSH-Security-Daemon

Schlüsseldokumente:
- cf_tools.md - Haupt-Doku für CF-Tools
- README_indexing.md - Markdown → Qdrant Workflow

Wichtige Befehle:

# Snapshot-Management
cf-tools recent L1 60        # Letzte 60 Min, Layer L1
cf-tools device L1 ESP04     # Device-Stats
cf-tools device-json L1 ESP04 | jq  # JSON-Output

# Vektor-Indexierung
vector-index                 # Qdrant re-indexieren
vector search "term" --k 5   # Suche
eule --no-llm "question"     # Kontext-only

# System-Diagnostik
crumbpages-doktor --check-all

🔌 Hardware (24 Dokumente)

Im Ordner hardware/:

Physical Layer des Crumbforest:
- ESP32 (SVGA, Kamera, LoRa)
- Raspberry Pi (Pi4, Pi5, Zero)
- LoRa-Netzwerk (CrumbSignals)
- Sensoren (LiPo, Solar, Rainbow-Counter)
- LED-Visualisierung (Netzwerk-Baum)

Hardware-Projekte:
- Robot Academy: LiPo Power, Rainbow Counter, Moon Machine
- Solar Kettle: Simulator für Energiesysteme
- LoRa v1: Mesh-Netzwerk im Wald
- LED-Baum: Physische Netzwerk-Visualisierung

Schlüsseldokumente:
- Crumbforest_Logbuch__Raspberry_Pi_5.md
- Crumbforest_Pi4_Gateway_Plan.md
- crumbsignals__lora_v1.md
- Crumbforest_LED-Baum_–_Netzwerkvisu.md

📊 Logs Technik (14 Dokumente)

Im Ordner logs_technik/:

Build-Logs, Debug-Protokolle, Statusberichte:
- Crumbforest Build-Logs
- Docker-Deployment-Logs
- Blockly-Terminal-Bridge-Logs
- TTYD Debug-Logs
- SnakeCam Debug-Lessons

Schlüsseldokumente:
- crumbforest_build_manifest.md - Build-System-Manifest
- DebuglogCrumbforestBuildv0.md - Debug-Log v0
- 🧱_Blockly-Terminal-Bridge_Logbuch.md
- 🐛_TTYD_Debug_Log_–_Crumbforest_Termin.md

Die fünf Säulen der Waldmitte

1. Containerisierung (Docker)

Alles läuft lokal.
Keine Cloud-Abhängigkeit.
Reproduzierbar. Transparent.

2. Backend & AI (CrumbCore)

15 Charakter-Rollen mit echten LLMs.
RAG über Qdrant für Kontext.
Multi-Provider für Resilienz.

3. Operations (Tools)

CLI-First.
Skriptbar. Monitorbar.
Keine GUIs, die lügen können.

4. Physical Layer (Hardware)

Der Wald ist nicht nur Software.
ESP32, LoRa, Sensoren bringen ihn in die reale Welt.

5. Observability (Logs)

Jeder Build ist dokumentiert.
Jeder Fehler ist lehrbar.
Transparenz über Magic.

Technologie-Stack

Frontend:
  - Browser (CrumbCore UI)
  - TTYD (Terminal im Browser)
  - Crumbblocks (Blockly → Terminal Bridge)

Backend:
  - FastAPI (Python 3.11+)
  - CakePHP 5 (PHP 8.3+)
  - MariaDB (kuchenwald)

AI:
  - OpenAI (GPT-4o, GPT-3.5)
  - Anthropic (Claude Sonnet/Opus)
  - Google (Gemini)
  - OpenRouter (Multi-Provider)

Vector DB:
  - Qdrant (localhost:6333)
  - Collection: md_files
  - Model: sentence-transformers

Hardware:
  - ESP32 (Camera, LoRa, GPIO)
  - Raspberry Pi 4/5/Zero
  - LoRa Modules (868 MHz)
  - LiPo, Solar, LEDs

DevOps:
  - Docker & Docker Compose
  - Bash automation
  - Systemd timers
  - Git (Gitea self-hosted)

Verbindungen zu anderen Waldebenen

Vom Waldrand hierher: Du willst jetzt bauen, nicht nur lernen
Von hier zu den Wurzeln: Du willst verstehen, warum wir so bauen
Von hier zu den Samen: Du hast Ideen für neue Features

Die Waldmitte ist kein Ort zum Ausruhen. Aber wer hier arbeitet, baut den Wald. 🌲🔧

Wenn du hier bist: Willkommen in der Werkstatt.
Mach die Hände dreckig. Das gehört dazu. ⚙️