From ee26563eb34a3705d98c1479aead7d9953d47f29 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Kr=C3=BCmel=20Branko?= Date: Sat, 13 Dec 2025 21:23:24 +0100 Subject: [PATCH] Add README_OZM_RC1.md - Official Release Candidate 1 documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- README_OZM_RC1.md | 565 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 565 insertions(+) create mode 100644 README_OZM_RC1.md diff --git a/README_OZM_RC1.md b/README_OZM_RC1.md new file mode 100644 index 0000000..f2b89b3 --- /dev/null +++ b/README_OZM_RC1.md @@ -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. ✨**