📖 OZM-Keks-Handbuch v1 - README

Original Repository: https://194-164-194-191.sslip.io/git/kruemel/OZM-Keks-Handbuch-v1
Part of: Crumbforest Ecosystem
Role: Crumbpages - Educational Foundation & The Owl on the Bash 🦉

🌲 Crumbpages v2

Dokumentation und Lernsystem für System-Administration
Teil des Crumbforest-Ökosystems

📜 Lizenz & Kinderrechte

License: MIT + CKL
Children's Rights Protected

Dieses Projekt ist dual-lizenziert:

  • MIT License für Code und allgemeine Nutzung
  • CKL (Children's Knowledge License) für Bildungskontexte mit Kindern

Für Lernende: Deine Rechte sind geschützt. Lies hier mehr →

Für Entwickler: Frei nutzbar und forkbar. Compliance-Infos →

Was ist Crumbpages?

Crumbpages v2 kombiniert Bildungsdokumentation mit operationalen Tools für System-Administration:

📚 Lernpfade

  • 24 Crumbpages (Markdown) zu Linux-Fundamenten, SSH, Netzwerk, Kernel, Docker, uvm.
  • Template-basierte Struktur für konsistentes Lernen
  • Progressive Learning Paths: von Basics zu Advanced Topics

🛠️ Operational Tools

  • crumbpages-doktor.sh (496 Zeilen) - Hauptwerkzeug für Diagnostik & Operations
  • ssh-agent-guard.sh - Produktions-SSH-Security-Daemon
  • ssh-agent-screenlock_v4.sh - MATE Desktop SSH-Integration

🌳 Philosophie: Waldwächter

"Transparency over magic"

  • Bash-zentrisch, klar lesbar, lehrbar
  • Minimale Dependencies, einfache Patterns
  • Education-First: Alle Tools sind verständlich und nachvollziehbar

Schnellstart

1. Haupttool starten

# Ausführbar machen (einmalig)
chmod +x crumbpages-doktor.sh

# Interaktives Menü starten
./crumbpages-doktor.sh

Das Doktor-Tool bietet 6 Module:

  1. Git Workstation - Interaktive Git-Shell mit Health Checks
  2. DNS Doktor - DNS-Diagnostik und Reporting
  3. System Doktor - Host Vitals (Disk, RAM, OS Info)
  4. Web Tools - API-Testing (api_search, api_get, api_ask)
  5. Remote Tools - SSH-Helfer und SCP-Uploads
  6. Werkzeugkasten - Tool-Verfügbarkeits-Checks

2. SSH-Security aktivieren

# SSH-Agent Guard starten (systemd/autostart)
./ssh-agent-guard.sh

# Für MATE Desktop Integration
./ssh-agent-screenlock_v4.sh

Beide Scripts:

  • Killen und starten ssh-agent bei Screen Lock neu
  • Loggen nach ~/.ssh-agent-screenlock.log
  • Nutzen festen Socket-Path ~/.ssh/agent.sock

3. Lernpfade durcharbeiten

# Crumbpages lesen (Markdown)
ls crumbpage-*.md

# Template für neue Pages
cat crumbpage-template.md

🔑 Die 24 Crumbpages

  1. Users & Rechte - Grundlagen
  2. Host Info - System-Informationen
  3. Navigation - Verzeichnisse & Pfade
  4. Editoren - vi, nano, emacs
  5. Packages - apt, pkg, Paketmanagement
  6. Netzwerk - Grundlagen
  7. SSH Basics - Verbindung & Keys
  8. SSH Keys - Generierung & Management
  9. Storage - Festplatten, Mount, ZFS
  10. Services & Ports - Daemon, systemd
  11. First Access - Erstzugriff auf Systeme
  12. Git Basics - Version Control
  13. Pipes & Filters - Unix-Philosophie
  14. Environment - Shell-Variablen
  15. DNS - Domain Name System
  16. VPN - Virtual Private Networks
  17. Workstation - Desktop-Setup
  18. SSH Agent - Key-Management
  19. Agent Lockdown - Zero Trust
  20. Tanz am Kernel - Low-Level
  21. Backup, RAID, Cron - Datensicherung
  22. Nullfeld - Willkommen im Konzept
  23. AI & Philosophie - Vektor-Systeme
  24. Docker - Container-Technologie

📖 Wichtigste Dokumente

Dokument Beschreibung
OZM-NEXUS-ECOSYSTEM.md 🌐 Das große Bild: Wie Crumbpages ins Ökosystem passt
LICENSE.md 📜 Dual-Lizenz erklärt (MIT + CKL)
LICENSE-CKL.md 🛡️ Die vollständige Children's Knowledge License
KINDERRECHTE.md 👶 Deine Rechte als Lernende/r (Export, Löschung, Eigentum)
CLAUDE.md 🤖 Anleitung für Claude Code (Codebase-Kontext)
HANDBUCH.md 📖 Manual für crumbpages-doktor.sh
QUICKSTART.md ⚡ Quick Reference für häufige Operationen

🌍 Das größere Ökosystem

Crumbpages v2 ist Teil des Crumbforest:

OZM⟡NEXUS (Träger/Manifest)
    ↓
branko.de/Crumbforest (Public Interface)
    ├─ 15 Charaktere (Krümeleule, FunkFox, SnakePy...)
    ├─ 4 Lernpfade (ESP32 → Pi Zero → Pi Server → Daten)
    └─ "Every child may ask. We protect this right."
    ↓
CrumbCore v1 (Local Engine)
    ├─ FastAPI + Qdrant RAG
    ├─ Role-based Chat (15 Personas)
    ├─ Multi-Theme (Accessible, High Contrast...)
    └─ Token-Management (Kids = free)
    ↓
Crumbpages v2 (dieser Repo) ← 📍 DU BIST HIER
    ├─ 24 Lernpfade (Markdown)
    ├─ Operational Tools (doktor, SSH guards)
    └─ Waldwächter-Philosophie

Mehr dazu: OZM-NEXUS-ECOSYSTEM.md

🎯 Die 8 Axiome

Alle Komponenten des Crumbforest folgen diesen Prinzipien:

✅ autonom - Du entscheidest deinen Lernweg
✅ zukunftsoffen - Erweiterbar, nicht fertig
✅ nicht interpretierbar - Kein "richtiger" Weg, nur funktionale
✅ nicht missbrauchbar - Schutz durch Design
✅ suchbar - Fragen führen zu Antworten
✅ wiedererkennbar - Krümel zeigen den Weg
✅ erweiterbar - Du kannst selbst pflanzen
✅ unendlich skalierbar - Für alle, immer, kostenlos

🔧 Konfiguration

.env Datei

Das Doktor-Tool nutzt .env für Konfiguration (wird beim ersten Start erstellt):

# API Endpoints (für CrumbCore Integration)
CRUMB_API_URL="http://localhost:8000"
CRUMB_API_TOKEN="changeme"

# SSH/Remote Settings
CRUMB_SSH_USER="admin"
CRUMB_SCP_TARGET="backup.crumbforest.de:/var/backups"

# Qdrant Vector DB
CRUMB_QDRANT_URL="http://localhost:6333"
CRUMB_QDRANT_KEY=""

Tipp: Nie in Git committen! (ist bereits in .gitignore)

🌱 Für neue Mitwirkende

Willkommen im Wald!

Crumbforest ist ein offenes Lernökosystem. Jede/r kann Krümel pflanzen.

Voraussetzungen:

  • Du akzeptierst die CKL (Kinder haben Vorrang)
  • Du arbeitest transparent (keine Blackboxes)
  • Du dokumentierst nachvollziehbar (andere sollen nachbauen können)

🌲 Status & Roadmap

✅ Aktueller Stand

Fertig:

  • 24 Crumbpages
  • Operational Tools (doktor, SSH guards)
  • Dual-Lizenzierung (MIT + CKL v0.1)
  • Ecosystem-Dokumentation
  • Kinderrechte-Spezifikation

In Arbeit:

  • Integration mit CrumbCore
  • Export/Lösch-APIs für Kinderrechte
  • OZM als rechtlicher Träger

📍 Ressourcen

Related Repositories

  • CrumbCore v1: https://194-164-194-191.sslip.io/git/kruemel/Crumb-Core-v.1
  • CrumbCodex: https://194-164-194-191.sslip.io/git/kruemel/CrumbCodex-v.0.0
  • Crumbmissions: https://194-164-194-191.sslip.io/git/kruemel/crumbmissions

Websites

  • OZM: https://onezeromore.com
  • branko.de: https://branko.de

🦉 Zitat

"Wissen gehört dem Kind, solange es fragt."
"Nullfeld zuerst, dann Messung. Resonanz vor Regel."
— Waldwächter-Prinzip

Version: 2.0
Lizenz: MIT + CKL v0.1
Status: Active Development

Erstellt mit 💚 im Crumbforest
"Transparenz über Magic" 🌲

This README is part of the CRUMBFOREST-COMPLETE-DOCS-v1.0 collection
See also: README_CRUMB_CORE.md, README_CRUMBCODEX.md, README_CRUMBMISSIONS.md