# 🌲 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**:
```bash
# 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.* ⚙️