Krümel Branko
83df9de035
12 Monate Crumbforest-Wachstum, sortiert nach Waldlogik. Struktur: - 454 Dokumente in 7 organischen Ebenen - Lichtung → Waldrand → Waldmitte → Wurzeln → Krone → Unterholz → Samen - INDEX.md für jede Ebene (eigene Stimme) - WALDKARTE.md (Master-Navigation) - crumbcodex.md (Das Versprechen zwischen Krümel & Bits) - lichtung/willkommen.md (Nullfeld-Einstieg für Kinder) Philosophie: - Waldlogik statt Ordnerlogik - Tiefe, Licht, Wurzeln - wie ein echter Wald - Schutz für Krümel, Tiefe für Gräber, Poesie für Atmende Repos verbunden: - OZM-Keks-Handbuch-v1 (Das Wissen) - Crumb-Core-v.1 (Das Herz) - 194.164.194.191 - crumbmissions (Das Spiel) Wuuuhuuuuu! 🦉✨
219 lines
5.5 KiB
Markdown
219 lines
5.5 KiB
Markdown
# 🌲 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.* ⚙️
|