kruemel/OZM-Keks-Handbuch-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add README_OZM_RC1.md - Official Release Candidate 1 documentation

Browse Source 
Comprehensive README for OZM Release Candidate 1:

**For Kids:**
- 23 learning paths (Basics → Mastery → Philosophy)
- Console-first approach (#console)
- 15 crew characters (#eule #crewlove)
- Spiral learning model (#spirale)
- No paywalls, no tracking

**For Teachers & Parents:**
- GDPR-compliant (KINDERRECHTE + DATENSCHUTZ)
- Offline-capable (no cloud lock-in)
- Open Source (MIT + CKL v0.1)
- DPA template coming Q1 2025

**For Admins & Developers:**
- 23 Crumbpages (~7,000+ lines)
- Bash-centric, transparent tools
- Samurai ⟡ Shaolin philosophy
- Contribution guidelines

**RC1 Status:**
✅ 22/23 paths complete (Pfad 20 = WIP)
✅ GDPR-compliant documentation
✅ Dual-licensed (MIT + CKL)
✅ OZMAI acceptance test passed
⏳ Community feedback pending

**Key Sections:**
- Quick Start (3 steps)
- The 23 Paths overview
- Samurai vs Shaolin metaphor
- The 8 Axioms (operationalized)
- Children's Rights (CKL)
- Ecosystem context (OZM⟡NEXUS)
- Roadmap Q1-Q4 2025
- Known Issues
- Credits & Hashtags

"Der Wald ist das, was passiert, wenn ein Krümel eine Frage stellt
und jemand zuhört."

Ready for Kids. Ready for Production. RC1. 🦉✨

#crumbforest #wald #spirale #kids #console #eule #crewlove

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Krümel Branko
2025-12-13 21:23:24 +01:00
parent bb1ce7ed20
commit ee26563eb3
1 changed files with 565 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

565
README_OZM_RC1.md Normal file
View File

@@ -0,0 +1,565 @@
# 🦉 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. ✨**