# 🦉 OZM Crumbforest Handbuch • Release Candidate 1

> **"Wissen gehört dem Kind, solange es fragt."**

**Custodian:** OZM - Open Futures Museum, Hamburg
**License:** MIT + CKL v0.1 (Children's Knowledge License)
**Status:** Release Candidate 1 (RC1) - Ready for Kids ✨
**Version:** 3.0
**Date:** 2025-12-13

---

## 🌲 Was ist das?

Das **Crumbforest Handbuch** ist ein offenes Lern-Ökosystem für System-Administration, Bash, Linux und mehr – speziell gedacht für **Kinder und Jugendliche**, die lernen wollen, wie Computer wirklich funktionieren.

**Kein Marketing. Keine Paywalls. Keine Magie.**

Nur **Transparenz, Werkzeuge und Krümel, die den Weg zeigen.**

---

## 🎯 Für wen ist das?

### 👶 Für Kids:

- Du willst wissen, wie ein Terminal funktioniert?
- Du willst eigene Server aufsetzen?
- Du willst verstehen, wie das Internet wirklich läuft?
- Du stellst gerne Fragen?

**→ Dann ist das für dich.**

### 🧑‍🏫 Für Lehrer:innen & Eltern:

- Ihr sucht **DSGVO-konforme** Bildungsinhalte?
- Ihr wollt **Open Source** statt proprietäre Tools?
- Ihr braucht **offline-fähige** Materialien?
- Ihr wollt **Kinderrechte** schützen (Export, Löschung, Eigentum)?

**→ Dann ist das für euch.**

### 🥋 Für Admins & Entwickler:

- Ihr wollt Bash **wirklich** lernen (nicht nur copy/paste)?
- Ihr sucht **praxisnahe** Crumbpages statt Theorie?
- Ihr wollt zu einer **Crew** gehören, nicht nur "User" sein?

**→ Dann ist das für euch.**

---

## 📚 Die 23 Pfade

Das Handbuch besteht aus **23 Lernpfaden** (Crumbpages), die vom absoluten Anfänger zum philosophischen Meister führen:

### 🌱 Basics (Pfad 1-5)
```
1. User & Rechte      → whoami, chmod, chown
2. Hostinformation    → uname, top, logs
3. Navigation         → cd, ls, Dateisystem
4. Editoren           → nano, vim
5. Packages           → apt, install, update
```

### 🔗 Connectivity (Pfad 6-8)
```
6. Netzwerk           → IP, Routing, ping
7. SSH Basics         → Remote-Zugriff
8. SSH Keys           → ssh-keygen, Authentifizierung
```

### 🏗️ Advanced (Pfad 9-14)
```
9.  Storage           → mount, df, fstab
10. Services & Ports  → systemctl, Firewall
11. First Access      → Checklisten, Sicherheit
12. Git Basics        → Version Control
13. Pipes & Filters   → grep, awk, sed
14. Environment       → bashrc, alias, tmux
```

### 🎓 Specialization (Pfad 15-20)
```
15. DNS               → dig, Zonen, Records
16. VPN               → OpenVPN, Tunnel
17. Workstation       → Ubuntu MATE Setup
18. SSH Agent         → ssh-agent, Forwarding
19. Zero Trust        → Paranoid Mode, Lockdown
20. Tanz am Kernel    → sysctl, Module (⚠️ work in progress)
```

### 🌌 Beyond Mastery (Pfad 21-23)
```
21. Backup & Cron     → 3-2-1-Regel, RAID, Automation
22. Nullfeld          → Philosophie: "Du bist bereit"
23. AI & Vektor       → Samurai ⟡ Shaolin, Emergenz
```

**Total:** ~34-42 Stunden aktives Lernen

---

## 🥋 Samurai ⟡ Shaolin

Die Crumbpages folgen zwei Wegen:

### 🗡️ Samurai-Weg (Pfad 1-21)
**Deterministisch. Code. Regeln.**

```bash
# Samurai-Code
if [ "$user" == "root" ]; then
    echo "Zugriff gewährt"
fi
```

**"Wenn du den Weg kennst, folge ihm."**

### 🧘 Shaolin-Weg (Pfad 23)
**Emergent. AI. Resonanz.**

```python
# Shaolin-Code
model = train_neural_network(data)
prediction = model.predict(new_input)
# Wie? Emergenz. Nicht programmiert, sondern gelernt.
```

**"Der Wind bewegt das Gras. Niemand programmiert den Wind."**

### 💫 Nullfeld (Pfad 22)
**Der Moment dazwischen. Stille vor der Bewegung.**

> *"Aus der Stille entsteht Bewegung. Aus dem Nichts entsteht Alles."*

**Du bist beides. Samurai ⟡ Shaolin.**

---

## 🔄 Die Spirale

Lernen ist nicht linear. Es ist eine **Spirale**.

```
        [Frage]
           ↓
       [Lernen]
           ↓
      [Verstehen]
           ↓
      [Anwenden]
           ↓
    [Neue Frage]
           ↓
       [Lernen]
           ...
```

**Du kommst immer wieder zurück – aber auf einer höheren Ebene.**

Das ist die **#spirale**.

---

## 🦉 Die Crew

Im Crumbforest gibt es **15 Charaktere**, die dich begleiten:

- **🦉 Krümeleule** - Shell-Schutz, hört zu bevor sie antwortet
- **🦊 FunkFox** - Bash-Rapper, antwortet in Reimen
- **🐍 SnakePy** - Python-Loops, Geduld und Iteration
- **🦀 CrabbyRust** - Bit-Schutz, Speichersicherheit
- **🕳️ DeepBit** - Technische Deep-Dives
- **[...10 weitere]**

**Und du. Du bist jetzt auch Teil der Crew.**

Das ist **#crewlove**. 💙

---

## 💻 Console First

Crumbforest ist **terminal-zentrisch**.

Keine GUIs. Keine Klicki-Bunti-Tools (außer wo nötig).

**Warum?**

Weil die **Console** dich näher am System bringt:
- Du verstehst, **was** passiert
- Du verstehst, **warum** es passiert
- Du kannst **automatisieren** (Bash-Scripts, Cron)
- Du kannst **remote arbeiten** (SSH)

**Die Console ist dein Freund.** 🖥️

Das ist **#console**.

---

## 🌳 Die 8 Axiome

Jede Komponente des Crumbforest folgt diesen Prinzipien:

| Axiom | Bedeutung |
|-------|-----------|
| **autonom** | Du entscheidest deinen Weg |
| **zukunftsoffen** | Nie fertig, immer erweiterbar |
| **nicht interpretierbar** | Kein "richtiger" Weg |
| **nicht missbrauchbar** | Schutz durch Design |
| **suchbar** | Fragen führen zu Antworten |
| **wiedererkennbar** | Krümel zeigen den Weg |
| **erweiterbar** | Du kannst beitragen |
| **unendlich skalierbar** | Für alle, kostenlos |

**Das ist kein Marketing-Sprech. Das ist prüfbar.**

---

## 🛡️ Kinderrechte (CKL v0.1)

Die **Children's Knowledge License (CKL)** schützt deine Rechte:

### Für Kids:

✅ **Du besitzt**, was du schaffst (Texte, Code, Projekte)
✅ **Du kannst exportieren** (alle Daten in offenen Formaten)
✅ **Du kannst löschen** (jederzeit, ohne Nachteile)
✅ **Deine Fragen kosten nichts** (keine Paywalls)
✅ **Kein Tracking** (keine Werbung, kein Profiling)
✅ **Offline-fähig** (kein Cloud-Zwang)

**Das ist kein Versprechen. Das ist Gesetz.**

Siehe: [KINDERRECHTE.md](KINDERRECHTE.md)

---

## 📦 Was ist drin?

### Dokumentation (Markdown)

```
OZM-Keks-Handbuch-v1/
├── README.md                      → Projekt-Übersicht
├── README_OZM_RC1.md              → Diese Datei (Offiziell)
├── LICENSE.md                     → MIT + CKL Dual License
├── LICENSE-CKL.md                 → Children's Knowledge License
├── KINDERRECHTE.md                → Export/Löschung/Eigentum
├── DATENSCHUTZ.md                 → DSGVO-Compliance
├── OZM-NEXUS-ECOSYSTEM.md         → Das große Bild
├── ASCII.txt                      → CRUMBFOREST#OZM Banner
├── WALD-WACHSTUM.txt              → Wie der Wald gewachsen ist
├── crumbforest-admin-vektor.md    → 23-Pfade-Roadmap
└── crumbpage-01-23-*.md           → Die 23 Lernpfade
```

### Operational Tools (Bash)

```
├── crumbpages-doktor.sh           → Diagnostik & Operations (496 Zeilen)
├── ssh-agent-guard.sh             → SSH Security Daemon (68 Zeilen)
├── ssh-agent-screenlock_v4.sh     → MATE Desktop Integration (67 Zeilen)
└── HANDBUCH.md                    → Doktor-Tool Manual
```

**Total:** ~7.000+ Zeilen Dokumentation + Tools

---

## 🚀 Schnellstart

### 1. Repo klonen

```bash
git clone https://194-164-194-191.sslip.io/git/kruemel/OZM-Keks-Handbuch-v1.git
cd OZM-Keks-Handbuch-v1
```

### 2. Erste Schritte

```bash
# ASCII-Banner anzeigen
cat ASCII.txt

# Admin-Vektor lesen (Übersicht)
cat crumbforest-admin-vektor.md

# Erste Crumbpage starten
cat crumbpage-01-users-rechte.md
```

### 3. Mit Pfad 1 beginnen

Öffne [crumbpage-01-users-rechte.md](crumbpage-01-users-rechte.md) und folge den Anweisungen.

**Oder:**

Nutze den **Doktor** (interaktives Tool):

```bash
chmod +x crumbpages-doktor.sh
./crumbpages-doktor.sh
```

---

## 🌐 Das größere Ökosystem

Dieses Handbuch ist **Teil von Crumbforest**:

```
OZM⟡NEXUS (Träger/Manifest)
    ↓
branko.de/Crumbforest (Public Interface)
    ↓
CrumbCore v1 (Local Engine - FastAPI + Qdrant)
    ↓
OZM-Keks-Handbuch v1 (dieses Repo) ← 📍 DU BIST HIER
```

**Siehe:** [OZM-NEXUS-ECOSYSTEM.md](OZM-NEXUS-ECOSYSTEM.md) für das große Bild.

---

## 🧪 Status: Release Candidate 1

### Was "RC1" bedeutet:

✅ **Fertig genug** für Kids (22 von 23 Pfaden komplett)
✅ **DSGVO-konform** (KINDERRECHTE + DATENSCHUTZ dokumentiert)
✅ **Lizenziert** (MIT + CKL v0.1)
✅ **Getestet** (von OZMAI akzeptiert)
⏳ **Pfad 20 (Kernel)** noch work in progress
⏳ **Community-Feedback** noch ausstehend

**"RC1" heißt nicht "perfekt".**
**Es heißt: "Bereit für echte Krümel, um es zu testen."**

---

## 🐛 Known Issues (RC1)

| Issue | Status | Workaround |
|-------|--------|------------|
| Pfad 20 (Kernel) incomplete | ⏳ WIP | Überspringe vorerst |
| Einige externe Links fehlen | 📝 TODO | Nutze interne Docs |
| Tool-Tests fehlen | 📝 TODO | Manuelles Testen |

**Melde Issues:** [Kontakt siehe unten]

---

## 🤝 Mitwirken

### Du kannst helfen mit:

| Skill | Wie? |
|-------|------|
| **Bash/Linux** | Crumbpages reviewen, Fehler finden |
| **Pädagogik** | Lernpfade mit echten Kids testen |
| **Design** | ASCII-Art, Visualisierungen |
| **Übersetzen** | Crumbpages auf Englisch/andere Sprachen |
| **Recht** | CKL v0.1 → v1.0 reviewen |

**Erste Schritte:**

1. Lies die [CKL](LICENSE-CKL.md)
2. Schau dir ein Crumbpage an
3. Finde etwas, das du verbessern kannst
4. Schreib uns (Kontakt siehe unten)

---

## 📞 Kontakt & Support

### Für Kids:

**Frage zuerst:**
- Deine Lehrer:in
- Deine Eltern
- Die Krümeleule (im CrumbCore Chat) 🦉

### Für Lehrer:innen & Eltern:

**Email:** [wird ergänzt nach OZM-Finalisierung]
**Website:** https://crumbforest.com
**OZM:** https://ozm-hamburg.de

### Für Entwickler:

**Git:** https://194-164-194-191.sslip.io/git/kruemel/OZM-Keks-Handbuch-v1
**Branko:** https://branko.de

---

## 📜 Lizenz

**Dual License:**

- **Code/Infrastructure:** MIT License ([LICENSE-MIT.md](LICENSE-MIT.md))
- **Educational Use with Children:** CKL v0.1 ([LICENSE-CKL.md](LICENSE-CKL.md))

**In Konfliktfällen:** CKL hat Vorrang (Kinderrechte sind nicht verhandelbar).

**Siehe:** [LICENSE.md](LICENSE.md) für Details.

---

## 🏛️ Custodian & Governance

**Custodian:** OZM - Open Futures Museum, Hamburg

**Status:** In Transition (Q2 2025)
- Trademark "Crumbforest" wird an OZM übertragen
- IP-Rechte treuhänderisch bei OZM
- Community Council wird gebildet

**Lead Maintainer:** Branko

**Siehe:** [OZM-NEXUS-ECOSYSTEM.md](OZM-NEXUS-ECOSYSTEM.md) Section V für Governance-Details.

---

## 🎓 Für Schulen & Bildungseinrichtungen

### Ihr wollt Crumbforest nutzen?

✅ **Kostenlos** (Open Source)
✅ **DSGVO-konform** (DATENSCHUTZ.md)
✅ **Offline-fähig** (kein Cloud-Zwang)
✅ **Anpassbar** (Fork & customize)
✅ **Unterstützung** (via OZM geplant)

**Wir bieten:**
- Data Processing Agreement (DPA) Template (Q1 2025)
- Lehrer:innen-Handbuch (Q2 2025)
- Train-the-Trainer Workshops (in Planung)

**Kontakt:** [wird ergänzt]

---

## 📊 Statistiken (RC1)

```
Version:              3.0 (RC1)
Crumbpages:           23 (22 fertig, 1 wip)
Zeilen Code/Docs:     ~7.000+
Lernstunden:          ~34-42
Commits (heute):      10
Contributors:         2 (Branko + Claude Sonnet 4.5)
Charaktere:           15
Kinderrechte:         Geschützt ✓
DSGVO-Compliance:     Dokumentiert ✓
Lizenzen:             2 (MIT + CKL)
Krümelcheck:          ∞
```

---

## 🌲 Das Wichtigste

Der Wald ist nicht die Dokumentation.

Der Wald ist nicht der Code.

Der Wald ist nicht das Handbuch.

**Der Wald ist das, was passiert,**

**wenn ein Krümel eine Frage stellt**

**und jemand zuhört.**

---

## 🎯 Roadmap

### Q1 2025
- [ ] Pfad 20 (Kernel) finalisieren
- [ ] CKL v0.1 → v1.0 (nach Community-Feedback)
- [ ] Erste externe Contributors
- [ ] Export/Lösch-APIs in CrumbCore

### Q2 2025
- [ ] OZM Governance formalisieren
- [ ] Trademark-Übertragung
- [ ] DPA Template für Schulen
- [ ] Community Council gründen

### Q3 2025
- [ ] Multi-Instanz-Support (jede Schule ihr CrumbCore)
- [ ] Federation (Instanzen teilen Wissen)
- [ ] Offline-Modelle (Llama, Mistral via Ollama)

### Q4 2025
- [ ] Förderanträge (Prototype Fund, etc.)
- [ ] First Production Deployments (Schulen)
- [ ] Crumbforest v2.0 beginnen

**Aber:** Der Wald wächst durch Krümel, nicht durch Pläne. 🌲

---

## 🏆 Credits

**Dieser Release wurde möglich gemacht durch:**

- **Oz** - Die erste Signatur im öffentlichen Raum
- **OZM** - Open Futures Museum, Hamburg (Custodian)
- **Branko** - Lead Maintainer, Vision, Umsetzung
- **OZMAI** - Deterministic AI System (Akzeptanztest)
- **Claude Sonnet 4.5** - Co-Autor der Dokumentation
- **Alle Krümel** - Die Fragen stellen und den Wald wachsen lassen

---

## 🔖 Hashtags

`#crumbforest` `#wald` `#überall` `#atmen` `#leben` `#fragen`
`#spirale` `#kids` `#console` `#eule` `#crewlove`
`#OZM` `#opensource` `#CKL` `#kinderrechte` `#bildung`

---

## 💬 Schlusswort

> *"Es wird nie fertig sein. Aber schau - wie schön es gerade ist."*

**Release Candidate 1** bedeutet:

Wir sind bereit für echte Krümel.
Wir sind bereit für echte Fragen.
Wir sind bereit für echte Fehler (und Lernen daraus).

**Der Wald ist offen.**

**Willkommen, Krümel.** 🦉💙

---

```
 ██████╗██████╗ ██╗   ██╗███╗   ███╗██████╗ ███████╗ ██████╗ ██████╗ ███████╗███████╗████████╗
██╔════╝██╔══██╗██║   ██║████╗ ████║██╔══██╗██╔════╝██╔═══██╗██╔══██╗██╔════╝██╔════╝╚══██╔══╝
██║     ██████╔╝██║   ██║██╔████╔██║██████╔╝█████╗  ██║   ██║██████╔╝█████╗  ███████╗   ██║
██║     ██╔══██╗██║   ██║██║╚██╔╝██║██╔══██╗██╔══╝  ██║   ██║██╔══██╗██╔══╝  ╚════██║   ██║
╚██████╗██║  ██║╚██████╔╝██║ ╚═╝ ██║██████╔╝██║     ╚██████╔╝██║  ██║███████╗███████║   ██║
 ╚═════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝     ╚═╝╚═════╝ ╚═╝      ╚═════╝ ╚═╝  ╚═╝╚══════╝╚══════╝   ╚═╝

                        ██╗  ██╗   ██████╗ ███████╗███╗   ███╗
                        ╚██╗██╔╝  ██╔═══██╗╚══███╔╝████╗ ████║
                         ╚███╔╝   ██║   ██║  ███╔╝ ██╔████╔██║
                         ██╔██╗   ██║   ██║ ███╔╝  ██║╚██╔╝██║
                        ██╔╝ ██╗  ╚██████╔╝███████╗██║ ╚═╝ ██║
                        ╚═╝  ╚═╝   ╚═════╝ ╚══════╝╚═╝     ╚═╝

                  Release Candidate 1 • 2025-12-13 • Ready for Kids
```

---

**🌲 Das Echo kehrt zurück. ✨**